Géocodage et recherche géographique

Les localisateurs vous permettent de trouver des adresses et des lieux que vous pouvez visualiser sur une carte, insérer comme arrêts pour un itinéraire et charger comme entrée pour l’analyse spatiale. Les localisateurs ArcGIS Online intègrent la recherche géographique et le géocodage comme suit :

  • Recherche géographique (également connue comme recherche d’emplacement) : localise une adresse ou un point d’intérêt et fait zoomer la carte vers cet emplacement. Le résultat peut être affiché sur la carte, mais il n’est en aucun cas stocké en vue d’une utilisation ultérieure. La recherche géographique est disponible pour quiconque accède à Map Viewer, Map Viewer Classic ou une application publique qui comprend une recherche d’emplacement sur une carte. Elle ne nécessite pas de compte d’organisation ou n’utilise aucun crédit (vous êtes cependant limité à 1 million de recherches géographiques par mois).
  • Géocodage : convertissez un adresse ou un lieu en une coordonnée x et y et ajoutez le résultat à un enregistrement existant dans une base de données. Une opération de cartographie n’est pas toujours nécessaire, mais, dans le cadre d’un workflow, vous devrez peut-être placer les résultats sur une carte. Le géocodage par lots et le géocodage inverse tombent dans cette catégorie. Un compte organisationnel avec le privilège de géocodage de contenu Premium est nécessaire pour accéder à ArcGIS World Geocoding Service et à et n’importe laquelle de ses vues pour le géocodage par lots.

    Remarque :

    Certaines propriétés d’affichage de localisateur ne sont pas prises en charge dans le géocodage inverse.

Par défaut, ArcGIS Online utilise ArcGIS World Geocoding Service pour trouver les adresses, les villes, les repères, les noms d’entreprise et les codes postaux dans plus de 100 pays dans le monde. En outre, ArcGIS World Geocoding Service est utilisé pour trouver l’emplacement de coordonnées x, y à l’aide de la longitude et de la latitude, ainsi que les systèmes de référence de coordonnées tels que MGRS (Military Grid Reference System) et USNG (United States National Grid).

Si votre organisation souhaite optimiser les résultats de recherche pour les adresses et les sites d’intérêt, les membres disposant des privilèges permettant de créer du contenu peuvent concevoir une nouvelle vue de ArcGIS World Geocoding Service afin de rechercher uniquement des types d’emplacement spécifiques dans une zone d’intérêt. Par exemple, vous pouvez créer une vue de localisateur pour limiter les résultats de recherche à un pays ou une région spécifique ou pour ne retourner que les résultats correspondant à une catégorie spécifique telle que des adresses ou des aéroports. Une fois que vous créez une vue de localisateur, les membres avec un rôle d’administrateur par défaut peuvent configurer l’organisation afin qu’elle puisse utiliser la vue de votre localisateur lorsque les membres effectuent des recherches géographiques.

Remarque :

L’utilisation de ArcGIS World Geocoding Service ou de vues de ce localisateur pour le géocodage par lots (y compris la publication de fichiers CSV ou Microsoft Excel en tant que couches d’entités hébergées) consomme des crédits. L’utilisation de localisateurs pour la recherche géographique ne consomme pas de crédits.

Un compte organisationnel avec le privilège de géocodage de contenu Premium est nécessaire pour utiliser les vues du localisateur pour le géocodage par lots.

En outre, si votre organisation doit géocoder les adresses ou les lieux selon ses propres données, les administrateurs peuvent configurer votre organisation pour utiliser ses propres localisateurs en cours d’exécution sur un site ArcGIS Server, pour la recherche géographique, le géocodage ou les deux. Par exemple, une compagnie pétrolière peut ajouter des localisateurs pour rechercher ses puits de pétrole ou une ville peut ajouter un localisateur pour trouver ses bornes incendie.

Si vous ajoutez des localisateurs ou des vues de localisateurs supplémentaires, les membres voient une flèche dans la zone de recherche géographique et peuvent choisir le localisateur ou la vue à utiliser.

Types d’emplacement et catégories

Cette section décrit les types, les catégories et les sous-catégories d’emplacement lorsque vous configurez la vue de localisateur.

Addresses, Postal Codes and Populated Places (Adresses, codes postaux et lieux peuplés)

Lorsque vous choisissez Addresses, Postal Codes and Populated Places (Adresses, codes postaux et lieux peuplés) comme types d’emplacement à rechercher, vous pouvez affiner davantage les résultats de recherche de la vue du localisateur en sélectionnant les catégories et sous-catégories qui vous intéressent. Les catégories suivantes pour Addresses, Postal Codes and Populated Places (Adresses, codes postaux et lieux peuplés) sont disponibles :

  • Address (Adresse) - Lorsque vous sélectionnez cette catégorie, toutes les sous-catégories d’adresses sont automatiquement répertoriées dans la table ci-dessous. Cette catégorie limite les résultats de recherche aux lieux qui peuvent être classés comme adresses lors du filtrage des résultats pour les lieux d’intérêt, les codes postaux, les pays ou les états. Pour augmenter la précision des résultats de recherche, sélectionnez une combinaison de sous-catégories d’adresses répondant à vos critères de recherche.
  • Postal (Postal) - Lorsque vous sélectionnez cette catégorie, les résultats de recherche intègrent tous les types de code postal, y compris les codes postaux à cinq chiffres et les formats plus longs. Pour appliquer ce degré de précision minimal aux résultats de recherche, sélectionnez à la fois la catégorie Postal (Postal) et la catégorie de niveau supérieur Address (Adresse).
  • Populated Place (Lieu peuplé) - Lorsque vous sélectionnez cette catégorie, toutes les sous-catégories de lieux peuplés sont automatiquement répertoriées dans la table ci-dessous. Cette catégorie limite les résultats de recherche aux divisions administratives (ou frontières), telles que les villes, les provinces ou les pays, tout en éliminant les résultats portant sur les adresses, les lieux d’intérêt et les codes postaux. Pour augmenter la précision des résultats de recherche, sélectionnez une combinaison de sous-catégories de lieux peuplés répondant à vos critères de recherche.

