Elige tu versión del SDK

Las funciones del SDK de Places para Android que están disponibles en tu app tienen las siguientes características: determinada por una combinación del número de versión del SDK (p.ej., 3.5.0) que especificar en la configuración de tu app, las APIs habilitadas para tu clave de API y cómo inicializa tu app. En esta guía, se explican las diferencias entre las versiones y cómo seleccionar qué versiones están habilitadas en tu app.

Números de versión del SDK

Es el número de versión del SDK que especificas en el archivo build.gradle del nivel de tu app. determina si tu app tiene acceso a las funciones que se agregaron en un lanzamiento en particular. Por ejemplo, Autocomplete (nuevo) solo está disponible en el SDK. versión 3.5.0 o superior.

Para obtener más información sobre los cambios introducidos en cada versión del SDK, consulta el artículo Places Versión del SDK para Android notas.

Versiones de la API de Places del SDK de Places para Android

Además de especificar un número de versión del SDK, también debes seleccionar el dominio servicio de API que el SDK llama en la consola de Google Cloud: ya sea la API de Places o API de Places (nueva). Junto con el número de versión del SDK, el servicio de API que Seleccionar determina la versión de las funciones específicas que están disponibles en tu app como Autocomplete o Autocomplete (nuevo). Si bien solo puedes especificar un SDK número de versión, puedes habilitar tanto la API de Places como la API de Places (nueva) en tu clave de API al mismo tiempo y, luego, selecciona a qué servicio llama el SDK el método que usas para inicializar el SDK en tu app. Sin embargo, en la mayoría de los casos, deseas habilitar la API de Places (nuevo) y usar las versiones (nueva) de la API de Places del SDK de tu app.

Selecciona tu versión del SDK y los servicios de la API

Para seleccionar qué funciones del SDK están disponibles en tu app, haz lo siguiente:

  1. En tu proyecto de Google Cloud, habilita la API de Places, la API de Places (nueva) o ambos. Para obtener más información, consulta Cómo habilitar APIs
  2. En las restricciones de tu clave de API, habilita la API de Places, la API de Places (nueva) o ambos. Para obtener más información, consulta Cómo restringir la API claves.
  3. En el archivo build.gradle de nivel de la app, especifica un número de versión. Para ver más información, consulta Instalación.

  4. Inicializa tu app llamando al Places.initializeWithNewPlacesApiEnabled() o Places.initialize() .

Para obtener más información sobre cómo seleccionar el servicio de API de Places, consulta Configurar tu proyecto de Google Cloud.

Funciones del SDK disponibles en cada versión

En la siguiente tabla, se muestran las versiones de SDK y API necesarias para cada SDK atributo:

Función API de Places habilitada en la clave de API Método de inicialización Versión mínima del SDK
Autocompletar (nuevo) API de Places (nuevo) initializeWithNewPlacesApiEnabled() 3.5.0
Place Details (nuevo) API de Places (nuevo) initializeWithNewPlacesApiEnabled() 3.3.0
Nearby Search (nuevo) API de Places (nuevo) initializeWithNewPlacesApiEnabled() 3.5.0
Place Photos (nuevo) API de Places (nuevo) initializeWithNewPlacesApiEnabled() 3.4.0
Text Search (nueva) API de Places (nuevo) initializeWithNewPlacesApiEnabled() 3.3.0
Place Autocomplete API de Places initialize()
Current Place API de Places initialize()
Place Details API de Places initialize()
Fotos de lugares API de Places initialize()

Consideraciones para elegir qué versiones habilitar

