Vue d'ensemble

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

Introduction

Le SDK Places pour Android vous permet de créer des applications avec détection de la position qui répondent en fonction du contexte aux établissements locaux et aux autres lieux à proximité de l'appareil de l'utilisateur. Vous pouvez ainsi 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 situation géographique des 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'à l'emplacement actuel de l'appareil.
  • Autocomplete fournit des widgets prédéfinis permettant d'afficher des prédictions de lieux en réponse aux requêtes de recherche des utilisateurs.

Un lieu est défini comme un espace physique portant un nom. Vous pouvez également définir un lieu comme étant tout ce que l'on peut trouver sur une carte. Il peut s'agir, par exemple, d'établissements locaux, de points d'intérêt et de lieux géographiques. Dans l'API, un lieu est représenté par l'interface Place. Elles incluent des informations telles que le nom et l'adresse du lieu, son emplacement géographique, son ID, son numéro de téléphone, le type de lieu, l'URL du site Web, etc.

Choisir votre version du SDK

Le SDK Places pour Android version 3.3.0 est compatible avec deux versions de SDK: le SDK Places pour Android existant et le SDK Places pour Android (nouveau), la version nouvelle génération du SDK.

Votre première tâche consiste à décider quel 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 de votre SDK.

Tarifs pour chaque version du SDK

La version choisie du SDK contrôle les prix pour Place Details, Text Search et Place Photos. 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 la tarification des deux SDK, 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 renseigne 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 la dernière position connue de l'appareil de l'utilisateur, 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.
  • Recherche de texte renvoie des lieux en fonction d'une chaîne de texte de recherche. Text Search fait partie du SDK Places pour Android (nouveauté).
  • Place Photos affiche des images de haute qualité d'un lieu.
  • Les ID de lieu stockent l'identifiant unique d'un ou 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 Conditions d'utilisation de Google Maps Platform, Utilisation et facturation et Afficher les attributions.