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
Obtención de lugar recupera información detallada sobre un lugar con su PlaceId único. 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, consulte Obtención de lugar en la Referencia de la API de Amazon Location Service.
Para ver ejemplos de solicitudes, respuestas, cURL y comandos de la CLI para esta API, consulte Cómo usar la 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. Use la API de GetPlace para actualizar los detalles sobre empresas y lugares, asegurándose de que los usuarios tengan 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.
-
Recupere los detalles de los sitios después de recibir sugerencias de escritura anticipada: mejore la experiencia del usuario integrando la API de GetPlace con características de autocompletado o sugerencias. A medida que los usuarios escriben una dirección, un nombre de empresa o un punto de interés, las sugerencias proporcionan lugares relevantes, y GetPlace permite acceder a información más detallada una vez realizada la selección.
Explicación de la solicitud
La solicitud de la API de GetPlace requiere parámetros específicos, como PlaceId, y admite parámetros opcionales para características adicionales o 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, consulte la referencia de la API de GetPlace.
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 de
-
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 API de GetPlace incluye datos básicos, como la dirección, las coordenadas y los detalles de la empresa, así como datos adicionales en función de 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, consulte la referencia de la API de GetPlace.
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.
-
