Guide de facturation pour Google Maps Platform et Mobility

Avant d'implémenter un nouveau projet Google Maps en production, vous devez vous assurer que votre configuration est correcte afin de payer le bon montant pour les produits que vous utilisez. Dans ce document, nous abordons les aspects permettant de vous assurer que vous disposez (i) d'une transparence de facturation, afin que l'utilisation puisse être vérifiée avant qu'une facture ne soit générée, et (ii) d'une configuration de projet appropriée, pour vous permettre d'utiliser nos produits.

Bien que ce processus soit relativement simple, les partenaires Maps peuvent vous aider à vous assurer que vos projets sont correctement transférés.

Concepts

Dans cette section, nous souhaitons vous assurer que vous comprenez les informations de base sur la facturation Google Maps et les différentes configurations possibles. Dans de nombreuses situations, il n'y a pas de bonne ou de mauvaise réponse. Tout dépend du type de résultat que vous essayez d'obtenir.

Tout au long de ce document, nous parlons beaucoup de votre projet Google Cloud. En effet, les produits Google Maps sont disponibles via cette plate-forme. Cela signifie que la configuration décrite dans ce document est effectuée dans votre projet Google Cloud.

Comptes de facturation

Chaque entreprise qui utilise des produits Google Maps aujourd'hui a un projet Google Cloud associé. Un compte de facturation doit être configuré pour ce projet. Le compte de facturation est chargé de comptabiliser l'ensemble de l'utilisation de Google Maps et de créer une facture mensuelle en fonction de cette utilisation.

Pour Mobility, un compte de facturation spécial est provisionné. Ce compte de facturation ne doit être utilisé que pour les cas d'utilisation liés à la mobilité, tels que le covoiturage, la livraison et la logistique.

Un seul compte de facturation peut être utilisé par plusieurs projets Google Cloud ou par un seul.

Un seul projet pointant vers le même compte de facturation:

• Cas d'utilisation spécifique (par exemple, cas d'utilisation de la mobilité)
• Factures distinctes
• La remise est appliquée sur le volume de ce projet unique.

Plusieurs projets pointant vers le même compte de facturation:

• Même cas d'utilisation
• Profiter des niveaux de remise en agrégant l'utilisation
• Facture unique

Pour en savoir plus sur les comptes de facturation et obtenir d'autres informations utiles, cliquez ici.

Comme indiqué ci-dessus, un seul compte de facturation peut faire référence à plusieurs projets. Si vous avez plusieurs projets, vous devez identifier ceux qui utiliseront nos services de mobilité et les associer à un compte de facturation de mobilité. Les projets qui ne sont associés à aucun cas d'utilisation de la mobilité doivent continuer à pointer vers le compte de facturation Google Maps Platform que vous utilisez actuellement. Pour obtenir un compte de facturation pour la mobilité, vous devez signer un contrat de mobilité avec Google ou via un partenaire. Vous pouvez voir ci-dessous comment un compte de facturation s'intègre dans l'ensemble du schéma et les différentes configurations possibles:

Ressources Cloud, compte de facturation et génération de factures

En ce qui concerne les tarifs, Google Maps Platform propose différents niveaux de remises, disponibles via les partenaires Maps ou directement auprès de Google dans certains cas. Ces niveaux sont basés sur le volume. Par conséquent, plus vous utilisez nos produits, moins vous payez (les remises sont appliquées à chaque SKU individuellement). Notre système de facturation identifie vos projets en fonction des identifiants que vous avez utilisés pour appeler nos produits. Il peut s'agir d'une clé API ou d'un compte de service pour certaines API de mobilité:

Clés API

Les API Google Maps Platform sont authentifiées à l'aide d'une clé API. Google identifie le compte de facturation du projet Google Cloud correspondant à l'aide de cette clé API, où la consommation aura lieu.

Exemple de requête à l'API Geocoding:

https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJeRpOeF67j4AR9ydy_PIzPuM&key=YOUR_API_KEY

JWT