Para ayudarte a decidir qué versión elegir, ten en cuenta lo siguiente:

  • Si eres un cliente nuevo que recién comienza a usar el SDK de Places para Android Luego, comienza con la API de Places (nueva) y el SDK nuevo.
  • Si ya eres cliente, puedes seguir usando el SDK existente. Sin embargo, para aprovechar las mejoras en el rendimiento y la mejoras del SDK de Places para Android (nuevo), debes utilizar el nuevo SDK de Google Cloud. No es necesario realizar una migración cuando se pasa al nuevo SDK, solo sigue sigue los pasos que se indican en Cómo seleccionar la versión del SDK y la API Google Cloud.
  • En el SDK de Places para Android (nuevo), los tokens de sesión están disponibles a partir del en la versión 3.5.0. Para obtener más información, consulta Sesión tokens.
  • Las llamadas que se realizan con los widgets de Place Autocomplete siempre llaman a Place Autocompletar, no Place Autocomplete (nuevo); las llamadas del widget no se ven afectadas método de inicialización.
  • Place Photos (nuevo) solo devuelve un URI a una imagen de mapa de bits, mientras que Place Fotos solo devuelve un mapa de bits. imagen.
  • El lugar actual es Solo está disponible en el SDK de Places para Android, no en el SDK de Places para Android. (Nuevo).

Mejoras en el SDK de Places para Android (nuevo)

En esta sección, se describen las funciones clave que se agregaron al SDK de Places para Android (versión nueva).

Se implementa en la plataforma estándar de Google Cloud

El SDK de Places para Android (nuevo) se implementa en el servicio infraestructura en Google Cloud. Esta implementación proporciona una plataforma más segura y confiable. Este diseño estándar aporta un nivel de coherencia entre los SDK que mejora la eficiencia del desarrollo con el SDK de Places para Android (Nuevo).

Mejor rendimiento

El SDK de Places para Android (nuevo) brinda un mejor rendimiento, por lo que y vale la pena reemplazar las apps que usan el SDK existente.

Nuevas funciones

El SDK de Places para Android (nuevo) incluye las versiones más recientes de todo el SDK. atributos:

Nuevo servicio de Text Search

Text Search (nueva) devuelve información sobre un conjunto de lugares basados en una cadena (por ejemplo, "pizza en Nueva York"). o "tiendas de zapatos cerca de Ottawa" o “Calle Principal 123”. El servicio responde con una lista de lugares que coinciden con la cadena de texto y cualquier personalización de ubicación que se haya establecido.

Se agregaron nuevos datos de respuesta a Placed Details (nuevo) y Place Photos (nuevo).

  • Place Details (Nuevo) ahora incluye el nuevo Repaso en el objeto Place de respuesta. El Clase Place Contiene el nuevo método getReviews() para admitir este campo. Llamada getReviews() para mostrar hasta cinco opiniones sobre un lugar

  • Place Photo (Nuevo) agrega el AuthorAttributions a la clase PhotoMetadata. AuthorAttributions contiene una List de AuthorAttribution objetos.

Se agregó una nueva respuesta de URI a Place Photos (nuevo)

Ahora puedes usar Place Photo (Nuevo) para mostrar un URI a un mapa de bits de imagen. Anteriormente, solo podías devolver el mapa de bits de la imagen.

Precios simplificados

Los precios se simplifican con el SDK de Places para Android (nuevo) para que solo y pagan por los datos que usas. Los precios simplificados se implementan usando listas de campos, también llamadas máscaras de campo.

Con Place Details y Text Search, usas listas de campos para controlar la lista de para devolver en la respuesta. De este modo, solo se te facturará por los datos solicitado. Usar una lista de campos es una buena práctica de diseño para solicitar datos innecesarios, lo que ayuda a evitar tiempos de procesamiento y cargos de facturación.

Para obtener información detallada sobre los precios de ambos SDK, consulta Uso y Facturación.

Tipos de lugares expandidos

El nuevo SDK agrega los tipos de lugares que se muestran en la siguiente tabla. Estos tipos son se devuelven como parte de los detalles de Es la respuesta de Text Search. También puedes usar estos nuevos tipos, y los tipos existentes, en una búsqueda con Text Search. Los nuevos tipos se incluyen en la Tabla R:

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) movió 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