CatégorieSous-catégorieDescription

Adresse

Adresse du point

L’adresse du point est une adresse reposant sur des points qui représentent les emplacements de maisons et de bâtiments. Les adresses de points représentent le toit ou l’emplacement réel de l’adresse. En règle générale, il s’agit du niveau d’appariement le plus précis spatialement. Les données de référence contiennent des points d’adresse avec des numéros de maison et des noms de rue associés, ainsi que les divisions administratives et les informations facultatives de code postal, par exemple, 380 New York St, Redlands, CA, 92373.

Une vue du localisateur configurée avec cette sous-catégorie limite les résultats à ces points d’adresse d’une grande précision, ce qui permet d’éviter l’intégration de points d’adresse moins précis si vous avez besoin d’un appariement de haute précision.

Adresse

Une adresse se distingue d’une adresse du point en ce sens que le numéro de domicile dans une adresse est interpolé à partir d’une plage de numéros. Les données de référence contiennent les axes médians des rues avec les plages de numéros de domiciles, ainsi que des divisions administratives et un code postal facultatif, par exemple, 647 Haight St, San Francisco, CA, 94117.

Une vue du localisateur configurée avec cette sous-catégorie permet d’obtenir un résultat interpolé. Si vous souhaitez appliquer ce degré de précision minimal aux résultats de recherche, sélectionnez à la fois cette sous-catégorie et la catégorie Point Address (Adresse du point).

Intersection

Une intersection est une adresse de rue constituée d’une intersection de rue, ainsi que la ville, et les informations facultatives de l’état et du code postal, par exemple Redlands Blvd & New York St, Redlands, CA, 92373.

Une vue du localisateur configurée avec cette sous-catégorie limite les résultats aux intersections au lieu d’inclure des adresses complètes qui n’existent que dans une seule rue.

Nom de rue

Un nom de rue est similaire à une adresse, mais sans le numéro de domicile. Il contient les axes médians des rues avec les noms de rues associés (aucune plage d’adresses numérotées), ainsi que des divisions administratives et un code postal facultatif, par exemple, W Olive Ave, Redlands, CA, 92373.

Une vue du localisateur configurée avec cette sous-catégorie limite les résultats aux noms de rue uniquement. Si vous souhaitez appliquer ce degré de précision minimal aux résultats de recherche, sélectionnez cette sous-catégorie, ainsi que les sous-catégories Point Address (Adresse du point) et Street Address (Adresse).

Sous-adresse

Une sous-adresse est un sous-ensemble d’une adresse de points qui représente une maison ou un lieu de sous-ensemble de bâtiments comme un immeuble d’appartements, un étage, ou un bâtiment individuel dans un immeuble complexe, par exemple 3836 Emerald Ave, Suite C, La Verne, CA, 91750.

Une vue du localisateur configurée avec cette sous-catégorie limite les résultats aux points de sous-adresses qui intègrent un numéro de domicile, un nom de rue et des éléments de sous-adresses, ainsi que des divisions administratives et un code postal facultatif, sans inclure d’autres types d’adresse.

Postal

Aucune sous-catégorie

Une vue du localisateur configurée avec la catégorie Postal (Postal) renvoie tous les types de code postal, y compris les codes postaux à cinq chiffres (par exemple, 92373) et d’autres formats. Pour appliquer ce degré de précision minimal aux résultats, sélectionnez la catégorie Postal (Postal) et la catégorie de niveau supérieur Address (Adresse).

Lieu peuplé

Quartier

Un voisinage est une sous-section d’une ville, plus petite qu’un district et plus grande qu’un secteur.

Ville

Un localisateur configuré avec les limites de sous-catégorie résulte en villes uniquement, par exemple la ville de Venise en Italie.

Département

Une sous-région est un sous-ensemble d’un état ou d’une province, tel qu’un comté aux États-Unis, par exemple le comté d’Adams dans l’état du Wisconsin.

Région

Une région est une sous-section d’un pays, généralement un état ou une province, par exemple, la province d’Ontario au Canada.

Pays

Un pays est la division administrative la plus haute, également appelée nation, par exemple le Japon.

Secteur

Un secteur est une division administrative plus grande qu’un îlot mais plus petite qu’un voisinage. Il représente une sous-division d’un voisinage ou d’un district, ou un ensemble d’îlots.

Bloquer

Un îlot est la plus petite zone administrative d’un pays. Il représente une sous-division d’un secteur ou d’un voisinage, ou un îlot urbain nommé.

Arrondissement

Un district est une division administrative plus petite qu’une ville et plus grande qu’un voisinage. Par exemple, un district municipal.

Métropole

