Quota et rapports

Cette page concerne uniquement les clients qui possèdent une ancienne licence Maps APIs for Work ou Maps API for Business. Cette page ne s'applique pas aux clients qui disposent du nouveau Google Maps APIs Premium Plan, sorti en janvier 2016.

Quota

Les API côté client dans la suite Google Maps APIs for Work comparent les vues de page au quota acheté. On appelle vue de page :

  • Un chargement unique de Google Maps JavaScript API dans une page.
  • Une requête unique pour une image Google Street View Image API ou une image Google Static Maps API.
  • Un chargement unique de Google Earth API dans une page.

Les interactions des utilisateurs avec une carte, comme effectuer un panoramique, zoomer ou changer de type de carte, ne génèrent pas de vues de page additionnelles.

Une vue de page est générée si l'API est chargée dans la page, même si elle n'est pas utilisée ensuite pour afficher une carte. Nous déconseillons donc d'inclure la balise <script> pour charger l'API dans les modèles de page et recommandons plutôt de charger l'API de manière asynchrone sur les pages où des cartes ne sont affichées qu'en réponse à une activité facultative de l'utilisateur.

Lorsque vous avez consommé la totalité du quota acheté, vous devez rapidement renouveler votre licence.

Rapports

Vous pouvez analyser vos statistiques d'utilisation de deux façons :

  • Pour des informations détaillée sur votre utilisation de Google Maps APIs for Work en ce qui concerne la facturation, accédez aux rapports disponibles sous l'onglet Maps: Usage Report sur le portail Google Cloud Support Portal.

  • Pour savoir comment les clients interagissent avec votre application Google Maps JavaScript API, vous pouvez activer Analytics for Google Maps APIs for Work.

Rapports d'utilisation

Le portail Google Cloud Support Portal fournit des rapports détaillés pour Google Maps JavaScript API et les API d'image Google Maps.

Une fois connecté au portail, cliquez sur Maps: Usage Report dans le panneau de navigation à gauche. Vous pouvez filtrer par canal et par plage de dates.

Les données contenues dans ces rapports sont les mêmes que Google utilise pour effectuer la facturation basée sur votre utilisation.

Rapports basés sur les canaux

Pour suivre l'utilisation entre différentes applications utilisant le même ID client, vous pouvez fournir un paramètre channel facultatif avec vos requêtes. En spécifiant différentes valeurs channel pour différents aspects de votre application, vous pouvez déterminer précisément de quelle façon votre application est utilisée.

Par exemple, votre site Web destiné aux clients peut accéder à l'API en utilisant un paramètre channel défini sur customer, tandis que votre service marketing interne peut utiliser un paramètre channel défini sur mkting. Vos rapports répartiront l'utilisation en fonction de ces valeurs channel.

Les rapports basés sur des canaux sont disponibles pour les applications qui utilisent Google Maps JavaScript API, les API d'image ou tout service Web Google Maps APIs.

Le paramètre channel doit utiliser le format suivant :

  • Il doit s'agir d'une chaîne alphanumérique ASCII.
  • Le point (.), la barre de soulignement (_) et le tiret (-) sont des caractères autorisés.
  • Le paramètre channel n'est pas sensible à la casse ; les paramètres channel en majuscules, en minuscules ou mélangés seront transformés en minuscules. Par exemple, l'utilisation du canal CUSTOMER sera combinée à celle du canal customer.
  • La valeur channel doit être une valeur statique attribuée par instance d'application et ne doit pas être générée de façon dynamique. Par exemple, vous ne pouvez pas utiliser des valeurs channel pour suivre des utilisateurs individuels.

Il est possible de créer jusqu'à 2 000 canaux distincts par ID client.

Le paramètre channel devrait être ajouté à la valeur src de votre balise de script :

<script src="https://maps.googleapis.com/maps/api/js?v=3&client=gme-yourclientid&channel=YOUR_CHANNEL"></script>

Analytics for Google Maps APIs for Work

Avec Analytics for Google Maps APIs for Work, vous pouvez savoir de quelle façon les utilisateurs interagissent avec vos cartes, de manière à pouvoir améliorer votre application sur la base de statistiques d'utilisation réelles. Analytics for Google Maps APIs for Work fournit des réponses à des questions comme :

  1. Quel niveau de zoom et type de carte sont les plus courants ?
  2. Pour quels pays les utilisateurs demandent-ils des résultats de géocodage ?
  3. À quelle fréquence les services JavaScript sont-ils utilisés ?

Analytics peut être activé sans aucune modification de votre code, et toutes les données sont regroupées et rendues anonymes pour protéger la vie privée des utilisateurs. Les rapports sont disponibles pour Google Maps JavaScript API et les services connexes.

Ce rapport *Zoom Interactions* montre que pour les sites associés à cet
ID client, la plupart des clients utilisent des niveaux de zoom situés
entre 4 et 7.

Accéder à Analytics

Accédez au portail Google Cloud Support Portal et sélectionnez Maps: Analytics dans la liste des ressources. Si vous avez plusieurs ID client associés à votre compte, vous serez invité à sélectionner l'ID client et le canal que vous souhaitez utiliser à chaque fois que vous accéderez à Analytics.

Activer Analytics pour votre ID client

Analytics est désactivé par défaut et doit être activé par ID client . Vous serez invité à confirmer que vous souhaitez activer Analytics la première fois que vous accéderez aux rapports pour chaque ID client. Une fois le processus terminé, il faut compter jusqu'à 5 minutes pour qu'Analytics commence à enregistrer les données.

Il n'est pas nécessaire de modifier votre code existant, à moins que vous ne souhaitiez utiliser des canaux et que vous n'avez pas encore spécifié un canal lors du chargement de la bibliothèque JavaScript.