Google Maps APIs for Work Usage Dashboard

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.

Présentation

Google Maps APIs for Work Usage Dashboard fournit des rapports détaillés qui vous permettent de surveiller l'utilisation et l'état de santé de votre application Maps APIs for Work. Les données de rapports sont disponibles pour toutes les requêtes qui utilisent un ID client.

Usage Dashboard vous offre une vue rapide et facile de l'utilisation de votre application :

  • Vues de page, services client et services Web utilisés
  • Nombre de requêtes par seconde (QPS) utilisé pour les services Web
  • Vues de page et services Web utilisés par domaine
  • Taux de réussite des requêtes et erreurs pour les services Web

Vous pouvez créer des rapports pour toute période de l'année antérieure et exporter les données vers un fichier pour analyse complémentaire et partage. Tous les rapports affichent des données concernant une ou plusieurs applications qui utilisent le même ID clientMaps APIs for Work.

Avantages des rapports

Les rapports disponibles dans Google Maps APIs for Work Usage Dashboard s'avèrent utiles pour le développement d'applications, le marketing et les achats. Par exemple, utilisez les rapports pour :

  • Comparer différentes périodes afin d'identifier les tendances d'utilisation et les périodes de pointe.
  • Déterminer le nombre de vues de page et de QPS à acheter.
  • Afficher les vues de page ou les requêtes de service côté client sur tous vos domaines pour comparer l'utilisation par marque, par public ciblé et selon d'autres facteurs.
  • Vérifier que votre application fonctionne correctement et résoudre des problèmes.

Contenu des rapports

Données Client/Web API/Services inclus
Vues de page Client JavaScript, Static Maps, Street View
Vues de page par domaine Client JavaScript, Static Maps, Street View
Requêtes de service Client Geocoding, Directions, Elevation
Requêtes de service Web Geocoding, Directions, Distance Matrix, Elevation, Time Zone
Requêtes de service par domaine Client Geocoding, Directions, Elevation
Requêtes par seconde (QPS) Web Geocoding, Directions, Distance Matrix, Elevation, Time Zone
Taux de réussite des requêtes de service Web Geocoding, Directions, Elevation, Time Zone
Erreurs de requête de service Web Geocoding, Directions, Distance Matrix, Elevation, Time Zone

Remarque : Usage Dashboard ne comprend pas de rappors pour Google Places API, Google Maps Geolocation API, Google Maps Roads API et Google Maps Mobile SDK for Work.

Se connecter à Usage Dashboard

Se connecter pour la première fois

Avant de vous connecter à Usage Dashboard pour la première fois, vous devez d'abord lier votre compte Google à Usage Dashboard. Si vous n'avez pas encore de compte Google, suivez les instructions fournies dans cet article pour en créer un.

  1. Connectez-vous au Google Cloud Support Portal.
  2. Dans le panneau de gauche, cliquez sur Maps: Usage Report.
  3. Sélectionnez Access the new Usage Dashboard.
  4. Suivez les invites pour sélectionner un compte Google et vous y connecter si nécessaire.
  5. Lorsqu'un message vous demande d'autoriser Usage Dashboard à accéder à votre compte Google, cliquez sur Approve. Cette approbation crée un lien entre votre compte Google Account et votre compte du portail de support.

À présent, Usage Dashboard s'affiche.

Remarque : Si vous ne pouvez pas accéder à Usage Dashboard, contacter le support.

Se connecter après la configuration initiale

Après avoir lié votre compte Google à Usage Dashboard, vous pouvez accéder directement à Usage Dashboard à la page :

https://maps-dashboard.appspot.com

Si ce n'est pas encore fait, connectez-vous au compte Google que vous avez lié à Usage Dashboard.

Utiliser les rapports

Afficher les graphiques des rapports

Google Maps APIs for Work Usage Dashboard propose des rapports graphiques qui permettent de visualiser les tendances d'utilisation dans le temps. Pour afficher les données correspondant à chaque API dans un rapport, passez la souris sur le graphique. Par exemple :

Modifier la plage de dates des rapports

La plage de dates par défaut des rapports est de 7 jours, mais vous pouvez facilement créer des rapports personnalisés pour toute plage de dates de l'année antérieure. (Pour les rapports de l'onglet Dashboard, toutefois, les plages de dates sont fixes.)

Remarque : Dans l'onglet Web Services, vous pouvez décomposer plus finement les données en sélectionnant une plage de dates de 3 jours ou moins afin d'afficher des informations horaires pour les taux de réussite des requêtes de l'application.

Pour modifier une plage de dates :

  1. Dans l'onglet Page Views, Client Services ou Web Services, cliquez sur l'icône Calendar image of Calendar icon.
  2. Cliquez sur les champs de date pour sélectionner les dates de début et de fin.
  3. Cliquez sur la coche image of checkmark button.

La nouvelle plage de dates est appliquée aux données de tous les onglets, sauf celles de l'onglet Dashboard.

