Vous êtes prêt !

Pour passer à l'étape de développement, accédez à notre documentation pour les développeurs.

Activer Google Places API for Android

Pour commencer, nous allons vous guider à travers la console Google Developers et effectuer deux ou trois petites choses :

  1. Créer ou choisir un projet
  2. Activer Google Places API for Android
  3. Créer les clés appropriées
Continuer

Premiers pas

Ce guide présente les fonctionnalités de Google Places API for Android et comment configurer votre application pour utiliser cette API.

  1. Introduction et concepts
  2. Présentation de l'API
  3. Versions de la plateforme Android prises en charge
  4. Configurer votre application
    1. Configurer les services Google Play
    2. Ajouter votre clé d'API
    3. Demander une augmentation des limites d'utilisation
  5. Se connecter à Places API

Introduction et concepts

Les principaux points d'accès à Google Places API for Android sont le widget IU PlacePicker, le widget IU Autocomplete, l'API GeoDataApi et l'API PlaceDetectionApi.

Google Places API for Android vous permet de concevoir des applications de géolocalisation qui renvoient, selon le contexte, les professionnels locaux et autres lieux à proximité de l'appareil. Autrement dit, vous pouvez concevoir des applications complètes basées sur les lieux pertinents pour l'utilisateur et qui complètent les services géographiques simples fournis par les services de géolocalisation Android.

Un lieu est défini comme un espace physique associé à un nom. Un lieu peut également être défini comme tout ce que l'on peut trouver sur une carte. Une entreprise locale, un point d'intérêt et un point géographique sont des exemples de lieu. Dans l'API, un lieu est représenté par l'interface Place. L'API inclut des informations telles que le nom du lieu et son adresse, la position géographique, l'identifiant de lieu, le numéro de téléphone, le type de lieu, l'URL du site Web, etc.

Présentation de l'API

Aidez vos clients à découvrir l'endroit où ils se trouvent et ce qui les entourent :

  • Utiliser le widget IU Sélecteur de lieux pour permettre aux utilisateurs de sélectionner un lieu sur une carte interactive.
  • Extraire le lieu actuel, à savoir, la dernière position connue de l'appareil. L'API renvoie une liste des lieux possibles avec une indication de la probabilité relative pour chaque lieu.
  • Simplifier la saisie de noms et adresses de lieu grâce à la saisie semi-automatique des lieux au cours de la frappe. Utiliser le widget IU Autocomplete, ou appeler l'API pour les prédictions de lieu.
  • Extraire et afficher des informations complètes sur un lieu.
  • Obtenir des photos de lieu de qualité supérieure.

Démarquez votre application en fournissant des informations locales actualisées :

  • Ajouter un lieu dans la base de données Google Places pour pouvoir l'extraire immédiatement de votre application et l'intégrer à d'autres applications après modération.
  • Générer un rapport de localisation pour indiquer que l'appareil est actuellement localisé à un endroit particulier.
  • Stocker l'identifiant de lieu unique d'un ou de plusieurs lieux et l'utiliser pour extraire, à la demande, des informations sur le lieu.

Autres fonctionnalités clés de l'API :

  • Détection de lieu précise même avec un signal faible grâce à l'analyse Wi-Fi.
  • Mise en cache sur l'appareil : La plupart des requêtes envoyées à Google Places API for Android peuvent impliquer une interaction avec un serveur Google, mais vous pouvez également mettre les données en cache localement pendant 30 jours.

Versions de la plateforme Android prises en charge

Google Places API for Android est disponible pour toutes les versions Android compatibles avec les services Google Play. Voir le guide Android sur la prise en charge des différentes versions de plateforme.

Configurer votre application

La procédure de configuration suivante doit être appliquée pour toutes les applications utilisant Google Places API for Android.

Configurer les services Google Play

Pour accéder à Google Places API for Android, le projet de développement de votre application doit inclure les services Google Play. Téléchargez et installez le composant des services Google Play via SDK Manager et ajoutez la bibliothèque à votre projet. Pour plus de détails, voir le guide Android sur la configuration des services Google Play.

Ajouter votre clé d'API

Si vous n'avez pas encore obtenu votre clé d'API et activé Google Places API for Android, suivez les instructions du guide de signature pour en obtenir une immédiatement.

Ajoutez votre clé d'API au manifeste de votre application comme illustré dans l'exemple de code suivant en remplaçant YOUR_API_KEY par votre propre clé d'API :

<application>
  ...
  <meta-data
      android:name="com.google.android.geo.API_KEY"
      android:value="YOUR_API_KEY"/>
</application>

Demander une augmentation des limites d'utilisation

L'utilisation de Google Places API for Android est gratuite et illimitée pour toutes les applications. Toutefois, pour garantir une utilisation juste entre toutes les applications, il existe des limites de requêtes hiérarchisées en fonction des méthodes.

Google Places API for Android applique une limite par défaut de 1 000 requêtes par tranche de 24 heures. Si votre application dépasse cette limite, elle ne fonctionne plus.

Une deuxième vérification est effectuée lorsque l'application atteint 150 000 requêtes par tranche de 24 heures. Si votre application dépasse cette limite, elle ne fonctionne plus à nouveau.

Augmentez votre limite rapidement si vous pensez que vous allez dépasser le nombre de requêtes autorisé par défaut. Voir le guide sur les limites d'utilisation.

Se connecter à Places API

Les interfaces suivantes fournissent les principaux points d'accès à Google Places API for Android :

  • L'API GeoDataApi offre un accès à la base de données Google contenant des informations sur les lieux et professionnels locaux.
  • L'API PlaceDetectionApi fournit rapidement la position actuelle de l'appareil et permet de géolocaliser l'appareil à un endroit précis.

Pour se connecter aux API, vous devez créer une instance du client API des services Google Play. Dans la méthode onCreate() de votre fragment ou activité, créez une instance de Google API Client à l'aide de GoogleApiClient.Builder. Utilisez l'outil de création pour ajouter les API requises, tel qu'illustré dans l'échantillon de code suivant :

import com.google.android.gms.common.api.GoogleApiClient;
import com.google.android.gms.common.api.GoogleApiClient.OnConnectionFailedListener;
import android.support.v4.app.FragmentActivity;

public class MyActivity extends FragmentActivity 
        implements OnConnectionFailedListener {
    private GoogleApiClient mGoogleApiClient;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        mGoogleApiClient = new GoogleApiClient
                .Builder(this)
                .addApi(Places.GEO_DATA_API)
                .addApi(Places.PLACE_DETECTION_API)
                .enableAutoManage(this, this)
                .build();
    }

    // TODO: Please implement GoogleApiClient.OnConnectionFailedListener to
    // handle connection failures.
}

Comme illustré dans l'échantillon de code, la classe Places fournit des jetons que vous pouvez transmettre à l'outil GoogleApiClient.Builder pour activer les API GeoDataApi et PlaceDetectionApi.

Pour plus de détails sur l'utilisation du client, voir le guide Android sur l'accès aux API Google. Notamment, voir les guides sur le lancement d'une connexion et le traitement des erreurs de connexion, pour plus d'informations sur addConnectionCallbacks() et addOnConnectionFailedListener().

Envoyer des commentaires concernant…

location_on
Google Places API for Android