Las funciones del SDK de Places para iOS que están disponibles en tu aplicaciones están determinadas por una combinación del número de versión del SDK (p.ej., 9.0.0) que que especifiques en las dependencias de tu paquete, así como en las APIs habilitadas para 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 tus dependencias de paquetes determina si tu app tiene acceso a funciones que se agregaron en un lanzamiento en particular. Por ejemplo, Autocomplete (nuevo) solo está disponible en el SDK. versión 9.0.0 o superior.
Para obtener más información sobre los cambios introducidos en cada versión del SDK, consulta el artículo Places Notas de la versión del SDK 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 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. Sin embargo, en la mayoría de los casos, querrás habilitar API de Places (nueva) y usa las versiones (nuevas) 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:
- 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
- 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.
- 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 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 | 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 nuevo SDK.
- Si ya eres cliente, puedes seguir usando el SDK existente. Sin embargo, para aprovechar las mejoras en el rendimiento y las funciones mejoras del SDK de Places para iOS (nuevo), deberías habilitar la API de Places (Nuevo) y usar el nuevo SDK. No es necesario migrar a el nuevo SDK, sigue los pasos que se indican en Selecciona la versión del SDK y la API Google Cloud.
- La API de Places (nueva) no habilita algunas
funciones como Current
Lugar,
GMSPlace.isOpenyGMSPlaceisOpenAtDate.
Cómo usar la versión preliminar de GooglePlacesSwift
Los siguientes pasos son obligatorios para utilizar GooglePlacesSwift:
- Habilitar la API de Places (Nuevo).
- Agrega el GooglePlacesSwiftSDK a tus dependencias.
- Inicializa el cliente de Places con
PlacesClient
Para obtener más información sobre GooglePlacesSwift, consulta la referencia documentación.
Migra a las APIs nuevas
Si usas una API existente y quieres migrar a la nueva, consulta la las siguientes guías de migración para cada API:
- Cómo migrar a Place Details (nuevo)
- Cómo migrar a Place Photo (nuevo)
- 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 (Nuevo).
Se implementa en la plataforma estándar de Google Cloud
El SDK de Places para iOS (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 iOS (Nuevo).
Mejor rendimiento
El SDK de Places para iOS (nuevo) brinda un mejor rendimiento, lo que facilita vale la pena reemplazar las apps que usan el SDK existente.
Nuevas funciones
El SDK de Places para iOS (nuevo) incluye las últimas versiones de todas las funciones del SDK:
- Autocompletar (nuevo)
- Place Details (nuevo)
- Nearby Search (nuevo)
- Place Photos (nuevo)
- Text Search (nueva)
Precios simplificados
Los precios se simplifican con el SDK de Places para iOS (nuevo) para que solo pagas por los datos que usas. Los precios simplificados se implementan usando campos también llamadas máscaras de campo.
Con el SDK de Places para iOS 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) trasladó 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:
countryadministrative_area_level_1administrative_area_level_2postal_codelocality