Widget cartographique

Le widget Map (Carte) permet d’afficher des informations géographiques en 2D ou 3D. Vous pouvez activer des outils dans la carte, tels que Zoom (Zoom), Locate (Localiser), Search (Rechercher) et Measure (Mesurer).

Exemples

Utilisez ce widget pour prendre en charge les exigences de conception d’application, telles que les suivantes :

• Vous devez afficher la comparaison d’une carte en 2D et 3D. Vous pouvez ajouter deux widgets Map (Carte) et créer un déclencheur et une action pour synchroniser les vues lors d’une interaction avec l’une ou l’autre de ces cartes.
• Vous souhaitez cliquer sur une entité de la carte et afficher l’enregistrement dans un widget Feature Info (Informations sur les entités).
• Vous devez filtrer un widget List (Liste) en fonction de la sélection à l’aide de la souris d’une entité sur la carte.

Remarques sur l’utilisation

Vous pouvez afficher une seule carte ou inclure l’option permettant de basculer entre deux cartes. Vous pouvez inclure plusieurs cartes dans une application en ajoutant plusieurs widgets Map (Carte).

Le widget Map (Carte) requiert une source de données, avec notamment des cartes Web et des scènes Web. Lorsque vous incluez des outils, ils sont automatiquement positionnés sur la carte en fonction de la taille du widget, aussi bien en mode conception que dans l’application finale.

Conseil :

Dans le cas d’une carte Web ou d’une scène Web comportant plusieurs couches, si vous souhaitez désigner les couches qui s’affichent par défaut dans différents widgets Map (Carte), vous pouvez ajouter la même carte Web ou la même scène Web plusieurs fois sur l’onglet Data (Données), choisir de masquer certaines sous-couches sur chaque copie de carte ou de scène et connecter chaque copie à un autre widget Map (Carte).

En savoir plus sur la configuration de la visibilité des couches à partir d’une carte et sur son utilisation avec d’autres widgets Carte.

Paramètres

Le widget Map (Carte) inclut les paramètres suivants :

• Select map (Sélectionner une carte) : ajoutez une source de données aux cartes Web et scènes Web.
• Initial view (Vue initiale) : il s’agit de la position initiale de la carte au moment de son chargement dans le widget.
  • Default (Par défaut) : utilisez la position de la carte héritée de la page Web ou de la scène Web.
  • Custom (Personnaliser) : modifiez la vue initiale en définissant une position personnalisée pour la carte.
• Tools (Outils) : incluez des outils pour que les utilisateurs finaux interagissent avec la carte.
  • Zoom (Zoom)  : effectuez un zoom avant et arrière sur la carte.
  • Home (Accueil) : effectuez un zoom sur la carte jusqu’à la position initiale de la carte (étendue).
  • Navigation : intégrez les outils de déplacement et de rotation des cartes. Ces outils apparaissent lorsque le widget Map (Carte) affiche une scène Web 3D.
  • Locate (Localiser) : indiquez la localisation actuelle de l’utilisateur.
  • Compass (Boussole) : indiquez si le nord est affiché en fonction de la vue actuelle d’une carte 2D ou 3D.
  • Search (Rechercher) : recherchez des localisations en fonction d’un service de géocodage de votre organisation ou de votre portail. Si vous activez des fenêtres contextuelles, ces dernières s’affichent pour les résultats de recherche.
  • Layers (Couches) : affichez une liste des couches et des symboles de la carte et offrez aux utilisateurs la possibilité de les activer ou les désactiver.
  • Basemap (Fonds de carte) : affichez une bibliothèque de fonds de carte.
  • Measure (Mesurer) : incluez des outils de mesure pour mesurer les surfaces et les distances. L’outil de mesure utilise la capture, c’est-à-dire que le pointeur effectue une capture sur les entités dans la carte. Lors d’une mesure, les utilisateurs peuvent maintenir la touche Ctrl enfoncée afin de désactiver temporairement la capture.
  • Fullscreen (Plein écran) : affichez la carte sur tout l’écran.
  • Scale bar (Barre d’échelle) : incluez sur la carte une barre d’échelle qui affiche les unités en valeurs métriques ou non métriques et qui répond dynamiquement à divers systèmes de coordonnées.
  • Select (Sélection) : sélectionnez des entités sur une carte à l’aide de plusieurs outils de sélection et modes de sélection. Les utilisateurs ont accès aux outils de sélection suivants et peuvent sélectionner des entités qui sont entièrement contenues par des polygones dessinés ou qui se trouvent partiellement ou complètement au sein de polygones dessinés.
    • Rectangle – Cliquez et faites glisser pour dessiner un rectangle sur des entités.
    • Lasso – Cliquez sur la carte pour créer les sommets d’un polygone ou dessinez à l’aide du pointeur pour créer une forme à main levée. Double-cliquez pour fermer le polygone et sélectionnez les entités contenues.
    • Circle (Cercle) – Cliquez et faites glisser pour dessiner un cercle sur des entités.
    • Line (Ligne) – Cliquez sur la carte pour créer les sommets d’une ligne. Double-cliquez pour terminer la ligne et sélectionnez les entités d’intersection.
    • Point – Cliquez sur la carte pour placer un point et sélectionnez les entités d’intersection.

    Les utilisateurs peuvent sélectionner plusieurs entités de l’une des manières suivantes :

    • Créez une sélection d’entités en dessinant avec le nouvel outil de sélection. Il s’agit de l’option par défaut.
    • Ajoutez à l’ensemble de sélection actuel (appuyez sur Maj tout en dessinant).
    • Supprimez des entités de l’ensemble de sélection actuel (appuyez sur Ctrl tout en dessinant sous Windows ; appuyez sur Cmd tout en dessinant sur Mac).
    • Sélectionnez des entités à partir de l’ensemble de sélection actuel (appuyez sur Ctrl+Maj tout en dessinant sous Windows ; appuyez sur Cmd+Maj tout en dessinant sur Mac).

    Lorsque l’utilisateur procède à une sélection, l’icône de l’outil de sélection devient une icône de progression. Si l’utilisateur sélectionne un nombre important d’entités, le traitement de la sélection peut prendre du temps. Les utilisateurs peuvent cliquer sur le bouton de progression pour arrêter le traitement de la sélection.

  • Extent navigate (Naviguer dans les étendues) – Revenez en arrière et avancez dans les étendues que l’utilisateur a visitées lors de l’exécution.
  • Overview map (Carte globale) : ajoutez une carte en encart développable. La carte globale est une version plus petite de la carte principale, avec un rectangle de localisation qui décrit l’étendue de la carte principale. Si vous cliquez sur le rectangle de localisation et le faites glisser, la carte principale zoome sur cette nouvelle localisation. Cet outil n’apparaît pas sur les mises en page pour petit écran.
