Rapports d'utilisation (forfait Premium)

Remarque : Il n'est plus possible de s'inscrire au forfait Premium de Google Maps Platform, qui n'est plus disponible non plus pour les nouveaux clients.

Cette page est réservée aux clients qui disposent de la nouvelle version du forfait Premium de Google Maps Platform, disponible depuis janvier 2016.

Vous disposez du forfait Premium ou d'une licence antérieure ?
Pour déterminer votre licence :
> Sur le portail d'assistance Google Cloud, cliquez sur Maps: Usage Report (Maps : rapport sur l'utilisation), à gauche.
> L'ID situé en haut du rapport se présente-il comme suit ?
gme-[company] & proj-[number] ([type])
Si oui, vous disposez du forfait Premium.
Si ce n'est pas le cas, vous disposez d'une licence antérieure (API Google Maps for Work ou API Google Maps for Business).

Présentation

Comme vous disposez d'un forfait Premium, vous pouvez utiliser les rapports d'utilisation de Google Maps pour suivre l'utilisation de Google Maps Platform dans votre application et votre consommation de crédits d'API Google Maps. Grâce à cet outil, vous pouvez consulter des rapports quotidiens et mensuels détaillés sur toutes les API incluses dans votre forfait Premium de Google Maps Platform. Les données de rapport sont disponibles pour toute requête API comportant un ID client ou un ID de projet.

Remarque : Les rapports d'utilisation fournissent les mêmes informations que celles permettant à Google de déterminer l'utilisation de votre application à des fins de facturation.

Types de rapports

Rapport sur les requêtes réussies

Ce rapport affiche le nombre total de requêtes envoyées quotidiennement et mensuellement par votre application à chaque API. Utilisez-le pour comparer différentes périodes afin d'identifier les tendances d'utilisation et les périodes de pointe. Vous pouvez aussi l'utiliser pour consulter les données suivantes :

  • Erreurs de requête : pour chaque API, le rapport quotidien affiche le nombre de requêtes qui ont abouti et le nombre de requêtes qui ont échoué (erreurs). Pour les API de services Web auxquelles votre application accède avec un ID client, le rapport affiche également des codes d'erreur qui facilitent la résolution des problèmes.
  • Données de canal : si vous incluez le paramètre channel dans vos requêtes, vous pouvez générer un rapport sur les requêtes réussies. Il indique la répartition des requêtes API réalisées par votre application entre différentes applications qui utilisent le même ID client (pour comparer les accès internes et externes, par exemple). Avec les canaux, vous pouvez générer des rapports plus détaillés sur l'utilisation de votre application.

Rapport sur les crédits d'API Google Maps

Ce rapport affiche la consommation globale de crédits par votre application pour toutes les API combinées, par jour et par mois. Utilisez-le pour déterminer le nombre de crédits à acheter. Pour plus d'informations sur la manière dont votre application consomme des crédits, consultez Taux et limites d'utilisation.

Composants des rapports

  • Graphiques faciles à lire : les rapports quotidiens contiennent des graphiques permettant de visualiser les tendances d'utilisation au fil du temps. Pour afficher les détails du rapport, il suffit de passer la souris sur le graphique.

  • Données de l'historique : consultez des rapports pour toute période de l'année antérieure.
  • Données téléchargeables : téléchargez vos totaux mensuels (requêtes et crédits) dans un fichier CSV (valeurs séparées par une virgule). Vous pourrez ainsi effectuer une analyse complémentaire à l'aide d'outils de feuille de calcul ou d'informatique décisionnelle, ou encore partager les données avec des tiers.
  • Exploration des données : accédez aux rapports quotidiens directement à partir des rapports mensuels, en cliquant sur les totaux mensuels ou sur les en-têtes de colonne dans les rapports. Par exemple :

Accéder aux rapports d'utilisation

Pour accéder aux rapports d'utilisation Google Maps :

  1. Connectez-vous au portail d'assistance Google Cloud.
  2. Dans le panneau de gauche, cliquez sur Maps : rapport sur l'utilisation.

Générer des rapports

Le rapport par défaut est le rapport mensuel sur les requêtes réussies pour les 12 derniers mois. Pour générer d'autres rapports, utilisez les filtres de rapport :

