La API de Places admite dos versiones de API: Las API de Places son las Las APIs existentes y la API de Places (Nuevo) son los siguientes de generación de demanda de las APIs.
Con el lanzamiento de la API de Places (nueva), tu primera tarea es decidir qué conjunto de APIs que debes usar. Esto se aplica a los clientes nuevos y el cliente ya usa las APIs. Usa esta guía para comprender la clave entre las dos APIs.
Lista de APIs
En la siguiente tabla, se enumeran ambos conjuntos de APIs. Si ya eres cliente, usar esta tabla para determinar la nueva API que reemplaza una API que en uso actualmente.
| 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 que incluyen una consulta de texto deben usar Text Search (nueva) porque Nearby Search (nuevo) 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 tan solo La API de Places está habilitada para el proyecto asociado con la clave de API que se usa para tu app, esta no tendrá acceso a las nuevas APIs.
API de Places (nueva): Habilita todas las APIs y funciones descritas en Funciones clave agregadas a SDK de Places para iOS (nuevo). Tu app no hará lo siguiente tienen acceso a las APIs existentes.
Ambos: Habilita todas las funciones y las APIs para ambos SDK de Places para iOS (nuevo) y SDK de Places para iOS:
Para obtener más información sobre cómo seleccionar el servicio de API de Places, consulta Configura tu proyecto de Google Cloud.
Migra a las APIs nuevas
Si usas una API existente y quieres migrar a la nueva, consulta la 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 del servicio en Google Cloud. Esta implementación brinda una experiencia más segura y confiable con opciones de seguridad mejoradas, como OAuth Esta API estándar el diseño genera un nivel de coherencia entre las APIs, lo que mejora la eficiencia del desarrollo con la API de Places (nuevo).
Mejor rendimiento
La API de Places (nueva) brinda un mejor rendimiento, por lo 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 y pagan por los datos que usas. Los precios simplificados se implementan usando un máscara de campo.
Con Place Details (nuevo), Nearby Search (nueva) Text Search (nueva): Se usa la máscara de campo para controlar el la lista de campos que la respuesta debe devolver. De este modo, solo se te facturará por los datos solicitado. Usar enmascaramiento de campo es una buena práctica de diseño para garantizar no solicite datos innecesarios, lo que ayuda a evitar tiempos de procesamiento innecesarios y cargos de facturación.
Datos de respuesta coherentes para un lugar
Con las APIs existentes, la API de Place Details, Nearby Search y Text Search Las APIs devuelven diferentes datos de respuesta para un sitio. API de Places (nuevo) 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. Todos los lugares pueden tener un valor de tipo único que se especifica como el tipo principal del lugar, según se indica en Tabla A:
Además, la nueva API agrega los tipos de lugares que se muestran en la siguiente tabla. Puedes usar estos nuevos tipos, junto con los existentes, en una búsqueda con Nearby Search (nuevo) y Text Search (nueva). Los nuevos tipos se incluyen en 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 | 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 | zona de juegos | 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) trasladó los siguientes tipos de la Tabla 2 para la API de Places a la Tabla A para la API de Places (nuevo). Esto significa que ahora puedes usar estos tipos 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 de una estación de carga de VE o los precios del combustible más recientes de una gasolinera. Usa estos campos de respuesta para crear experiencias de 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 luego, comenzar con las nuevas APIs.
Si eres un cliente nuevo y aún no hay un reemplazo para un API existente, como Place Autocomplete o Query Autocomplete, entonces podrás usar una combinación de APIs nuevas y existentes.
Si eres un cliente existente, puedes seguir usando el plan APIs Sin embargo, para aprovechar las mejoras en el rendimiento y las de la API de Places (nueva), puedes migrar a la APIs nuevas.
Para obtener más información sobre la migración, consulta Migración descripción general.