ArcGIS Experience Builder

Ce plugin est un widget personnalisé pour ArcGIS Experience Builder. Il affiche le panorama Jakartowns dans un panneau flottant, synchronisé avec un widget Carte de votre expérience : un clic sur la carte déplace le panorama, et un indicateur suit en direct la position et l'orientation de la vue sur la carte.

Vos utilisateurs consultent ainsi le jumeau numérique sans quitter votre application ArcGIS.

Le panneau Jakartowns superposé à la carte de l'expérience

Le code source, les versions publiées et le suivi des problèmes sont hébergés sur GitHub : jakarto3d/experience-builder-jakarto-plugin.

Fonctionnalités

• Affichage du panorama Jakartowns directement dans une expérience ArcGIS, dans un panneau flottant repliable, déplaçable et redimensionnable.

• Localisation du panorama depuis la carte : mode « Cliquer sur la carte », ou clic droit sur la carte (option à activer).

• Indicateur de position et d'orientation sur la carte, mis à jour pendant que l'utilisateur navigue dans le panorama.

• Frise des dates permettant de basculer entre les différentes prises de vue disponibles à un même endroit (multipass).

• Bouton « Ouvrir dans Jakartowns ↗ » qui ouvre l'image affichée dans Jakartowns, dans un nouvel onglet.

• Connexion par clé d'API personnelle : chaque utilisateur se connecte avec son propre compte Jakarto.

Prérequis

• Une expérience ArcGIS Experience Builder contenant un widget Carte.

• Un portail ArcGIS Enterprise 11.0 ou plus récent — les widgets personnalisés n'y sont pris en charge qu'à partir de cette version — ainsi que les privilèges d'administration nécessaires à leur enregistrement. (Pour un essai local, une édition développeur d'Experience Builder convient également.)

• Un serveur web accessible depuis le portail pour héberger les fichiers du widget (voir l'étape 2 de l'installation).

• Un compte Jakarto et sa clé d'API, pour chaque personne qui utilisera le panorama.

Installation

1. Télécharger le widget

Rendez-vous sur la page de la dernière version. Deux fichiers ZIP y sont publiés :

• Jakartowns-v<version>-portal.zip — la version compilée, à utiliser pour un portail ArcGIS Enterprise. C'est celle-ci qu'il vous faut dans la très grande majorité des cas.

• Jakartowns-v<version>.zip — le code source uniquement, destiné à une édition développeur d'Experience Builder (à copier dans client/your-extensions/widgets/).

⚠️ Avertissement :

Le ZIP de code source ne fonctionne pas sur un portail : le widget s'y enregistre mais reste inutilisable. Sur un portail, utilisez toujours le fichier -portal.zip.

2. Déployer et enregistrer le widget dans le portail

Transmettez le fichier Jakartowns-v<version>-portal.zip à la personne qui administre votre portail ArcGIS Enterprise. De son côté :

1. Héberger les fichiers : décompressez l'archive et déposez le dossier obtenu sur un serveur web accessible depuis le portail. Esri demande que cet emplacement soit servi en HTTPS, accessible anonymement, avec le CORS autorisé pour le domaine du portail et le type MIME application/json associé aux fichiers .json.

2. Enregistrer le widget : dans le portail, onglet Mon contenu, cliquez sur Ajouter un élément puis Une application, choisissez le type Widget Experience Builder et indiquez l'URL du fichier manifest.json du widget hébergé à l'étape précédente.

Le widget Jakartowns Viewer apparaît ensuite dans le groupe Personnalisé des widgets d'Experience Builder.

La procédure détaillée, avec les prérequis complets du serveur web, est décrite dans la documentation Esri : Ajouter des widgets personnalisés.

3. Ajouter le widget à une expérience

1. Ouvrez votre expérience dans Experience Builder, sur une page contenant déjà un widget Carte.

2. Insérez le widget Jakartowns Viewer (il apparaît parmi les widgets personnalisés).

3. Dans les réglages du widget, section Carte liée, sélectionnez le widget Carte auquel le panorama doit être synchronisé.

4. Enregistrez et publiez votre expérience.

La section Panorama des réglages permet par ailleurs d'afficher ou non la boussole de Jakartowns dans le panneau.

Important : tant qu'aucune carte n'est sélectionnée, le widget affiche un message invitant à en choisir une dans ses réglages.