Filtre Description
ID client
Disponible uniquement si vous possédez plusieurs ID client. Sélectionnez l'ID client pour lequel vous souhaitez afficher les rapports.
ID du canal
Disponible uniquement pour les rapports sur les requêtes réussies. Sélectionnez le canal pour lequel vous souhaitez afficher les données d'utilisation. Vous pouvez aussi sélectionner Tout afficher afin de consulter les données d'utilisation pour tous les canaux
Du/au Sélectionnez la plage de dates du rapport (un an au maximum). Cliquez sur "Mettre à jour" pour générer un rapport.
Type de rapport
Sélectionnez le rapport sur les requêtes réussies ou sur les crédits d'API Google Maps.
Sélectionner la fréquence Indiquez si vous souhaitez générer un rapport mensuel ou quotidien. Les rapports mensuels contiennent également des liens vers les rapports quotidiens. Les rapports quotidiens affichent les requêtes qui ont abouti et celles qui ont échoué, ainsi que les codes d'erreur.
Type d'API Disponible uniquement pour les rapports quotidiens. Sélectionnez l'API pour laquelle vous souhaitez afficher un rapport.

Questions fréquentes

Rapport sur les requêtes réussies

Quel est le délai d'affichage des données d'utilisation dans les rapports ?

Les données des rapports sont disponibles en temps réel. Les données d'utilisation correspondant aux requêtes envoyées avec un ID client sont traitées quotidiennement. Comme les dates des rapports se basent sur l'heure du Pacifique, vous observerez peut-être un retard pouvant aller jusqu'à quelques jours. Les données des requêtes qui utilisent une clé API nécessitent un traitement supplémentaire, et leur affichage dans les rapports peut prendre jusqu'à quatre jours.

Que sont les chargements de cartes de l'API Maps JavaScript ? En quoi sont-ils différents des pages vues ?

Avec le forfait Premium de Google Maps Platform, l'utilisation de l'API Maps JavaScript est basée sur les chargements de cartes (affichages des cartes sur une page). Les chargements de cartes diffèrent des pages vues, qui étaient utilisées pour calculer l'utilisation de l'API Maps JavaScript avec les anciennes licences de l'API Google Maps for Business ou des API Google Maps for Work. Pour en savoir plus, consultez Taux et limites d'utilisation.

Pourquoi le nombre de chargements de cartes ne correspond-il pas aux statistiques d'accès fournies par nos serveurs Web ?

Plusieurs raisons peuvent expliquer la différence entre le nombre de chargements de cartes sur une page et le nombre de visites de cette URL dans les journaux de votre serveur Web :

  • L'utilisation des cartes peut varier sur une page : un chargement de carte est généré chaque fois que l'objet google.maps.Map est créé sur une page. Lorsque vous comparez les rapports sur les chargements de cartes aux statistiques d'accès de votre serveur Web, analysez scrupuleusement l'utilisation des cartes sur chacune des pages Web pour identifier ce qui pourrait causer des différences. Voici quelques exemples :
    • Comme une page comporte plusieurs cartes, plusieurs objets Map ont été créés.
    • Une page n'affiche pas de carte, mais l'objet Map est tout de même créé. Cela peut se produire, par exemple, si l'objet Map est associé à un élément HTML div masqué.
    • Une page nécessite qu'un utilisateur réalise une action (cliquer sur un bouton, par exemple) pour afficher une carte. Si l'utilisateur n'a pas effectué cette action, l'objet Map n'a pas été créé.
    • Comme une page ne comporte aucune carte, l'objet Map n'a pas été créé.
  • Les fuseaux horaires sont différents : les rapports sont obtenus à partir de journaux définis sur le fuseau horaire du Pacifique. Vous pouvez analyser les journaux de votre serveur en vous basant sur ce fuseau horaire pour éviter les décalages dus aux consignations de données correspondant au fuseau horaire local.
  • Le code HTML est mis en cache : les chargements de cartes ne sont pas mis en cache. Si un utilisateur actualise votre page, l'opération génère un nouveau chargement de carte pour obtenir un jeton de session. Toutefois, dans ce cas, le navigateur peut charger le code HTML à partir du cache. Le nombre de chargements de cartes est alors supérieur au nombre de pages visitées indiqué par les journaux du serveur.
Pourquoi le nombre de requêtes est-il plus élevé que prévu pour l'API Distance Matrix ?

Le rapport de l'API Distance Matrix affiche le nombre d'éléments (paires point de départ-destination), et non le nombre de requêtes. Pour en savoir plus sur les éléments, consultez le guide du développeur.

