Avant de mettre en œuvre 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 nécessaires pour garantir (i) la transparence de la facturation, afin que l'utilisation puisse être vérifiée avant la génération d'une facture, et (ii) la bonne configuration du projet, afin de garantir que vous pouvez utiliser nos produits.
Ce processus devrait être relativement simple, mais les partenaires Maps peuvent vous aider à s'assurer que vos projets sont déplacés correctement.
Concepts
Dans cette section, nous souhaitons nous assurer que vous comprenez les informations de base concernant la facturation Google Maps, ainsi que les différentes configurations possibles. Il n'y a pas de bon ou de mal dans de nombreuses situations, cela 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 y sont accessibles. Cela signifie que la configuration que nous aborderons dans ce document est effectuée dans votre projet Google Cloud.
Comptes de facturation
Aujourd'hui, toutes les entreprises qui utilisent les produits Google Maps sont associées à un projet Google Cloud. Un compte de facturation doit être configuré pour ce projet. Le compte de facturation est chargé de cumuler toute l'utilisation de Google Maps et de créer une facture mensuelle en fonction de cette utilisation.
Pour la mobilité, un compte de facturation spécial est provisionné. Ce compte de facturation est destiné à être utilisé uniquement 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 par un seul.
Projet unique pointant vers le même compte de facturation:
- Cas d'utilisation spécifique (cas d'utilisation pour la mobilité)
- Factures séparées
- La remise est effectuée en fonction du volume pour ce projet unique
Plusieurs projets pointant vers le même compte de facturation:
- Même cas d'utilisation
- Profitez des niveaux de remise en regroupant l'utilisation
- Facture unique
Pour plus d'informations sur les comptes de facturation et d'autres informations pertinentes, cliquez sur ce lien.
Comme indiqué ci-dessus, un seul compte de facturation peut pointer vers plusieurs projets. Si vous gérez plusieurs projets, vous devez identifier ceux qui utiliseront nos services de mobilité et les orienter vers un compte de facturation pour la mobilité. Les projets qui ne sont associés à aucun cas d'utilisation pour la mobilité doivent continuer à pointer vers le compte de facturation Google Maps Platform standard que vous utilisez actuellement. Pour obtenir un compte de facturation pour la mobilité, vous devez signer un accord de mobilité avec Google ou un partenaire. Vous pouvez voir ci-dessous comment un compte de facturation s'intègre à l'ensemble du schéma et aux différentes configurations possibles:
Ressources cloud, compte de facturation et génération de factures
Concernant les prix, Google Maps Platform propose différents niveaux de remises, disponibles via Maps Partners ou directement auprès de Google dans certains cas. Ces niveaux sont basés sur le volume. Ainsi, plus vous utilisez nos produits, plus vous payez moins (des 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. C'est à partir de cette clé API que Google identifie le compte de facturation du projet Google Cloud correspondant, dans lequel la consommation 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 bons systèmes utilisent la bonne méthode d'authentification pour s'assurer que la facturation est effectuée 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, c'est-à-dire des trajets ou des tâches terminés (livraisons, et non enlèvements). Ce point est défini avant la signature du contrat. Si vous êtes une entreprise de partage de course ou de livraison de repas à domicile, la réalisation d'un trajet ou d'une livraison constitue votre critère de réussite : cela correspond à un trajet. Tasks est utilisé pour les entreprises et les marchands de logistique qui doivent réussir la livraison de colis.
Nous sommes conscients que les clients Mobility utilisent également les produits Google Maps Platform pour exécuter 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 tant que les limites prédéfinies sont respectées pour 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 10 fois pour chaque trajet réussi que vous effectuez. 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 une modification de votre contrat. Par conséquent, adressez-vous à votre représentant Google ou 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 au-delà des limites préétablies ("dépassements"). Nos limites sont alignées sur ce que nous avons constaté globalement comme nécessaire sur le marché.
Nous vous recommandons de lire attentivement la documentation officielle de facturation pour la mobilité, disponible sur cette page.
Pilotes et évaluation
Les clients peuvent exécuter un petit pilote (preuve 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 programme pilote, contactez votre partenaire Maps ou votre homologue Google.
Pendant la phase pilote, comme indiqué précédemment, aucun compte de facturation pour la mobilité n'est disponible, car le contrat n'a pas encore été signé. Cela signifie que chaque fois que vous utilisez des produits Google Maps Platform, vous êtes facturé, mais pas les produits spécifiques à la mobilité. Autrement dit, 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: vous ne payez que pour les API Google Maps disponibles publiquement. Les API et SDK qui ne sont pas disponibles publiquement n'entraînent aucuns frais tant qu'un compte de facturation de la mobilité n'est pas utilisé dans le projet. N'oubliez pas que Google offre 200 $de crédits pour les API Google Maps Platform à tout compte de facturation créé. Cela devrait suffire pour un environnement contrôlé pendant la période d'évaluation.
Phase de production: vous êtes facturé par trajets ou par tâches. Les coûts associés à Google Maps Platform ne seront facturés que si l'utilisation dépasse les limites d'utilisation ("plafonds") définies dans le contrat. Si c'est le cas, vous allez payer pour les dépassements. Les dépassements sont facturés comme indiqué sur cette page.
Migrer vers un compte de facturation pour la mobilité
Lorsque vous passez à l'environnement de production, vous devez généralement créer plusieurs projets Google Cloud Platform (GCP) pour représenter vos différents environnements, tels que le contrôle 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:
- Gérer les comptes de facturation sur Google Cloud est généralement effectué par l'administrateur du compte de facturation ou le propriétaire du projet.
- Accès au nouvel ID de compte de facturation indiqué dans le courrier de bienvenue généré 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 signalés.
Vous trouverez ci-dessous la procédure à suivre pour configurer un nouveau projet, ainsi que la procédure à suivre pour configurer la facturation de ces nouveaux projets.
Configuration d’un nouveau projet
Création de projet
- [Vous] Création d'un ou de plusieurs projets GCP pour le ou les nouveaux environnements (production, assurance qualité, etc.) Cette opération s'effectue via la console Google Cloud (lien direct ici).
- [Partenaire ou équipe Google] Ce projet doit être ajouté à la liste d'autorisation pour avoir accès aux produits de mobilité. Pour ce faire, adressez-vous à votre conseiller commercial chez Google ou à un partenaire. Indiquez l'ID du projet créé à l'étape précédente.
- [Vous] Mettez à jour les contacts essentiels sur vos projets. Cette étape est très importante pour que les équipes d'assistance Google puissent contacter les bonnes personnes à vos côtés.
Configuration du projet
Les étapes ci-dessous doivent être effectuées dans la console Google Cloud sur le projet créé lors des étapes précédentes:
- [Vous] Créez des comptes de service, y compris l'association des rôles IAM (Mobilité Identity and Access Management) appropriés (basé sur les trajets et basés sur les tâches), comme c'est le cas dans l'environnement de développement ou en définissant une séparation des accès plus structurée si nécessaire. Consultez cette section.
- [Vous] Création de clés API, comme vous le faisiez dans l'environnement de développement ou avec une séparation des accès plus structurée (par produit, domaine, etc.) si nécessaire.
- [Vous] Activer des API telles que "Local Rides and Deliveries" 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 RPS (requêtes par seconde) pour certaines API, envoyez une demande d'assistance. Cliquez ici pour savoir comment procéder. Vous devez ajouter une justification métier expliquant pourquoi l'amélioration est nécessaire. Pour consulter les quotas prédéfinis, cliquez ici.
- [Vous] Si vous avez développé des systèmes qui utilisent les identifiants de l'environnement de développement, assurez-vous qu'ils peuvent pointer vers les nouveaux identifiants créés pour les projets créés. Cela implique de pointer les systèmes backend et frontend vers les nouveaux identifiants, tels que les clés API et les comptes de service, et de s'assurer que les ID de projet appropriés sont utilisés dans chaque environnement respectif.
Configuration de facturation
Nous partons du principe que vous avez déjà signé un contrat avec Google directement (le cas échéant) ou via un partenaire. Il s'agit d'un prérequis pour recevoir le compte de facturation Mobility dans la lettre de bienvenue, qui sera utilisée dans les prochaines étapes.
- [Vous] Vérifiez si un ID de compte de facturation pour la mobilité a été reçu dans le courrier de bienvenue envoyé par Google par e-mail après la signature et la signature du contrat. Important: La lettre de bienvenue est envoyée aux contacts techniques et financiers indiqués sur le bon de commande de votre contrat. Demandez à l'équipe de projet de vous fournir l'ID du compte de facturation, composé d'une série de caractères et de chiffres séparés par un trait d'union, afin de savoir qui l'a peut-être reçu.
- [Vous] Collaborez avec Google ou un partenaire pour vous assurer que la validation de la facturation est 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] Faites pointer 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 garantir que les montants vous sont facturés correctement. Parfois, les entreprises implémentent accidentellement des API de manière incorrecte, ce qui entraîne une augmentation des frais ou une sous-évaluation des coûts.
La validation de la facturation comprend les étapes suivantes:
Vérifier si les requêtes envoyées aux API Google Maps Platform comportent un tripId (ou taskId) dans leur en-tête (en savoir plus)
Vérifier si les trajets (ou les tâches) sont correctement signalés. Cela dépend du forfait de mobilité utilisé:
- Mobility Starter et Optimize ou Accelerate (Trip Based): l'intégration à l'API ReportfacturableEvent est requise. Cela signifie que chaque fois qu'un trajet est terminé, une requête doit être envoyée à cette API. Pour savoir si cela se produit correctement, vous devez suivre cette procédure.
- Mobility Accelerate (tâche basée sur les tâches): la facturation ne doit pas nécessairement être déclenchée par un appel d'API. Cela se produit automatiquement lorsqu'un résultat de tâche est défini sur SUCCEEDED pour une tâche de livraison. Par conséquent, il est très important de définir correctement le résultat de la tâche sur ÉCHEC ou SUCCEEDED. Un ingénieur client (partenaires ou Google) vérifiera avec vous que la mise en œuvre a été effectuée correctement. Dans Cloud Logging, vous pouvez vérifier si les tâches sont mises à jour correctement 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 sont affichées, cela signifie que vos systèmes backend définissent correctement les tâches sur RÉUSSITE.
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 enregistrés. Il arrive que des événements de facturation soient enregistrés, mais qu'ils ne correspondent pas au nombre total de trajets ou de tâches réellement effectués en situation réelle (sous-évaluation).
État de l'intégration
Une migration réussie vers l'environnement de production ne doit pas seulement garantir que la facturation fonctionne correctement, mais aussi que l'exécution des API fonctionne correctement. 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:*
Vous devriez obtenir la liste de toutes les entrées de journal présentant des problèmes. Exemple :
Vous pouvez exporter ces problèmes vers d'autres produits Cloud tels que BigQuery. Les métriques et les alertes peuvent être configurées 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 signalent désormais correctement les trajets ou les tâches et qu'aucune erreur d'intégration n'existe, il est temps d'associer vos projets au compte de facturation que vous avez reçu dans le cadre de la lettre de bienvenue et que nous avons abordé dans les sections précédentes de ce document.
Remarque: Si vous travaillez avec un partenaire Maps, il peut vous aider à ce stade. Vous n'avez pas besoin de suivre uniquement les étapes ci-dessous. Si vous travaillez directement avec Google, ce qui peut se produire dans certaines régions, procédez comme suit:
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. Un raccourci permet d'accéder à ce lien: https://console.cloud.google.com/billing
- Facturation > Cliquez sur "Gérer les comptes de facturation" :
- Dans "Facturation", cliquez sur l'icône à trois points
à côté du projet de production que vous avez créé, puis sélectionnez "Changer de compte de facturation" :
- Facturation > Dans "Compte de facturation", choisissez le code du compte de facturation que vous avez reçu dans le courrier de bienvenue dans la liste déroulante. Cliquez ensuite sur DÉFINIR LE COMPTE :
- Le projet sera associé au nouveau compte de facturation :
- Une fois le nouveau mode de facturation ajouté, accédez à Vue d'ensemble > Vue d'ensemble des paiements et aux paramètres de paiement pour vérifier que les informations sont correctes. Pour en savoir plus sur la mise à jour des informations de facturation et de paiement, veuillez consulter cette page.
Pour tout problème lié à la facturation, veuillez envoyer une demande d'assistance pour la billing, ou contactez votre partenaire ou votre représentant Google.
Rapports Billing
Les rapports de facturation vous aident à comprendre les coûts associés au compte de facturation qui a été associé au projet.
Remarque: Si vous faites appel à un partenaire Maps, veuillez vous assurer que les informations de facturation pertinentes vous sont fournies.
Ouvrez le compte de facturation associé au projet, puis sélectionnez "Rapports". Vous pouvez ensuite utiliser l'ensemble de filtres suivant:
Ici, le principal paramètre à garder à l'esprit est le filtre Group by (Grouper par) par SKU. Il affichera des informations détaillées sur Trips et Tasks, ainsi que sur d'autres API, le cas échéant, y compris s'il y a eu des dépassements ou non, comme expliqué précédemment:
Les informations des rapports sont actualisées tous les jours. Si des informations intrajournalières sont nécessaires, les requêtes Cloud Logging peuvent être utilisées pour déterminer le nombre d'événements facturables qui se sont produits pendant la journée. Pour en savoir plus, consultez les sections précédentes.
Plan d'activation progressive
Un point important à mentionner est votre plan de montée en puissance. Selon la nature de votre activité, il est fréquent que la totalité du trafic ne soit pas migrée vers le projet de mobilité. Par exemple, certaines entreprises prennent le temps de déployer la nouvelle solution dans l'ensemble de leurs succursales, franchises, magasins, bureaux, etc., ce qui signifie qu'une partie du trafic utilisera les anciens systèmes et une partie du trafic sera dirigée vers le nouveau projet.
De plus, dans de nombreux cas, l'ensemble du trafic n'appartient pas à un cas d'utilisation de mobilité, comme c'est le cas pour les outils de localisation de magasins, le drive et les autres solutions internes. Ils doivent renvoyer 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 que vous respectiez le règlement relatif à l'implémentation:
- Modèle basé sur les trajets : "La solution On-demand Rides and Deliveries est destinée aux services à la demande de courses et de livraisons. Ces services incluent généralement (a) les consommateurs qui demandent un trajet vers une destination donnée (ou la livraison d'un article spécifique) et (b) les chauffeurs qui répondent à ces demandes et qui conduisent un véhicule pour effectuer les services."
- Modèle basé sur les tâches : "La solution Google Maps Platform Last Mile Fleet est destinée aux services commerciaux de livraison sur le dernier kilomètre et aux services de ramassage pour le premier kilomètre. Ces services incluent généralement (a) une flotte de Véhicules de livraison appartenant au Client, ou ayant fait l'objet d'un contrat, (b) des livraisons basées sur un itinéraire planifié, (c) un réseau de centres de distribution avec des équipes opérationnelles qui assistent l'exécution des livraisons, et (d) les consommateurs qui suivent et reçoivent les expéditions."
Vous devez donc comprendre quels systèmes doivent rediriger vers le compte de facturation Google Maps Platform et lesquels doivent renvoyer au compte de facturation de la mobilité. Il est courant d'avoir plusieurs projets, chacun pointant vers le bon compte de facturation.
À titre d'exemple, considérons que chaque trajet / tâche comprend aujourd'hui 10 requêtes de geocoding conformément aux limites d'utilisation. Si votre migration prend quelques mois et que vous commencez à enregistrer 100 000 trajets / tâches le premier mois, vous pouvez appeler l'API Geocoding 1 million de fois. Toutefois, si votre entreprise demande 5 millions de requêtes de geocoding, cette différence (4 millions) peut être signalée comme un dépassement. Voici deux options possibles:
- Vous augmentez le nombre de trajets / tâches que vous nous signalez (accélérez le plan de montée en puissance). Des limites plus élevées s'appliquent donc, dans ce cas, vous devez signaler 500 000 trajets / tâches par mois.
- Vous négociez des limites plus élevées lors des négociations contractuelles, comme expliqué précédemment.
- Vous pointez 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 activité, et que les cas d'utilisation peuvent être complexes. Contactez 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.
En résumé, pour créer un plan de montée en puissance approprié, vous devez suivre les étapes suivantes : 1. Identifiez les cas d'utilisation liés à la mobilité et ceux qui ne sont pas conformes au règlement d'implémentation. 2. Identifiez les API Google Maps Platform actuellement utilisées pour les cas d'utilisation pertinents et leurs volumes. 3. Déterminez si les API Google Maps Platform seront toujours nécessaires après la mise en œuvre de la solution de mobilité. Par exemple, le calcul de l'heure d'arrivée prévue est effectué automatiquement sur Fleet Engine. Vous n'aurez peut-être plus besoin de les calculer avec l'API Directions. 4. Déterminez le temps qu'il faudra pour migrer complètement les cas d'utilisation de la mobilité vers la nouvelle plate-forme de mobilité de votre côté. 5. Vérifiez si les limites d'utilisation sont suffisantes pour couvrir vos cas d'utilisation. 6. Identifiez le point d'inflexion à partir duquel toutes les requêtes Google Maps Platform peuvent être intégrées au compte de facturation de la mobilité pour les cas d'utilisation de la mobilité.
Conclusion
En conclusion, configurer correctement le compte de facturation est essentiel pour garantir la prévisibilité des prix et la transparence. En utilisant notre technologie de mobilité qui intègre les meilleurs services de localisation, 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 informations nécessaires pour prendre des décisions commerciales éclairées. De plus, la transparence offerte par un tel système permet aux entreprises de comprendre clairement leurs dépenses, ce qui se traduit par une meilleure gestion du budget.
Actions suivantes
- Configurez votre compte de facturation dans la console GCP.
- Vous trouverez plus d'informations sur la facturation en général à l'adresse