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 giusto per i prodotti che utilizzi. In questo documento trattiamo gli aspetti per assicurarci che tu disponga di (i) trasparenza della fatturazione, in modo che l'utilizzo possa essere verificato prima della generazione di una fattura e (ii) della configurazione corretta del progetto, per garantire che tu possa utilizzare i nostri prodotti.

Sebbene questa procedura dovrebbe essere relativamente semplice, i partner di Maps possono collaborare con te per garantire che i tuoi progetti vengano spostati correttamente.

Concetti

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

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

Account di fatturazione

Ogni azienda che utilizza i prodotti Google Maps oggi ha un progetto Google Cloud associato. 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 all'utilizzo solo con casi d'uso correlati 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 punta allo stesso account di fatturazione:

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

Più progetti che puntano allo stesso account di fatturazione:

• Stesso caso d'uso
• Sfrutta i livelli di sconto aggregando l'utilizzo
• Fattura singola

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

Come detto in precedenza, 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 di mobilità devono continuare a puntare all'account di fatturazione Google Maps Platform che utilizzi oggi. Per ottenere un account di fatturazione per la mobilità, è necessario firmare un contratto di mobilità con Google o tramite un partner. Di seguito puoi vedere come si inserisce un account di fatturazione nello schema completo e le diverse configurazioni possibili:

Risorse cloud, account di fatturazione e generazione di fatture

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

Chiavi API

Le API 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, in cui 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 avvenga 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"
    }
}'

Costi

Su Google Maps Platform, i costi vengono calcolati in base al volume di richieste API. Per i servizi di mobilità, addebitiamo un costo in base al volume delle transazioni di mobilità fatturabili, ovvero viaggi o attività (spedizioni, non ritiri) completati correttamente. Questo viene definito prima della firma del contratto. Se rappresenti un'azienda di ridesharing o di consegna di cibo, il completamento di una corsa o di una consegna è la tua metrica di successo, che corrisponde a un viaggio. I task vengono utilizzati per le aziende di logistica e i rivenditori che devono consegnare i pacchi.

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

Ad esempio, se sei un'azienda di consegna di cibo, per ogni viaggio riuscito puoi chiamare l'API Geocoding dieci volte. Per saperne di più su questi limiti, consulta la sezione Limiti di utilizzo nella documentazione sulla mobilità. Qualsiasi modifica ai limiti richiede un emendamento al contratto, pertanto 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 viaggi o attività completati segnalati nel sistema e (ii) qualsiasi volume di chiamate API Google Maps Platform oltre i limiti prestabiliti ("eccedenze"). I nostri limiti sono in linea con ciò che abbiamo riscontrato come necessario sul mercato.

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

Progetti pilota e valutazione

I clienti possono eseguire un piccolo progetto pilota (prova di fattibilità, valutazione) dei servizi di mobilità su un account di fatturazione 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 Maps o al tuo contatto Google.

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

Una volta lanciato ufficialmente in produzione, il progetto pilota deve essere pagato in base al contratto.

In sintesi:

• Fase pilota / di sviluppo: ti vengono addebitati solo i costi delle API di Google Maps che sono disponibili pubblicamente. Le API e gli SDK non disponibili pubblicamente non comportano addebiti finché non viene utilizzato un account di fatturazione della mobilità nel progetto. Tieni presente che Google offre importi di utilizzo senza costi per ogni SKU Google Maps Platform a qualsiasi nuovo account di fatturazione creato. Questo dovrebbe essere sufficiente per un ambiente controllato durante il periodo di valutazione.

• Fase di produzione: ti viene addebitato un costo in base ai viaggi o alle attività. I costi associati a Google Maps Platform verranno sostenuti solo se l'utilizzo supera i limiti di utilizzo ("massimali") previsti dal contratto. In questo caso, dovrai pagare i costi per l'utilizzo in eccesso. Le eccedenze vengono addebitate 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 progetti Google Cloud aggiuntivi per rappresentare i diversi ambienti, come QA (Quality Assurance) e produzione. Prima di allora, probabilmente hai un solo ambiente, quello di sviluppo.

Requisiti

Una persona dalla tua parte che possa:

1. Gestisci gli account di fatturazione su Google Cloud, in genere questa operazione viene eseguita dall'amministratore account di fatturazione o dal proprietario del progetto.
2. Accesso al nuovo ID account di fatturazione incluso nella lettera di benvenuto generata dopo la firma del contratto.
3. Accesso al progetto Google Cloud corrispondente all'ambiente di produzione in cui verranno segnalati viaggi o attività.

Per configurare nuovi progetti e la fatturazione, segui questi passaggi.

Configurazione di un nuovo progetto

Creazione del progetto

