Le SDK Places pour les fonctionnalités iOS disponibles dans votre application sont déterminés par une combinaison du numéro de version du SDK (par exemple, 9.0.0) qui que vous spécifiez dans vos dépendances de package et les API activées sur votre clé API. Ce guide explique les différences entre les versions et explique comment sélectionner celles que versions de pare-feu sont activées dans votre application.
Numéros de version du SDK
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 un une sortie en particulier. Par exemple, la saisie semi-automatique (nouveau) n'est disponible que dans le SDK. version 9.0.0 ou ultérieure.
Pour en savoir plus sur les modifications apportées dans chaque version du SDK, consultez la page Places Notes de version du SDK 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 les objets Service d'API appelé par le SDK dans la console Google Cloud: soit l'API Places, soit API Places (nouvelle version) Avec le numéro de version du SDK, le service d'API « select » détermine quelle version de fonctionnalités spécifiques est disponible dans votre application, telles que Autocomplete ou Autocomplete (Nouveau). Vous ne pouvez spécifier qu'un seul SDK vous pouvez activer à la fois l'API Places et l'API Places (nouvelle version) sur votre de clé API en même temps. Toutefois, dans la plupart des cas, il est préférable d'activer le paramètre API Places (nouvelle version) et utiliser les versions (nouvelles) des fonctionnalités du SDK dans votre application.
Sélectionnez la version du SDK et les 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 Places, l'API Places (nouvelle version) ou les deux. Pour en savoir plus, consultez la section Activer API
- Dans vos restrictions de clés API, activez l'API Places, l'API Places (nouvelle version) ou les deux. Pour en savoir plus, consultez la page Restreindre l'API clés.
- Lorsque vous installez le SDK, spécifiez le numéro de version. Pour plus d'informations, consultez la section Configurer un projet Xcode.
Pour en savoir plus sur la sélection du service de l'API Places, consultez la section 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 SDK fonctionnalité:
| Fonctionnalité | API Places activée sur la clé API | Version minimale du SDK |
|---|---|---|
| Saisie semi-automatique (nouveauté) | API Places (New) | 9.0.0 |
| Place Details (New) | API Places (New) | 9.0.0 |
| Nearby Search (nouveau) | API Places (New) | 9.0.0 |
| Place Photos (nouveauté) | API Places (New) | 9.0.0 |
| Text Search (nouvelle version) | API Places (New) | 8.5.0 |
| Place Autocomplete | API Places | 3.0.0 |
| Current Place | API Places | 3.0.0 |
| Place Details | API Places | 3.0.0 |
| Place Photos | API Places | 3.0.0 |
Éléments à prendre en compte pour choisir les versions à activer
- Si vous êtes un nouveau client et que vous commencez tout juste à utiliser le SDK Places pour iOS, commencez par l'API Places (nouvelle version) et le nouveau SDK.
- Si vous êtes déjà client, vous pouvez continuer à utiliser le SDK existant. Toutefois, pour profiter des améliorations de performances améliorations du SDK Places pour iOS (nouveau), vous devez activer l'API Places (Nouveau) et utilisez le nouveau SDK. Aucune migration n'est nécessaire lorsque vous passez à le nouveau SDK, suivez les étapes de la section Sélectionner la version du SDK et l'API Google Cloud.
- L'API Places (nouvelle version) n'active pas certaines autorisations
des fonctionnalités comme Current
Lieu
GMSPlace.isOpenetGMSPlaceisOpenAtDate.
Utiliser la version preview de GooglePlacesSwift
Pour utiliser GooglePlacesSwift, procédez comme suit:
- Activer l'API Places (Nouveau).
- Ajoutez le GooglePlacesSwiftSDK à vos dépendances.
- Initialiser le client Places avec
PlacesClient
Pour en savoir plus sur GooglePlacesSwift, consultez la documentation de référence documentation.
Migrer vers les nouvelles API
Si vous utilisez une API existante et souhaitez passer à la nouvelle API, consultez la les guides de migration suivants pour chaque API:
- Migrer vers Place Details (nouveau)
- Migrer vers Place Photo (nouveau)
- 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ée sur la plate-forme standard Google Cloud
Le SDK Places pour iOS (nouveau) est implémenté sur le service de l'infrastructure cloud sur Google Cloud. Cette implémentation offre une plate-forme plus sécurisée et plus fiable. Cette conception standard apporte un niveau de cohérence entre les SDK, ce qui améliore l'efficacité du développement avec le SDK Places pour iOS (Nouveau).
Performances améliorées
Le SDK Places pour iOS (nouvelle version) offre de meilleures performances : de remplacer celles 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 (nouveauté)
- Place Details (New)
- Nearby Search (nouveau)
- Place Photos (nouveauté)
- Text Search (nouvelle version)
Tarification simplifiée
Avec le SDK Places pour iOS (nouveau), la tarification est simplifiée. vous ne payez que pour les données que vous utilisez. La tarification simplifiée est mise en œuvre à l'aide de champs ou listes, également appelées masques de champ.
Avec le SDK Places pour iOS et Text Search vous permet d'utiliser des listes de champs pour contrôler la liste champs à renvoyer dans la réponse. Vous ne payez alors que les données demandée. L'utilisation d'une liste de champs est une bonne pratique de conception pour s'assurer que vous ne demander des données inutiles, ce qui permet d'éviter des délais de traitement et frais facturés.
Pour obtenir des informations détaillées sur la tarification des deux SDK, consultez la section Utilisation et Facturation.
Types de lieux développés
Le nouveau SDK ajoute les types de lieux indiqués dans le tableau suivant. Ces types sont renvoyées dans les champs Place Details Réponse Text Search. Vous pouvez également utiliser ces nouveaux types, et les types existants, dans une recherche avec Text Search. Les nouveaux types sont inclus dans le Tableau R.
| 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 | 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 |
Parallèlement à ces nouveaux types, l'API Places (nouvelle version) a déplacé les types suivants du tableau 2 pour l'API Places au tableau A pour l'API Places (nouvelle version). Vous pouvez donc désormais utiliser ces types dans un recherche:
countryadministrative_area_level_1administrative_area_level_2postal_codelocality