Introducción
La API de Places es un servicio que acepta solicitudes HTTP de datos de ubicación a través de diversos métodos. Devuelve datos de ubicación con formato y visualizaciones sobre establecimientos, ubicaciones geográficas o lugares de interés destacados.Por qué usar la API de Places (nueva)
Crea funciones que tengan en cuenta la ubicación para que tus usuarios tengan acceso a datos de ubicación detallados. Los datos disponibles a través de la API de Places (nueva) se basan en uno de los modelos de lugares más precisos, actualizados y completos del mundo real. Estos son algunos ejemplos de casos de uso para aplicaciones:
- Mostrar alquileres de condominios en las principales áreas metropolitanas con resultados segmentados específicamente para las ciudades
- Incluye detalles del lugar en una actualización del estado de retiro o entrega.
- Mostrar una lista de parques en un área junto con fotos y opiniones enviadas por los usuarios
- Proporcionar a las personas que planifican viajes información de contacto, opiniones y niveles de precios de los establecimientos que se encuentran en el camino
Qué puedes hacer con la API de Places (nueva)
Puedes usar la API de Places (nueva) para incluir las siguientes funciones en tus aplicaciones:
- Proporciona resultados de búsqueda de lugares a partir de diferentes tipos de búsquedas de los usuarios, como entradas de texto, ubicaciones cercanas y búsquedas ambiguas o categóricas.
- Habilita las funciones de autocompletado para diferentes tipos de búsquedas, ya sean búsquedas de texto específicas o búsquedas categóricas.
- Ajusta el tipo de detalles que se muestran sobre un lugar, como el horario de atención, un resumen, las opiniones de los usuarios y una foto.
- Agrega fotos de alta calidad a las ubicaciones que muestra tu aplicación.
Muchas APIs de Google Maps Platform admiten IDs de lugar, en los que el ID de lugar identifica de forma única un lugar en la base de datos de Google Places y en Google Maps. Hay muchas formas de obtener un ID de lugar, incluso desde la API de Places (nueva), pero también desde la API de Geocoding, la API de Routes y la API de Address Validation.
Una vez que tengas un ID de lugar, puedes usar la API de Places (nuevo) para solicitar más detalles sobre un establecimiento o punto de interés en particular, como su dirección completa, número de teléfono, calificación de los usuarios y opiniones.
Cómo funciona la API de Places (nueva)
La API de Places (nueva) acepta solicitudes como una URL estándar con un extremo de servicio específico, como /places o places:searchText, y devuelve una respuesta JSON.
La API de Places (nueva) admite la autorización por clave de API y token de OAuth.
En el siguiente ejemplo, se realiza una solicitud a Place Details (nuevo) para devolver los componentes de dirección de un ID de lugar con una clave de API:
https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents &key=YOUR_API_KEY
Cómo usar la API de Places (nueva)
Los siguientes pasos abarcan un caso de uso típico para usar el servicio de la API de Places. A medida que desarrolles tu solución, puedes usar extremos adicionales, como Nearby Search (nuevo) y Place Photos (nuevo).| 1 | Inicia la configuración | Configura la facturación, habilita la API de Places (nueva) y realiza tu primera solicitud. |
| 2 | Cómo realizar una búsqueda de texto básica | Realiza una búsqueda de texto con Text Search (nueva). |
| 3 | Usa el ID de lugar para obtener más detalles | Muchas APIs de Google Maps Platform devuelven un ID de lugar como parte de una respuesta. Usa IDs de lugar para obtener Place Details (nuevo). |
| 4 | Obtén una foto de un lugar | Place Photos (nuevo) te brinda acceso a los millones de fotos almacenadas en la base de datos de Places. Usa Place Photos (New) para acceder a las fotos de un lugar. |