Descripción general de la API de Places (heredada)

Desarrolladores del Espacio Económico Europeo (EEE)

Introducción

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 (heredada) 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 las dos y migrar a la API de Places (nueva).

API de Places (heredada) API de Places (nueva) Notas
Find Place (heredada) Text Search (nueva) No hay ninguna versión nueva de Find Place (heredada). Text Search (nueva) la reemplazó.
Nearby Search (heredada) Nearby Search (nueva) Todas las solicitudes que usan la API heredada y que incluyen una consulta de texto deben usar Text Search (nueva) ya que Nearby Search (nueva) no admite la entrada de texto.
Text Search (heredada) Text Search (nueva)
Place Details (heredada) Place Details (nueva)
Place Photos (heredada) Place Photos (nueva)
Place Autocomplete (heredada) Autocomplete (nueva)
Query Autocomplete (heredada) Autocomplete (nueva) Capacidades agregadas a Autocomplete (nueva).

Migra a las nuevas APIs

Para migrar a las nuevas APIs, consulta las siguientes guías de migración:

Funciones clave agregadas a la API de Places (nueva)

En esta sección, se abarcan las funciones clave agregadas a la API de Places (nueva).

Implementación en la plataforma estándar de Google Cloud

La API de Places (nueva) se implementa en la infraestructura de servicios de Google Cloud. Esta implementación incluye 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 API de Places (nueva) proporciona un rendimiento mejorado, lo que hace que valga 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 (nueva), Nearby Search (nueva) y Text Search (nueva), usas la máscara de campo para controlar la lista de campos que se deben devolver en la respuesta. Luego, 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 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 para 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 (nueva) y Text Search (nueva). Todos los tipos nuevos se incluyen en 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 más recientes del combustible para una estación de servicio. Usa estos campos de respuesta para crear experiencias de usuario dinámicas.