Geocodificación inversa usando Amazon Location - Amazon Location Service

Geocodificación inversa usando Amazon Location

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 [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 el Language o el idioma especificado no es compatible con un resultado, se utilizará el idioma predeterminado del socio para ese resultado.

Puede usar la AWS CLI o las API de Amazon Location.

API

El siguiente ejemplo es una solicitud de SearchPlaceIndexForPosition para buscar en el recurso de índice de ubicación, índice de ubicación de ejemplo, una dirección significativa, 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 comando de search-place-index-for-position para buscar en el recurso de índice de ubicación, índice de ubicación de ejemplo, una dirección significativa, 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 } ] }