Elige tu versión del SDK

La versión 3.3.0 del SDK de Places para Android admite dos versiones del SDK: SDK de Places para Android es el SDK existente y SDK de Places para Android (nuevo) es la versión de nueva generación del SDK.

Con el lanzamiento del SDK de Places para Android versión 3.3.0, tu primera tarea es decidir qué SDK usar. Esto es así si eres un cliente nuevo o un cliente existente que ya usa el SDK. Usa esta guía para comprender las diferencias clave entre los dos SDKs.

Cómo seleccionar tu versión del SDK

En el backend, el SDK de Places para Android se basa en el servicio de la API de Places. Antes de poder usar el SDK de Places para Android, debes habilitar el servicio de la API de Places en tu proyecto de Google Cloud.

La versión del servicio de la API de Places que habilitas controla la versión del SDK que usa tu app:

  • API de Places (nuevo): Habilita las funciones del SDK de Places para Android (versión nueva) y todas las demás funciones nuevas que se describen en Funciones clave agregadas al SDK de Places para Android (versión nueva).

  • API de Places: Habilita el SDK de Places para Android existente, de modo que no tengas acceso a las funciones nuevas que se agregaron en la versión 3.3.0 del SDK de Places para Android.

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

¿Qué SDK eliges?

Para ayudarte a decidir qué versión elegir, haz lo siguiente:

  1. Si eres un cliente nuevo que recién comienzas a usar el SDK de Places para Android, comienza con la API de Places (versión nueva) y el SDK nuevo.

  2. Si eres desarrollador de Kotlin, puedes usar cualquiera de los SDK, pero las funciones nuevas del SDK de Places para Android (versión nueva) solo están disponibles en Java en la versión 3.3.0.

  3. Si eres un cliente existente y usas tokens de sesión, sigue usando el SDK existente. Por el momento, el SDK de Places para Android (nuevo) no admite tokens de sesión.

  4. Si eres un cliente existente, puedes seguir usando el SDK existente. Sin embargo, para aprovechar las mejoras de rendimiento y las mejoras de funciones del SDK de Places para Android (versión nueva), puedes usar el SDK nuevo.

    No es necesario realizar una migración cuando se pasa al SDK nuevo. Solo tienes que hacer lo siguiente:

    1. Habilita la API de Places (versión nueva) en la clave de API que se usa en tu app. Si usas el SDK de Places para Android existente y el SDK de Places para Android (versión nueva), te recomendamos que crees una clave de API diferente para cada versión de la API. Para obtener más información, consulta Usar claves de API.
    2. En la sección dependencies de tu archivo build.gradle a nivel del módulo, actualiza la dependencia places y agrega la dependencia kotlin-bom:

        dependencies {
            implementation(platform("org.jetbrains.kotlin:kotlin-bom:1.8.0"))
            implementation 'com.google.android.libraries.places:places:3.3.0'
        }

      Para obtener más información sobre la dependencia kotlin-bom, consulta Uso de la versión más reciente de kotlin-stdlib en dependencias transitivas.

    3. Actualiza tu app existente para llamar al nuevo método Places.initializeWithNewPlacesApiEnabled() e inicializar la app. Para obtener más información, consulta Cómo inicializar el cliente de la API de Places.

    Tus apps existentes continúan funcionando sin cambios, pero ahora puedes aprovechar todas las funciones nuevas del SDK.

Se agregaron funciones clave al 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).

Implementado en la plataforma estándar de Google Cloud

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

tiene un rendimiento mejorado.

El SDK de Places para Android (versión nueva) proporciona un rendimiento mejorado, por lo que vale la pena reemplazar las apps que usan el SDK existente.

Nuevo servicio de Text Search

Text Search muestra información sobre un conjunto de lugares en función de una cadena; por ejemplo, "pizza en Buenos Aires", "tiendas de zapatos cerca de Santiago" o "Calle principal 123". El servicio responde con una lista de lugares que coinciden con la cadena de texto y con cualquier personalización de ubicación que se haya establecido.

Se agregaron nuevos datos de respuesta a Placed Details y Place Photos

  • Place Details ahora incluye la nueva clase Review en el objeto Place de respuesta. La clase Place contiene el nuevo método getReviews() para admitir este campo. Llama a getReviews() para mostrar hasta cinco opiniones de un lugar.

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

Precios simplificados

Con el SDK de Places para Android (versión nueva), los precios se simplifican a fin de que solo pagues por los datos que usas. Los precios simplificados se implementan mediante 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 campos que se debe mostrar en la respuesta. Entonces, solo se te facturará por los datos solicitados. Usar una lista de campos 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.

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

Tipos de lugares expandidos

El nuevo SDK agrega los tipos de sitios que se muestran en la siguiente tabla. Estos tipos se muestran como parte de las respuestas de Place Details y Text Search. También puedes usar estos tipos nuevos y los existentes en una búsqueda con Text Search. 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