Les fonctionnalités du SDK Places pour iOS disponibles dans votre application sont déterminées par une combinaison du numéro de version du SDK (par exemple, 9.0.0) que vous spécifiez dans vos dépendances de paquets et des API activées sur votre clé API. Ce guide explique les différences entre les versions et comment sélectionner les versions à activer dans votre application.
Numéros de version du SDK
Le numéro de version du SDK que vous spécifiez dans vos dépendances de package détermine si votre application a accès aux fonctionnalités ajoutées dans une version particulière. Par exemple, la fonctionnalité de saisie semi-automatique (nouvelle) n'est disponible que dans la version 9.0.0 du SDK ou ultérieure.
Pour en savoir plus sur les modifications apportées à chaque version du SDK, consultez les notes de version du SDK Places pour iOS.
Versions de l'API Places pour le SDK Places pour iOS
En plus de spécifier un numéro de version du SDK, vous devez également sélectionner le service de l'API Places que le SDK appelle dans la Google Cloud Console: API Places ou API Places (nouvelle). Avec le numéro de version du SDK, le service d'API que vous sélectionnez détermine la version des fonctionnalités spécifiques disponibles dans votre application, telles que la saisie semi-automatique ou la saisie semi-automatique (nouvelle). Bien que vous ne puissiez spécifier qu'un seul numéro de version de SDK, vous pouvez activer à la fois l'API Places et l'API Places (nouvelle) sur votre clé API. Toutefois, dans la plupart des cas, vous devez activer l'API Places (nouvelle) et utiliser les versions (nouvelles) des fonctionnalités du SDK dans votre application.
Sélectionner votre version de SDK et vos services d'API
Pour sélectionner les fonctionnalités du SDK disponibles dans votre application, procédez comme suit:
- Dans votre projet Google Cloud, activez l'API Google Adresses, l'API Google Adresses (nouvelle) ou les deux. Pour en savoir plus, consultez Activer des API.
- Dans les restrictions de votre clé API, activez l'API Places, l'API Places (nouvelle) ou les deux. Pour en savoir plus, consultez Restreindre les clés API.
- Lorsque vous installez le SDK, spécifiez le numéro de version. Pour en savoir plus, consultez Configurer un projet Xcode.
Pour en savoir plus sur la sélection du service API Places, consultez Configurer votre projet Google Cloud.
Fonctionnalités du SDK disponibles dans chaque version
Le tableau suivant indique les versions de SDK et d'API requises pour chaque fonctionnalité de SDK:
| SDK Places pour iOS (nouveau) | Version minimale du SDK | SDK Places pour iOS | Version minimale du SDK |
|---|---|---|---|
| Informations sur le lieu (nouvelle version) | 9.0.0 | Place Details | 3.0.0 |
| Placer une photo (nouveau) | 9.0.0 | Placer une photo | 3.0.0 |
| Recherche textuelle (nouvelle) | 8.5.0 | ||
| Nearby Search (Nouveau) | 9.0.0 | ||
| Saisie semi-automatique (nouvelle) | 9.0.0 | Saisie semi-automatique | 3.0.0 |
| Current Place | 3.0.0 |
Éléments à prendre en compte pour choisir les versions à activer
- Si vous êtes un nouveau client qui commence à utiliser le SDK Places pour iOS, commencez par l'API Places (nouvelle) et le nouveau SDK.
- Si vous êtes un client existant, vous pouvez continuer à utiliser le SDK existant. Toutefois, pour profiter des améliorations de performances et des fonctionnalités du SDK Places pour iOS (nouveau), vous devez activer l'API Places (nouvelle) et utiliser le nouveau SDK. Aucune migration n'est nécessaire lors du passage au nouveau SDK. Il vous suffit de suivre la procédure décrite dans la section Sélectionner votre version de SDK et vos services d'API.
- L'API Places (nouvelle) n'active pas certaines fonctionnalités existantes, telles que Current Place (Lieu actuel),
GMSPlace.isOpenetGMSPlace.isOpenAtDate.
Utiliser le SDK Places Swift pour iOS (bêta)
Pour utiliser le SDK Places Swift pour iOS (bêta), procédez comme suit :
- Activez l'API Places (nouvelle version).
- Ajoutez le SDK Places Swift pour iOS (bêta) à vos dépendances.
- Initialisez le client Places avec
PlacesClient.
Pour en savoir plus sur le SDK Places Swift pour iOS (bêta), consultez la présentation ou le guide de migration.
Migrer vers les nouvelles API
Si vous utilisez une API existante et que vous souhaitez migrer vers la nouvelle API, consultez les guides de migration suivants pour chaque API:
- Migrater vers Place Details (Nouveau)
- Passer à Place Photo (nouvelle version)
- Migrer vers la saisie semi-automatique (nouveau)
Améliorations apportées au SDK Places pour iOS (nouveau)
Cette section présente les principales fonctionnalités ajoutées au SDK Places pour iOS (nouveau).
Implémenté sur la plate-forme standard Google Cloud
Le SDK Places pour iOS (nouveau) est implémenté sur l'infrastructure de service sur Google Cloud. Cette implémentation offre une plate-forme plus sécurisée et fiable. Cette conception standard offre un niveau de cohérence entre les SDK qui améliore l'efficacité du développement avec le SDK Places pour iOS (nouveau).
Performances améliorées
Le SDK Places pour iOS (nouveau) offre de meilleures performances, ce qui justifie le remplacement des applications qui utilisent le SDK existant.
Nouvelles fonctionnalités
Le SDK Places pour iOS (nouveau) inclut les dernières versions de toutes les fonctionnalités du SDK:
- Saisie semi-automatique (nouvelle)
- Informations sur le lieu (nouvelle version)
- Nearby Search (Nouveau)
- Placer des photos (nouveau)
- Recherche textuelle (nouvelle)
Tarification simplifiée
La tarification est simplifiée avec le SDK Places pour iOS (nouveau) afin que vous ne payiez que les données que vous utilisez. La tarification simplifiée est implémentée à l'aide de listes de champs, également appelées masques de champ.
Avec le SDK Places pour iOS et Text Search, vous utilisez des listes de champs pour contrôler la liste des champs à renvoyer dans la réponse. Seules les données demandées vous sont alors facturées. L'utilisation d'une liste de champs est une bonne pratique de conception pour vous assurer de ne pas demander de données inutiles. Vous pourrez ainsi réduire le temps de traitement et les frais facturés.
Pour en savoir plus sur la tarification des deux SDK, consultez la section Consommation et facturation.
Types de lieux étendus
Le nouveau SDK ajoute les types d'établissements indiqués dans le tableau suivant. Ces types sont renvoyés dans la réponse Place Details et Text Search. Vous pouvez également utiliser ces nouveaux types, ainsi que les types existants, dans une recherche avec la recherche textuelle. Les nouveaux types sont inclus dans le tableau A.
| Type | |||
|---|---|---|---|
| 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 | ferme | korean_restaurant | sporting_goods_store |
| barber_shop | vacances à la ferme | lebanese_restaurant | sports_club |
| bed_and_breakfast | fast_food_restaurant | Marina | sports_complex |
| brazilian_restaurant | ferry_terminal | marché | steak_house |
| breakfast_restaurant | fitness_center | medical_lab | sushi_restaurant |
| brunch_restaurant | french_restaurant | mediterranean_restaurant | swimming_pool |
| bus_stop | gift_shop | mexican_restaurant | tailleur |
| 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 |
| consultant | héliport | aire de jeux | vegetarian_restaurant |
| convention_center | hiking_area | centre préscolaire | vietnamese_restaurant |
| cottage | historical_landmark | private_guest_room | visitor_center |
| courier_service | home_improvement_store | ramen_restaurant | wedding_venue |
| cultural_center | auberge de jeunesse | resort_hotel | grossiste |
| dental_clinic | hotel | rest_stop |
En plus de ces nouveaux types, l'API Places (nouvelle) a déplacé les types suivants du tableau 2 de l'API Places vers le tableau A de l'API Places (nouvelle). Vous pouvez donc désormais utiliser ces types dans une recherche:
countryadministrative_area_level_1administrative_area_level_2postal_codelocality