Guida alla fatturazione per Google Maps Platform and Mobility

Prima di implementare un nuovo progetto Google Maps in produzione, devi assicurarti che la configurazione sia corretta per pagare l'importo corretto per i prodotti che utilizzi. In questo documento vengono trattati gli aspetti che ti consentono di avere (i) la trasparenza della fatturazione, in modo che l'utilizzo possa essere verificato prima della generazione della fattura, e (ii) la configurazione corretta del progetto, per assicurarti di poter utilizzare i nostri prodotti.

Sebbene si tratti di una procedura relativamente semplice, Maps Partners può collaborare con te per garantire che i tuoi progetti vengano spostati correttamente.

Nota: per accedere ad alcuni link di questo documento potrebbe essere necessario un contratto per le soluzioni di mobilità firmato. In caso di problemi, contatta il tuo rappresentante di Google o del partner.

Concetti

In questa sezione vogliamo assicurarci che tu abbia compreso le informazioni di base sulla fatturazione di Google Maps e sulle diverse configurazioni possibili. In molte situazioni non esiste una risposta giusta o sbagliata, ma dipende dal tipo di risultato che stai cercando di ottenere.

In questo documento parliamo molto del tuo progetto Google Cloud. Questo perché i prodotti Google Maps sono disponibili tramite questo sito. Ciò significa che la configurazione descritta in questo documento viene eseguita nel tuo progetto Google Cloud.

Account di fatturazione

Oggi, a ogni azienda che utilizza i prodotti Google Maps è associato un progetto Google Cloud. Per questo progetto deve essere configurato un account di fatturazione. L'account di fatturazione è responsabile dell'accumulo di tutto l'utilizzo di Google Maps e della creazione di una fattura ogni mese in base a questo utilizzo.

Per Mobility, viene eseguito il provisioning di un account di fatturazione speciale. Questo account di fatturazione è destinato esclusivamente a scenari di utilizzo relativi alla mobilità, come ridesharing, consegna e logistica.

Un singolo account di fatturazione può essere utilizzato da più progetti Google Cloud o da uno solo.

Un singolo progetto che rimanda allo stesso account di fatturazione:

• Caso d'uso specifico (ad es. casi d'uso relativi alla mobilità)
• Fatture separate
• Lo sconto viene applicato in base al volume di questo singolo progetto

Più progetti che rimandano allo stesso account di fatturazione:

• Stesso caso d'uso
• Usufruisci dei livelli di sconto aggregando l'utilizzo
• Fattura singola

Per ulteriori informazioni sugli account di fatturazione e altre informazioni pertinenti, consulta questo link.

Come detto sopra, un singolo account di fatturazione può puntare a più progetti. Se hai più di un progetto, devi identificare quelli che utilizzeranno i nostri servizi di mobilità e indirizzarli a un account di fatturazione per la mobilità. I progetti a cui non è associato un caso d'uso per la mobilità dovrebbero continuare a puntare al normale account di fatturazione di Google Maps Platform che utilizzi attualmente. Per ottenere un account di fatturazione per la mobilità, devi sottoscrivere un contratto con Google o tramite un partner. Di seguito puoi vedere come un account di fatturazione si inserisce nell'intero schema e le diverse configurazioni possibili:

Possibili configurazioni dell'account di fatturazione

Risorse cloud, account di fatturazione e generazione di fatture

Per quanto riguarda i prezzi, su Google Maps Platform sono disponibili diversi livelli di sconti, tramite i partner di Maps o direttamente con Google in alcuni casi. Questi livelli si basano sul volume, quindi paghi di meno quanto più utilizzi i nostri prodotti (gli sconti vengono applicati a ogni SKU singolarmente). Il nostro sistema di fatturazione identifica i tuoi progetti in base alle credenziali che hai utilizzato per chiamare i nostri prodotti. Può trattarsi di una chiave API o di un service account per alcune API di mobilità:

Chiavi API

Le API di Google Maps Platform vengono autenticate utilizzando una chiave API. Google identifica l'account di fatturazione del progetto Google Cloud corrispondente in base a questa chiave API, dove avverrà il consumo.