Une zone métropolitaine (métro) est une agglomération urbaine constituée d’une grande ville et de petites villes alentours, par exemple le Grand Tokyo.

Territoire

Un secteur est une grande division administrative, plus petit qu’un pays et plus grand qu’un état ou un province, par exemple le secteur de Yukon au Canada.

Zone

Une zone est une catégorie représentant une zone administrative non officielle qui n’appartient pas à un pays, comme une zone contestée ou un groupement d’autres zones administratives, par exemple l’Amérique centrale.

Coordonnées

Lorsque vous choisissez Coordinates (Coordonnées) comme types d’emplacement à rechercher, vous pouvez affiner davantage les résultats de recherche de la vue du localisateur en sélectionnant les catégories qui vous intéressent. Vous trouverez leur description dans la table ci-dessous.

CatégorieDescription

Longitude, Latitude

Cette catégorie représente les coordonnées géographiques (x,y). X réfère à la longitude (coordonnées est-ouest) et y réfère à la latitude (coordonnées nord-sud). Les coordonnées sont saisies et renvoyées sous la forme x,y.

Latitude, Longitude

Cette catégorie représente les coordonnées géographiques (x,y). X réfère à la longitude (coordonnées est-ouest) et y réfère à la latitude (coordonnées nord-sud). Les coordonnées sont saisies et renvoyées sous la forme y,x.

MGRS

Cette catégorie représente les coordonnées MGRS (Military Grid Reference System).

USNG

Cette catégorie représente le système de coordonnées USNG (United States National Grid).

Places of Interest (Lieux d’intérêt)

Lorsque vous choisissez Places of Interest (Lieux d’intérêt) comme types d’emplacement à rechercher, vous pouvez affiner davantage les résultats de recherche de la vue du localisateur en sélectionnant les catégories qui vous intéressent. Vous trouverez leur description dans la table ci-dessous.

CatégorieDescription

Enseignement

Cette catégorie représente tous les types d’institutions éducatives, notamment les universités, les écoles primaires et les écoles professionnelles.

Cuisine

Cette catégorie représente les restaurants de tous types.

Magasins et services

Cette catégorie représente tous les types d’activité commerciale ou de détail.

Aéroport

Cette catégorie représente les aéroports, désignés par leur nom ou code.

Conditions requises pour configurer vos propres localisateurs

ArcGIS Online prend en charge les localisateurs exécutés sur ArcGIS Server 10.0 et versions ultérieures comme localisateurs pour la recherche géographique. Lorsqu’ils sont utilisés pour la recherche géographique, les localisateurs peuvent être internes ou externes. Les localisateurs internes fonctionnent uniquement pour la recherche géographique lorsque Map Viewer Classic ou d’autres clients ArcGIS Online y ont accès. Par exemple, si votre organisation partage des applications avec le public, seuls les utilisateurs qui ont accès à vos localisateurs internes seront en mesure de rechercher des sites avec ces applications.

ArcGIS Online prend également en charge les localisateurs exécutés sur ArcGIS Server 10.1 et versions ultérieures comme géocodeurs pour le géocodage par lots. Contrairement à la recherche géographique, les localisateurs externes qui sont hébergés à l’extérieur de votre pare-feu sont requis pour le géocodage par lots. En effet, ArcGIS Online doit accéder à l’opération geocodeAddresses sur votre localisateur afin d’exécuter le géocodage par lots. Si votre localisateur externe est sécurisé, vous devez d’abord créer un élément de service sécurisé dans ArcGIS Online qui stocke les informations d’identification requises pour l’accès au localisateur. Vous pouvez ensuite configurer l’URL du service fourni par l’élément de service sécurisé en tant que localisateur.

Lorsque vous configurez votre propre localisateur pour le géocodage par lots, vous devez prévoir suffisamment de ressources de calcul pour le localisateur. ArcGIS Online soumet simultanément de nombreuses requêtes lors des opérations de géocodage par lots pour améliorer les performances. Ainsi, vos propres localisateurs doivent présenter suffisamment de ressources de calcul pour pouvoir gérer des requêtes simultanées sans trop affecter leur durée de traitement.

ArcGIS Online prend en charge les localisateurs à champ unique de ArcGIS Server 10.0 et versions ultérieures. Les localisateurs de ArcGIS Server 10.0 et les localisateurs internes peuvent servir à la recherche géographique, mais pas au géocodage par lots. Les localisateurs externes de ArcGIS Server 10.1 ou version ultérieure sont requis pour procéder au géocodage par lots. Les localisateurs internes ne fonctionnent que pour la recherche géographique lorsque Map Viewer, Map Viewer Classic ou d’autres clients ArcGIS Online y ont accès. Par exemple, si votre organisation partage des applications avec le public, seuls les utilisateurs qui ont accès à vos localisateurs internes seront en mesure de rechercher des sites avec ces applications. Les éléments des services sécurisés de ArcGIS Online ne sont actuellement pas pris en charge dans ArcGIS Desktop. Pour procéder au géocodage par lots, votre localisateur doit être hébergé à l’extérieur de votre pare-feu, afin que ArcGIS Online puisse accéder à l’opération geocodeAddresses sur votre localisateur.

Enrichir la couche avec des informations d’adresse

Lorsque vous publiez une couche d’entités hébergée à partir d’un fichier de valeurs séparées par des virgules (CSV), vous avez la possibilité d’y inclure des informations provenant du processus de géocodage. Ces informations sont générées par le localisateur et stockées dans des champs de la couche d’entités hébergée.

