Les fonctionnalités du SDK Places pour Android disponibles dans votre application sont les suivantes : déterminé par une combinaison du numéro de version du SDK (par exemple, 3.5.0) que vous spécifier dans la configuration de votre application, les API activées sur votre clé API et la manière dont vous pour initialiser votre application. Ce guide explique les différences entre les versions et comment sélectionner les versions activées dans votre application.
Numéros de version du SDK
Numéro de version du SDK que vous spécifiez dans le fichier build.gradle au niveau de l'application 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 3.5.0 ou ultérieure.
Pour en savoir plus sur les modifications apportées dans chaque version du SDK, consultez la page Places Version du SDK pour Android commentaires.
Versions de l'API Places pour le SDK Places pour Android
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 clé API en même temps, puis sélectionnez le service via lequel le SDK appelle la méthode utilisée pour initialiser le SDK dans votre application. Cependant, dans la plupart des cas, vous devez activer l'API Places (nouvelle version) et utiliser les versions (nouvelles) de la les fonctionnalités 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.
Dans le fichier build.gradle au niveau de l'application, spécifiez un numéro de version. Pour plus pour en savoir plus, consultez Installation.
Initialisez votre application en appelant la méthode
Places.initializeWithNewPlacesApiEnabled()ouPlaces.initialize().
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 | Méthode d'initialisation | Version minimale du SDK |
|---|---|---|---|
| Saisie semi-automatique (nouveauté) | API Places (New) | initializeWithNewPlacesApiEnabled() |
3.5.0 |
| Place Details (New) | API Places (New) | initializeWithNewPlacesApiEnabled() |
3.3.0 |
| Nearby Search (nouveau) | API Places (New) | initializeWithNewPlacesApiEnabled() |
3.5.0 |
| Place Photos (nouveauté) | API Places (New) | initializeWithNewPlacesApiEnabled() |
3.4.0 |
| Text Search (nouvelle version) | API Places (New) | initializeWithNewPlacesApiEnabled() |
3.3.0 |
| Place Autocomplete | API Places | initialize() |
|
| Current Place | API Places | initialize() |
|
| Place Details | API Places | initialize() |
|
| Place Photos | API Places | initialize() |
Éléments à prendre en compte pour choisir les versions à activer
Pour vous aider à choisir la version à utiliser, tenez compte des éléments suivants:
- Si vous êtes un nouveau client et que vous commencez tout juste à utiliser le SDK Places pour Android, Commençons 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 des performances et de la fonctionnalité du SDK Places pour Android (nouveau), vous devez utiliser la nouvelle SDK. Aucune migration n'est nécessaire lorsque vous passez au nouveau SDK. Il vous suffit de suivre suivez la procédure décrite dans la section Sélectionner la version du SDK et l'API Google Cloud.
- Dans le SDK Places pour Android (nouveau), les jetons de session sont disponibles à partir des dans la version 3.5.0. Pour en savoir plus, consultez la page Session les jetons.
- Les appels effectués à l'aide des widgets Place Autocomplete appellent toujours Place de saisie semi-automatique, et non Place Autocomplete (Nouveau) les appels de widget ne sont pas affectés par d'initialisation.
- Place Photos (nouveauté) ne renvoie qu'un URI vers une image bitmap, tandis que Place Photos ne renvoie qu'un bitmap l'image.
- Current Place (Lieu actuel) est disponible uniquement dans le SDK Places pour Android, et non dans le SDK Places pour Android (Nouveau).
Améliorations apportées au SDK Places pour Android (nouveau)
Cette section présente les principales fonctionnalités ajoutées au SDK Places pour Android (nouveau).
Implémentée sur la plate-forme standard Google Cloud
Le SDK Places pour Android (nouvelle version) 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 Android (Nouveau).
Performances améliorées
Le SDK Places pour Android (nouvelle version) offre de meilleures performances : de remplacer celles qui utilisent le SDK existant.
Nouvelles fonctionnalités
Le SDK Places pour Android (nouveau) inclut les dernières versions de tous les SDK fonctionnalités:
- Saisie semi-automatique (nouveauté)
- Place Details (New)
- Nearby Search (nouveau)
- Place Photos (nouveauté)
- Text Search (nouvelle version)
Nouveau service Text Search
Text Search (nouvelle version) renvoie des informations sur un ensemble de lieux en fonction d'une chaîne, par exemple "pizza à New York" ou "magasins de chaussures près d'Ottawa" ou "123 Main Street". Le service renvoie une liste des lieux correspondant à la chaîne de texte et tout biais géographique défini.
Nouvelles données de réponse ajoutées à Placed Details (New) et Place Photos (New)
Place Details (Nouveau) inclut désormais le nouveau Récapitulatif dans l'objet de réponse
Place. La Classe Place contient la nouvelle méthodegetReviews()compatible avec ce champ. AppelergetReviews()pour afficher jusqu'à cinq avis sur un lieu.Place Photo (Nouveau) ajoute les
AuthorAttributionsà la classePhotoMetadata.AuthorAttributionscontient unListdeAuthorAttributiond'objets.
Nouvelle réponse URI ajoutée à Place Photos (nouveau)
Vous pouvez désormais utiliser Place Photo (Nouveau) pour renvoyer un URI vers un bitmap d'image. Auparavant, vous ne pouviez renvoyer le bitmap d'image lui-même.
Tarification simplifiée
La tarification est simplifiée grâce au SDK Places pour Android (nouveau) afin que vous pour payer les données que vous utilisez. La tarification simplifiée est mise en œuvre à l'aide de listes de champs, également appelés masques de champ.
Avec Place Details 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