Esempio di richiesta all'API Geocoding:

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

JWT

Alcune API richiedono un ID progetto Google Cloud nell'URL e utilizzano un JWT per l'autenticazione. Pertanto, è importante assicurarsi che i sistemi giusti utilizzino il metodo di autenticazione corretto per garantire che la fatturazione venga eseguita correttamente.

Esempio di richiesta all'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"
    }
}'

Prova ora: visita la console Cloud e prova le API di Google Maps Platform .

Costi

In Google Maps Platform, i costi vengono calcolati in base al volume di richieste API. Per i servizi di mobilità, l'addebito avviene in base al volume di transazioni di mobilità fatturabili, ovvero corse o attività completate correttamente (spedizioni, non ritiri). Questo viene definito prima della firma del contratto. Se sei una società di ridesharing o consegna di cibo, il completamento di una corsa o di una consegna è la tua metrica di successo e corrisponde a un viaggio. Le attività vengono utilizzate per le aziende di logistica e i rivenditori che devono consegnare i pacchi correttamente.

Siamo consapevoli che i clienti del settore della mobilità utilizzano anche i prodotti Google Maps Platform per l'esecuzione di viaggi e consegne. Pertanto, se utilizzi un account di fatturazione per la mobilità, puoi chiamare Google Maps Platform senza costi, a condizione che i limiti predefiniti vengano rispettati nello stesso caso d'uso per la mobilità.

Ad esempio, se sei un'azienda di consegna di cibo, per ogni viaggio riuscito puoi chiamare l'API Geocoding dieci volte. Per scoprire di più su questi limiti, consulta la sezione Limiti di utilizzo nella documentazione sulla mobilità. Eventuali modifiche ai limiti richiedono un emendamento al contratto, quindi collabora con il tuo rappresentante di Google o del partner per discutere delle tue esigenze specifiche.

Alla fine del mese verrà generata una fattura in base a (i) il numero di corse o attività riuscite registrate nel sistema e (ii) qualsiasi volume di chiamate API di Google Maps Platform oltre i limiti predefiniti ("eccedenze"). I nostri limiti sono in linea con ciò che riteniamo necessario sul mercato.

Ti consigliamo di leggere attentamente la documentazione ufficiale sulla fatturazione per la mobilità disponibile qui.

Progetti pilota e valutazione

I clienti possono eseguire un piccolo progetto pilota (prova di concetto, valutazione) dei servizi di mobilità su un account di fatturazione di Google Maps Platform per un periodo di tempo limitato prima della firma di un contratto. Se vuoi eseguire un progetto pilota, rivolgiti al tuo partner di Maps o alla controparte di Google.

Durante la fase pilota, come accennato, non è disponibile alcun account di fatturazione per la mobilità perché il contratto non è stato ancora firmato. Ciò significa che ogni volta che vengono utilizzati i prodotti Google Maps Platform, verrà addebitato un importo, ma non per i prodotti specifici per la mobilità. In altre parole, durante la fase di prova la fatturazione non si basa su attività o viaggi e, di conseguenza, i limiti di utilizzo non si applicano in questa fase.

Una volta che il progetto pilota viene lanciato ufficialmente in produzione, il pagamento deve essere effettuato in base al contratto.

In sintesi:

• Fase di prova / sviluppo: ti viene addebitato solo il costo delle API di Google Maps disponibili pubblicamente. Le API e gli SDK non disponibili pubblicamente non comportano addebiti finché nel progetto non viene utilizzato un account di fatturazione per la mobilità. Tieni presente che Google offre 200 $di crediti per le API di Google Maps Platform a ogni nuovo account di fatturazione creato. Dovrebbe essere sufficiente per un ambiente controllato durante il periodo di valutazione.

• Fase di produzione: ti vengono addebitati i costi per corse o attività. I costi associati a Google Maps Platform verranno addebitati solo se l'utilizzo supera i limiti di utilizzo ("limiti") previsti dal contratto. In questo caso, dovrai pagare gli importi in eccesso. Gli eccessi vengono addebitati come definito qui.