Par défaut, seules les informations du localisateur (coordonées x,y) sont incluses dans la couche d’entités hébergée. Pour inclure des informations supplémentaires dans une couche d’entités hebergée, il existe deux options :

  • Append four fields that show how well addresses matched (Ajoutez quatre champs qui indiquent le niveau de correspondance des adresses) : inclut les champs status, score, match_addr et addr_type, et leurs valeurs. Ces champs et valeurs sont décrits dans le tableau suivant.
  • Append 50 fields for full location information (Ajoutez 50 champs pour des informations de localisation complètes) : inclut tous les champs répertoriés dans le tableau suivant.

Notez que ces champs et valeurs supplémentaires vont venir augmenter la taille de la couche d’entités hébergée. Le ratio d’augmentation de la taille de la couche dépend du nombre d’enregistrements que contient le fichier en entrée et de l’option que vous choisissez. Le tableau suivant décrit les champs que vous pouvez ajouter à une couche d’entités hébergée publiée à partir d’un fichier .csv :

TerrainDescriptionTypes de demande pris en charge

spatialReference

Référence spatiale des coordonnées de l’emplacement d’appariement en sortie, telle qu’indiqué dans les propriétés de wkid et de latestWkid. Le paramètre en entrée outSR détermine la référence spatiale.

findAddressCandidates

geocodeAddresses

reverseGeocode

address

Adresse d’appariement complète renvoyée pour les requêtes de géocodage findAddressCandidates et geocodeAddresses.

Exemple : 380 New York St, Redlands, California, 92373

findAddressCandidates

geocodeAddresses

address (reverseGeocode only)

Adresse postale complète d’une localisation, avec le numéro et le nom de la rue.

Exemple : 380 New York St

Remarque :
Cette adresse est différente de celle du champ address renvoyé en réponse aux demandes findAddressCandidates et geocodeAddresses. Elle est renvoyée uniquement pour reverseGeocode. Elle est identique au champ StAddr en sortie pour findAddressCandidates et geocodeAddresses.

reverseGeocode

location

Coordonnées de points de l’emplacement d’appariement en sortie, telles qu’indiquées par les propriétés de x et de y. La référence spatiale des coordonnées x et y est définie par le champ en sortie spatialReference. Reportez-vous à la description du paramètre locationType pour obtenir plus d’informations sur la relation entre le champ en sortie de l’emplacement et les attributs en sortie x et y.

Pour reverseGeocode spécifiquement, reportez-vous à la description du paramètre returnInputLocation pour savoir comment il peut être utilisé pour modifier les coordonnées de localisation en sortie.

findAddressCandidates

geocodeAddresses

reverseGeocode

ResultID

Elle est renvoyée uniquement pour les requêtes geocodeAddresses. Chaque enregistrement de réponse d’un géocodage par lots inclut une valeur ResultID, égale à la valeur OBJECTID de l’enregistrement d’adresse en entrée correspondant. Il peut également servir à joindre les champs en sortie de la réponse aux attributs de la table d’adresses d’origine.

geocodeAddresses

Loc_name

Nom du localisateur utilisé pour renvoyer un résultat d’appariement particulier.

Remarque :

Le champ Loc_name est utilisé en interne par le logiciel ArcGIS et n’est pas destiné à un usage par les applications client.

findAddressCandidates

geocodeAddresses

Status

Indique si une demande de géocodage génère un appariement ou un rattachement ou si elle n’est pas appariée.

Les valeurs possibles sont les suivantes :

  • M : appariée. L’adresse renvoyée correspond à la demande et constitue le candidat avec le meilleur score.
  • T : rattachée. L’adresse renvoyée correspond à la requête mais a le même score qu’un ou plusieurs autres candidats.
  • U : non appariée. Aucune adresse ne correspond à la requête.

findAddressCandidates

geocodeAddresses

Score

Un nombre entre 1 et 100 indique à quel degré les jetons en entrée d’une requête de géocodage correspondent aux composants de l’adresse dans l’enregistrement du candidat. Un score de 100 indique une correspondance parfaite, tandis que les scores inférieurs indiquent une correspondance partielle.

findAddressCandidates

geocodeAddresses

Match_addr

Adresse complète renvoyée pour la requête de géocodage. Le format de l’adresse est dicté par les normes du pays où elle se situe.

findAddressCandidates

geocodeAddresses

reverseGeocode

LongLabel

Version plus longue de la valeur Match_addr, contenant des informations administratives supplémentaires.

findAddressCandidates

geocodeAddresses

reverseGeocode

ShortLabel

Version abrégée de la valeur Match_addr.

findAddressCandidates

geocodeAddresses

reverseGeocode

Addr_type

Niveau d’appariement de la requête de géocodage. Les niveaux d’appariement pris en charge varient en fonction des pays.

