Cette page a été traduite par l'API Cloud Translation.

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 points à prendre en compte pour vous assurer que : la transparence de la facturation (afin de pouvoir vérifier l'utilisation avant la génération d'une facture) ; et (ii) la bonne configuration de projet, pour vous assurer que vous pouvez utiliser nos produits.

Ce processus devrait être relativement simple, mais les partenaires Maps peuvent vous aider à transférer correctement vos projets.

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 toute l'utilisation de Google Maps et de créer une facture mensuelle basée sur cette utilisation.

Pour Mobility, un compte de facturation spécial est provisionné. Ce compte de facturation est destiné à n'être utilisé que pour des cas d'utilisation liés à la mobilité, tels que le partage de course, la livraison et la logistique.

Un seul compte de facturation peut être utilisé par plusieurs projets Google Cloud ou 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 mobile. 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 trouverez ci-dessous la façon dont un compte de facturation s'intègre dans l'ensemble du schéma, ainsi que les différentes configurations possibles:

**Configurations de compte de facturation 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 en fonction de cette clé API, où l'utilisation a lieu.

Exemple de requête envoyée à 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. Par conséquent, il est important de s'assurer que les systèmes appropriés utilisent la méthode d'authentification appropriée pour que la facturation se déroule correctement.

Exemple de requête envoyée à 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 effectués (expéditions, pas de collectes). Ceci est défini avant la signature du contrat. Si vous êtes une entreprise de partage de course ou de livraison de repas, votre critère de réussite est d'effectuer un trajet ou une livraison. 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 à domicile, vous pouvez appeler l'API Geocoding 10 fois pour chaque trajet réussi que vous effectuez. Pour en savoir plus sur ces limites, consultez Limites d'utilisation dans la documentation sur la mobilité. Toute modification des plafonds nécessite un avenant au contrat. Par conséquent, contactez votre représentant Google ou celui de 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 (appelés "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.

Pendant la phase pilote, comme indiqué, aucun compte de facturation mobile n'est disponible, car le contrat n'a pas encore été signé. Cela signifie que chaque fois que des produits Google Maps Platform sont utilisés, ils sont facturés, mais ce n'est pas le cas pour 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 lancé officiellement en production, il doit être payé conformément au contrat.

En résumé :

Phase pilote / de développement: seules les API Google Maps accessibles vous sont facturées. Les API et les SDK qui ne sont pas accessibles au public n'entraînent aucuns frais tant qu'un compte de facturation mobile 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 être suffisant 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. Si c'est le cas, vous paierez les dépassements. Les dépassements sont facturés comme défini ici.

Migrer vers un compte de facturation pour la mobilité

Lorsque vous migrez vers la 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 avez probablement un environnement unique, celui du développement.

Conditions requises

Une personne de votre côté qui peut :

Gérer les comptes de facturation sur Google Cloud, généralement par l'administrateur du compte de facturation ou le propriétaire du projet
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.
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

