Elige la versión de tu API

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)

Si usas una API existente y deseas migrar a la nueva API, consulta las siguientes guías de migración para cada API:

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
Junto con estos tipos nuevos, el SDK de Places para Android (nuevo) movió los siguientes tipos de la Tabla B de la Tabla A. Eso significa que ahora puedes usar estos tipos como parte de una 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 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:

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

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

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