Les valeurs possibles sont les suivantes :

  • Subaddress - Sous-ensemble d’une valeur PointAddress qui représente l’emplacement de sous-adresse d’une maison ou d’un bâtiment, tel qu’un appartement, un étage ou un bâtiment individuel au sein d’un complexe. Les valeurs de champ UnitName,UnitType, LevelName, LevelType, BldgName et BldgType permettent de distinguer les sous-adresses qui peuvent être associées à la même valeur PointAddress. Les données de référence se composent d’entités ponctuelles avec un numéro d’habitation, un nom de rue et les éléments de sous-adresse associés, ainsi que les divisions administratives et le code postal facultatif. Exemple : 3836 Emerald Ave, Suite C, La Verne, CA, 91750.
  • PointAddress - Adresse reposant sur des points qui représentent l’emplacement de maisons et de bâtiments. En règle générale, il s’agit du niveau d’appariement le plus précis spatialement. Les données de référence contiennent des points d’adresse avec des numéros de domicile et des noms de rue associés, ainsi que des divisions administratives et un code postal facultatif. Les valeurs X / Y et geometry en sortie pour un appariement PointAddress représentent l’emplacement de rue de l’adresse ; il s’agit de l’emplacement utilisé pour les opérations de calcul d’itinéraire. Les valeurs DisplayX et DisplayY représentent le toit ou l’emplacement réel de l’adresse. Exemple : 380 New York St, Redlands, CA, 92373.
  • StreetAddress - Adresse qui diffère de PointAddress, car le numéro d’habitation est interpolé à partir d’une plage de nombres. Les données de référence contiennent des points d’adresse avec des numéros de maison et des noms de rue associés, ainsi que les divisions administratives et les informations facultatives de code postal. Exemple : 647 Haight St, San Francisco, CA, 94117.
  • StreetInt - Adresse composée d’une intersection de rue, ainsi que de la ville et éventuellement des informations sur l’État et le code postal. Elle provient des données de référence StreetAddress. Exemple : Redlands Blvd & New York St, Redlands, CA, 92373.
  • StreetAddressExt - Adresse de rue interpolée qui est renvoyée lorsque matchOutOfRange=true et que le numéro d’habitation est supérieur à la plage des numéros d’habitation pour le segment de rue apparié.
  • DistanceMarker - Adresse de rue qui représente la distance linéaire le long d’une rue, généralement exprimée en kilomètres ou en miles, depuis un emplacement d’origine désigné. Exemple : Carr 682 KM 4, Barceloneta, 00617.
  • StreetMidBlock - centre estimé d’une plage de numéros d’habitation le long d’un segment de rue qui correspond à un îlot de ville. L’emplacement renvoyé pour un appariement StreetMidBlock est plus précis que celui d’un appariement StreetName, mais moins précis qu’un appariement StreetAddress. Cette valeur est actuellement opérationnelle pour les États-Unis uniquement. Exemple : 100 Block of Grant Ave, Millville, New Jersey.
  • StreetBetween : point central d’une rue située entre deux rues perpendiculaires données. L’emplacement renvoyé pour un appariement StreetBetween est plus précis que celui d’un appariement StreetName, mais moins précis qu’un appariement StreetAddress. La valeur Addr_Type est actuellement opérationnelle pour les États-Unis uniquement. Exemple : Davison Rd entre Pine Hill Rd et Ridgetop Ln, Henniker, New Hampshire.
  • StreetName - Cette valeur est similaire à l’adresse de rue, mais sans le numéro d’habitation. Les données de référence contiennent les axes médians des rues avec les noms de rue associés (aucune plage d’adresses numérotées), ainsi que des divisions administratives et un code postal facultatif. Exemple : W Olive Ave, Redlands, CA, 92373.
  • Locality - Nom de lieu représentant un endroit peuplé. Le champ en sortie Type détaille davantage le type de lieu renseigné. Les valeurs Type possibles pour les appariements Locality sont les suivantes : Block, Sector, Neighborhood,District, City, MetroArea, County, State or Province,Territory, Country et Zone. Exemple : Bogotá, COL
  • PostalLoc - Combinaison d’un code postal et d’un nom de ville. Les données de référence correspondent généralement à une combinaison de limites postales et de limites administratives (localité). Exemple : 7132 Frauenkirchen.
  • PostalExt - Code postal avec extension supplémentaire, tel que le service postal des États-Unis, code postal + 4 chiffres. Les données de référence correspondent à des points de code postal avec des extensions. Exemple : 90210-3841.
  • Postal - Code postal. Les données de référence correspondent à des points de code postal. Exemple : 90210 USA.
  • POI - Points d’intérêt. Les données de référence se composent de commerces, de lieux d’intérêt et d’entités géographiques. Exemple : Starbucks.
  • LatLong - Paire de coordonnées x/y. La valeur LatLong addr_type est renvoyée lorsque la recherche en entrée est une paire de coordonnées x/y, telle que 117.155579,32.703761.
  • XY - Appariement basé sur l’hypothèse que la première coordonnée en entrée est la longitude et la seconde est la latitude.
  • YX - Cette valeur est renvoyée comme Addr_type pour le candidat qui suppose que la latitude est le premier chiffre en entrée, suivi de la longitude.
  • MGRS - Emplacement MGRS (Military Grid Reference System), tel que 46VFM5319397841.
  • USNG - Emplacement USNG (U.S. National Grid), tel que 15TXN29753883. Cette valeur Addr_type n’est renvoyée que si le paramètre category est défini sur USNG dans une requête findAddressCandidates ou geocodeAddresses.

findAddressCandidates

geocodeAddresses

reverseGeocode

Type

Type d’entités pour les résultats renvoyés par une recherche. Le champ Type inclut uniquement une valeur pour les candidats avec Addr_type = POI ou Locality. Par exemple, pour Starbucks, Type=Coffee Shop.

findAddressCandidates

geocodeAddresses

reverseGeocode