• Tools layout (Mise en page des outils) : sélectionnez une mise en page pour les outils cartographiques sur les appareils moyen écran et grand écran.

  Remarque :

  Le widget Map (Carte) masque automatiquement les outils selon la hauteur du widget pour que ce dernier s’adapte instantanément aux appareils moyen écran et petit écran. Par exemple, si la hauteur d’un widget Map (Carte) est inférieure à 465 pixels, les outils Mesurer et Localiser sont masqués sur les petits écrans et les moyens écrans même s’ils sont activés dans les paramètres du widget. Plus la hauteur du widget diminue, plus le nombre d’outils masqués est élevé. Les outils Plein écran, Rechercher, Zoom, Barre d’échelle et Boussole sont les derniers à disparaître.

• Options
  • Feature selection colors (Couleurs de sélection d’entités) : modifiez la couleur de mise en surbrillance et la transparence des entités sélectionnées sur la carte. Vous pouvez personnaliser le remplissage et le contour de mise en surbrillance.
  • Enable scroll zooming (Activer le zoom avec défilement) : activez le zoom à l’aide de la molette de la souris et, sur les écrans tactiles, les déplacements à un doigt sur la carte.
  • Enable pop-up (Activer les fenêtres contextuelles) - Activez les fenêtres contextuelles sur la carte. Si votre application inclut un widget Feature Info (Informations sur les entités), vous pouvez désactiver ce paramètre. Si une source de données comporte des données associées et que vous configurez des enregistrements associés dans des fenêtres contextuelles dans Map Viewer, vous pouvez afficher les enregistrements associés dans les fenêtres contextuelles dans Experience Builder.
    • Show pop-up upon feature selection (Afficher la fenêtre contextuelle lors de la sélection d’une entité) : affichez des fenêtres contextuelles sur la carte lorsque l’utilisateur sélectionne des entités cartographiques dans un autre widget, tel qu’une table ou une liste.
    • Dock the pop-up (Ancrer la fenêtre contextuelle) : ancrez les fenêtres contextuelles par défaut. Vous pouvez configurer les fenêtres contextuelles afin qu’elles s’affichent à l’un des six points d’ancrage dans la fenêtre du widget Map (Carte). Au moment de l’exécution, les utilisateurs peuvent toujours cliquer sur Dock (Ancrer) et Undock (Détacher) dans la fenêtre contextuelle afin de modifier son lieu d’apparition.
  • Scene quality mode (Mode de qualité de scène) (pour les scènes Web) : contrôlez la qualité de la scène Web en équilibrant l’effet visuel et l’efficacité de chargement.
    • Low (Faible) : améliorez la performance, la stabilité et la vitesse en réduisant la charge des données.
    • Medium (Moyen) : optimisez les performances et la qualité de façon équitable.
    • High (Élevée) : améliorez la qualité des options de visualisation (comme la réflexion par l'eau).
• Enable client-side query (Activer la requête côté client) : activez ces boutons bascule pour que les widgets dans l’application utilisent les requêtes côté client et exploiter les données de vos cartes Web. Si vous connectez une même carte web à plusieurs widgets Map (Carte), il vous suffit d’activer les requêtes côté client une seule fois pour une carte web.

  Remarque :

  Les scènes web ne prennent pas en charge les requêtes côté client.

  Les avantages des requêtes côté client sont une diminution de la demande sur le serveur et une amélioration des performances de l’application. Les requêtes côté client réduisent significativement le nombre de requêtes réseau sur un serveur. De plus, les requêtes côté client sont plus rapides que les requêtes côté serveur. Les tâches liées aux données, comme la sélection d’une entité pour mettre à jour un diagramme, s’effectuent plus rapidement.

  L’inconvénient des requêtes côté client est que le chargement des entités cartographiques est plus long lorsque vous modifiez l’étendue de la carte.

  Remarque :

  Une configuration de l’application Experience Builder courante qui peut être exigeante envers les serveurs est un widget List (Liste) qui se met à jour en fonction de l’étendue de carte actuelle.

  Pour éviter de surcharger les serveurs, il est recommandé d’activer les requêtes côté client si vous configurez un widget Map (Carte) avec le déclencheur Extent changes (Modifications d’étendue) et l’action Message Filter data records (Filtrer les enregistrements de données). Cette activation est particulièrement importante si un grand nombre d’utilisateurs est supposé accéder à une application simultanément.

  Remarque :

  Pour les limitations connues des requêtes côté client, voir la documentation ArcGIS Maps SDK for JavaScript.

Options d’interaction

Le widget Map (Carte) prend également en charge la définition de déclencheurs dans l’onglet Action des paramètres du widget. Vous pouvez synchroniser deux widgets Map (Carte) en ajoutant un déclencheur Extent changes (Modifications d’étendue) aux deux cartes, en sélectionnant l’autre carte comme cible pour chaque carte, et en choisissant les actions Pan to (Déplacer sur) et Zoom to (Zoom sur). Pour les cartes Web, la synchronisation Zoom to (Zoom sur) inclut le comportement de rotation de la carte. Pour les scènes Web, elle inclut les comportements de rotation et d’inclinaison.

Remarque :

Si un widget Map (Carte) est configuré avec à la fois l’action Zoom to (Zoom sur) et l’action Pan to (Déplacer sur), l’action Zoom to (Zoom sur) est prioritaire sur l’action Pan to (Déplacer sur). En d’autres termes, si l’utilisateur se déplace et zoome sur la carte en même temps, l’action Pan to (Déplacer sur) est ignorée.

Vous pouvez définir des déclencheurs et des actions Messages pour qu’une carte interagisse avec d’autres widgets. Par exemple, vous pouvez ajouter un déclencheur d’actions de sorte qu’un widget List (Liste) n’affiche que les entités qui sont visibles sur la carte. Le widget Map (Carte) prend également en charge les actions Données qui apparaissent dans des fenêtres contextuelles et autorisent les utilisateurs à exporter des données, afficher les enregistrements dans une table, et plus encore. L’onglet Action des paramètres du widget permet de définir et de gérer les déclencheurs, les actions Messages et les actions Données. Pour en savoir plus sur les actions prises en charge du widget Map (Carte), reportez-vous à la rubrique Ajouter des actions à des widgets.

Paramètres URL

Les sous-sections ci-après décrivent les paramètres d’URL liés à la carte. Vous pouvez utiliser les paramètres sous Manage URL status (Gérer le statut de l’URL) pour faire en sorte que ces paramètres apparaissent dans l’URL lorsque l’utilisateur interagit avec le widget Map (Carte). Tous les paramètres du widget Map (Carte) suivent les croisillons (#). Pour ajouter plusieurs paramètres, vous devez les séparer par des esperluettes (&).

Remarque :

Les paramètres center, scale et rotation du widget Map (Carte) fonctionnent uniquement avec des cartes Web, pas avec des scènes Web.

Définir la carte ou la scène Web lors du chargement initial d’un widget Map (Carte)

Si votre widget Map (Carte) contient plusieurs cartes ou scènes Web, vous pouvez définir laquelle activer lors du chargement de l’application à l’aide du paramètre active_datasource_id suivi de l’ID de source de données de l’élément souhaité. Voici quelques exemples :

https://experience.arcgis.com/experience/<AppId>#<mapWidgetID>=active_datasource_id:<dataSourceId>

https://experience.arcgis.com/experience/<AppId>#map_1=active_datasource_id:dataSource_4

Centrer une carte

Pour centrer une carte sur un emplacement en particulier, utilisez le paramètre center suivi des coordonnées souhaitées et de l’identifiant connu du système de coordonnées souhaité (WKID). Voici quelques exemples :

https://experience.arcgis.com/experience/<AppId>#<mapWidgetID>=center:<x,y,wkid>

https://experience.arcgis.com/experience/<AppId>#map_1=center:-10373125.398783844%2C4598516.55871741%2C102100

Définir l’échelle de la carte

Pour définir l’échelle de la carte, utilisez le paramètre scale suivi d’une valeur d’échelle. Voici quelques exemples :

https://experience.arcgis.com/experience/<AppId>#<mapWidgetID>=scale:<scaleValue>

https://experience.arcgis.com/experience/<AppId>#map_1=scale:19257701.0800833

Définir la rotation de la carte

Pour définir la rotation de la carte, utilisez le paramètre rotation suivi d’un nombre de degrés. Voici quelques exemples :

https://experience.arcgis.com/experience/<AppId>#<mapWidgetID>=rotation:<rotationValue>

https://experience.arcgis.com/experience/<AppId>#map_1=rotation:45

Définir le point de vue de la carte

Pour définir le point de vue, qui est la localisation ou la position de la caméra à partir d’où afficher la carte ou la scène, utilisez viewpoint. Si votre widget Map (Carte) contient plusieurs cartes ou scènes, le paramètre viewpoint les affecte tous.

Les points de vue et leurs propriétés sont généralement écrits au format JSON, comme dans l’exemple suivant :

 {
  "rotation": 0,
  "scale": 19966005.903731048,
  "targetGeometry": {
    "spatialReference": {
      "latestWkid": 3857,
      "wkid": 102100
    },
    "x": -9870655.016044471,
    "y": 4724533.527708739
  }
}

Pour définir un point de vue spécifique à l’aide de l’URL, vous devez encoder toutes ces propriétés, généralement écrites au format JSON, dans l’URL. En voici un exemple :

https://experience.arcgis.com/experience/<AppId>#map_1=viewpoint:%7B"rotation"%3A0%2C"scale"%3A24387741.012671936%2C"targetGeometry"%3A%7B"spatialReference"%3A%7B"latestWkid"%3A3857%2C"wkid"%3A102100%7D%2C"x"%3A-10078461.002935613%2C"y"%3A4523117.553838721%7D%7D

Remarque :

Les paramètres center, scale et rotation ont des priorités plus élevées que le paramètre viewpoint et le remplacent si vous utilisez plusieurs paramètres liés à une carte Web.

Remarque :

Les modifications d’étendue de la carte qui ont été générées par des actions Messages ont une priorité plus élevée que celles générées par des paramètres d’URL. Par exemple, si vous tentez d’ouvrir un widget Map (Carte) sur des étendues prédéfinies en utilisant les paramètres d’URL ci-dessus, mais que le widget Map (Carte) est également configuré en tant que cible du déclencheur Record selection changes (Modifications de sélection d’enregistrements) et des actions Messages Pan to (Déplacer sur) ou Zoom to (Zoom sur), les étendues associées aux actions Messages remplacent les étendues que vous avez définies avec les paramètres d’URL.

Définir la visibilité des couches de carte

Pour définir la visibilité des couches d’une carte, utilisez le paramètre layer_visibility.

La visibilité d’une couche est généralement écrite au format JSON, comme dans l’exemple suivant :

 {
  "widget_1-dataSource_1": {
    "widget_1-dataSource_1-187938b7328-layer-2": false
  },
  "widget_1-dataSource_4": {
    "widget_1-dataSource_4-18a690b433a-layer-4": false
  }
}

Pour que les couches de votre carte soient visibles ou masquées à l’aide de l’URL, vous devez encoder toutes les informations dans l’URL après le paramètre layer_visibility. En voici un exemple :

https://experience.arcgis.com/experience/<AppId>#map_1=layer_visibility:%7B%22widget_1-dataSource_1%22%3A%7B%22widget_1-dataSource_1-187938b7328-layer-2%22%3Afalse%7D%2C%22widget_1-dataSource_4%22%3A%7B%22widget_1-dataSource_4-18a690b433a-layer-4%22%3Afalse%7D%7D

Zoom sur une entité sélectionnée

Le paramètre data_s apparaît dans l’URL de l’application lorsque vous sélectionnez une entité. Vous pouvez actuellement utiliser le paramètre zoom_to_selection=true pour effectuer un zoom sur une entité sélectionnée sur la carte par ObjectID. Voici quelques exemples :

https://experience.arcgis.com/experience/<AppId>/#data_s=id:<data source ID>:<OBJECTID>&zoom_to_selection=true

https://experience.arcgis.com/experience/<AppId>/#data_s=id%3AdataSource_1-csv_905%3A77&zoom_to_selection=true