Come eseguire la migrazione a un account di fatturazione per la mobilità

Quando esegui la migrazione alla produzione, in genere devi creare un altro progetto Google Cloud per rappresentare i diversi ambienti, come QA (controllo qualità) e produzione. Prima di questo, probabilmente hai un solo ambiente, quello di sviluppo.

Requisiti

Una persona che può:

1. Gestire gli account di fatturazione su Google Cloud, in genere questa operazione viene eseguita dall'amministratore dell'account di fatturazione o dal proprietario del progetto.
2. Accedere al nuovo ID account di fatturazione fornito nella lettera di benvenuto generata dopo la firma del contratto.
3. Accedi al progetto Google Cloud corrispondente all'ambiente di produzione in cui verranno registrati i viaggi o le attività.

Per configurare nuovi progetti e la relativa fatturazione, segui questi passaggi:

Configurazione del nuovo progetto

Creazione del progetto

1. [Tu] Crea un nuovo progetto Google Cloud nella console Google Cloud per ogni nuovo ambiente. Ad esempio, produzione, staging e controllo qualità.
2. [Partner o team di Google] Aggiungi nuovi progetti a una lista consentita per avere accesso ai prodotti per la mobilità. Collabora con il tuo rappresentante di vendita di Google o del partner e fornisci l'ID progetto creato nel passaggio precedente.
3. [Tu] aggiorni Contatti fondamentali nei tuoi progetti. Questo passaggio è molto importante per garantire che i team di assistenza di Google possano raggiungere le persone giuste per il tuo progetto, se necessario.

Configurazione progetto

Completa i seguenti passaggi nella console Google Cloud per il progetto creato nei passaggi precedenti:

1. [Tu] crei account di servizio, inclusa l'associazione dei ruoli IAM (Identity and Access Management) di Mobility corretti (in base alle corse e in base alle attività).

   • come è stato fatto nell'ambiente di sviluppo o con una suddivisione più strutturata dell'accesso, se necessario (vedi questa sezione).

2. [Tu] crei le chiavi API, come è stato fatto nell'ambiente di sviluppo o, se necessario, con una segregazione dell'accesso più strutturata (ad es. per prodotto, dominio e così via).

3. [Tu] abiliti API come "Local Rides and Deliveries" e altre API di Google Maps Platform necessarie (ad es. Geocoding, Autocomplete, Address Validation).

4. Quota [tu]: se hai bisogno di un aumento delle query al minuto (QPM) per determinate API, apri un ticket per l'assistenza. Scopri come farlo qui. Devi aggiungere una giustificazione aziendale che indichi il motivo per cui è necessario l'aumento. Puoi consultare le quote predefinite qui.

5. [Tu] Se hai sviluppato sistemi che utilizzavano le credenziali dell'ambiente di sviluppo, assicurati che questi sistemi siano in grado di puntare alle nuove credenziali create per i nuovi progetti. Ciò include l'indirizzamento dei sistemi frontend e backend alle nuove credenziali, come le chiavi API e gli account di servizio, e l'utilizzo degli ID progetto corretti in ogni rispettivo ambiente.

Configurazione di fatturazione

Qui presupponiamo che tu abbia già firmato un contratto direttamente con Google (se applicabile) o tramite un partner. Questo è un prerequisito per ricevere l'account di fatturazione per la mobilità nella lettera di benvenuto, che verrà utilizzato nei passaggi successivi.

