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.
GetPlace
GetPlace recupera información detallada sobre un lugar utilizando sus características únicasPlaceId. La solicitud admite parámetros opcionales para características adicionales, como los datos de la zona horaria o los fonemas, y la localización del idioma. La API devuelve información como la dirección, las coordenadas, los detalles de la empresa, los métodos de contacto y la información de la zona horaria.
nota
Si los resultados se almacenan, se facturarán según el nivel de precios de almacenamiento superior. Utilice el parámetro IntendedUse para especificar si los resultados son para un solo uso o para almacenamiento. Consulte Precios de lugares para detalles de los costos asociados a los resultados almacenados.
Para obtener más información, consulta GetPlacela referencia de la API de Amazon Location Service.
Para ver ejemplos de solicitudes, respuestas, cURL y comandos CLI para esta API, consulta Cómo utilizarlos. GetPlace
Casos de uso
-
Actualice los datos almacenados: actualice periódicamente los datos almacenados para garantizar que la aplicación proporcione información precisa y actualizada. Usa la GetPlace API para actualizar los detalles de las empresas y los lugares, asegurándote de que los usuarios dispongan de la información más reciente. Por ejemplo, actualice los horarios de apertura, los datos de contacto y las opiniones de los usuarios de los restaurantes o tiendas locales para aumentar la confianza de los usuarios y la funcionalidad de la aplicación.
-
Recupera los detalles de los sitios después de recibir sugerencias de mecanografía: mejora la experiencia del usuario integrando la GetPlace API con funciones de autocompletado o sugerencias. A medida que los usuarios escriben una dirección, un nombre comercial o un punto de interés, las sugerencias proporcionan lugares relevantes y GetPlace permiten acceder a información más detallada una vez realizada la selección.
Explicación de la solicitud
nota
En ap-southeast-1 el caso de los clientesap-southeast-5, los campos de solicitud y respuesta admitidos pueden diferir. Consulta la referencia de la GetPlace API para obtener más información.
La solicitud de GetPlace API requiere parámetros específicos, como elPlaceId, y admite parámetros opcionales para funciones adicionales o para la localización de idiomas. Estos parámetros ayudan a personalizar los resultados en función del idioma, el uso previsto y el contexto geográfico. Para obtener más información, consulta la referencia de la GetPlace API.
La solicitud acepta los parámetros clave siguientes:
- Autenticación
-
El parámetro
Keyes opcional si se utilizan otros métodos de autenticación.-
Key: clave de la API para la autorización.
Para obtener más información, consulte Autenticación con Amazon Location Service.
-
- Consultas
-
Define el identificador único para recuperar la información del lugar.
-
PlaceId: el identificador único para el lugar (obligatorio).
Para obtener más información, consulte Consultas y sesgos.
-
- Internacionalización y localización
-
Opciones para personalizar el idioma y aplicar una visión política a los resultados.
-
Language: especifica el idioma de los resultados. -
PoliticalView: aplica una visión política que refleja las reclamaciones territoriales.
Para obtener más información, consulte Localización e internacionalización.
-
- Características adicionales
-
Solicita datos adicionales, como detalles de la zona horaria.
-
AdditionalFeatures: opción para solicitar información adicional, como detalles sobre la zona horaria o fonemas.
Para obtener más información, consulte Características adicionales.
-
Explicación de la respuesta
La respuesta de la GetPlace API incluye datos básicos, como la dirección, las coordenadas y los detalles de la empresa, así como datos adicionales basados en los parámetros de la solicitud. También se puede proporcionar información como las restricciones de acceso, las zonas horarias y los detalles de los fonemas para la pronunciación. Para obtener más información, consulta la referencia de la GetPlace API.
La respuesta incluye los datos de claves siguientes:
- Dirección y detalles relacionados
-
Proporciona los detalles completos de la dirección de la ubicación.
-
Address: información de la dirección completa que incluye el país, la región y el código postal. -
PostalCodeDetails: información adicional sobre los códigos postales y las autoridades.
-
- Tipos y categorías de lugares
-
Describe el tipo y la categoría del lugar.
-
BusinessChains: información sobre cualquier cadena empresarial asociada. -
Categories: categorías a las que pertenece el lugar, como alimentos o venta minorista. -
PlaceType: tipo de lugar, como un punto de interés o una localidad.
-
- Detalles adicionales
-
Proporciona datos adicionales sobre el lugar, tal como se especifica en la solicitud.
-
Contacts: métodos de contacto, incluidos números de teléfono, correos electrónicos y sitios web. -
OpeningHours: horario comercial u horario de acceso. -
AccessPoints: coordenadas geográficas (longitud y latitud) de los puntos de acceso. -
Phonemes: pronunciaciones para varios componentes de direcciones. -
TimeZone: información de zona horaria, incluida la desviación.
-