Certaines API nécessitent un ID de projet Google Cloud dans l'URL et utilisent un jeton JWT pour l'authentification. Il est donc important de s'assurer que les systèmes appropriés utilisent la bonne méthode d'authentification pour que la facturation se déroule correctement.

Exemple de requête à l'API Fleet Engine:

curl -X GET \ https://fleetengine.googleapis.com/v1/providers/project_id/deliveryVehicles/vehicle-1234 \
  -H 'authorization: Bearer eyJ0eXAiOi...' \
  -H 'cache-control: no-cache' \
  -H 'content-type: application/json' \
  -d '{
    "lastLocation": {
        "location": {
            "latitude": 37.432,
            "longitude": -122.094
        },
        "updateTime": "2022-11-13T17:55:00Z"
    }
}'

Coûts

Sur Google Maps Platform, les coûts sont calculés en fonction du volume de requêtes API. Pour les services de mobilité, nous facturons en fonction du volume de transactions de mobilité facturables, qui correspondent aux trajets ou tâches terminés (expéditions, pas de collectes). Cette valeur est définie avant la signature du contrat. Si vous êtes une entreprise de covoiturage ou de livraison de repas, le nombre de trajets ou de livraisons effectués est votre métrique de réussite. Cela correspond à un trajet. Les tâches sont utilisées par les entreprises de logistique et les marchands qui doivent livrer des colis.

Nous sommes conscients que les clients Mobility utilisent également les produits Google Maps Platform pour effectuer leurs trajets et leurs livraisons. Par conséquent, si vous utilisez un compte de facturation pour la mobilité, vous pouvez appeler Google Maps Platform sans frais, à condition que les limites prédéfinies soient respectées dans le même cas d'utilisation de la mobilité.

Par exemple, si vous êtes une entreprise de livraison de repas, vous pouvez appeler l'API Geocoding dix fois pour chaque trajet réussi. Pour en savoir plus sur ces limites, consultez la section Limites d'utilisation dans la documentation sur la mobilité. Toute modification des plafonds nécessite un avenant à votre contrat. Contactez donc votre représentant Google ou votre partenaire pour discuter de vos besoins spécifiques.

À la fin du mois, une facture sera générée en fonction (i) du nombre de trajets ou de tâches réussis enregistrés dans le système et (ii) du volume d'appels d'API Google Maps Platform dépassant les limites prédéfinies (les "dépassements"). Nos limites correspondent à ce que nous avons globalement identifié comme nécessaire sur le marché.

Nous vous suggérons de lire attentivement la documentation officielle sur la facturation de la mobilité disponible sur cette page.

Pilotes et évaluation

Les clients peuvent exécuter un petit pilote (démonstration de faisabilité, évaluation) des services de mobilité sur un compte de facturation Google Maps Platform pendant une durée limitée avant la signature d'un contrat. Si vous souhaitez lancer un pilote, contactez votre partenaire Maps ou votre homologue Google.

Comme indiqué, aucun compte de facturation pour la mobilité n'est disponible pendant la phase pilote, car le contrat n'a pas encore été signé. Cela signifie que chaque fois que des produits Google Maps Platform sont utilisés, ils seront facturés, mais pas les produits spécifiques à la mobilité. En d'autres termes, pendant la phase pilote, la facturation n'est pas basée sur les tâches ou les trajets. Par conséquent, les limites d'utilisation ne s'appliquent pas pendant cette phase.

Une fois le pilote officiellement lancé en production, il doit être payé conformément au contrat.

En résumé :

• Phase pilote / de développement: vous ne payez que les API Google Maps publiquement disponibles. Les API et les SDK qui ne sont pas disponibles publiquement ne sont pas facturés tant qu'un compte de facturation de mobilité n'est pas utilisé dans le projet. N'oubliez pas que Google offre un crédit de 200 $pour les API Google Maps Platform à tout nouveau compte de facturation créé. Cela devrait suffire pour un environnement contrôlé pendant la période d'évaluation.

• Phase de production: vous êtes facturé en fonction des trajets ou des tâches. Les coûts associés à Google Maps Platform ne sont facturés que si l'utilisation dépasse les limites d'utilisation (plafonds) du contrat. Dans ce cas, vous devrez payer les dépassements. Les dépassements sont facturés comme indiqué ici.