PlaceName

Nom officiel d’un candidat d’appariement de géocodage. Exemple : Paris ou Starbucks.

findAddressCandidates

geocodeAddresses

reverseGeocode

Place_addr

Adresse complète d’un lieu, avec la rue, la ville et la région. Exemple : 275 Columbus Ave, New York, New York.

findAddressCandidates

geocodeAddresses

Phone

Numéro de téléphone principal d’un point d’intérêt (PI). Exemple : Knott’s Berry Farm, Phone=(714)220-5200. Pour d’autres recherches, comme l’adresse, l’intersection et le code postal, le champ est vide.

findAddressCandidates

geocodeAddresses

URL

URL du site Web principal d’un point d’intérêt (PI). Exemple : University of Georgia, URL =http://www.uga.edu/. Pour d’autres recherches, comme l’adresse, l’intersection et le code postal, le champ est vide.

findAddressCandidates

geocodeAddresses

Rank

Valeur représentant un nombre à virgule flottante, qui indique la priorité d’un résultat par rapport aux autres résultats avec le même nom. Par exemple, en France et au Texas, on trouve une ville nommée Paris. La ville de Paris, en France, a une population plus importante que la ville de Paris au Texas. C'est la raison pour laquelle elle est mieux classée. Le champ Rank est utilisé pour trier les résultats pour les recherches ambigües telles que Lincoln, pour laquelle aucune information supplémentaire (État) n’est disponible. Les valeurs Rank sont basées sur le type de population ou d’entité.

findAddressCandidates

geocodeAddresses

AddBldg

Nom d’un bâtiment. Exemple : Empire State Building.

findAddressCandidates

geocodeAddresses

AddNum

Valeur alphanumérique qui représente la partie d’une adresse généralement connue comme un numéro d’habitation ou un numéro de bâtiment. Exemple : dans l’adresse 380 New York Street, AddNum = 380.

Cette valeur est renvoyée uniquement pour les appariements PointAddress et StreetAddress.

findAddressCandidates

geocodeAddresses

reverseGeocode

AddNumFrom

Valeur représentant le numéro de début d’une plage d’adresses de rue. Elle est relative à la direction de la numérisation de l’entité et n’est pas toujours le plus petit numéro de la plage. Cette valeur est fournie pour les résultats StreetAddress.

findAddressCandidates

geocodeAddresses

AddNumTo

Valeur représentant le numéro de fin d’une plage d’adresses de rue. Elle est relative à la direction de la numérisation de l’entité et n’est pas toujours le plus grand numéro de la plage. Cette valeur est fournie pour les résultats StreetAddress.

findAddressCandidates

geocodeAddresses

AddRange

Plage complète des numéros d’habitation pour le segment de rue où figure une adresse, au format AddNumFrom-AddNumTo. Par exemple, la valeur AddRange pour l’adresse de rue 123 Main St peut être 101-199.

findAddressCandidates

geocodeAddresses

Side

Côté de la rue où se trouve une adresse par rapport à la direction de la numérisation de l’entité. Cette valeur n’est pas relative à la direction du déplacement dans la rue. Les valeurs possibles sont R (droite) et L (gauche).

Remarque :

Side est un champ hérité qui n’est conservé que dans le but de prendre en charge des applications qui s’attendent à le trouver dans la réponse REST. Le champ est vide pour la plupart des adresses renvoyées par le service de géocodage. Il ne doit pas être utilisé à des fins d’analyse.

findAddressCandidates

geocodeAddresses

StPreDir

Élément d’adresse définissant la direction d’une rue et survenant avant le nom de rue principal. Exemple : North (Nord) dans North Main Street.

findAddressCandidates

geocodeAddresses

StPreType

Élément d’adresse définissant le type de préfixe d’une rue. Exemple : le terme espagnol Avenida dans Avenida Central ou le terme français Rue dans Rue Lapin.

findAddressCandidates

geocodeAddresses

StName

Élément d’adresse définissant le nom principal d’une rue. Exemple : Main (Principal) dans North Main Street.

findAddressCandidates

geocodeAddresses

StType

Élément d’adresse définissant le type d’une rue. Exemple : Street (Rue) dans Main Street.

findAddressCandidates

geocodeAddresses

StDir

Élément d’adresse définissant la direction d’une rue et survenant après le nom de rue principal. Exemple : North (Nord) dans Main Street North.

findAddressCandidates

geocodeAddresses

BldgName

Nom ou numéro d’une sous-unité de bâtiment. Exemple : A dans bâtiment A.

findAddressCandidates

geocodeAddresses

BldgType

Classification d’une sous-unité de bâtiment. Exemples : bâtiment, hangar et tour.

findAddressCandidates

geocodeAddresses

LevelType

Classification d’une sous-unité d’étage. Exemples : étage, niveau, département et aile.

findAddressCandidates

geocodeAddresses

LevelName

Nom ou numéro d’une sous-unité d’étage. Exemple : 3 dans niveau 3.

findAddressCandidates

geocodeAddresses

UnitType

Classification d’une sous-unité d’unité. Exemples : unité, appartement, bureau et suite.

findAddressCandidates

geocodeAddresses

UnitName

Nom ou numéro d’une sous-unité d’unité. Exemple : 2B dans appartement 2B.

findAddressCandidates

geocodeAddresses

SubAddr

