Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Géocodage à l'aide d'Amazon Location
Le géocodage est un processus qui convertit du texte, tel qu'une adresse, une région, le nom d'une entreprise ou un point d'intérêt, en un ensemble de coordonnées géographiques. Vous pouvez utiliser les ressources d'index de localisation pour envoyer des demandes de géocodage et intégrer les données extraites du géocodage afin d'afficher les données sur une carte pour votre application Web ou mobile.
Cette section explique comment envoyer une demande de géocodage simple et comment envoyer des demandes de géocodage avec des spécifications facultatives.
Géocodage
Vous pouvez envoyer une simple demande de géocodage à l'aide de l'SearchPlaceIndexForTextopération de conversion d'une adresse en un ensemble de coordonnées. Une demande simple contient le paramètre obligatoire suivant :
-
Text— Une adresse, un nom, une ville ou une région à convertir en un ensemble de coordonnées. Par exemple, la chaîneAny Town.
Pour spécifier un nombre maximum de résultats par page, utilisez le paramètre facultatif suivant :
-
MaxResults— Limite le nombre maximum de résultats renvoyés dans la réponse à la requête.
Vous pouvez utiliser le AWS CLI ou l'Amazon LocationAPIs.
Géocoder à proximité d'une position
Lors du géocodage, vous pouvez géocoder à proximité d'une position donnée avec le paramètre facultatif suivant :
-
BiasPosition— La position que vous souhaitez rechercher à proximité. Cela permet d'affiner votre recherche en recherchant les résultats les plus proches de la position donnée. Défini comme[longitude, latitude]
L'exemple suivant est une SearchPlaceIndexForText demande de recherche dans la ressource d'index des lieux pour une adresse, un nom, une ville ou une région appelée Any
Town près de la position [-123.4567,45.6789].
POST /places/v0/indexes/ExamplePlaceIndex/search/text Content-type: application/json { "Text": "Any Town", "BiasPosition": [-123.4567,45.6789] }
Géocodez dans un cadre de délimitation
Vous pouvez géocoder dans un cadre de délimitation pour affiner vos résultats aux coordonnées situées à l'intérieur d'une limite donnée à l'aide du paramètre facultatif suivant :
-
FilterBBox— Un cadre de délimitation que vous spécifiez pour filtrer vos résultats en fonction des coordonnées situées dans les limites du cadre. Défini comme[LongitudeSW, LatitudeSW, LongitudeNE, LatitudeNE]Note
Une demande ne peut pas contenir à la fois les
BiasPositionparamètresFilterBBoxet. La spécification des deux paramètres dans la demande renvoie uneValidationExceptionerreur.
L'exemple suivant est une SearchPlaceIndexForText demande de recherche dans un cadre contenant une adresse, un nom, une ville ou une région appelé Any Town. Le cadre de délimitation indique que :
-
La longitude du coin sud-ouest est
-124.1450. -
La latitude du coin sud-ouest est
41.7045. -
La longitude du coin nord-est est
-124.1387. -
La latitude du coin nord-est est
41.7096.
POST /places/v0/indexes/ExamplePlaceIndex/search/text Content-type: application/json { "Text": "Any Town", "FilterBBox": [-124.1450,41.7045,-124.1387,41.7096] }
Géocoder au sein d'un pays
Vous pouvez géocoder dans un ou plusieurs pays que vous spécifiez en utilisant le paramètre facultatif suivant :
-
FilterCountries— Le pays ou la région dans lequel vous souhaitez géocoder. Vous pouvez définir jusqu'à 100 pays dans une seule demande en utilisant un code de pays à trois lettres ISO3166. Par exemple, utilisez AUSpour l'Australie.
L'exemple suivant est une SearchPlaceIndexForText demande de recherche d'une adresse, d'un nom, d'une ville ou d'une région appelée Any Town en Allemagne et en France.
POST /places/v0/indexes/ExamplePlaceIndex/search/text Content-type: application/json { "Text": "Any Town", "FilterCountries": ["DEU","FRA"] }
Filtrer par catégorie
Vous pouvez filtrer les catégories renvoyées dans votre demande de géocodage à l'aide du paramètre facultatif suivant :
-
FilterCategories— Les catégories de résultats que vous souhaitez voir apparaître dans votre requête. Vous pouvez spécifier jusqu'à 5 catégories dans une seule demande. Vous trouverez la liste des catégories d'Amazon Location Service dans la section Catégories. Par exemple, vous pouvez spécifierHotelde ne spécifier que les hôtels récurrents dans votre requête.
L'exemple suivant est une SearchPlaceIndexForText demande de recherche d'un café appelé Hometown Coffee aux États-Unis.
POST /places/v0/indexes/ExamplePlaceIndex/search/text Content-type: application/json { "Text": "Hometown Coffee", "FilterCategories": ["Coffee Shop"], "FilterCountries": ["USA"] }
Pour plus de détails sur le filtrage par catégories, voir Catégories de lieux et filtrage des résultats avec Amazon Location
Géocodez dans la langue de votre choix
Vous pouvez définir une préférence linguistique pour les résultats de votre recherche à l'aide du Language paramètre facultatif. Par exemple, une recherche 100 Main
St, Anytown, USA peut être renvoyée 100 Main St, Any Town,
USA par défaut. Mais si vous le sélectionnezLanguage, fr les résultats peuvent être renvoyés à la 100 Rue
Principale, Any Town, États-Unis place.
-
Language— Un code de langue à utiliser pour afficher les résultats de votre requête. La valeur doit être un code de langue BCP47valide. Par exemple, enpour l'anglais.
Note
Si Language ce n'est pas spécifié ou si la langue spécifiée n'est pas prise en charge pour un résultat, la langue par défaut du partenaire pour ce résultat sera utilisée.
L'exemple suivant est une SearchPlaceIndexforText demande de recherche d'un lieu appelé Any Town avec la langue préférée spécifiée commede.
POST /places/v0/indexes/ExamplePlaceIndex/search/text Content-type: application/json { "Text": "Any Town", "Language": "de" }
Exemple de réponse
Voici un exemple de réponse lorsque vous appelez l'SearchPlaceIndexForTextopération depuis Amazon Location PlacesAPIs. Les résultats incluent les lieux pertinents et le résumé de la demande. Deux réponses sont affichées, en fonction de la sélection d'Esri ou en HERE tant que partenaire.
