Geocodificación inversa - Amazon Location Service

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Geocodificación inversa

La geocodificación inversa es un proceso que convierte un conjunto de coordenadas en texto significativo, como una dirección, una región, el nombre de una empresa o un punto de interés. Puede utilizar los recursos de índice de ubicación para enviar solicitudes de geocodificación inversa e incorporar los datos recuperados de la geocodificación inversa para mostrarlos en un mapa para su aplicación web o móvil.

En esta sección, se explica cómo enviar una solicitud sencilla de geocodificación inversa.

Geocodificación inversa

Puede enviar una solicitud sencilla para geocodificar de forma inversa un conjunto de coordenadas y convertirlas en una dirección significativa, un punto de interés o una ubicación general sin una dirección mediante la operación de SearchPlaceIndexForPosition. Una solicitud simple contiene el siguiente parámetro obligatorio:

  • Position: un conjunto de coordenadas que desea convertir en una dirección, un punto de interés o una ubicación general. Definido mediante el formato de [longitude,latitude].

Para especificar un número máximo de resultados por página, añada el siguiente parámetro opcional:

  • MaxResults: limita el número máximo de resultados devueltos en la respuesta a la consulta.

Si desea especificar un idioma preferido para los resultados de la consulta, utilice el siguiente parámetro opcional:

  • Language: un código de idioma que se utilizará para representar los resultados. El valor debe ser un código de idioma BCP 47 válido. Por ejemplo, en para inglés.

nota

Si no se especifica Language o el idioma especificado no es compatible con un resultado, se utilizará el idioma predeterminado del socio para ese resultado.

Puedes usar las API de ubicación de Amazon AWS CLI o las API.

API

El siguiente ejemplo es una SearchPlaceIndexForPosition solicitud para buscar en el recurso del índice de sitios una dirección significativa ExamplePlaceIndex, un punto de interés o una ubicación general cercana a la posición [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

El siguiente ejemplo es un search-place-index-for-position comando para buscar en el recurso de indexación de lugares una dirección significativa ExamplePlaceIndex, un punto de interés o una ubicación general cercana a la posición [122.3394, 47.6159].

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

Ejemplo de respuesta

El siguiente es un ejemplo de respuesta al llamar a la operación SearchPlaceIndexForPosition desde las API de Amazon Location Places. Los resultados muestran las ubicaciones relevantes y el resumen de la solicitud. Se muestran dos respuestas basadas en la selección de Esri o Here como socio.

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