La API de Places admite dos versiones de la API: la API de Places son las APIs existentes y la API de Places (nueva) es la versión de nueva generación de las APIs.
Con el lanzamiento de la API de Places (nueva), tu primera tarea es decidir qué conjunto de APIs usar. Esto es así si eres un cliente nuevo o un cliente existente que ya usa las APIs. Usa esta guía para comprender las diferencias clave entre las dos APIs.
Lista de APIs
En la siguiente tabla, se enumeran ambos conjuntos de APIs. Si eres un cliente existente, usa esta tabla para determinar qué API nueva reemplazará una API que estés usando en la actualidad.
| API de Places | API de Places (nuevo) | Nota |
|---|---|---|
| Find Place | Text Search (nuevo) | No hay una versión nueva de Find Place. Text Search (nuevo) la reemplazó. |
| Búsqueda de Nearby | Nearby Search (nuevo) | Todas las solicitudes que usan la API existente y que incluyen una consulta de texto deben usar Text Search (nuevo) porque Nearby Search (nuevo) no admite entradas de texto. |
| Búsqueda de texto | Text Search (nuevo) | |
| Place Details | Place Details (nuevo) | |
| Foto del lugar | Place Photos (nuevo) | |
| Place Autocomplete | Autocompletar (nuevo) | En vista previa |
| Autocompletar consultas | Autocompletar (nuevo) | Se agregaron funciones a la versión preliminar de Autocomplete (nuevo) |
La versión del servicio de la API de Places que habilitas en tu clave de API controla las APIs que usa tu app:
API de Places: Habilita las APIs existentes. Si solo está habilitada la API de Places para el proyecto asociado con la clave de API que se usa en tu app, esta no tendrá acceso a las APIs nuevas.
API de Places (nuevo): Habilita todas las APIs y funciones nuevas que se describen en Funciones clave agregadas al SDK de Places para iOS (nuevo). Tu app no tendrá acceso a las APIs existentes.
Ambos: Habilita todas las funciones y las APIs para el SDK de Places para iOS (nuevo) y el SDK de Places para iOS.
Para obtener más información sobre cómo seleccionar el servicio de la API de Places, consulta Configura tu proyecto de Google Cloud.
Cómo migrar a las APIs nuevas
Si usas una API existente y deseas migrar a la nueva API, consulta las siguientes guías de migración para cada API:
- Cómo migrar a Nearby Search (nuevo)
- Migra a Text Search (nuevo)
- Migra a Place Details (nuevo)
- Migrar a Place Photos (nuevo)
- Migra a Autocomplete (nuevo)
Se agregaron funciones clave a la API de Places (nuevo)
En esta sección, se describen las funciones clave que se agregaron a la API de Places (versión 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 trae consigo una plataforma más segura y confiable con opciones de seguridad mejoradas como OAuth. Este diseño estándar de la API aporta un nivel de coherencia entre las APIs que mejoran la eficiencia del desarrollo con la API de Places (versión nueva).
tiene un rendimiento mejorado.
La API de Places (versión nueva) mejora el rendimiento, por lo que vale la pena reemplazar las apps que usan la API de Places existente.
Precios simplificados
Con la API de Places (versión nueva), el precio se simplifica para que solo pagues por los datos que uses. 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 mostrarán en la respuesta. Entonces, solo se te facturará 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 innecesarios.
Datos de respuesta coherentes para un lugar
Con las APIs existentes, las APIs de Place Details, Nearby Search y Text Search mostraron diferentes datos de respuesta 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 solo valor de tipo que se especifica como el tipo principal del lugar, como se muestra en la Tabla A.
Además, la nueva API agrega los tipos de sitios que se muestran en la siguiente tabla. 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.
| Tipo | |||
|---|---|---|---|
| american_restaurant | discount_store | ice_cream_shop | sandwich_shop |
| amusement_center | dog_park | indian_restaurant | school_district |
| athletic_field | electric_vehicle_charging_station | indonesian_restaurant | seafood_restaurant |
| auto_parts_store | event_venue | italian_restaurant | ski_resort |
| banquet_hall | extended_stay_hotel | japanese_restaurant | spanish_restaurant |
| barbecue_restaurant | .farm | korean_restaurant | sporting_goods_store |
| barber_shop | hacienda | lebanese_restaurant | sports_club |
| bed_and_breakfast | fast_food_restaurant | puerto deportivo | sports_complex |
| brazilian_restaurant | ferry_terminal | mercado | steak_house |
| breakfast_restaurant | fitness_center | medical_lab | sushi_restaurant |
| brunch_restaurant | french_restaurant | mediterranean_restaurant | swimming_pool |
| bus_stop | gift_shop | mexican_restaurant | sastre |
| camping_cabin | golf_course | middle_eastern_restaurant | telecommunications_service_provider |
| cell_phone_store | greek_restaurant | motel | thai_restaurant |
| child_care_agency | grocery_store | national_park | transit_depot |
| chinese_restaurant | guest_house | park_and_ride | truck_stop |
| coffee_shop | hair_salon | performing_arts_theater | turkish_restaurant |
| community_center | hamburger_restaurant | pizza_restaurant | vegan_restaurant |
| consultor | helipuerto | playground | vegetarian_restaurant |
| convention_center | hiking_area | preescolar | vietnamese_restaurant |
| cabaña | historical_landmark | private_guest_room | visitor_center |
| courier_service | home_improvement_store | ramen_restaurant | wedding_venue |
| cultural_center | hostal | resort_hotel | mayorista |
| dental_clinic | hotel | rest_stop |
countryadministrative_area_level_1administrative_area_level_2postal_codelocality
Datos de lugar dinámicos
La API de Places (nueva) admite datos de respuesta dinámica, como la disponibilidad de una estación de carga de VE o los precios de combustible más recientes de una gasolinera. Utiliza estos campos de respuesta para crear experiencias del usuario dinámicas.
¿Qué API eliges?
Antes de comenzar el desarrollo de apps, debes elegir tu API:
Si eres un cliente nuevo que recién comienza a usar la API de Places, comienza con las APIs nuevas.
Si eres un cliente nuevo y aún no existe un reemplazo para una API existente, como Place Autocomplete o Query Autocomplete, puedes utilizar una combinación de APIs nuevas y existentes.
Si eres un cliente existente, puedes seguir usando las APIs existentes. Sin embargo, para aprovechar las mejoras de rendimiento y las mejoras de funciones de la API de Places (versión nueva), puedes migrar a las APIs nuevas.
Para obtener más información sobre la migración, consulta Descripción general de la migración.