1. [Tu] Crea un nuovo progetto GCP nella console Google Cloud per ogni nuovo ambiente. Ad esempio, produzione, staging e garanzia di qualità.
2. [Partner o team Google] Aggiungi nuovi progetti a una lista consentita per accedere 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] Aggiorna Contatti fondamentali nei tuoi progetti. Questo passaggio è molto importante per garantire che i team di assistenza Google possano contattare 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] Crea service account, inclusa l'associazione dei ruoli IAM (Identity & Access Management) corretti per la mobilità (basati sui viaggi e basati sulle attività)

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

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

3. [Tu] Abilita API come "Corse e consegne locali" e altre API di Google Maps Platform necessarie (ad es. Geocoding, Autocomplete, Address Validation).

4. Quota [You]: se hai bisogno di aumenti di QPM (query al minuto) per determinate API, apri un ticket di assistenza. Scopri come farlo qui. Devi aggiungere una giustificazione aziendale che spieghi il motivo per cui è necessario l'incremento. Le quote predefinite sono disponibili 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 di backend e frontend alle nuove credenziali come chiavi API, service account e la verifica che gli ID progetto corretti vengano utilizzati in ogni 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 della mobilità nella lettera di benvenuto, che verrà utilizzato nei passaggi successivi.

1. [Tu] Verifica se un ID account di fatturazione per la mobilità è stato ricevuto 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 del progetto per capire chi potrebbe averlo ricevuto e chiedi a questa persona di fornirti l'ID account di fatturazione, che è una serie di caratteri e numeri separati da un trattino.
2. [Tu] Collabora con Google o con un partner per assicurarti che venga eseguita una convalida della fatturazione, il che significa che i tuoi sistemi segnalano già correttamente i viaggi o le attività a Google. Maggiori dettagli nella sezione successiva.
3. [Tu] Indica i tuoi progetti Google Cloud nel nuovo account di fatturazione utilizzando Cloud Console. Consulta la sezione Configurazione dell'account di fatturazione più avanti in questo documento.

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

Convalida della fatturazione

La convalida della fatturazione è importante per assicurarsi che ti venga addebitato l'importo corretto. A volte le aziende implementano accidentalmente le API in modo errato, il che comporta addebiti maggiori o una sottostima.

La convalida della fatturazione prevede i seguenti passaggi:

1. Verifica che le richieste alle API Google Maps Platform abbiano un tripId (o taskId) nell'intestazione della richiesta. Per ulteriori dettagli, consulta questa pagina.

2. Verificare se i viaggi (o le attività) vengono segnalati correttamente. Dipende dal pacchetto di mobilità utilizzato:

   • Mobility Starter e Optimize o Accelerate (basato sul viaggio): è 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 ciò avvenga correttamente, devi seguire i passaggi descritti qui.
   • Mobility Accelerate (basato sulle attività): la fatturazione non deve essere attivata da una chiamata API. Si verifica automaticamente quando lo stato di un'attività di consegna viene impostato su RIUSCITA. Pertanto, è molto importante impostare correttamente il risultato dell'attività su FAILED o SUCCEEDED. I Customer Engineer (partner o Google) collaboreranno 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 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 tuoi sistemi di backend impostano correttamente le attività su SUCCEEDED.

   Nota: è importante verificare se il conteggio dei viaggi o delle attività effettivamente completati corrisponde al numero di chiamate segnalate. A volte vengono segnalati eventi di fatturazione che non corrispondono all'importo totale di viaggi o attività effettivamente completati nella vita reale (sottodichiarazione).

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:*

Dovrebbe essere visualizzato un elenco di tutte le voci di log con problemi. Ad esempio:

Questi problemi possono essere esportati in altri prodotti cloud come BigQuery. Metriche e avvisi possono essere configurati in base alla query Cloud Logging:

Trattandosi di prodotti Google Cloud, potrebbero essere addebitati costi aggiuntivi. Per saperne di più, puoi rivolgerti al tuo partner o al tuo rappresentante di Google.

Configurazione dell'account di fatturazione

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

Nota: se collabori con un partner di Maps, quest'ultimo può aiutarti in questa fase e non devi seguire i passaggi riportati di seguito da solo. Se collabori direttamente con Google, cosa che può accadere in alcune regioni, puoi seguire i passaggi successivi:

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 l'accesso 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 mostrato sopra.
5. In Fatturazione, fai clic sull'icona con tre puntini accanto a uno dei progetti di produzione creati e scegli "Cambia account di fatturazione":

   

6. Fatturazione > in 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à segnalati in questo progetto verranno fatturati come spiegato in precedenza. Se la convalida della fatturazione non è ancora avvenuta, non collegare ancora l'account di fatturazione.
8. Dopo aver aggiunto il nuovo metodo di fatturazione, vai a "Panoramica > Panoramica dei pagamenti" e "Impostazioni di pagamento" per verificare che le informazioni siano corrette. Per saperne di più sull'aggiornamento della fatturazione e del pagamento, consulta questo link. Per eventuali problemi relativi alla fatturazione, invia una richiesta di assistenza per la fatturazione o collabora con il tuo partner o 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, chiedi a quest'ultimo di fornirti i dati di fatturazione pertinenti di cui hai bisogno.

