Elige tu versión del SDK

Las funciones del SDK de Places para iOS disponibles en tu app se determinan mediante una combinación del número de versión del SDK (p.ej., 9.0.0) que especificas en las dependencias de tu paquete y las APIs habilitadas en tu clave de API. En esta guía, se explican las diferencias entre las versiones y cómo seleccionar las que están habilitadas en tu app.

Números de versión del SDK

El número de versión del SDK que especificas en las dependencias de paquetes determina si tu app tiene acceso a las funciones que se agregaron en una versión en particular. Por ejemplo, Autocomplete (nuevo) solo está disponible en la versión 9.0.0 o posterior del SDK.

Para obtener más información sobre los cambios que se introducen en cada versión del SDK, consulta las notas de la versión del SDK de Places para iOS.

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

Además de especificar un número de versión del SDK, también debes seleccionar el servicio de la API de Places al que llama el SDK en Google Cloud Console: API de Places o API de Places (nueva). Junto con el número de versión del SDK, el servicio de API que selecciones determinará la versión de las funciones específicas que estarán disponibles en tu app, como Autocomplete o Autocomplete (nuevo). Si bien solo puedes especificar un número de versión del SDK, puedes habilitar la API de Places y la API de Places (nueva) en tu clave de API al mismo tiempo. Sin embargo, en la mayoría de los casos, deberás habilitar la API de Places (nueva) y usar las versiones (nueva) de las funciones del SDK en 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 ambas. Para obtener más información, consulta Cómo habilitar las APIs
  2. En las restricciones de tu clave de API, habilita la API de Places, la API de Places (nueva) o ambas. Para obtener más información, consulta Restringe las claves de API.
  3. Cuando instales el SDK, especifica el número de versión. Para obtener más información, consulta Configura un proyecto Xcode.

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

Funciones del SDK disponibles en cada versión

En la siguiente tabla, se muestran las versiones del SDK y de la API que se requieren para cada función del SDK:

Función API de Places habilitada en la clave de API Versión mínima del SDK
Autocompletar (nuevo) API de Places (nuevo) 9.0.0
Place Details (nuevo) API de Places (nuevo) 9.0.0
Nearby Search (nuevo) API de Places (nuevo) 9.0.0
Place Photos (nuevo) API de Places (nuevo) 9.0.0
Text Search (nueva) API de Places (nuevo) 8.5.0
Place Autocomplete API de Places 3.0.0
Current Place API de Places 3.0.0
Place Details API de Places 3.0.0
Fotos de lugares API de Places 3.0.0

Consideraciones para elegir qué versiones habilitar

  • Si eres un cliente nuevo que recién comienza a usar el SDK de Places para iOS, 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 de rendimiento y de funciones del SDK de Places para iOS (nuevo), debes habilitar la API de Places (nueva) y usar el SDK nuevo. No es necesario realizar una migración cuando migras al SDK nuevo; solo sigue los pasos que se indican en Selecciona la versión del SDK y los servicios de la API.
  • La API de Places (nueva) no habilita algunas funciones existentes, como Current Place, GMSPlace.isOpen y GMSPlaceisOpenAtDate.

Cómo usar la versión preliminar de GooglePlacesSwift

Si deseas usar la versión preliminar de GooglePlacesSwift versión 0.1.0, habilita la API de Places (nueva) y, luego, instala el SDK de GooglePlacesSwift.

Migra a las APIs nuevas

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

Mejoras en el SDK de Places para iOS (nuevo)

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

Se implementa en la plataforma estándar de Google Cloud

El SDK de Places para iOS (nuevo) se implementa en la infraestructura de servicios de 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 SDKs, lo que mejora la eficiencia del desarrollo con el SDK de Places para iOS (nuevo).

tiene un rendimiento mejorado.

El SDK de Places para iOS (nuevo) proporciona un rendimiento mejorado, por lo que vale la pena reemplazar las apps que usan el SDK existente.

Funciones nuevas

El SDK de Places para iOS (nuevo) incluye las versiones más recientes de todas las funciones del SDK:

Precios simplificados

Los precios se simplifican con el SDK de Places para iOS (nuevo) para que solo pagues por los datos que uses. Los precios simplificados se implementan mediante listas de campos, también llamadas máscaras de campo.

Con el SDK de Places para iOS y Text Search, puedes usar listas de campos para controlar la lista de campos que se mostrará en la respuesta. Entonces, solo se te factura 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 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 se muestran como parte de la respuesta de Place Details y Text Search. También puedes usar estos nuevos tipos, 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 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 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 nuevos tipos, la API de Places (nueva) movió los siguientes de la Tabla 2 para la API de Places a la Tabla A para la API de Places (nuevo). 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