Migrer vers un compte de facturation pour la mobilité

Lorsque vous passez en production, vous devez généralement créer des projets Google Cloud supplémentaires pour représenter vos différents environnements, tels que l'assurance qualité et la production. Avant cela, vous n'avez probablement qu'un seul environnement, celui de développement.

Conditions requises

Une personne de votre côté qui peut:

1. Gérer les comptes de facturation dans Google Cloud (généralement, l'administrateur du compte de facturation ou le propriétaire du projet).
2. Accès au nouveau numéro de compte de facturation fourni dans la lettre de bienvenue générée après la signature du contrat.
3. Accès au projet Google Cloud correspondant à l'environnement de production dans lequel les trajets ou les tâches seront enregistrés.

Pour configurer de nouveaux projets et leur facturer, procédez comme suit.

Nouvelle configuration du projet

Créer un projet

1. [Vous] Créez un projet GCP dans la console Google Cloud pour chaque nouvel environnement. Par exemple, la production, la préproduction et l'assurance qualité.
2. [Partenaire ou équipe Google] Ajoutez des projets à une liste d'autorisation pour accéder aux produits Mobility. Contactez votre conseiller commercial Google ou votre partenaire, et indiquez l'ID de projet créé à l'étape précédente.
3. [Vous] Mettez à jour les contacts essentiels de vos projets. Cette étape est très importante pour s'assurer que les équipes d'assistance Google peuvent contacter les bonnes personnes pour votre projet si nécessaire.

Configuration du projet

Effectuez les étapes suivantes dans la console Google Cloud pour le projet créé dans les étapes précédentes:

1. [Vous] Créez des comptes de service, y compris l'association des rôles IAM (Identity and Access Management) appropriés (basés sur les trajets et basés sur les tâches).

   • comme cela a été fait dans l'environnement de développement ou avec une ségrégation des accès plus structurée si nécessaire (voir cette section).

2. [Vous] Créez des clés API, comme cela a été fait dans l'environnement de développement ou avec une ségrégation des accès plus structurée (par produit, domaine, etc.) si nécessaire.

3. [Vous] Activez des API telles que "Local Rides and Deliveries" et d'autres API Google Maps Platform nécessaires (par exemple, Geocoding, Autocomplete, Address Validation).

4. [Vous] Quota: si vous avez besoin d'augmenter le nombre de requêtes par minute (RPM) pour certaines API, ouvrez une demande d'assistance. Pour savoir comment procéder, cliquez ici. Vous devez ajouter une justification métier indiquant pourquoi cette augmentation est nécessaire. Pour consulter les quotas prédéfinis, cliquez ici.

5. [Vous] Si vous avez développé des systèmes qui utilisaient des identifiants de l'environnement de développement, assurez-vous qu'ils peuvent pointer vers les nouveaux identifiants créés pour les nouveaux projets. Cela inclut la redirection des systèmes backend et frontend vers les nouveaux identifiants tels que les clés API, les comptes de service et s'assurer que les bons ID de projet sont utilisés dans chaque environnement respectif.

Configuration de facturation

Nous supposons que vous avez déjà signé un contrat directement avec Google (le cas échéant) ou via un partenaire. Cette condition est requise pour recevoir le compte de facturation Mobility dans la lettre de bienvenue, qui sera utilisé lors des prochaines étapes.

1. [Vous] Vérifiez si un ID de compte de facturation de mobilité a été reçu dans le courrier de bienvenue envoyé par e-mail par Google après la signature et l'exécution du contrat. Important: La lettre de bienvenue est envoyée aux contacts techniques et financiers indiqués sur le formulaire de commande de votre contrat. Travaillez avec votre équipe de projet pour déterminer qui a pu le recevoir et demandez-lui de vous fournir l'ID du compte de facturation, qui est une série de caractères et de chiffres séparés par un trait d'union.
2. [Vous] Contactez Google ou votre partenaire pour vous assurer qu'une validation de la facturation est effectuée. Cela signifie que vos systèmes transmettent déjà correctement les trajets ou les tâches à Google. Pour en savoir plus, consultez la section suivante.
3. [Vous] Pointez vos projets Google Cloud vers le nouveau compte de facturation à l'aide de la console Cloud. Consultez la section Configuration du compte de facturation plus loin dans ce document.

Pour en savoir plus sur la facturation en général, consultez cette page et cette page.

Validation des informations de facturation

La validation de la facturation est importante pour vous assurer que vous êtes facturé correctement. Il arrive que les entreprises implémentent accidentellement des API de manière incorrecte, ce qui entraîne des frais supplémentaires ou une sous-déclaration.

La validation de la facturation comprend les étapes suivantes:

1. Vérifier si les requêtes envoyées aux API Google Maps Platform contiennent un tripId (ou taskId) dans l'en-tête de la requête (en savoir plus).

2. Vérifier si les trajets (ou les tâches) sont correctement enregistrés Cela dépend du package de mobilité utilisé:

   • Mobility Starter et Optimize, ou Accelerate (basé sur les trajets): l'intégration de l'API ReportBillableEvent est requise. Cela signifie que chaque fois qu'un trajet est effectué, une requête doit être envoyée à cette API. Pour vérifier que cela se produit correctement, vous devez suivre ces étapes.
   • Mobility Accelerate (basé sur les tâches): la facturation n'a pas besoin d'être déclenchée par un appel d'API. Cela se produit automatiquement lorsque le résultat d'une tâche est défini sur "RÉUSSI" pour une tâche de diffusion. Il est donc très important de définir correctement le résultat de la tâche sur "FAILED" ou "SUCCEEDED". Les ingénieurs client (partenaires ou Google) collaboreront avec vous pour vérifier que l'implémentation a été correctement effectuée. Grâce à Cloud Logging, vous pouvez vérifier si les tâches sont correctement mises à jour en exécutant la requête Cloud Logging suivante:

   resource.type="fleetengine.googleapis.com/DeliveryFleet"
   jsonPayload.@type="type.googleapis.com/maps.fleetengine.delivery.log.v1.UpdateTaskLog"
   jsonPayload.request.task.taskOutcome="TASK_OUTCOME_LOG_SUCCEEDED"
   

   Si des entrées s'affichent, cela signifie que vos systèmes backend définissent correctement les tâches sur "RÉUSSI".

   Remarque: Il est toutefois important de vérifier si le nombre de trajets ou de tâches réellement effectués correspond au nombre d'appels signalés. Il arrive que des événements de facturation soient signalés, mais qu'ils ne correspondent pas au nombre total de trajets ou de tâches effectués dans la réalité (sous-déclaration).

État de l'intégration

Une migration vers la production réussie ne doit pas seulement garantir que la facturation fonctionne correctement, mais aussi que les API ne rencontrent pas d'erreurs d'exécution. En ce qui concerne les services de mobilité, il est important de vérifier si l'intégration avec Fleet Engine (API Local Rides and Deliveries) a été correctement implémentée.

Pour ce faire, vous pouvez ouvrir Cloud Logging et utiliser la requête suivante:

jsonPayload.errorResponse.code:*

Toutes les entrées de journal présentant des problèmes devraient s'afficher. Par exemple :

Ces problèmes peuvent être exportés vers d'autres produits Cloud, comme BigQuery. Vous pouvez configurer des métriques et des alertes en fonction de la requête Cloud Logging:

Comme il s'agit de produits Google Cloud, des coûts supplémentaires peuvent s'appliquer. Pour en savoir plus, vous pouvez contacter votre partenaire ou votre représentant Google.

Configuration du compte de facturation

Si tous vos systèmes enregistrent désormais correctement les trajets ou les tâches et qu'aucune erreur d'intégration n'est détectée, il est temps de diriger vos projets vers le compte de facturation que vous avez reçu dans la lettre de bienvenue et qui a été abordé dans les sections précédentes de ce document.

Remarque: Si vous collaborez avec un partenaire Maps, il peut vous aider à ce stade. Vous n'avez donc pas besoin de suivre les étapes ci-dessous seul. Si vous travaillez directement avec Google, ce qui peut être le cas dans certaines régions, vous pouvez suivre les étapes ci-dessous:

Pour ce faire, procédez comme suit :

1. Ouvrez la console Google Cloud (https://console.cloud.google.com).
2. Sélectionnez le nouveau projet qui sera utilisé en production.
3. Accédez à la section "Facturation" de ce projet. Vous pouvez accéder à cette page pour accéder rapidement à la console: https://console.cloud.google.com/billing.
4. Facturation > Cliquez sur "Gérer les comptes de facturation" :

   

   Votre projet peut être différent de celui ci-dessus.
5. Dans "Facturation", cliquez sur l'icône à trois points  à côté du projet de production créé, puis sélectionnez "Modifier le compte de facturation" :

   

6. Facturation > Compte de facturation, sélectionnez le code de compte de facturation que vous avez reçu dans la lettre de bienvenue dans la liste déroulante. Cliquez ensuite sur "DÉFINIR LE COMPTE" :

   

7. Le projet sera associé au nouveau compte de facturation :

   

   Important: À partir de ce moment, tous les trajets ou tâches enregistrés dans ce projet seront facturés comme expliqué précédemment. Si la validation de la facturation n'a pas encore été effectuée, n'associez pas encore le compte de facturation.
8. Une fois le nouveau mode de facturation ajouté, accédez à "Vue d'ensemble > Vue d'ensemble des paiements" et "Paramètres de paiement" pour vérifier que les informations sont correctes. Pour savoir comment mettre à jour vos informations de facturation et de paiement, veuillez consulter cette page. Pour tout problème lié à la facturation, veuillez déposer une demande d'assistance concernant la facturation ou contacter votre partenaire ou votre représentant Google.

Rapports sur la facturation

Les rapports de facturation vous aident à comprendre les coûts associés au compte de facturation associé au projet.

Remarque: Si vous collaborez avec un partenaire Maps, veuillez vous assurer qu'il vous fournit les informations de facturation dont vous avez besoin.

Ouvrez le compte de facturation associé au projet, puis sélectionnez "Rapports". Vous pouvez ensuite utiliser l'ensemble de filtres suivant:

Le paramètre principal à garder à l'esprit est le filtre Grouper par par SKU, qui affiche des informations détaillées sur les trajets et les tâches, ainsi que sur d'autres API si elles sont utilisées, y compris si des dépassements ont été enregistrés ou non, comme expliqué précédemment:

Les informations des rapports sont actualisées quotidiennement. Si des informations intrajournalières sont nécessaires, vous pouvez utiliser des requêtes Cloud Logging pour connaître le nombre d'événements facturables survenus au cours de la journée. Pour en savoir plus, consultez les sections précédentes.

Plan d'activation progressive

Un point important à mentionner est votre plan d'augmentation. Il est courant que tout le trafic ne soit pas migré vers le projet de mobilité, en fonction de la nature de votre activité. Par exemple, certaines entreprises prennent du temps à déployer la nouvelle solution dans toutes leurs succursales, franchises, magasins, bureaux, etc., ce qui signifie qu'une partie du trafic utilisera les anciens systèmes et une autre le nouveau projet.

De plus, dans de nombreux cas, tout le trafic n'appartient pas à un cas d'utilisation de mobilité, comme c'est le cas pour les outils de localisation de magasins, le retrait en bordure de rue et d'autres solutions internes. Ils doivent pointer vers un compte de facturation Google Maps Platform, car le trafic doit être séparé du compte de facturation de mobilité.

Il est important de respecter le règlement sur l'implémentation:

• Modèle basé sur les trajets : "La solution Courses et livraisons à la demande est destinée aux services de courses et de livraisons commerciaux à la demande. Ces services incluent généralement (a) des consommateurs qui envoient des demandes de trajet vers une destination donnée (ou de livraison d'un article spécifique) et (b) des chauffeurs qui sont mis en correspondance avec les demandes et qui conduisent un véhicule pour effectuer les services."
• Modèle basé sur les tâches : "La solution de parc de véhicules pour le dernier kilomètre de Google Maps Platform est destinée aux services de livraison et de retrait commerciaux du dernier kilomètre. Ces services incluent généralement (a) une flotte de véhicules de livraison appartenant au Client ou sous-traités par celui-ci, (b) des livraisons basées sur un itinéraire préplanifié, (c) un réseau de centres de distribution avec des équipes opérationnelles qui facilitent l'exécution des livraisons, et (d) des consommateurs qui suivent et reçoivent ensuite les envois."

Vous devez donc déterminer quels systèmes doivent pointer vers le compte de facturation Google Maps Platform et lesquels vers le compte de facturation de la mobilité. Il est courant de disposer de plusieurs projets, chacun pointant vers le bon compte de facturation.

Par exemple, chaque trajet / tâche inclut actuellement 10 requêtes de géocodage, conformément aux limites d'utilisation. Si votre migration va prendre quelques mois et que vous commencez à enregistrer 100 000 trajets / tâches au cours du premier mois, cela signifie que vous pouvez appeler l'API Geocoding un million de fois. Toutefois, si votre entreprise génère 5 millions de requêtes de géocodage, cette différence (4 millions) peut être comptabilisée comme dépassement. Deux options s'offrent à vous:

1. Vous augmentez le nombre de trajets / tâches que vous nous signalez (vous accélérez le plan d'augmentation), des limites plus élevées s'appliquent. Dans ce cas, vous devez signaler 500 000 trajets / tâches par mois.
2. Vous négociez des limites plus élevées lors des négociations contractuelles, comme expliqué précédemment.
3. Vous dirigez les requêtes de l'API Geocoding vers une API Google Maps Platform pour bénéficier de niveaux de remise plus élevés et payer moins cher que les dépassements.

Nous savons que l'estimation des coûts peut être complexe en fonction de la taille et de la complexité de votre entreprise et de vos cas d'utilisation. Veuillez collaborer avec votre partenaire ou votre homologue Google pour déterminer la meilleure façon de vous préparer au lancement en production à l'aide de vos projets existants.

Pour résumer, voici les étapes à suivre pour créer un plan de montée en puissance approprié : 1. Identifiez les cas d'utilisation liés à la mobilité et ceux qui ne le sont pas, conformément au règlement d'implémentation. 2. Identifiez les API Google Maps Platform utilisées aujourd'hui pour les cas d'utilisation pertinents et leurs volumes. 3. Déterminez si les API Google Maps Platform seront toujours nécessaires après l'implémentation de la solution de mobilité. Par exemple, le calcul de l'heure d'arrivée estimée est effectué automatiquement sur Fleet Engine. Vous n'aurez peut-être plus besoin de le calculer avec l'API Directions. 4. Déterminez le temps nécessaire pour migrer complètement les cas d'utilisation de la mobilité vers la nouvelle plate-forme de mobilité. 5. Vérifiez que les limites d'utilisation sont suffisantes pour prendre en charge vos cas d'utilisation. 6. Identifiez le point d'inflexion à partir duquel toutes les requêtes Google Maps Platform peuvent être regroupées dans le compte de facturation de la mobilité pour les cas d'utilisation de la mobilité.

Conclusion

En conclusion, une configuration correcte du compte de facturation est essentielle pour la prévisibilité et la transparence des prix. En utilisant notre technologie de mobilité qui intègre des services de localisation de pointe, les entreprises peuvent être sûres que leurs processus de facturation sont précis et efficaces. Cela permet non seulement de réduire les coûts, mais aussi de fournir les données et les insights nécessaires pour prendre des décisions commerciales éclairées. De plus, la transparence offerte par un tel système permet aux entreprises d'avoir une compréhension claire de leurs dépenses, ce qui améliore la gestion de leur budget.

Étapes suivantes

• Configurez votre compte de facturation dans la console GCP.
• Pour en savoir plus sur la facturation en général, consultez la page
  • Documentation commerciale sur les services de mobilité
  • Activez, désactivez ou modifiez la facturation pour un projet bookmark_border.