La API de Places te permite buscar y recuperar información de una variedad de tipos de lugares con una cadena de texto o por proximidad. La API de Places es la versión heredada de la API de Places (nueva).
En la siguiente tabla, se muestran las versiones correspondientes de ambas APIs. Usa esta guía para comprender las diferencias clave entre ambas y migrar a la API de Places (nueva).
| API de Places (heredada) | API de Places (nuevo) | Notas |
|---|---|---|
| Find Place (heredada) | Búsqueda de texto (nueva) | No hay una versión nueva de Find Place. Text Search (nueva) la reemplazó. |
| Búsqueda cercana (heredada) | Nearby Search (nuevo) | Todas las solicitudes que usan la API heredada que incluyen una consulta de texto deben usar Text Search (nueva), ya que Nearby Search (nueva) no admite entradas de texto. |
| Búsqueda de texto (heredada) | Búsqueda de texto (nueva) | |
| Place Details (heredada) | Place Details (nuevo) | |
| Place Photo (heredada) | Place Photo (nuevo) | |
| Place Autocomplete (heredado) | Autocompletar (nuevo) | |
| Query Autocomplete (heredado) | Autocompletar (nuevo) | Se agregaron funciones a Autocomplete (nuevo). |
Migra a las nuevas APIs
Para migrar a las APIs nuevas, consulta las siguientes guías de migración:
- Cómo migrar a Nearby Search (nueva)
- Cómo migrar a Text Search (nueva)
- Cómo migrar a Place Details (nuevo)
- Cómo migrar a Place Photo (nueva)
- Cómo migrar a Autocomplete (nuevo)
Se agregaron funciones clave a la API de Places (nueva)
En esta sección, se describen las funciones clave que se agregaron a la API de Places (nueva).
Se implementó en la plataforma estándar de Google Cloud
La API de Places (nueva) se implementa en la infraestructura del servicio en Google Cloud. Esta implementación brinda una plataforma más segura y confiable con opciones de seguridad mejoradas, como OAuth. Este diseño de API estándar brinda un nivel de coherencia entre las APIs que mejora la eficiencia del desarrollo con la API de Places (nueva).
Rendimiento mejorado
La API de Places (nueva) proporciona un rendimiento mejorado, por lo que vale la pena reemplazar las apps que usan la API de Places existente.
Precios simplificados
Los precios se simplifican con la API de Places (nueva) para que solo pagues por los datos que usas. Los precios simplificados se implementan con una máscara de campo.
Con Place Details (nuevo), Nearby Search (nuevo) y Text Search (nuevo), puedes usar la máscara de campo para controlar la lista de campos que se deben mostrar en la respuesta. Solo se te factura por los datos solicitados. El uso de campos enmascarados es una práctica de diseño recomendada para garantizar que no solicites datos innecesarios, lo que ayuda a evitar tiempos de procesamiento y cargos de facturación adicionales.
Datos de respuesta coherentes para un lugar
Con las APIs existentes, las APIs de Place Details, Text Search y Nearby Search mostraban datos de respuesta diferentes para un lugar. La API de Places (nueva) estandariza la respuesta para que todas estas APIs muestren los mismos datos de un lugar.
Tipos de lugares expandidos
La respuesta de la API ahora puede contener el tipo principal de un lugar. Cada lugar puede tener un valor de tipo único que se especifica como el tipo principal del lugar, como se indica en la Tabla A.
La nueva API también incluye varios tipos nuevos. Puedes usar estos tipos nuevos y los existentes en una búsqueda con la Búsqueda cercana (nueva) y la Búsqueda de texto (nueva). Todos los tipos nuevos se incluyen en la Tabla A.
Datos de lugares dinámicos
La API de Places (nueva) admite datos de respuesta dinámicos, como la disponibilidad de una estación de carga de VE o los precios de combustible más recientes de una gasolinera. Usa estos campos de respuesta para crear experiencias del usuario dinámicas.