Introducción
La API de Places te permite buscar y recuperar información de una variedad de tipos de lugares usando una cadena de texto o por proximidad. La API de Places (heredada) es la versión heredada de la API de Places (nueva).
En la siguiente tabla, se enumeran las versiones correspondientes de ambas APIs. Usa esta guía para comprender las diferencias clave entre ambas y migrar a la Places API (nueva).
| API de Places (heredada) | API de Places (nuevo) | Notas |
|---|---|---|
| Find Place (heredado) | Búsqueda de texto (nuevo) | No hay una versión nueva de Find Place (Legacy). La reemplazó la nueva versión de Text Search. |
| Nearby Search (heredada) | Nearby Search (nuevo) | Todas las solicitudes que usen la API heredada y que incluyan una búsqueda de texto deben usar Text Search (nuevo), ya que Nearby Search (nuevo) no admite la entrada de texto. |
| Búsqueda de texto (heredada) | Búsqueda de texto (nuevo) | |
| Place Details (heredado) | Place Details (nuevo) | |
| Place Photos (heredado) | Place Photos (versión nueva) | |
| Place Autocomplete (heredado) | Autocompletar (nuevo) | |
| Query Autocomplete (heredado) | Autocompletar (nuevo) | Se agregaron capacidades a Autocomplete (nuevo). |
Migra a las nuevas APIs
Para migrar a las nuevas APIs, consulta las siguientes guías de migración:
- Migra a la Búsqueda cercana (nuevo)
- Migra a Text Search (nuevo)
- Migra a Place Details (nuevo)
- Migra a Place Photos (nuevo)
- Migrate to Autocomplete (New)
Funciones clave agregadas a la API de Places (nueva)
En esta sección, se describen las funciones clave que se agregaron a la API de Places (nueva).
Implementado en la plataforma estándar de Google Cloud
La API de Places (nueva) se implementa en la infraestructura de servicio de Google Cloud. Esta implementación ofrece una plataforma más segura y confiable con opciones de seguridad mejoradas, como OAuth. Este diseño de API estándar aporta un nivel de coherencia en todas las APIs que mejora la eficiencia del desarrollo con la API de Places (nueva).
Rendimiento mejorado
La nueva API de Places ofrece un mejor rendimiento, lo que hace que valga la pena reemplazar las apps que usan la API de Places existente.
Precios simplificados
Los precios se simplificaron 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), utilizas la máscara de campo para controlar la lista de campos que se deben devolver en la respuesta. Luego, solo se te facturarán los datos solicitados. Usar una máscara de campo 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 heredadas, las APIs de Place Details (heredada), Nearby Search (heredada) y Text Search (heredada) devolvían diferentes datos de respuesta para un lugar. La API de Places (nueva) estandariza la respuesta para que todas estas APIs devuelvan 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 solo valor de tipo 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 Nearby Search (nuevo) y Text Search (nuevo). 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 para VE o los precios de combustible más recientes de una gasolinera. Usa estos campos de respuesta para crear experiencias del usuario dinámicas.