Valeur complète de sous-unité pour un candidat avec Addr_type=Subaddress qui inclut <subunit type> + <subunit name>. Par exemple, si le candidat d’une sous-adresse est une unité appartement, SubAddr = UnitType + UnitName. Exemple : Apt 4B

findAddressCandidates

geocodeAddresses

StAddr

Adresse d’un lieu, sans la ville et la région. Exemple : 275 Columbus Ave.

findAddressCandidates

geocodeAddresses

Block

Nom de la division administrative au niveau de l’îlot pour un candidat. Block désigne la zone administrative la plus petite d’un pays. Il peut être décrit sous la forme d’une sous-division d’un secteur ou d’un quartier, ou d’un îlot de ville nommé. Il n’est pas couramment utilisé.

findAddressCandidates

geocodeAddresses

reverseGeocode

Sector

Nom de la division administrative au niveau du secteur pour un candidat. La valeur Sector désigne une sous-division d’un quartier, d’un arrondissement ou représente un ensemble d’îlots. Il n’est pas couramment utilisé.

findAddressCandidates

geocodeAddresses

reverseGeocode

Nbrhd

Nom de la division administrative au niveau du quartier pour un candidat. La valeur Nbhrhd désigne une sous-section de ville ou d’arrondissement.

findAddressCandidates

geocodeAddresses

Neighborhood

Nom de la division administrative au niveau du quartier pour un candidat. La valeur Neighborhood désigne une sous-section de ville ou d’arrondissement.

Remarque :
Elle est identique au champ Nbhrhd en sortie pour les demandes findAddressCandidates et geocodeAddresses.

reverseGeocode

District

Nom de la division administrative au niveau de l’arrondissement pour un candidat. Elle désigne une sous-division d’une ville.

findAddressCandidates

geocodeAddresses

reverseGeocode

City

Nom de la division administrative au niveau de la ville pour un candidat. La valeur City désigne une sous-division de sous-région ou de région.

findAddressCandidates

geocodeAddresses

reverseGeocode

MetroArea

Nom de la division administrative au niveau de la zone métropolitaine pour un candidat. Il s’agit d’une zone urbaine composée d’une grande ville et de petites villes environnantes. La valeur peut éventuellement intersecter plusieurs départements ou régions. Exemple : Kolkata Metropolitan Area (zone métropolitaine de Kolkata) en Inde.

findAddressCandidates

geocodeAddresses

reverseGeocode

Subregion

Nom de la division administrative au niveau du département pour un candidat. La valeur Subregion désigne une sous-division de région.

findAddressCandidates

geocodeAddresses

reverseGeocode

Region

Nom de la division administrative au niveau de la région pour un candidat. Il s’agit d’une sous-division d’un pays ou d’un territoire. Elle désigne généralement la plus grande zone administrative d’un pays si la division administrative Territory n’est pas utilisée.

findAddressCandidates

geocodeAddresses

reverseGeocode

RegionAbbr

Nom de région abrégé. La valeur RegionAbbr pour la Californie est CA.

findAddressCandidates

geocodeAddresses

reverseGeocode

Territory

Nom de la division administrative au niveau du territoire pour un candidat. Elle désigne une sous-division de pays. Il n’est pas couramment utilisé. La macrorégion du Sudeste au Brésil, qui comprend l’État de São Paulo, le Minas Gerais, l’État de Rio de Janeiro et l’Espírito Santo, en est un exemple.

findAddressCandidates

geocodeAddresses

reverseGeocode

Postal

Élément d’adresse alphanumérique définissant le code postal principal. Exemple : V7M 2B4 pour un code postal canadien et 92374 pour un code postal aux États-Unis.

findAddressCandidates

geocodeAddresses

reverseGeocode

PostalExt

Élément d’adresse alphanumérique définissant l’extension du code postal. Exemple : 8100 dans le code postal des États-Unis 92373-8110.

findAddressCandidates

geocodeAddresses

reverseGeocode

Country

Code à trois chiffres désignant un pays. Exemple : CAN correspond au Canada. La liste des pays et des codes pris en charge est disponible dans la rubrique Couverture des données de géocodage. Ce champ est renvoyé par les opérations findAddressCandidates et geocodeAddresses.

findAddressCandidates

geocodeAddresses

CountryCode

Code à trois chiffres désignant un pays. Exemple : CAN correspond au Canada. La liste des pays et des codes pris en charge est disponible dans la rubrique Couverture des données de géocodage.

Remarque :
Elle est identique au champ Country en sortie pour les demandes findAddressCandidates et geocodeAddresses.

reverseGeocode

CntryName

Nom de pays entier d’une adresse candidate. Exemple : 日本 (Japon). Le nom peut être dans la même langue que l’adresse en entrée ou dans la langue spécifiée par le paramètre langCode de la requête. Si le nom de pays entier n’est pas disponible dans la langue spécifiée, la langue principale du pays où se trouve l’adresse candidate est utilisée. Des informations sur les langues prises en charge par pays sont disponibles dans la rubrique Couverture des données de géocodage. Ce champ est renvoyé par les opérations findAddressCandidates, geocodeAddresses et reverseGeocode.

findAddressCandidates

geocodeAddresses

reverseGeocode

LangCode

Code de langue à trois caractères représentant la langue de l’adresse. Exemple : ENG correspond à l’anglais.

findAddressCandidates

geocodeAddresses

Distance

