Le SDK Places pour iOS version 8.5.0 est compatible avec deux versions : le SDK Places pour iOS est le SDK Places pour iOS (nouveau) qui est la version nouvelle génération du SDK.
Avec la sortie du SDK Places pour iOS version 8.5.0, votre première tâche consiste à choisir le SDK à utiliser. Cela est vrai si vous êtes un nouveau client ou un client existant qui utilise déjà le SDK. Consultez ce guide pour comprendre les principales différences entre les deux SDK.
Sélectionner la version de votre SDK
Le SDK Places pour iOS repose sur le service de l'API Places. Avant de pouvoir utiliser le SDK Places pour iOS, vous devez activer le service de l'API Places dans votre projet Google Cloud.
La version du service de l'API Places que vous activez contrôle la version du SDK utilisée par votre application:
API Places: active le SDK Places pour iOS existant. Si seule l'API Places est activée pour le projet associé à la clé API utilisée pour votre application, celle-ci n'aura pas accès aux nouvelles fonctionnalités ajoutées dans le SDK Places pour iOS version 8.5.0 ou ultérieure.
API Places (nouvelle version): active le SDK Places pour iOS (nouvelle version), y compris Text Search et toutes les nouvelles fonctionnalités décrites dans la section Principales fonctionnalités ajoutées au SDK Places pour iOS (nouveau). N'active pas les fonctionnalités existantes telles que Place Details, Place Photos, Current Place et Place Autocomplete.
Les deux: active toutes les fonctionnalités du SDK Places pour iOS (nouveau) et du SDK Places pour iOS.
Pour en savoir plus sur la sélection du service de l'API Places, consultez Configurer votre projet Google Cloud.
Quel SDK choisissez-vous ?
Pour vous aider à choisir quelle version choisir:
Si vous êtes un nouveau client qui fait vos premiers pas avec le SDK Places pour iOS, commencez avec l'API Places (nouvelle version) et l'API Places pour accéder à toutes les fonctionnalités.
Si vous êtes un client existant, vous pouvez continuer à utiliser le SDK existant. Toutefois, vous pouvez utiliser le nouveau SDK pour profiter des améliorations de performances et des fonctionnalités du SDK Places pour iOS (nouveau).
Aucune migration n'est nécessaire lorsque vous passez au nouveau SDK. Il vous suffit d'activer le SDK Places pour iOS (Nouveau) sur la clé API utilisée dans votre application. Si vous utilisez à la fois le SDK Places pour iOS et le SDK Places pour iOS (Nouveau), activez les deux versions sur votre clé API. Pour en savoir plus, consultez la page Utiliser des clés API.
Principales fonctionnalités ajoutées au SDK Places pour iOS (nouveau)
Cette section couvre les principales fonctionnalités ajoutées au SDK Places pour iOS (nouveau).
Mise en œuvre sur la plate-forme standard Google Cloud
Le SDK Places pour iOS (nouveau) est mis en œuvre sur l'infrastructure de service de Google Cloud. Cette implémentation apporte une plate-forme plus sûre et plus fiable. Cette conception standard apporte un niveau de cohérence entre les SDK qui améliorent 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 facilite le remplacement des applications qui utilisent le SDK existant.
Nouveau service Text Search
Text Search renvoie des informations sur un ensemble de lieux en fonction d'une chaîne (par exemple, "pizza à New York", "magasins de chaussures près d'Ottawa" ou "123 Main Street"). Le service répond avec une liste des lieux correspondant à la chaîne de texte et aux limitations de zone géographique définis.
Tarification simplifiée
La tarification est simplifiée avec le SDK Places pour iOS (nouveau) afin que vous ne payiez que pour les données que vous utilisez. La tarification simplifiée est mise en œuvre à 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. Vous n'êtes ensuite facturé que pour les données demandées. L'utilisation d'une liste de champs est une bonne pratique à appliquer 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 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és dans la réponse Place Details et 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 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 | 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 | playground | 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 |
countryadministrative_area_level_1administrative_area_level_2postal_codelocality