Erreurs de requête

Comment afficher les erreurs de requête de mon application ?

Générez un rapport quotidien sur les requêtes réussies, puis choisissez une API dans la liste Type d'API. Vous verrez un graphique et un tableau qui indiquent le nombre de requêtes réalisées par l'application qui ont abouti et le nombre de celles qui ont échoué. Pour les API de services Web auxquelles votre application accède avec un ID client, vous verrez également les codes d'état affichés par ces requêtes :

À quoi correspondent les codes d'état ?

Les rapports d'utilisation affichent des codes d'état pour les API de services Web auxquelles votre application accède avec un ID client. Les codes sont décrits dans le guide du développeur pour chaque API :

Les API Geolocation, Places et Roads nécessitent toujours une clé API. Pour ces API, comme pour toute API à laquelle votre application accède avec une clé, vérifiez les codes d'état dans la Developers Console.

Les erreurs consomment-elles des crédits d'API Google Maps ?

Non. Les requêtes qui obtiennent un code d'erreur ne consomment aucun crédit. En revanche, celles qui reçoivent les codes OK ou ZERO_RESULTS consomment des crédits.

Données de canal

En quoi consistent les canaux ?

Pour suivre l'utilisation de différentes applications qui se servent du même ID client ou de la même clé API, vous pouvez inclure le paramètre channel dans vos requêtes API. En spécifiant différentes valeurs du paramètre 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 externe accède à une API avec le paramètre channel défini sur customer, tandis que votre service marketing interne utilise un paramètre channel défini sur mkting. Dans vos rapports, l'utilisation de l'API est répartie en fonction de ces valeurs, ou canaux.

Quelles sont les API compatibles avec les canaux ?

Les rapports basés sur des canaux sont disponibles pour les applications qui utilisent les API Maps JavaScript, Maps Static et Street View Static, et les services Web Google Maps Platform. Les canaux ne sont pas disponibles pour les API Geolocation, Places et Roads, ni pour les SDK Maps Mobile.

Combien de canaux puis-je utiliser ?

Vous pouvez utiliser jusqu'à 2 000 canaux distincts par ID client ou clé API.

Comment configurer des canaux pour les requêtes de mon application ?

Dans vos requêtes, la valeur du paramètre channel doit respecter les exigences suivantes :

  • Il doit s'agir d'une chaîne alphanumérique ASCII.
  • Elle peut inclure un trait de soulignement (_) et un tiret (-).
  • Elle n'est pas sensible à la casse : les valeurs du paramètre channel définies en majuscules, ou en minuscules et majuscules, sont fusionnées en une valeur équivalente tout en minuscules. Par exemple, l'utilisation de la valeur CUSTOMER du paramètre channel est combinée à celle de la valeur customer.
  • Elle doit être statique et attribuée par instance d'application (elle ne peut pas être générée dynamiquement). Ainsi, vous ne pouvez pas utiliser les valeurs du paramètre channel pour le suivi d'utilisateurs spécifiques.

Pour ajouter le paramètre channel à vos requêtes, procédez comme suit :

API côté client

Ajoutez le paramètre channel à 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>

API Maps Static et Street View Static

Ajoutez le paramètre channel à l'URL de la requête :

https://maps.googleapis.com/maps/api/staticmap
?center=15.800513,-47.91378
&zoom=11
&size=300x300
&client=gme-yourclientid
&channel=your_channel
&signature=your_signature

Services Web

Ajoutez le paramètre channel à l'URL de la requête :

https://maps.googleapis.com/maps/api/geocode/json
?address=101+Main+St
&client=gme-yourclientid
&channel=your_channel
&signature=your_signature

Rapport sur les crédits d'API Google Maps

En quoi consistent les crédits d'API Google Maps ?

Les requêtes que votre application envoie aux API consomment des crédits d'API Google Maps, provenant d'une réserve de crédits que vous avez achetée avec votre forfait Premium pour Google Maps Platform. Pour plus d'informations sur les crédits et leur consommation par votre application, consultez Taux et limites d'utilisation.

Quel est le délai d'affichage des informations sur les crédits dans les rapports ?

Les données de consommation des crédits pour les rapports d'utilisation de Google Maps nécessitent un traitement. Leur affichage dans les rapports peut donc prendre jusqu'à trois jours.