La API de Places admite dos versiones de 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 la API nueva que reemplaza una API que usas en la actualidad.
| API de Places | API de Places (nuevo) | Nota |
|---|---|---|
| Find Place | Text Search (nueva) | No hay una versión nueva de Find Place. La búsqueda de texto (nueva) la reemplazó. |
| Nearby Search | 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 | Text Search (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 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 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 (nuevo). Tu app no tendrá acceso a las APIs existentes.
Ambos: Habilita todas las funciones y las APIs del 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.
Migra a las APIs nuevas
Si usas una API existente y deseas migrar a la nueva, consulta las siguientes guías de migración para cada API:
- Migrar a Nearby Search (nuevo)
- Cómo migrar a Text Search (nuevo)
- Cómo migrar a Place Details (nuevo)
- Cómo migrar a Place Photo (nuevo)
- Cómo migrar a Autocomplete (nuevo)
Funciones clave agregadas a la API de Places (nuevo)
En esta sección, se describen las funciones clave que se agregaron a la API de Places (nueva).
Se implementa en la plataforma estándar de Google Cloud
La API de Places (nueva) se implementa en la infraestructura de servicio en 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).
tiene un 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
La API de Places (versión nueva) simplifica los precios 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), debes usar la máscara de campo para controlar la lista de campos que se mostrarán en la respuesta. Entonces, 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 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 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 especificado como el tipo principal del lugar, según se muestra en la Tabla A.
Además, la nueva API agrega los tipos de lugares que se muestran en la siguiente tabla. Puedes usar estos nuevos tipos, 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 | alojamiento 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 |
| asesor | 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 |
Junto con estos nuevos tipos, la API de Places (nueva) movió los siguientes de la Tabla 2 para la API de Places a la Tabla A para la API de Places (nuevo). Eso significa que ahora puedes usar estos tipos como parte de una búsqueda:
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. Usa 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 hay un reemplazo para una API existente, como Place Autocomplete o Query Autocomplete, puedes usar una combinación de APIs nuevas y existentes.
Si eres un cliente existente, puedes seguir usando las APIs. 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.