Las funciones del SDK de Places para iOS que están 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 tu paquete 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 introdujeron 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 para el 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 la API que selecciones determina qué versión de funciones específicas está disponible en tu app, como Autocomplete o Autocomplete (New). 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 la 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:
- 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
- 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 Cómo restringir las claves de API.
- 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 de SDK y API que se requieren para cada función del SDK:
SDK de Places para iOS (nuevo) | Versión mínima del SDK | SDK de Places para iOS | Versión mínima del SDK |
---|---|---|---|
Place Details (nuevo) | 9.0.0 | Place Details | 3.0.0 |
Place Photo (nuevo) | 9.0.0 | Foto de lugar | 3.0.0 |
Búsqueda de texto (nueva) | 8.5.0 | ||
Nearby Search (nuevo) | 9.0.0 | ||
Autocompletar (nuevo) | 9.0.0 | Autocompletar | 3.0.0 |
Current Place | 3.0.0 |
Consideraciones para elegir qué versiones habilitar
- Si eres un cliente nuevo que acaba de comenzar a usar el SDK de Places para iOS, comienza con la API de Places (nueva) y el nuevo SDK.
- Si ya eres cliente, puedes seguir usando el SDK existente. Sin embargo, para aprovechar las mejoras de rendimiento y las mejoras de funciones del SDK de Places para iOS (nuevo), debes habilitar la API de Places (nueva) y usar el nuevo SDK. 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
yGMSPlace.isOpenAtDate
.
Usa el SDK de Places para Swift en iOS (versión preliminar)
Los siguientes pasos son obligatorios para usar el SDK de Places Swift para iOS (versión preliminar):
- Habilita la API de Places (versión nueva).
- Agrega el SDK de Places para Swift para iOS (versión preliminar) a tus dependencias.
- Inicializa el cliente de Places con
PlacesClient
.
Para obtener más información sobre el SDK de Places Swift para iOS (versión preliminar), consulta la descripción general o la guía de migración.
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:
- Cómo migrar a Place Details (nuevo)
- Cómo migrar a Place Photo (nueva)
- Cómo migrar a Autocomplete (nuevo)
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 implementó en la plataforma estándar de Google Cloud
El SDK de Places para iOS (nuevo) se implementa en la infraestructura de servicios en Google Cloud. Esta implementación brinda una plataforma más segura y confiable. Este diseño estándar brinda un nivel de coherencia entre los SDKs que mejora la eficiencia del desarrollo con el SDK de Places para iOS (nuevo).
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.
Nuevas funciones
El SDK de Places para iOS (nuevo) incluye las versiones más recientes de todas las funciones del SDK:
- Autocompletar (nuevo)
- Place Details (nuevo)
- Nearby Search (nuevo)
- Place Photos (versión nueva)
- Búsqueda de texto (nueva)
Precios simplificados
Los precios se simplifican con el SDK de Places para iOS (nuevo) para 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 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 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 adicionales.
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 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 tipos nuevos y los existentes en una búsqueda con la Búsqueda de texto. 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 | granja | korean_restaurant | sporting_goods_store |
barber_shop | turismo 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 |
consultor | helipuerto | parque | 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, la API de Places (nueva) trasladó los siguientes tipos de la Tabla 2 de la API de Places a la Tabla A de la API de Places (nueva). Esto 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