Remarque : Tous les horodatages avec date uniquement (dates sans indication de l'heure de la journée) affichés dans Usage Dashboard correspondent au fuseau horaire de l'heure du Pacifique. Les horodatages plus précis (indiquant les heures, les minutes ou les secondes) affichés dans l'onglet Web Services lorsqu'une plage de dates courte est sélectionnée correspondent au fuseau horaire local.

Exporter et analyser les données de rapport

Si vous souhaitez analyser les données de rapport dans d'autres outils ou les partager avec vos collaborateurs, vous pouvez exporter toutes les informations fournies dans les onglets Page Views, Client Services et Web Services sous la forme d'un fichier de valeurs séparées par des virgules (CSV).

Par exemple, vous pouvez ouvrir des fichiers de données dans un programme de feuilles de calculs (tel que Google Sheets), une plateforme d'analyse ou un outil de veille économique pour analyser les tendances, comparer l'utilisation avec le trafic global du site Web, obtenir des estimations d'utilisation future, etc.

Pour exporter les données :

  1. Si vous le souhaitez, modifiez la plage de dates du rapport.
  2. Dans l'angle inférieur gauche d'un panneau de rapport, cliquez sur image of CSV download button.
  3. Enregistrez le fichier.

Rapports sur les vues de page

Afficher un instantané des données annuelles et mensuelles

Dans l'onglet Dashboard, le panneau Page View Consumption affiche les valeurs suivantes pour votre application :

  • Nombre total de vues de page pendant l'année antérieure
  • Nombre moyen de vues de page par mois
  • Nombre moyen de vues de page par jour

Astuce : Pour calculer le nombre de vues de page qu'il vous faudra probablement acheter pour l'ensemble des 12 prochains mois, multipliez la valeur moyenne mensuelle par 12.

Le panneau Total Request affiche un graphique représentant l'utilisation des vues de page de votre application au cours des 30 derniers jours.

Afficher les détails de l'utilisation des vues de page

Cliquez sur l'onglet Page Views. Le panneau Total Requests indique le nombre total de requêtes de vues de page pour chaque date de la plage de dates sélectionnée. Le panneau de droite affiche les données sur un graphique. Si vous le souhaitez, modifiez la plage de dates du rapport et exportez les données pour analyse complémentaire.

Afficher l'utilisation des vues de page par domaine

Cliquez sur l'onglet Page Views. Le panneau By Authorized Domain affiche le nombre total de requêtes de vues de page pour chacun de vos domaines et pour chaque API au cours de la plage de dates sélectionnée. Si vous avez spécifié des paramètres de canal pour les requêtes de votre application, les données d'utilisation sont décomposées par domaine et par canal.

Remarque : Le rapport affiche tous les domaines enregistrés dans le Google Cloud Support Portal pour l'ID client utilisé pour obtenir les données Google Maps APIs.

Si vous le souhaitez, modifiez la plage de dates du rapport et exportez les données pour analyse complémentaire.

Rapports sur les services client

Afficher l'utilisation côté client totale

Cliquez sur l'onglet Client Services. Pour chaque date de la plage de dates sélectionnée, le panneau Client-Side Services Usage indique le nombre total de requêtes réalisées par l'implémentation JavaScript de votre application. Le panneau de droite affiche les données sur un graphique.

Si vous le souhaitez, modifiez la plage de dates du rapport et exportez les données pour analyse complémentaire.

Afficher l'utilisation côté client par domaine

Cliquez sur l'onglet Client Services. Le panneau By Authorized Domain affiche les requêtes de service côté client pour chacun de vos domaines et pour la plage de dates sélectionnée. Si vous avez spécifié des paramètres de canal pour les requêtes de votre application, l'utilisation est décomposée par domaine et par canal.

Remarque : Le rapport affiche tous les domaines enregistrés dans le Google Cloud Support Portal pour un ID client donné.

Si vous le souhaitez, modifiez la plage de dates du rapport et exportez les données pour analyse complémentaire.

Rapports sur les services Web

Afficher les données relatives au nombre de requêtes par seconde (QPS)

Cliquez sur l'onglet Web Services. Le panneau Queries Per Second affiche les donnés suivantes pour chaque API et pour la plage de dates sélectionnées :

  • QPS moyen utilisé par votre application
  • QPS maximal utilisé par votre application
  • QPS utilisé par votre application 99 % du temps

Notez que pour Distance Matrix API, le rapport affiche des éléments (paires point de départ-destination) par seconde, au lieu d'afficher des requêtes.

Si vous le souhaitez, modifiez la plage de dates du rapport.

Astuce : Utilisez les données QPS pour déterminer le nombre de QPS à acheter.

Afficher les détails de l'utilisation des services Web

Cliquez sur l'onglet Web Services. Le panneau Total Requests indique le nombre total de requêtes de service Web pour chaque date de la plage de dates sélectionnée. Notez que pour Distance Matrix API, le rapport affiche des éléments (paires point de départ-destination) par jour, au lieu d'afficher des requêtes.

Si vous le souhaitez, modifiez la plage de dates du rapport et exportez les données pour analyse complémentaire.

Remarque : Le panneau de droite affiche le taux de réussite des requêtes de service Web de votre application, ainsi que toute erreur obtenue lors des requêtes effectuées par votre application. Pour plus de détails, voir « Rapports sur l'état de santé des applications ».

Rapports sur l'état de santé des applications

Obtenir un instantané de l'état de santé de votre application

L'onglet Dashboard affiche un instantané des performances de votre application au cours des deux derniers jours dans le panneau Application Status. Les icônes ci-dessous indiquent le taux de réussite des requêtes de service Web de votre application pour les données Google Maps APIs :

icon Description

Correct : Au moins 95 % des requêtes ont abouti.

Avertissement : Entre 80 et 94 % des requêtes ont abouti.

Alerte : Moins de 80 % des requêtes ont abouti.

Pas de requête : Votre application n'a pas utilisé cette API.

Passez la souris sur une API pour obtenir plus d'informations.

Vérifier le taux de réussite des requêtes de service Web

Cliquez sur l'onglet Web Services. Le graphique du panneau % Request Success montre le taux de réussite des requêtes de service Web de votre application pour la plage de dates sélectionnée.

Si vous le souhaitez, modifiez la plage de dates du rapport et exportez les données pour analyse complémentaire.

Vérifier les erreurs des requêtes de service Web

Cliquez sur l'onglet Web Services. Si le taux de réussite des requêtes de service Web de votre application est inférieur à 100 % pour la plage de dates sélectionnée, tout code d'erreur reçu par votre application s'affiche dans le panneau % Request Success, sous le graphique. Si vous le souhaitez, modifiez la plage de dates du rapport. Pour visualiser des données horaires (affichant les horodatages par minute), sélectionnez une plage de dates de 3 jours ou moins. Pour approfondir l'analyse et la résolution des erreurs, exportez les données dans un fichier.

Usage Dashboard affiche les types d'erreurs suivants que votre application peut recevoir lorsqu'elle réalise des requêtes de service Web Google Maps APIs. Pour obtenir des solutions, voir la [section dédiée aux services Web Google Maps APIs sur le site Web des développeurs.

Code d'erreur Description
OVER_DAILY_LIMIT La requête de votre application a dépassé la limite journalière. Lorsque cette erreur se produit, le service Web cesse de renvoyer des données jusqu'à ce que l'utilisation autorisée augmente.
OVER_QPS_LIMIT Le nombre de requêtes par seconde (QPS) de votre application pour les services Web a dépassé la limite par seconde. Lorsque cette erreur se produit, le service Web cesse de renvoyer des données jusqu'à ce que l'utilisation autorisée augmente.
INVALID_SIGNATURE La signature numérique de la requête de votre application est incorrecte. Pour plus d'informations sur les signatures et la génération de signatures, voir la section dédiée aux signatures numériquessur la page Authentification et autorisation.
INVALID_REQUEST Le service Web n'a pas pu analyser la requête de votre application. Cette erreur se produit généralement lorsqu'il manque des informations pour une requête.
INTERNAL_ERROR Une erreur s'est produite lors du traitement de la requête de votre application, mais le service Web n'en a pas indiqué la raison.

Support et feedback

Obtenir un support technique

Si vous avez besoin d'aide relativement à Google Maps APIs for Work Usage Dashboard, vous pouvez créer une demande d'assistance dans le Google Cloud Support Portal.

  1. Connectez-vous au Google Cloud Support Portal.
    Remarque : Si vous n'avez pas d'identifiant de connexion, vous pouvez déposer une demande d'accès sur le portail.
  2. Cliquez sur l'onglet Cases.
  3. Cliquez sur Create New Case.
  4. Pour Product Name, cliquez sur My product isn’t listed. Choisissez ensuite Google Maps dans la liste déroulante.
  5. Pour Group et Components (de la demande), sélectionnez Other.
  6. Définissez Priority selon les désignations de priorité.
  7. Dans la description, incluez un résumé du problème et les étapes à effectuer pour le reproduire. Indiquez bien que le problème concerne Google Maps APIs for Work Usage Dashboard.

Nous envoyer votre feedback

Vous pouvez suggérer une fonctionnalité, signaler un problème ou envoyer tout autre commentaire concernant Google Maps APIs for Work Usage Dashboard. Même si nous ne pouvons pas vous répondre personnellement, nous utiliserons votre feedback pour améliorer votre expérience avec Usage Dashboard.

  1. Dans l'angle inférieur droit de tout onglet Dashboard, cliquez sur le bouton Send Feedback image of Feedback button.
  2. Suivez les instructions affichées à l'écran.