Conseils & Astuces ArcGIS Online - N°173

Avant de voir une série d'exemples, une dernière chose importante concerne l'encodage des URL. L'encodage des URL a pour objectif de remplacer les caractères particuliers (autres que lettres et nombres) par le signe de pourcentage (%) suivi de leur équivalent hexadécimal (hexadécimal). Dans les navigateurs modernes, le codage d'URL est automatiquement ajouté au besoin lors de la saisie d'une URL dans la barre d'adresse du navigateur. Lors de l'utilisation d'applications intégrées (par iframe par exemple), un encodage sera généralement nécessaire.

Par exemple, ce qui suit est un exemple utilisant l'application instantanée "De Base" qui accepte le paramètre "find" pour localiser "La Plagne, France". Les espaces dans l'emplacement sont automatiquement remplacés par %20 (et la virgule par %2C) dans la barre d'adresse du navigateur :

https://www.arcgis.com/apps/instant/basic/index.html?appid=3ad44ff5f69047a29742cdd0c418a74a&find=La Plagne, France

https://www.arcgis.com/apps/instant/basic/index.html?appid=3ad44ff5f69047a29742cdd0c418a74a&find=La%20Plagne%2C%20France

L'encodage complet de l'URL est le suivant :

https%3A%2F%2Fwww.arcgis.com%2Fapps%2Finstant%2Fbasic%2Findex.html

%3Fappid%3D3ad44ff5f69047a29742cdd0c418a74a%26find=La%20Plagne%2C%20France

Pour plus d'informations et pour encoder vos chaînes, voir URLEncoder.io

Exemples de paramètres pouvant être utilisés avec les applications instantanées ArcGIS

Les exemples suivants utilisent l'application instantanée "De Base" (Basic). Le modèle "Media Map", par exemple, prendra en charge les mêmes paramètres. D'autres applications pourront différer. Il vous faudra expérimenter pour voir quels paramètres fonctionnent dans l'application que vous avez choisie.

1. Pour ouvrir l'application telle que configurée, l'application étant référencée par son ID (dans notre cas : a4f4cfe25b044274ae2b4f60d75bf480), l'URL sera donc la suivante :
   
   https://www.arcgis.com/apps/basic/index.html?appid=a4f4cfe25b044274ae2b4f60d75bf480
   
   
2. Pour en plus spécifier un affichage au niveau d'échelle 10, vous pourrez utiliser le paramètre
    &level=<LOD>.  L'URL sera donc la suivante :
   
   https://www.arcgis.com/apps/instant/basic/index.html?appid=a4f4cfe25b044274ae2b4f60d75bf480&level=10
   
   
3. Pour en plus centrer la carte sur un point particulier (et se mettre au niveau d'échelle 14), vous pourrez utiliser le paramètres &center=<x>,<y>.  L'URL sera donc la suivante :
   
   https://www.arcgis.com/apps/instant/basic/index.html?appid=a4f4cfe25b044274ae2b4f60d75bf480&level=10&center=1.331,47.585
   
   
4. A la place d'un centre et d'un niveau d'échelle, vous pourrez utiliser une étendue. Cette dernière sera spécifiée à l'aide du paramètre &extent qui utilise deux coordonnées <x>,<y> pour définir les coordonnées de l'enveloppe. L'URL sera donc la suivante :
   
   https://www.arcgis.com/apps/instant/basic/index.html?appid=a4f4cfe25b044274ae2b4f60d75bf480&extent=1.31,47.56,1.34,47.59
   
   
5. Vous pouvez également vous localiser sur la carte en spécifiant un nom de lieu. Par exemple ici, "Chateau de Blois"
   
   https://www.arcgis.com/apps/instant/basic/index.html?appid=a4f4cfe25b044274ae2b4f60d75bf480&find=Chateau%20de%20Blois
   
   
6. Vous pouvez également vous localiser sur une entité (si la recherche par couche a été configuré dans la carte) ou sur un lieu spécifique. Par exemple ici, "16 Rue Montesquieu, Blois"
   
   https://www.arcgis.com/apps/instant/basic/index.html?appid=a4f4cfe25b044274ae2b4f60d75bf480&find=16%20Rue%20Montesquieu,%20Blois
   
   
7. Vous pourrez également aller plus loin en ajoutant un marqueur et une fenêtre contextuelle. Pour cela, vous pouvez utiliser le paramètre &marker qui utilise les propriétés suivantes. Pour ignorer une propriété, utilisez des virgules doubles (,,). Les propriétés du marqueur doivent être dans cet ordre : &marker=<x>,<y>,<WKID>,<titre>,<URL symbole>,<texte>. L'utilisateur cliquera ensuite sur le marqueur pour afficher la fenêtre contextuelle.
   
   
   <coordonnée x>,<coordonnée y> pour définir l'emplacement du marqueur.
   <WKID> pour définir la référence spatiale du marqueur à ajouter à la carte. Si vous n'incluez pas de WKID, le système WGS84 seront utilisées.
   <titre> pour spécifier le titre de la fenêtre contextuelle. Si vous n'incluez pas de titre, la fenêtre contextuelle sera vide.
   <URL du symbole> pour décrire l'url (image) du symbole du point. Si vous n'incluez pas de symbole, un symbole de marqueur de cercle noir est utilisé.
   <texte>— Texte à inclure dans la fenêtre contextuelle.
   
   Par exemple ici sur l'école primaire Victor Hugo à Blois :
   
   
   https://www.arcgis.com/apps/instant/basic/index.html?appid=a4f4cfe25b044274ae2b4f60d75bf480&level=14&marker=1.3325,47.5891,,Ecole%20Primaire%20Victor%20Hugo%20,https://www.arcgis.com/sharing/rest/content/items/3ae86cbdf61b4d588f682f615d26e5f0/data,Ses%20effectifs%20sont%20de%20135%20%C3%A9coliers.%20L%27%C3%A9cole%20accueille%2012%20enfants%20en%20situation%20de%20handicap%20dans%20le%20cadre%20du%20dispositif%20d%27inclusion%20scolaire%20ULIS.