Aperçu

Sélectionnez une plate-forme : Android iOS JavaScript Services Web

Introduction

Le SDK Places pour Android vous permet de créer des applications sensibles à la position qui répondent de manière contextuelle aux établissements locaux et à d'autres lieux à proximité de l'appareil de l'utilisateur. Vous pouvez ainsi créer des applications riches basées sur des lieux qui ont une signification pour l'utilisateur, en complément des services géographiques simples proposés 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'à la position actuelle de l'appareil.
  • Autocomplete fournit des widgets prédéfinis pour renvoyer des prédictions de lieux en réponse aux requêtes de recherche des utilisateurs.

Un lieu est un espace physique qui possède un nom. Une autre façon de voir les choses est de considérer qu'un lieu est tout ce que vous pouvez trouver sur une carte. Il peut s'agir, par exemple, d'établissements locaux, de points d'intérêt et d'emplacements géographiques. Dans l'API, un lieu est représenté par l'interface Place. Il comprend des informations telles que le nom du lieu et son adresse, sa localisation géographique, son ID de lieu, son numéro de téléphone, son type de lieu, l'URL de son site Web, etc.

Choisir votre version de SDK

Les fonctionnalités du SDK Places pour Android 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 la section Choisir votre version de SDK.

Votre première tâche consiste à choisir le SDK à utiliser. Cela s'applique 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 votre version de SDK.

Tarifs de 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) est compatible avec un modèle de tarification simplifié qui vous permet de ne payer que les données que vous utilisez. Pour obtenir des informations détaillées sur les tarifs du SDK Places pour Android et du SDK Places pour Android (nouveau), consultez la section Utilisation et facturation.

Présentation de l'API

Aidez vos clients à explorer l'endroit où ils se trouvent et ce qui les entoure:

  • Place Autocomplete permet de saisir automatiquement le nom et/ou l'adresse d'un lieu à mesure que les utilisateurs saisissent du texte.
  • Current Place (Emplacement actuel) renvoie une liste des lieux où l'appareil de l'utilisateur a été localisé pour la dernière fois, ainsi qu'une indication de la probabilité relative de 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. La recherche textuelle fait partie du SDK Places pour Android (nouveau).
  • Photos de lieu affiche des images de haute qualité d'un lieu.
  • Les ID de lieu stockent l'ID unique d'un ou de plusieurs lieux pour permettre de récupérer des informations sur ces lieux à 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 Conditions d'utilisation de Google Maps Platform, la section Utilisation et facturation et la section Affichage des attributions.