La API de Places admite dos versiones: API de Places son las APIs existentes y API de Places (nueva) son 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 ya eres cliente, usa esta tabla para determinar la API nueva que reemplaza una API que usas actualmente.
| API de Places | API de Places (nuevo) | Nota |
|---|---|---|
| Find Place | Text Search (nueva) | No hay una versión nueva de Find Place. Text Search (nueva) la reemplazó. |
| Búsqueda cercana | Nearby Search (nuevo) | Todas las solicitudes que usan la API existente y que incluyen una consulta de texto deben usar Text Search (nueva) porque Nearby Search (nueva) no admite entradas de texto. |
| Text Search | Búsqueda de texto (nueva) | |
| Place Details | Place Details (nuevo) | |
| Place Photo | Place Photo (nuevo) | |
| Place Autocomplete | Autocompletar (nuevo) | |
| Query Autocomplete | Autocompletar (nuevo) | Funciones agregadas a Autocomplete (nuevo) |
La versión del servicio de la API de Places que habilites 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 para tu app, esta no tendrá acceso a las APIs nuevas.
API de Places (nueva): Habilita todas las APIs y funciones nuevas que se describen en Funciones clave agregadas al SDK de Places para iOS (nueva). Tu app no tendrá acceso a las APIs existentes.
Ambas: Habilita todas las funciones y APIs del SDK de Places para iOS (nuevo) y del 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.
Migra a las nuevas APIs
Si usas una API existente y deseas migrar a la nueva, consulta las siguientes guías de migración para cada API:
- Cómo migrar a Nearby Search (nueva)
- Cómo migrar a Text Search (nuevo)
- Cómo migrar a Place Details (nuevo)
- Cómo migrar a Place Photo (nueva)
- Cómo migrar a Autocomplete (nuevo)
Funciones clave agregadas a la API de Places (nuevas)
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 de servicios de Google Cloud. Esta implementación brinda una plataforma más segura y confiable con opciones de seguridad mejoradas, como OAuth. El diseño de esta API estándar aporta un nivel de coherencia entre las APIs, lo que mejora la eficiencia del desarrollo con la API de Places (versión 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. 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, 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 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 valor de tipo único que se especifica como el tipo principal del lugar, como se indica en la Tabla A.
Además, la nueva API agrega los tipos de lugares que se muestran en la siguiente tabla. 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.
| 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 | granja | korean_restaurant | sporting_goods_store |
| barber_shop | turismo rural | 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 | parque | 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 |
Junto con estos tipos nuevos, la API de Places (nueva) trasladó los siguientes tipos de la Tabla 2 de la API de Places a la Tabla A de la API de Places (nueva). Esto significa que ahora puedes usar estos tipos como parte de una búsqueda:
countryadministrative_area_level_1administrative_area_level_2postal_codelocality
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.
¿Qué API eliges?
Antes de comenzar a desarrollar la app, debes elegir la 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 hay un reemplazo para una API existente, como el Autocompletado de lugares o el Autocompletado de consultas, puedes usar 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 (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.