Le blog francophone consacré
aux technologies Esri

Conseils & Astuces ArcGIS Online - N°173

N° 173 - Utiliser des paramètres d'URL standards dans vos Instant Apps


ArcGIS Instant Apps offre une expérience simplifiée qui vous permet de créer des applications rapidement et facilement à l'aide des modes de configuration "Express" ou "Complet". Tous les modèles d'applications instantanées se trouvent sur la page d'accueil d'ArcGIS Instant Apps.

Les paramètres d'URL peuvent être utilisés pour transmettre des informations ou des instructions supplémentaires à de ces apps ArcGIS. Par exemple, à l'ouverture de l'application, vous pouvez effectuer un cadrage vers un emplacement spécifique de la carte, effectuer un zoom avant ou arrière sur un niveau d'échelle spécifique, rechercher un emplacement, etc.

Dans une application web, les paramètres d'URL correspondent à ce que vous ajoutez derrière le point d'interrogation (?) de l'URL. Les paramètres sont constitués d'une paire clé-valeur reliée par un signe égal (=). Par exemple, pour l'application "Map Viewer", l'ID de la carte Web à ouvrir est ajouté en tant que paramètre d'URL.

https://www.arcgis.com/apps/mapviewer/index.html?webmap=d5dbd717294c43708dab23a6c4db9694

De même, les applications instantanées (comme Media Map illustrée ci-dessous) récupèrent l'ID de l'application à ouvrir via le paramètre d'URL.

https://www.arcgis.com/apps/instant/media/index.html?appid=e182d5982ab44ff9b9164e957c2a6336

Pour inclure plusieurs paramètres, il suffira d'utiliser le caractère "&", nous verrons des exemples un peu plus loin.

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.

     
Dans un prochain article, je poursuivrai sur l'ajout de paramètres d'URL dans les applications instantanées en expliquant comment utiliser vos propres paramètres personnalisés.


Bonne route sur ArcGIS Online !
   
Pour retrouver l'ensemble des Conseils & Astuces ArcGIS Online, cliquez sur ce lien

Partager cet article:

Rejoindre la discussion

    Les commentaires à propos de cet article: