La versión 8.5.0 del SDK de Places para iOS admite dos versiones del SDK: SDK de Places para iOS es el SDK de Places para iOS (nuevo) existente y la versión de nueva generación del SDK.
Con el lanzamiento del SDK de Places para iOS versión 8.5.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
El SDK de Places para iOS se basa en el servicio de la API de Places. Antes de poder usar el SDK de Places para iOS, 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: Habilita el SDK de Places para iOS existente. Si solo está habilitada la API de Places para el proyecto asociado a la clave de API que se usa en tu app, esta no tendrá acceso a las funciones nuevas que se agregaron en el SDK de Places para iOS 8.5.0 y versiones posteriores.
API de Places (nuevo): Habilita el SDK de Places para iOS (nuevo), incluido Text Search y todas las funciones nuevas que se describen en Funciones clave agregadas al SDK de Places para iOS (nuevo). No habilita funciones existentes, como Place Details, Place Photos, Current Place y Place Autocomplete.
Ambos: Habilita todas las funciones del SDK de Places para iOS (nuevo) y el SDK de Places para iOS.
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:
Si eres un cliente nuevo que recién comienzas a usar el SDK de Places para iOS, comienza con la API de Places (nuevo) y la API de Places para tener acceso a todas las funciones.
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 iOS (versión nueva), puedes usar el SDK nuevo.
No es necesario realizar una migración cuando se pasa al SDK nuevo. Solo debes habilitar el SDK de Places para iOS (nuevo) en la clave de API que se usa en tu app. Si usas el SDK de Places para iOS y el SDK de Places para iOS (nuevo), habilita ambas versiones en tu clave de API. Para obtener más información, consulta Cómo utilizar las claves de API.
Se agregaron funciones clave al SDK de Places para iOS (nuevo)
En esta sección, se describen las funciones clave que se agregan al SDK de Places para iOS (nuevo).
Implementado en la plataforma estándar de Google Cloud
El SDK de Places para iOS (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 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.
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.
Precios simplificados
Con el SDK de Places para iOS (versión nueva), se simplifican los precios, de modo que solo pagues por los datos que utilices. 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, usas listas de campos para controlar la lista de campos que se mostrarán 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 |
countryadministrative_area_level_1administrative_area_level_2postal_codelocality