[Vous] Créez un projet GCP dans le Console Google Cloud pour chaque nouvel environnement. Exemples : production, préproduction et qualité garantie.
[Partenaire ou équipe Google] Ajoutez des projets à une liste d'autorisation pour y accéder les produits Mobility. Contactez votre conseiller commercial Google ou votre partenaire, et indiquez l'ID de projet créé à l'étape précédente.
[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éé lors des étapes précédentes:

[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).
[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 exemple, par produit, par domaine, etc.) si nécessaire.
[Vous] Activez des API telles que "Local Rides and Deliveries" (Courses et livraisons locales) et d'autres API Google Maps Platform nécessaires (par exemple, Geocoding, Autocomplete, Address Validation).
[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.
[Vous] Si vous disposez de systèmes développés qui utilisent des identifiants issus du environnement de développement, assurez-vous que ces systèmes sont en mesure de pointer vers les nouveaux identifiants créés pour les projets créés. 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.

[Vous] Vérifiez si un ID de compte de facturation de mobilité a été reçu dans la lettre de bienvenue envoyée 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.
[Vous] Collaborez avec Google ou un partenaire pour vous assurer qu'une validation de la facturation a été effectuée. Cela signifie que vos systèmes signalent déjà correctement les trajets ou les tâches à Google. Pour en savoir plus, consultez la section suivante.
[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 de la facturation

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

La validation de la facturation comprend les étapes suivantes :

Vérifiez si les requêtes envoyées aux API Google Maps Platform comportent un tripId (ou taskId) dans l'en-tête de la requête (en savoir plus).
Vérifier si les trajets (ou les tâches) sont correctement enregistrés Tout dépend du package 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. Par conséquent, il est très important de définir correctement le résultat de la tâche sur ÉCHEC ou Réussite. Des ingénieurs client (partenaires ou Google) travailleront avec vous pour vérifier que l'implémentation a été effectuée correctement. Avec 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 suivis. Parfois, des événements de facturation sont signalés, mais ils ne correspondent pas au nombre total de trajets ou de tâches réellement effectués dans la vie réelle (sous-évaluation).

État de l'intégration

Une migration réussie vers l'environnement de production ne doit pas seulement garantir le bon fonctionnement de la facturation, mais aussi que l'exécution des API fonctionne correctement. En ce qui concerne les services de mobilité, il est important de vérifier que 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 :

Interroger les erreurs à l'aide de Cloud Logging — **Erreurs de requête à l'aide de Cloud Logging**

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

Création de métriques à partir d'une requête Cloud Logging — **Création de métrique à partir d'une requête Cloud Logging**

Comme il s'agit de produits Google Cloud, des coûts supplémentaires peuvent s'appliquer. Vous pouvez contacter votre partenaire ou votre représentant Google pour obtenir plus de précisions.

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 :

Ouvrez la console Google Cloud (https://console.cloud.google.com).
Sélectionnez le nouveau projet qui sera utilisé en production.
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.
Facturation > Cliquez sur "Gérer les comptes de facturation" :
<ph type="x-smartling-placeholder"></ph>
Votre projet peut être différent de ce qui précède.
Dans "Facturation", cliquez sur l'icône à trois points à côté du projet de production créé, puis sélectionnez "Modifier le compte de facturation" :
Facturation > sur "Compte de facturation", choisissez le code du compte de facturation que vous avez reçu dans la lettre de bienvenue de la liste déroulante. Ensuite, cliquez sur "Définir le compte" :
<ph type="x-smartling-placeholder"></ph>
Le projet sera associé au nouveau compte de facturation:
<ph type="x-smartling-placeholder"></ph>
Important: À partir de ce moment-là, tous les trajets ou tâches indiqués dans ce projet seront facturés comme indiqué précédemment. Si la validation de la facturation n'a pas encore eu lieu, n'associez pas encore le compte de facturation.
Une fois la nouvelle méthode de facturation ajoutée, accédez à Présentation > Vue d'ensemble des paiements" et "Paramètres de paiement" pour vérifier si les informations sont correctes. Pour en savoir plus sur la mise à jour des informations de facturation et de paiement, cliquez ici. Pour tout problème lié à la facturation, veuillez déposer une facturation demande d'assistance 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 travaillez avec un partenaire Maps, veuillez le contacter pour vous assurer que vous avez accès aux informations de facturation pertinentes.

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

Filtres du rapport de facturation — **Filtres des rapports sur la facturation**

Ici, le paramètre principal à garder à l'esprit est le filtre Group by (Grouper par) par SKU. Il 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 s'il y a eu des dépassements 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 pour déployer la nouvelle solution dans l'ensemble de leurs succursales, franchises, magasins, bureaux, etc. Cela signifie qu'une partie du trafic utilisera les anciens systèmes et une partie du trafic sera consacrée au nouveau projet.

Par ailleurs, dans de nombreux cas, tout le trafic ne relève pas d'un cas d'utilisation de la mobilité, comme c'est le cas pour les outils de localisation de magasins, le drive 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 la mobilité.

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

Modèle basé sur le trajet – "La solution On-demand Rides and Deliveries est conçue pour être utilisée dans des services commerciaux de transport et de livraison à la demande. Ces services incluent généralement (a) les consommateurs qui envoient des demandes de covoiturage vers une destination donnée (ou la livraison d'un article spécifique), et (b) les conducteurs qui correspondent aux demandes et qui conduisent un véhicule pour effectuer ces 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 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 :

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 donc. Dans ce cas, vous devez signaler 500 000 trajets/tâches par mois.
Comme expliqué précédemment, vous négociez des limites plus élevées lors des négociations de contrats.
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 dépend de la taille et de la complexité de votre entreprise et que les cas d'utilisation peuvent être complexes. 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. Identifier quelles API Google Maps Platform sont actuellement utilisées pour les cas d'utilisation pertinents et leur volume. 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é à vos côtés. 5. Vérifiez que les limites d'utilisation sont suffisantes pour prendre en charge vos cas d'utilisation. 6. Identifier le point d'inflexion à partir duquel toutes les requêtes Google Maps Platform peuvent être associées au compte de facturation de la mobilité pour les cas d'utilisation de la mobilité.

Conclusion

En conclusion, il est essentiel de configurer correctement le compte de facturation pour assurer la prévisibilité des prix et la transparence. 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 conduit à une meilleure gestion du 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é
- Activer, désactiver ou modifier la facturation d'un projet favori_border