Géocodage inversé

Le géocodage inversé est un processus qui convertit un ensemble de coordonnées en texte significatif, tel qu'une adresse, une région, le nom d'une entreprise ou un point d'intérêt. Vous pouvez utiliser les ressources d'index de localisation pour envoyer des demandes de géocodage inversé et intégrer les données extraites du géocodage inversé afin d'afficher les données sur une carte pour votre application Web ou mobile.

Cette section explique comment envoyer une simple demande de géocodage inversé.

Géocodage inversé

Vous pouvez envoyer une simple demande pour inverser le géocodage d'un ensemble de coordonnées et les convertir en une adresse significative, un point d'intérêt ou un emplacement général sans adresse à l'aide de cette SearchPlaceIndexForPosition opération. Une demande simple contient le paramètre obligatoire suivant :

• Position— Ensemble de coordonnées que vous souhaitez convertir en adresse, point d'intérêt ou emplacement général. Défini à l'aide du format[longitude,latitude].

Pour spécifier un nombre maximum de résultats par page, ajoutez le paramètre facultatif suivant :

• MaxResults— Limite le nombre maximum de résultats renvoyés dans la réponse à la requête.

Si vous souhaitez spécifier une langue préférée pour les résultats de votre requête, utilisez le paramètre facultatif suivant :

• Language— Code de langue à utiliser pour le rendu des résultats. La valeur doit être un code de langue BCP 47 valide. Par exemple, en pour 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.

Vous pouvez utiliser les AWS CLI ou les API Amazon Location.

API

L'exemple suivant est une SearchPlaceIndexForPosition demande visant à rechercher dans la ressource d'index des lieux une adresse ExamplePlaceIndex, un point d'intérêt ou un emplacement général significatif à proximité de la position [122.3394, 47.6159].

POST /places/v0/indexes/ExamplePlaceIndex/search/position
Content-type: application/json

{
   "Position": [-122.3394,47.6159],
   "MaxResults": 5,
   "Language": "de"
}

AWS CLI

L'exemple suivant est une search-place-index-for-position commande permettant de rechercher dans la ressource d'index des lieux une adresse ExamplePlaceIndex, un point d'intérêt ou un emplacement général significatif à proximité de la position [122.3394, 47.6159].

aws location \
    search-place-index-for-position \
        --index-name ExamplePlaceIndex \
        --position -122.3394 47.6159 \
        --max-results 5 \
        --language de

Exemple de réponse

Voici un exemple de réponse lorsque vous appelez l'SearchPlaceIndexForPositionopération depuis les API Amazon Location Places. Les résultats renvoient les lieux pertinents et le résumé de la demande. Deux réponses sont affichées, selon la sélection d'Esri ou Here comme partenaire.

Example request

POST /places/v0/indexes/ExamplePlaceIndex/search/position
Content-type: application/json

{
   "Position": [-122.3394,47.6159],
   "MaxResults": 1
}

Example response (Esri)

{
    "Results": [
        {
            "Place": {
                "AddressNumber": "2111",
                "Country": "USA",
                "Geometry": {
                    "Point": [
                        -122.33937999999995,
                        47.61591000000004
                    ]
                },
                "Interpolated": false,
                "Label": "The Spheres, 2111 7th Ave, Seattle, WA, 98121, USA",
                "Municipality": "Seattle",
                "Neighborhood": "Belltown",
                "PostalCode": "98121",
                "Region": "Washington",
                "SubRegion": "King County"
            },
            "Distance": 1.8685861313438727
        }
    ],
    "Summary": {
        "DataSource": "Esri",
        "MaxResults": 1,
        "Position": [
            -122.3394,
            47.6159
        ]
    }
}

Example response (HERE)

{
    "Summary": {
        "Position": [
            -122.3394,
            47.6159
        ],
        "MaxResults": 1,
        "DataSource": "Here"
    },
    "Results": [
        {
            "Place": {
                "Label": "2111 7th Ave, Seattle, WA 98121-5114, United States",
                "Geometry": {
                    "Point": [
                        -122.33938,
                        47.61591
                    ]
                },
                "AddressNumber": "2111",
                "Street": "7th Ave",
                "Neighborhood": "Belltown",
                "Municipality": "Seattle",
                "SubRegion": "King",
                "Region": "Washington",
                "Country": "USA",
                "PostalCode": "98121-5114",
                "Interpolated": false,
                "TimeZone": {
                    "Name": "America/Los_Angeles",
                    "Offset": -28800
                }
            },
            "PlaceId": "AQAAAIAADsn2T3KdrRWeaXLeVEyjNx_JfeTsMB0NVCEAnAZoJ-o3nqdlJZAdgcT2oWi1w9pS4wXXOk3O1vsKlGsPyHjV4EJxsu289i3hVO_BUPgP7SFoWAi8BW2v7LvAjQ5NfUPy7a1v9ajT3feIqcUZszWSTqKbJHFYvQqW7wdqhpQq3Wy-et39ZQDWSPLZUzgcjN-6VD2gyKkH0Po7gSm8YSJNSQ",
            "Distance": 1.868586125090601
        }
    ]
}