Utilisation

Se connecter

Le widget demande une clé d'API Jakarto au premier affichage. Récupérez la vôtre depuis votre profil sur la plateforme Jakarto, collez-la dans le champ Clé d'API Jakarto, puis cliquez sur Se connecter.

Le formulaire de connexion affiché tant qu'aucune clé d'API n'a été fournie

La clé est conservée dans votre navigateur : vous n'avez pas à la ressaisir à chaque visite. Le bouton Déconnexion de la barre de titre ferme la session et efface la clé enregistrée.

Important : la connexion est individuelle. Chaque personne consultant l'expérience utilise sa propre clé d'API, avec les accès associés à son compte Jakarto.

Localiser le panorama sur la carte

Tant qu'aucun endroit n'a été choisi, le panneau reste vide et rappelle la marche à suivre.

Le panneau avant qu'un premier endroit n'ait été pointé sur la carte

Deux façons de choisir l'endroit à visualiser :

• Mode « Cliquer sur la carte » : cliquez sur le bouton du même nom dans la barre de titre du panneau, puis cliquez sur la carte. Le mode se désarme automatiquement après ce clic, pour que les clics suivants restent disponibles pour vos autres outils.

• Clic droit sur la carte : disponible à tout moment, sans rien activer au préalable, mais désactivé par défaut. Activez-le via le bouton Réglages (icône d'engrenage) du panneau, option « Activer le clic droit sur la carte pour localiser le panorama ». Ce réglage est propre à chaque utilisateur et conservé dans son navigateur.

Dans les deux cas, le panorama se positionne sur la prise de vue disponible la plus proche du point cliqué — pas nécessairement exactement dessus — puis s'oriente vers ce point.

Suivre la vue sur la carte

Un indicateur placé sur la carte montre la position de la prise de vue et la direction du regard ; il se met à jour au fil de votre navigation dans le panorama.

L'indicateur de position et d'orientation, sur la carte liée

En revanche, la carte ne se recentre pas automatiquement quand vous vous déplacez dans le panorama : votre cadrage de carte reste celui que vous avez choisi.

Changer de date de prise de vue

Quand plusieurs passages existent au même endroit, une frise de dates s'affiche en bas du panorama. Cliquez sur une date pour afficher la prise de vue correspondante ; les flèches situées de part et d'autre font défiler la frise lorsque les dates sont nombreuses. L'orientation de votre vue est conservée d'une prise de vue à l'autre.

Ouvrir dans Jakartowns

Le bouton Ouvrir dans Jakartowns ↗ ouvre un nouvel onglet sur l'image exacte actuellement affichée. Il reste utile comme solution de repli si le panorama intégré ne parvenait pas à s'afficher.

Organiser le panneau

• Replier / Déplier : le chevron de la barre de titre réduit le panneau à sa seule barre de titre, pour dégager la carte sans perdre la session en cours.

• Déplacer : glissez la barre de titre. Le panneau reste contenu dans la zone du widget.

• Redimensionner : tirez sur un bord ou un coin du panneau.

Mettre à jour le plugin

Un portail ne se met pas à jour tout seul : le widget reste dans la version qui y a été déposée. Le plugin signale donc lui-même les nouvelles versions.

Ouvrez les réglages du widget dans Experience Builder : la section Version du widget indique la version installée et, si une version plus récente existe, son numéro et un lien vers sa page de publication.

Pour mettre à jour, téléchargez le fichier Jakartowns-v<version>-portal.zip de cette nouvelle version et remplacez les fichiers hébergés sur votre serveur web par ceux de l'archive, à la même adresse. L'élément enregistré dans le portail continue de pointer vers le même manifest.json : il n'y a rien à réenregistrer tant que l'URL ne change pas.

Quelques précisions utiles :

• La vérification n'a lieu que dans le constructeur d'expériences, jamais dans l'expérience publiée consultée par vos utilisateurs.

• Elle est anonyme et discrète : si le portail n'a pas accès à github.com, la mention « Mise à jour non vérifiable » s'affiche, sans erreur ni blocage.

Aller plus loin

Le dépôt GitHub du plugin reste la référence pour le code, les notes de version et les limitations connues : jakarto3d/experience-builder-jakarto-plugin.