Vue d'ensemble

Introduction

Le SDK Places pour Android vous permet de créer des applications avec détection de la position qui réagissent en fonction du contexte aux établissements locaux et à d'autres lieux à proximité de l'appareil de l'utilisateur. Cela signifie que vous pouvez créer des applications enrichies basées sur des lieux qui ont une signification pour l'utilisateur, en complément des services simples basés sur la zone géographique offerts par les services de localisation Android.

Concepts

Les interfaces suivantes constituent les principaux points d'accès au SDK Places pour Android :

• Places fournit un accès programmatique à la base de données Google contenant des informations sur les lieux et les établissements locaux, ainsi qu'au lieu actuel de l'appareil.
• Autocomplete fournit des widgets prédéfinis permettant de renvoyer des prédictions de lieux en réponse aux requêtes de recherche des utilisateurs.

Un lieu est défini comme un espace physique qui porte un nom. Vous pouvez également considérer un lieu comme tout ce que vous pouvez trouver sur une carte. Exemples : établissements locaux, points d'intérêt et emplacements géographiques. Dans l'API, un lieu est représenté par l'interface Place. Elles incluent des informations telles que le nom du lieu et son adresse, son emplacement géographique, son ID de lieu, son numéro de téléphone, son type de lieu, l'URL du site Web, etc.

Choisir la version du SDK

Les fonctionnalités du SDK Places disponibles dans votre application sont déterminées par une combinaison du numéro de version du SDK (par exemple, 3.5.0) que vous spécifiez dans la configuration de votre application, des API activées sur votre clé API et de la manière dont vous initialisez votre application. Pour en savoir plus sur les différences entre le SDK Places pour Android et le SDK Places pour Android (nouveau), consultez Choisir la version du SDK.

La première étape consiste à choisir le SDK à utiliser. Cela est vrai si vous êtes un nouveau client ou un client existant qui utilise déjà le SDK. Pour connaître les principales différences entre les deux versions du SDK, consultez Choisir la version du SDK.

Tarifs pour chaque version du SDK

La version du SDK que vous activez contrôle la tarification de votre utilisation du SDK. Le SDK Places pour Android (nouveau) accepte un modèle de tarification simplifié afin que vous ne payiez que pour les données que vous utilisez. Pour obtenir des informations détaillées sur les tarifs des SDK Places pour Android et pour Android (nouveau), consultez Utilisation et facturation.

Présentation de l'API

Aidez vos clients à découvrir où ils se trouvent et ce qui les entoure:

• Place Autocomplete remplit automatiquement le nom et/ou l'adresse d'un lieu à mesure que l'utilisateur saisit du texte.
• Current Place renvoie la liste des lieux où se trouve l'appareil de l'utilisateur pour la dernière fois, ainsi qu'une indication de la probabilité relative pour chaque lieu.
• Place Details renvoie et affiche des informations plus détaillées sur un lieu.
• Text Search renvoie des lieux en fonction d'une chaîne de texte de recherche. Text Search fait partie du SDK Places pour Android (nouveau).
• Place Photos renvoie des images de haute qualité d'un lieu.
• Les ID de lieu stockent l'identifiant unique d'un ou de plusieurs lieux afin de récupérer des informations sur le lieu à la demande.

Règles et conditions d'utilisation

Toutes les applications qui utilisent le SDK Places pour Android doivent respecter les exigences décrites dans les sections Conditions d'utilisation de Google Maps Platform, Utilisation et facturation et Afficher les attributions.