Elige la versión de tu API

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:

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). Todos los tipos nuevos 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:

  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality

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 de 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:

  1. Si eres un cliente nuevo que recién comienza a usar la API de Places luego, comenzar con las nuevas APIs.

  2. 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.

  3. 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.