Distance physique en mètres d’un candidat à un emplacement spécifié. La valeur en sortie Distance est calculée pour chaque candidat lorsque le paramètre en entrée Location est transmis dans une requête au moyen de l’opération findAddressCandidates. Si le paramètre Location n’est pas transmis dans une requête, la valeur de Distance est nulle.

findAddressCandidates

X

Coordonnée x principale d’une adresse renvoyée par le ArcGIS World Geocoding Service dans la référence spatiale WGS84 (WKID 4326).

findAddressCandidates

geocodeAddresses

reverseGeocode

Y

Coordonnée y principale d’une adresse renvoyée par le ArcGIS World Geocoding Service dans la référence spatiale WGS84 (WKID 4326).

findAddressCandidates

geocodeAddresses

reverseGeocode

InputX

La coordonnée x qui a été envoyée dans une requête reverseGeocode pour le paramètre location

reverseGeocode

InputY

La coordonnée y qui a été envoyée dans une requête reverseGeocode pour le paramètre location

reverseGeocode

DisplayX

Coordonnée x d’affichage d’une adresse renvoyée par le ArcGIS World Geocoding Service dans la référence spatiale WGS84 (WKID 4326). Pour la plupart des types d’appariement, les valeurs X et DisplayX sont identiques. Pour les appariements de Addr_type, PointAddress et Subaddress en particulier, les valeurs peuvent être différentes. En général, pour les appariements de PointAddress et Subaddress, DisplayX représente la valeur de la coordonnée x du centroïde de toit de bâtiment ou de parcelle de l’adresse, tandis que la valeur X représente la valeur de la coordonnée x de l’emplacement du côté de la rue de l’adresse. Il existe toutefois des exceptions. Certaines sources de données d’adresse utilisées par le ArcGIS World Geocoding Service fournissent uniquement l’emplacement du toit du bâtiment des entités PointAddress et Subaddress. D’autre part, pour certaines entités PointAddress et Subaddress, seul l’emplacement du côté de la rue est disponible. Dans ces cas-là, les valeurs X et DisplayX sont équivalentes.

findAddressCandidates

geocodeAddresses

DisplayY

Coordonnée y d’affichage d’une adresse renvoyée par le ArcGIS World Geocoding Service dans la référence spatiale WGS84 (WKID 4326). Pour la plupart des types d’appariement, les valeurs Y et DisplayY sont identiques. Pour les appariements de Addr_type, PointAddress et Subaddress en particulier, les valeurs peuvent être différentes. En général, pour les appariements de PointAddress et Subaddress, DisplayY représente la valeur de la coordonnée y du centroïde de toit de bâtiment ou de parcelle de l’adresse et la valeur Y représente la valeur de la coordonnée y de l’emplacement du côté de la rue de l’adresse. Il existe toutefois des exceptions. Certaines sources de données d’adresse utilisées par le ArcGIS World Geocoding Service fournissent uniquement l’emplacement du toit du bâtiment des entités PointAddress et Subaddress. D’autre part, pour certaines entités PointAddress et Subaddress, seul l’emplacement du côté de la rue est disponible. Dans ces cas-là, les valeurs Y et DisplayY sont équivalentes.

findAddressCandidates

geocodeAddresses

Xmin

Coordonnée x minimum pour l’étendue d’affichage d’une entité renvoyée par le ArcGIS World Geocoding Service. Les valeurs Xmin, Xmax, Ymin et Ymax peuvent être combinées afin de définir l’étendue de la carte pour l’affichage d’un résultat de géocodage. Les coordonnées d’étendue utilisent la référence spatiale WGS84.

findAddressCandidates

geocodeAddresses

Xmax

Coordonnée x maximum pour l’étendue d’affichage d’une entité renvoyée par le ArcGIS World Geocoding Service. Les valeurs Xmin, Xmax, Ymin et Ymax peuvent être combinées afin de définir l’étendue de la carte pour l’affichage d’un résultat de géocodage. Les coordonnées d’étendue utilisent la référence spatiale WGS84.

findAddressCandidates

geocodeAddresses

Ymin

Coordonnée y minimum pour l’étendue d’affichage d’une entité renvoyée par le ArcGIS World Geocoding Service. Les valeurs Xmin, Xmax, Ymin et Ymax peuvent être combinées afin de définir l’étendue de la carte pour l’affichage d’un résultat de géocodage. Les coordonnées d’étendue utilisent la référence spatiale WGS84.

findAddressCandidates

geocodeAddresses

Ymax

Coordonnée y maximum pour l’étendue d’affichage d’une entité renvoyée par le ArcGIS World Geocoding Service. Les valeurs Xmin, Xmax, Ymin et Ymax peuvent être combinées afin de définir l’étendue de la carte pour l’affichage d’un résultat de géocodage. Les coordonnées d’étendue utilisent la référence spatiale WGS84.

findAddressCandidates

geocodeAddresses

ExInfo

Ensemble de chaînes de l’entrée qui n’ont pu être appariées à aucune partie d’adresse et ont été utilisées pour noter ou pénaliser le résultat.

findAddressCandidates

geocodeAddresses

extent

Rectangle d’emprise minimale défini par l’entité d’appariement en sortie, tel que spécifié par les valeurs des champs Xmin, Ymin, Xmax et Ymax. La référence spatiale des coordonnées x et y est définie par le champ en sortie spatialReference. Elle est toujours renvoyée par défaut pour les requêtes de géocodage findAddressCandidates uniquement.

findAddressCandidates