1. [Tu] Verifica se è stato ricevuto un ID account di fatturazione per la mobilità nell'ambito della lettera di benvenuto inviata da Google via email dopo la firma e l'esecuzione del contratto. Importante: la lettera di benvenuto viene inviata ai contatti tecnici e finanziari indicati nel modulo d'ordine del contratto. Collabora con il team di progetto per capire chi potrebbe averlo ricevuto e chiedi a questa persona di fornirti l'ID account di fatturazione, ovvero una serie di caratteri e numeri separati da un trattino.
2. Collabora con Google o con il partner per assicurarti che venga eseguita una convalida della fatturazione, il che significa che i tuoi sistemi stanno già inviando correttamente a Google i dati di Viaggi o Attività. Maggiori dettagli nella sezione successiva.
3. [Tu] Devi indirizzare i tuoi progetti Google Cloud al nuovo account di fatturazione utilizzando la console Cloud. Consulta la sezione Configurazione dell'account di fatturazione di questo documento.

Puoi trovare ulteriori dettagli sulla fatturazione in generale qui e qui.

Convalida della fatturazione

La convalida della fatturazione è importante per assicurarti che l'addebito sia corretto. A volte le aziende implementano per errore le API in modo errato, con un conseguente aumento degli addebiti o una sottostima.

La convalida della fatturazione prevede i seguenti passaggi:

1. Verificare se le richieste alle API di Google Maps Platform hanno un tripId (o taskId) nell'intestazione della richiesta. Scopri di più qui.

2. Verificare se i viaggi (o le attività) vengono registrati correttamente. Dipende dal pacchetto Mobility utilizzato:

   • Mobility Starter e Optimize o Accelerate (in base alla corsa): è necessaria l'integrazione con l'API ReportBillableEvent. Ciò significa che ogni volta che un viaggio viene completato correttamente, deve essere effettuata una richiesta a questa API. Per verificare che tutto funzioni correttamente, devi seguire i passaggi descritti qui.
   • Mobility Accelerate (basato su attività): la fatturazione non deve essere attivata da una chiamata API. Questo accade automaticamente quando il risultato di un'attività di importazione è impostato su ESEGUITA. Pertanto, è molto importante impostare correttamente il risultato dell'attività su FAILED o SUCCEEDED. I Customer Engineer (partner o Google) lavoreranno con te per verificare che l'implementazione sia stata eseguita correttamente. Tramite Cloud Logging puoi verificare se le attività vengono aggiornate correttamente eseguendo la seguente query di Cloud Logging:

   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"
   

   Se vengono visualizzate voci, significa che i sistemi di backend stanno impostando correttamente le attività su SUCCEEDED.

   Nota: è importante però verificare se il conteggio dei viaggi o delle attività effettivi completati corrisponde al numero di chiamate registrate. A volte notiamo che vengono registrati eventi di fatturazione, ma non corrispondono al numero totale di corse o attività effettivamente completate nella realtà (sottostima).

Stato di integrità dell'integrazione

Una migrazione alla produzione riuscita non deve solo garantire il corretto funzionamento della fatturazione, ma anche l'esecuzione delle API. Per quanto riguarda i servizi di mobilità, è importante verificare se l'integrazione con Fleet Engine (API Local Rides and Deliveries) è stata implementata correttamente.

Per farlo, puoi aprire Cloud Logging e utilizzare la seguente query:

jsonPayload.errorResponse.code:*

Dovresti vedere elencate tutte le voci di log con problemi. Ad esempio:

Eseguire query sugli errori utilizzando Cloud Logging

Questi problemi possono essere esportati in altri prodotti Cloud come BigQuery. Le metriche e gli avvisi possono essere configurati in base alla query di Cloud Logging:

Creazione di metriche da una query di Cloud Logging

Poiché si tratta di prodotti Google Cloud, potrebbero essere applicati costi aggiuntivi. Per ulteriori informazioni, puoi rivolgerti al tuo partner o al tuo rappresentante di Google.

Configurazione dell'account di fatturazione

Se ora tutti i tuoi sistemi registrano correttamente i viaggi o le attività e non esistono errori di integrazione, è il momento di indirizzare i tuoi progetti all'account di fatturazione che hai ricevuto nella lettera di benvenuto e che è stato descritto nelle sezioni precedenti di questo documento.

Nota: se collabori con un partner di Maps, a questo punto può aiutarti e non devi seguire da solo i passaggi riportati di seguito. Se collabori direttamente con Google, come può accadere in alcune regioni, puoi seguire i passaggi che seguono:

