Geocodificação reversa

A geocodificação reversa é um processo que converte um conjunto de coordenadas em texto significativo, como endereço, região, nome comercial ou ponto de interesse. Você pode usar recursos de índice de localização para enviar solicitações de geocodificação reversa e incorporar dados recuperados da geocodificação reversa para exibir dados em um mapa para seu aplicativo da web ou móvel.

Esta seção explica como enviar uma solicitação simples de geocodificação reversa.

Geocodificação reversa

Você pode enviar uma solicitação simples para fazer geocodificação reversa de um conjunto de coordenadas e convertê-las em um endereço significativo, um ponto de interesse ou um local geral sem que um endereço use a operação SearchPlaceIndexForPosition. Uma solicitação simples contém o seguinte parâmetro necessário:

• Position — Um conjunto de coordenadas que você deseja converter em um endereço, ponto de interesse ou localização geral. Definido usando o formato [longitude,latitude].

Para especificar um número máximo de resultados por página, adicione o seguinte parâmetro opcional:

• MaxResults — Limita o número máximo de resultados retornados na resposta da consulta.

Se você quiser especificar um idioma preferencial para os resultados da sua consulta, use o seguinte parâmetro opcional:

• Language — Um código de linguagem a ser usado para renderizar resultados. O valor deve ser um código de idioma BCP 47 válido. Por exemplo, en para inglês.

nota

Se Language não for especificado ou se o idioma especificado não for suportado para um resultado, o idioma padrão do parceiro para esse resultado será usado.

Você pode usar as APIs de localização da Amazon AWS CLI ou as APIs.

API

O exemplo a seguir é uma SearchPlaceIndexForPosition solicitação para pesquisar no recurso de índice de local um endereço significativo ExamplePlaceIndex, ponto de interesse ou localização geral próxima à posição [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

O exemplo a seguir é um search-place-index-for-position comando para pesquisar no recurso de índice de local um endereço significativo ExamplePlaceIndex, ponto de interesse ou localização geral perto da posição [122.3394, 47.6159].

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

Exemplo de resposta

Veja a seguir um exemplo de resposta ao chamar a operação SearchPlaceIndexForPosition a partir das APIs de localização do Amazon Location. Os resultados retornam locais relevantes e o resumo da solicitação. Duas respostas são mostradas, com base na seleção da Esri ou da Here como parceira.

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
        }
    ]
}