ArcGIS Instant Apps permet d’ajouter des paramètres d’URL dans l’URL de votre application lors du partage et de configurer un paramètre personnalisé. Vous pouvez utiliser les paramètres d’URL pour inclure des instructions lors de l’ouverture du lien de l’application. Par exemple, vous pouvez effectuer un zoom sur une application sur un emplacement ou un niveau d’échelle donné, effectuer un zoom sur une entité avec une fenêtre contextuelle, et bien plus encore.
Structure des paramètres
Les paramètres sont ajoutés à la fin de l’URL et sont mis en forme en tant que paire clé-valeur connectée avec un signe égal (=). Pour ajouter des paramètres, vous devez utiliser des esperluettes (&) pour les connecter à votre URL.
Les URL Instant Apps avec des paramètres utilisent la structure suivante :
https://<domain>/apps/instant/<Template>/index.html?<AppID>&<param1=value>&<param2=value>&<param3=value>&...Remarque :
Les symboles inférieur à et supérieur à (<>) sont utilisés dans cette rubrique comme des parenthèses. N’ajoutez pas ces symboles à votre URL.
<Template> est le modèle Instant Apps de votre application.
<AppID> est l’ID unique de l’application Web. Les modèles Instant Apps (tels que le modèle Basic [De base] utilisé ci-dessous) utilisent l’ID de l’application pour l’ouvrir comme un paramètre d’URL :
https://example.maps.arcgis.com/apps/instant/basic/index.html?appid=6c133f9d56d64723aee1da68e704c146Pour ajouter plusieurs paramètres, séparez-les par des esperluettes (&) :
https://example.maps.arcgis.com/apps/instant/basic/index.html?appid=6c133f9d56d64723aee1da68e704c146&locale=en¢er=-157.7118,20.7413&level=7Dans cet exemple, les paramètres locale, center et level ont tous été ajoutés.
Paramètres généraux
Les sous-sections ci-après décrivent les paramètres qui peuvent être disponibles dans votre application.
Remarque :
Tous les modèles Instant Apps ne prennent pas en charge les paramètres suivants. Assurez-vous de tester votre application pour vérifier que le paramètre est pris en charge.
Spécifier une localisation
Définissez une localisation sur laquelle votre application sera centrée lors de l’ouverture de l’URL. Définissez le centre à l’aide des coordonnées géographiques (x,y) avec center=<x>,<y>.
En voici un exemple :
https://example.maps.arcgis.com/apps/instant/basic/index.html?appid=6c133f9d56d64723aee1da68e704c146¢er=-157.7118,20.7413L’application s’ouvre sur les coordonnées (-157.7118, 20.7413).
Spécifier un niveau d’échelle
Définissez un niveau d’échelle spécifique à l’aide du paramètre level. Ajoutez level=<zoom level value>.
En voici un exemple :
https://example.maps.arcgis.com/apps/instant/basic/index.html?appid=6c133f9d56d64723aee1da68e704c146&level=2L’application s’ouvre avec un niveau de zoom inférieur au niveau de zoom par défaut de l’application.
Spécifier une étendue
Utilisez deux coordonnées géographiques (x,y) pour définir l’étendue de la carte. Utilisez extent=<MinX>,<MinY>,<MaxX>,<MaxY>. Les premières coordonnées (MinX,MinY) doivent définir l’angle sud-ouest de l’étendue de carte souhaitée. Les deuxièmes coordonnées (MaxX,MaxY) doivent définir l’angle nord-est de l’étendue de carte souhaitée.
En voici un exemple :
https://example.maps.arcgis.com/apps/instant/basic/index.html?appid=6c133f9d56d64723aee1da68e704c146&extent=-73.28,42.08,-68.46,42.04L’application s’ouvre sur l’étendue de carte souhaitée.
Rechercher la localisation d’une entité
Recherchez une localisation ou une entité à l’ouverture de l’application à l’aide du paramètre find. La carte effectue un zoom sur le résultat le plus proche et un symbole ponctuel de rappel apparaît. Utilisez find=<search string>.
En voici un exemple :
https://example.maps.arcgis.com/apps/instant/basic/index.html?appid=6c133f9d56d64723aee1da68e704c146&find=michiganL’application zoome sur l’État américain du Michigan, car il s’agit du meilleur résultat de recherche renvoyé.
Ajouter un symbole ponctuel avec une fenêtre contextuelle
À l’ouverture de l’URL, effectuez un zoom sur un symbole ponctuel avec une fenêtre contextuelle personnalisée à l’aide du paramètre marker. Le paramètre utilise les propriétés suivantes. Pour ignorer une propriété, utilisez des virgules doubles (,,).
Remarque :
L’ensemble du paramètre doit être encodé. L’encodage de l’URL remplace les caractères par le signe de pourcentage (%) suivi de leur équivalent hexadécimal (hex). Pour plus d’informations, et pour encoder vos chaînes, reportez-vous à URLEncoder.io.
Les propriétés du symbole ponctuel doivent être structurées dans l’ordre suivant :
marker=<x>,<y>,<WKID>,<title>,<symbol URL>,<label>- <x>,<y> : coordonnées géographiques du symbole ponctuel.
- <WKID> : références spatiales des coordonnées à ajouter à la carte. Si vous n’incluez pas de WKID, les coordonnées GCS sont utilisées.
- <title> : titre de la fenêtre contextuelle. Si vous n’incluez pas de titre, la fenêtre contextuelle sera vide.
- <symbol URL> : symbole du point. Si vous n’incluez pas de symbole, un symbole ponctuel de cercle noir est utilisé.
- <label> : texte à inclure dans la description de la fenêtre contextuelle.
Le paramètre effectue un zoom sur le symbole ponctuel. Cliquez sur le symbole ponctuel pour ouvrir la fenêtre contextuelle.
En voici un exemple :
https://example.maps.arcgis.com/apps/instant/basic/index.html?appid=6c133f9d56d64723aee1da68e704c146&marker=-166.50,24.77,,Papah%C4%81naumoku%C4%81kea%20Marine%20National%20Monument,,One%20of%20the%20world%27s%20largest%20protected%20areas.%20This%20monument%20is%20home%20to%20native%20cultural%20significance%20and%20protects%20critical%20endemic%20species.L’URL crée un symbole ponctuel et une fenêtre contextuelle aux coordonnées désignées. La fenêtre contextuelle est intitulée Papahānaumokuākea Marine National Monument.
Modifier la langue de l’application
Configurez votre URL afin que l’application s’ouvre dans une langue spécifique. Utilisez le paramètre locale et un code de langue ISO 639-1 de deux lettres. Instant Apps prend en charge les mêmes langues que celles prises en charge par ArcGIS Online. Ajoutez locale=<language code>.
En voici un exemple :
https://example.maps.arcgis.com/apps/instant/basic/index.html?appid=6c133f9d56d64723aee1da68e704c146&locale=viL’interface utilisateur de l’application est désormais configuée pour s’ouvrir en vietnamien.
Générer des paramètres avec la fonction de partage
Vous pouvez créer une URL vers votre application avec les paramètres générés grâce à la fonction Share (Partager). L’URL que vous générez peut conserver la vue de carte actuelle et ouvrir des fenêtres contextuelles.
Remarque :
Certains modèles ne prennent pas en charge l’outil Share (Partager). reportez-vous aumatrice des outils d’application (PDF)pour voir quels modèles prennent en charge l’outil Share (Partager).
Les paramètres suivants peuvent être générés automatiquement avec la fonction Share (Partager) :
- locale=<language code>
- center=<x>,<y>
- level=<LOD>
- selectedFeature=<feature>
Le paramètre selectedFeature ouvre la fenêtre contextuelle d’une entité.
Pour utiliser la fonction Share (Partager) pour créer une URL avec les paramètres générés, procédez comme suit :
- Dans le volet latéral, désactivez le mode Express, puis, lorsque l’invite de confirmation apparaît, cliquez sur Continue (Continuer).
- Dans le volet latéral, cliquez sur Interactivity (Interactivité) pour ouvrir la fenêtre.
- Cliquez sur Share (Partager) pour ouvrir le menu Share (Partager).
- Activez l’option Sharing (Partage). Cela active l’outil Share (Partager) dans votre application.
- Dans la carte Web, configurez la vue de carte que vous voulez que l’URL ouvre.
Vous pouvez également sélectionner une entité si vous voulez que l’URL ouvre une entité sélectionnée et sa fenêtre contextuelle.
- Cliquez sur l’outil Share (Partager).
- Cliquez sur Copy Link (Copier le lien) pour copier l’URL de votre application vers le Presse-papiers.
Cette URL inclut les paramètres ajoutés qui ouvrent votre application sur la vue et la fenêtre contextuelle de l’entité sélectionnée (si vous l’avez configurée). De plus, cette URL est toujours encodée.
Créer un paramètre d’URL personnalisé
Vous pouvez créer un paramètre d’URL personnalisé dans votre application Instant Apps pour zoomer sur une entité et afficher la fenêtre contextuelle à l’ouverture de l’application. Les paramètres d’URL personnalisés peuvent être associés à d’autres paramètres d’URL et sont pris en charge dans 3D Viewer (Visionneuse 3D), Basic (Basique), Interactive Legend (Légende interactive), Reporter (Journaliste) et Sidebar (Barre latérale). Basic (Basique) et Sidebar (Barre latérale) prennent également en charge les paramètres d’URL personnalisés qui s’appliquent à plusieurs couches.
Pour créer un paramètre d’URL personnalisé, procédez comme suit :
- Dans le volet latéral, désactivez le mode Express, puis, lorsque l’invite de confirmation apparaît, cliquez sur Continue (Continuer).
- Cliquez sur Search settings (Paramètres de recherche) et recherchez URL parameter name.
Les paramètres URL parameter (Paramètre d’URL) apparaissent.
- Dans la section URL parameter name (Nom du paramètre d’URL), saisissez le nom de votre paramètre personnalisé.
Il s’agira du paramètre personnalisé à ajouter à l’URL de votre application.
- Dans URL parameter search layer (Couche de recherche du paramètre d’URL), sélectionnez la couche d’entités dans l’application dans laquelle vous voulez que votre paramètre personnalisé effectue une recherche.
- En regard de la couche d’entités que vous avez sélectionnée, cliquez sur Field (Champ) pour ouvrir le menu déroulant des champs.
Sélectionnez le champ dans votre couche de recherche dans lequel vous voulez que votre paramètre personnalisé effectue une recherche.
- Cliquez sur Done (Terminé).
- Cliquez sur Publish (Publier) pour déployer vos configurations de paramètres personnalisés.
Votre paramètre d’URL personnalisé a été configuré. Vous pouvez ajouter le paramètre personnalisé avec la valeur d’identification de votre entité à l’URL de l’application en utilisant la structure de <assigned name>=<field value>. Cela appliquera un zoom et affichera la fenêtre contextuelle d’une entité donnée à l’ouverture de l’application.
Par exemple, si le nom du paramètre personnalisé était « site » et qu’il doit rechercher des noms de sites, ajoutez site=<site name> à la fin de l’URL de votre application Web pour qu’elle effectue un zoom sur cette entité spécifiée. Dans cet exemple d’application des zones marines protégées de la NOAA, le paramètre suivant effectue un zoom sur le site du sanctuaire marin national de la baie de Monterey et ouvre la fenêtre contextuelle de l’entité : site=Monterey Bay National Marine Sanctuary.
L’URL suivante illustre cette situation :
https://example.maps.arcgis.com/apps/instant/basic/index.html?appid=6c133f9d56d64723aee1da68e704c146&site=Monterey%20Bay%20National%20Marine%20SanctuaryVous avez un commentaire à formuler concernant cette rubrique ?