Per farlo, segui questi passaggi:

1. Apri la console Google Cloud (https://console.cloud.google.com).
2. Seleziona il nuovo progetto che verrà utilizzato in produzione.
3. Vai alla sezione Fatturazione del progetto. Una scorciatoia può essere accedere a questo link: https://console.cloud.google.com/billing
4. Fatturazione > Fai clic su "Gestisci account di fatturazione":

   

   Il tuo progetto potrebbe avere un aspetto diverso da quello riportato sopra.
5. In Fatturazione > Fai clic sull'icona con tre puntini accanto a un progetto di produzione creato e scegli "Cambia account di fatturazione":

   

6. Fatturazione > nell'account di fatturazione, scegli il codice dell'account di fatturazione che hai ricevuto nella lettera di benvenuto nell'elenco a discesa. Poi fai clic su "IMPOSTA ACCOUNT":

   

7. Il progetto verrà collegato al nuovo account di fatturazione:

   

   Importante: da questo momento in poi, tutti i viaggi o le attività registrati in questo progetto verranno fatturati come spiegato in precedenza. Se la convalida della fatturazione non è ancora stata eseguita, non collegare ancora l'account di fatturazione.
8. Dopo aver aggiunto il nuovo metodo di fatturazione, vai a "Panoramica > Panoramica pagamenti" e "Impostazioni pagamenti" per verificare che le informazioni siano corrette. Per saperne di più sull'aggiornamento della fatturazione e del pagamento, fai clic su questo link. Per eventuali problemi relativi alla fatturazione, invia una richiesta di assistenza per la fatturazione o rivolgiti al tuo partner o al rappresentante di Google.

Report di fatturazione

I report di fatturazione ti aiutano a comprendere i costi associati all'account di fatturazione collegato al progetto.

Nota: se collabori con un partner di Maps, collabora con lui per assicurarti di ricevere i dati di fatturazione pertinenti di cui hai bisogno.

Apri l'account di fatturazione collegato del progetto e seleziona Report. A questo punto puoi utilizzare il seguente insieme di filtri:

Filtri dei report di fatturazione

Qui l'impostazione principale da tenere presente è il filtro Raggruppa per per SKU, che mostra informazioni dettagliate su Viaggi e Attività, nonché su altre API, se utilizzate, incluso se sono stati registrati o meno superamenti, come spiegato in precedenza:

Esempio di prodotti utilizzati nel progetto

Le informazioni dei report vengono aggiornate quotidianamente. Se sono necessarie informazioni intraday, le query di Cloud Logging possono essere utilizzate per vedere quanti eventi fatturabili si sono verificati durante la giornata. Consulta le sezioni precedenti per informazioni in merito.

Piano di applicazione graduale

Un aspetto importante da menzionare è il piano di implementazione. È normale che non tutto il traffico venga migrato al progetto di mobilità, a seconda della natura della tua attività. Ad esempio, alcune aziende impiegano del tempo per implementare la nuova soluzione in tutti i loro filiali, franchising, negozi, uffici e così via, il che significa che parte del traffico utilizzerà i vecchi sistemi e parte del traffico verrà indirizzata al nuovo progetto.

Inoltre, in molti casi, non tutto il traffico appartiene a un caso d'uso per la mobilità, come nel caso di localizzatori di negozi, ritiro a bordo strada e altre soluzioni interne. Questi devono puntare a un account di fatturazione Google Maps Platform, in quanto il traffico deve essere mantenuto separato dall'account di fatturazione per la mobilità.

È importante rispettare le norme di implementazione:

• Modello basato sul percorso: "La soluzione Trasporto passeggeri e consegne on demand è progettata per essere utilizzata in servizi di trasporto passeggeri e consegne commerciali on demand. Questi servizi in genere includono (a) consumatori che inviano richieste di corsa per una determinata destinazione (o consegna di un articolo specifico) e (b) autisti che vengono abbinati alle richieste e che guidano un veicolo per completare i servizi.
• Modello basato su attività: "La soluzione per i parchi di veicoli Last Mile di Google Maps Platform è progettata per essere utilizzata nei servizi commerciali di consegna dell'ultimo miglio e di ritiro del primo miglio. Questi servizi in genere includono (a) un parco di veicoli di consegna di proprietà o in contratto con il Cliente, (b) consegne basate su un itinerario pre-pianificato, (c) una rete di centri di distribuzione con team operativi che supportano l'esecuzione delle consegne e (d) consumatori che monitorano e poi ricevono le spedizioni.

Pertanto, devi capire quali dei tuoi sistemi devono puntare all'account di fatturazione di Google Maps Platform e quali all'account di fatturazione per la mobilità. È normale avere più progetti, ognuno dei quali rimanda all'account di fatturazione corretto.

Ad esempio, tieni presente che ogni viaggio / attività include oggi 10 richieste di geocodifica in base ai limiti di utilizzo. Se la migrazione richiederà alcuni mesi e inizi a registrare 100.000 viaggi / attività nel primo mese, significa che potresti chiamare l'API Geocoding 1 milione di volte. Tuttavia, se la tua attività richiede 5 milioni di richieste di geocodifica, la differenza (4 milioni) potrebbe essere segnalata come superamento. In questo caso sono possibili due opzioni:

1. Aumenti la quantità di corse / attività che ci segnali (accelerando il piano di implementazione), quindi si applicano limiti più elevati. In questo caso, dovrai segnalare 500.000 corse / attività al mese.
2. Negozia limiti più elevati durante le negoziazioni contrattuali, come spiegato in precedenza.
3. Indirizzi le richieste dell'API Geocoding a un'API di Google Maps Platform per usufruire di livelli di sconto più elevati e pagare meno degli extra.

Sappiamo che la stima dei costi può essere complessa a seconda delle dimensioni e della complessità della tua attività e dei casi d'uso. Collabora con il tuo partner o con la controparte di Google per determinare il modo migliore per prepararti al lancio della produzione utilizzando i tuoi progetti esistenti.

In sintesi, per creare un piano di implementazione adeguato sono necessari i seguenti passaggi: 1. Identifica quali casi d'uso sono correlati alla mobilità e quali no in base ai criteri di implementazione. 2. Identifica quali API di Google Maps Platform vengono utilizzate al momento per i casi d'uso pertinenti e i relativi volumi. 3. Scopri se le API Google Maps Platform saranno ancora necessarie dopo l'implementazione della soluzione di mobilità. Ad esempio, il calcolo dell'orario di arrivo stimato avviene automaticamente in Fleet Engine, quindi potresti non dover più calcolarlo con l'API Directions. 4. Scopri quanto tempo occorre per eseguire la migrazione completa dei casi d'uso di mobilità alla nuova piattaforma di mobilità. 5. Verifica se i limiti di utilizzo sono sufficienti per supportare i tuoi casi d'uso. 6. Identifica il punto di svolta in cui tutte le richieste di Google Maps Platform possono essere aggregate all'account di fatturazione per la mobilità per i casi d'uso della mobilità.

Conclusione

In conclusione, la configurazione corretta dell'account di fatturazione è essenziale per la prevedibilità e la trasparenza dei prezzi. Grazie alla nostra tecnologia di mobilità che integra i migliori servizi di geolocalizzazione, le aziende possono essere certe che le loro procedure di fatturazione siano accurate ed efficienti. Ciò non solo contribuisce a ridurre i costi, ma fornisce anche i dati e le informazioni necessari per prendere decisioni aziendali informate. Inoltre, la trasparenza offerta da un sistema di questo tipo consente alle aziende di avere una chiara comprensione delle proprie spese, con una conseguente migliore gestione del budget.

Azioni successive

• Configura il tuo account di fatturazione nella console Google Cloud.
• Per ulteriori dettagli sulla fatturazione in generale, consulta
  • Documentazione commerciale di Mobility Services
  • Attiva, disattiva o modifica la fatturazione per un progetto bookmark_border.