Apri l'account di fatturazione collegato del progetto e seleziona Report. Puoi quindi utilizzare il seguente insieme di filtri:

L'impostazione principale da tenere presente è il filtro Raggruppa per SKU, che mostra informazioni dettagliate su Spostamenti e Attività, nonché su altre API, se utilizzate, inclusi eventuali superamenti, come spiegato in precedenza:

Le informazioni del report vengono aggiornate quotidianamente. Se sono necessarie informazioni infragiornaliere, è possibile utilizzare le query Cloud Logging per vedere quanti eventi fatturabili si sono verificati durante il giorno. Per farlo, consulta le sezioni precedenti.

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 tutte le loro filiali, franchising, negozi, uffici e così via, il che significa che parte del traffico utilizzerà i vecchi sistemi e parte andrà al nuovo progetto.

Inoltre, in molti casi, non tutto il traffico apparterrà a un caso d'uso di mobilità, come nel caso di localizzatori di negozi, ritiro in negozio e altre soluzioni interne. Questi devono puntare a un account di fatturazione Google Maps Platform, poiché il traffico deve essere tenuto separato dall'account di fatturazione della mobilità.

È importante che tu rispetti le Norme di implementazione:

• Modello basato sul percorso: "La soluzione Trasporto passeggeri e consegne on demand è destinata all'uso in servizi commerciali di trasporto passeggeri e consegne on demand. Questi servizi in genere includono (a) consumatori che inviano richieste di trasporto verso una determinata destinazione (o consegna di un articolo specifico) e (b) conducenti a cui vengono assegnate le richieste e che guidano un veicolo per completare i servizi".
• Modello basato sulle attività: "La soluzione Last Mile Fleet di Google Maps Platform è destinata all'utilizzo nei servizi commerciali di consegna dell'ultimo miglio e di ritiro del primo miglio. Questi servizi in genere includono (a) una flotta di veicoli di consegna di proprietà del Cliente o per i quali è stato stipulato un contratto, (b) consegne basate su un percorso pianificato in anticipo, (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 della mobilità. È comune avere più progetti e ognuno punta all'account di fatturazione corretto.

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

1. Aumenti il numero di viaggi / attività che ci comunichi (acceleri il piano di implementazione), quindi si applicano limiti più elevati. In questo caso, devi segnalare 500.000 viaggi / attività al mese.
2. Negozi limiti più elevati durante le negoziazioni contrattuali, come spiegato in precedenza.
3. Indirizzi le richieste dell'API Geocoding a un'API Google Maps Platform per usufruire di livelli di sconto più elevati e pagare meno rispetto agli addebiti per superamento.

Sappiamo che la stima dei costi in base alle dimensioni e alla complessità della tua attività e dei tuoi casi d'uso può essere complessa. Collabora con il tuo partner o con la tua controparte 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 alle norme di implementazione. 2. Identifica le API di Google Maps Platform utilizzate oggi per i casi d'uso pertinenti e i relativi volumi. 3. Identifica se le API Google Maps Platform saranno ancora necessarie dopo l'implementazione della soluzione di mobilità. Ad esempio, il calcolo dell'ETA avviene automaticamente su Fleet Engine, quindi potresti non doverlo più calcolare con l'API Directions. 4. Identifica il tempo necessario per eseguire la migrazione completa dei casi d'uso della mobilità alla nuova piattaforma di mobilità. 5. Verifica che i limiti di utilizzo siano sufficienti per supportare i tuoi casi d'uso. 6. Identificare il punto di inflessione in cui tutte le richieste di Google Maps Platform possono essere trasferite all'account di fatturazione per la mobilità per i casi d'uso della mobilità.

Conclusione

In conclusione, la corretta configurazione dell'account di fatturazione è essenziale per la prevedibilità e la trasparenza dei prezzi. Utilizzando la nostra tecnologia di mobilità che incorpora i migliori servizi di localizzazione della categoria, le aziende possono essere sicure che i loro processi di fatturazione siano accurati ed efficienti. Ciò non solo contribuisce a ridurre i costi, ma fornisce anche i dati e gli approfondimenti 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, il che porta a una migliore gestione del budget.

Azioni successive

• Configura il tuo account di fatturazione nella console Google Cloud.
• Per ulteriori dettagli sulla fatturazione in generale, visita la pagina
  • Documentazione commerciale dei servizi di mobilità
  • Abilita, disabilita o modifica la fatturazione per un progetto bookmark_border.