Questa pagina è stata tradotta dall'API Cloud Translation.

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 in modo da pagare l'importo giusto per i prodotti che utilizzi. In questo documento vengono trattati aspetti per garantire la (i) trasparenza della fatturazione, per garantire che l'utilizzo possa essere verificato prima che venga generata una fattura e (ii) la corretta configurazione del progetto, per assicurarci di poter utilizzare i nostri prodotti.

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

Concetti

In questa sezione vogliamo assicurarci che tu abbia compreso le informazioni di base sulla fatturazione di Google Maps e le diverse configurazioni possibili. Non c'è giusto o sbagliato in molte situazioni, dipende dal tipo di risultato che stai cercando di ottenere.

In questo documento, parliamo molto del tuo progetto Google Cloud. Questo perché i prodotti di Google Maps sono disponibili tramite questo servizio. Ciò significa che la configurazione descritta in questo documento viene effettuata all'interno del tuo progetto Google Cloud.

Account di fatturazione

Ogni azienda che utilizza i prodotti Google Maps oggi ha un progetto Google Cloud associato. Questo progetto deve avere un account di fatturazione configurato. L'account di fatturazione è responsabile dell'accumulo di tutti gli utilizzi di Google Maps e della creazione di una fattura ogni mese in base a tale utilizzo.

Per Mobilità, è stato eseguito il provisioning di un account di fatturazione speciale. Questo account di fatturazione è destinato a essere utilizzato solo con casi d'uso relativi alla mobilità, come ridesharing, consegne e logistica.

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

Singolo progetto che punta allo stesso account di fatturazione:

Caso d'uso specifico (ad es. casi d'uso per la mobilità)
Fatture separate
Viene applicato uno sconto sul volume in base a questo singolo progetto

Più progetti che puntano allo stesso account di fatturazione:

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

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

Come indicato in precedenza, un singolo account di fatturazione può puntare a più progetti. Se hai più di un progetto, devi identificare quali 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 relativo alla mobilità devono continuare a indirizzare al normale account di fatturazione di Google Maps Platform che stai utilizzando oggi. Per ottenere un account di fatturazione per la mobilità, un deal di mobilità deve essere firmato 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, disponibili tramite Maps Partners o direttamente con Google in alcuni casi. Questi livelli sono basati sul volume, quindi paghi meno man mano che utilizzi i nostri prodotti (gli sconti vengono applicati a ogni SKU individualmente). Il nostro sistema di fatturazione identifica i progetti in base alla credenziale utilizzata per chiamare i nostri prodotti, che può essere una chiave API o un account di servizio per alcune API per la mobilità:

Chiavi API

Le API di Google Maps Platform vengono autenticate mediante una chiave API. Google identifica l'account di fatturazione del progetto Google Cloud corrispondente in base a questa chiave API, dove si verificherà 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 garantire che i sistemi corretti 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à, gli addebiti vengono effettuati in base al volume di transazioni fatturabili per la mobilità, ovvero le corse o le attività completate correttamente (spedizioni, non ritiri). Questa definizione viene definita prima della firma del contratto. Se hai un'azienda di ridesharing o di consegna di cibo a domicilio, completare una corsa o una consegna è la tua metrica di successo, che corrisponde a un Viaggio. Le attività vengono utilizzate per le aziende di logistica e i rivenditori che devono consegnare i pacchi.

Sappiamo che i clienti di Mobility utilizzano anche i prodotti Google Maps Platform nell'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, a condizione che i limiti predefiniti vengano rispettati nello stesso caso d'uso relativo alla mobilità.

Ad esempio, se la tua è un'azienda di consegna di cibo a domicilio, per ogni viaggio riuscito puoi chiamare l'API Geocoding dieci volte. Per scoprire di più su questi limiti, consulta la sezione sui limiti di utilizzo nella documentazione sulla mobilità. Eventuali modifiche ai limiti richiedono un emendamento al contratto, quindi rivolgiti al tuo rappresentante di Google o del tuo 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à andate a buon fine segnalato nel sistema e (ii) qualsiasi volume di chiamate all'API Google Maps Platform oltre i limiti prestabiliti ("overage"). I nostri limiti sono allineati a ciò che abbiamo generalmente visto come necessario nel mercato.

Ti consigliamo di leggere attentamente la documentazione ufficiale sulla fatturazione per gli spostamenti, disponibile qui.

Progetti pilota e valutazione

I clienti possono eseguire un piccolo progetto pilota (proof of concept, valutazione) di 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 di Maps o alla controparte Google.

Durante la fase pilota, come accennato, non è disponibile alcun account di fatturazione per la mobilità in quanto il contratto non è ancora stato firmato. Ciò significa che ogni volta che vengono utilizzati i prodotti Google Maps Platform, viene addebitato un costo, mentre non per i prodotti specifici per gli spostamenti. In altre parole, ciò significa che, durante la fase pilota, la fatturazione non si basa su attività o viaggio, di conseguenza, i limiti di utilizzo non si applicano durante questa fase.

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

In sintesi:

Fase pilota / sviluppo: ti verranno addebitate solo le API di Google Maps disponibili pubblicamente. Le API e gli SDK che non sono disponibili pubblicamente non verranno addebitati fino a quando nel progetto non verrà utilizzato un account di fatturazione per la mobilità. Tieni presente che Google offre 200 $in crediti per le API Google Maps Platform a ogni nuovo account di fatturazione creato. Questo dovrebbe essere sufficiente per un ambiente controllato durante il periodo di valutazione.
Fase di produzione: l'addebito avviene in base ai viaggi o alle attività. I costi associati a Google Maps Platform vengono addebitati solo se l'utilizzo supera i limiti ("tetti") previsti dal contratto. In tal caso, pagherai per il superamento della soglia. I costi per il superamento della soglia 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 alcuni altri progetti della piattaforma Google Cloud per rappresentare i diversi ambienti, ad esempio QA (Controllo qualità) e Produzione. Prima probabilmente hai un solo ambiente, quello di sviluppo.

Requisiti

Una persona dalla tua parte che può:

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

Di seguito sono riportati i passaggi necessari per la configurazione di un nuovo progetto e come configurare la fatturazione per i nuovi progetti.

Configurazione di un nuovo progetto

Creazione di progetti

[Tu] Creazione di nuovi progetti Google Cloud per il nuovo o i nuovi ambienti (ad es. produzione, garanzia di qualità e così via). Per farlo, usa la console Google Cloud. Link diretto qui.
[Partner o team di Google] Questo progetto deve essere inserito nella lista consentita per avere accesso ai prodotti per la mobilità. Per farlo, rivolgiti al tuo rappresentante di vendita di Google o di un partner. Fornisci l'ID progetto creato nel passaggio precedente.
[Tu] Aggiornare i contatti necessari sui tuoi progetti. Questo è molto importante per garantire che i team dell'Assistenza Google possano raggiungere le persone giuste al tuo fianco.

Configurazione progetto

I passaggi seguenti devono essere eseguiti nella console Google Cloud sul progetto creato nei passaggi precedenti:

[Tu] Creazione di account di servizio, inclusa l'associazione di ruoli IAM corretti (basati su viaggio e basati su attività), come avviene nell'ambiente di sviluppo o con una segregazione più strutturata dell'accesso, se necessario, consulta questa sezione.
[Tu] Creazione di chiavi API, come è avvenuta nell'ambiente di sviluppo o con una segregazione dell'accesso più strutturata (ad esempio per prodotto, dominio e così via), se necessario.
[Tu] Abilitare API come "Local Rides and Deliveries" e altre API Google Maps Platform necessarie (ad es. Geocoding, Autocomplete, Address Validation).
[Tu] Quota: se hai bisogno di aumenti di QPS (query al secondo) per determinate API, apri un ticket per l'assistenza. Scopri come fare qui. Devi aggiungere una giustificazione aziendale che affermi il motivo per cui è necessario un aumento. Le quote predefinite sono disponibili qui.
[Tu] Se hai sistemi sviluppati che utilizzavano credenziali dell'ambiente di sviluppo, assicurati che questi sistemi siano in grado di indirizzare alle nuove credenziali create per i nuovi progetti creati. Ciò include il puntamento dei sistemi di backend e frontend alle nuove credenziali, come chiavi API, account di servizio, e la garanzia che vengano utilizzati gli ID progetto corretti in ogni rispettivo ambiente.

Configurazione di fatturazione

In questo caso si presuppone che tu abbia già firmato un contratto direttamente con Google (ove applicabile) o tramite un partner. Questo è un prerequisito per ricevere l'account di fatturazione Mobility nella lettera di benvenuto, che verrà utilizzata nei passaggi successivi.

[Tu] Verifica se è stato ricevuto un ID account di fatturazione per la mobilità con la lettera di benvenuto che viene 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 quella persona di fornirti l'ID dell'account di fatturazione, costituito da una serie di caratteri e numeri separati da trattini.
[Tu] Lavora con Google o con un partner per assicurarti che venga eseguita una convalida della fatturazione, ciò significa che i tuoi sistemi stanno già segnalando correttamente i Viaggi o le Attività a Google. Maggiori dettagli sono disponibili nella prossima sezione.
[Tu] Indirizza i tuoi progetti Google Cloud al nuovo account di fatturazione utilizzando la console Cloud. Consulta la sezione Configurazione dell'account di fatturazione più avanti in questo documento.

Ulteriori dettagli sulla fatturazione in generale sono disponibili qui e qui.

Convalida della fatturazione

La convalida della fatturazione è importante per assicurarsi che gli addebiti vengano effettuati correttamente. A volte le aziende implementano accidentalmente le API in modo errato, generando ulteriori addebiti o report inferiori.

La convalida della fatturazione prevede i seguenti passaggi:

Verifica se le richieste alle API di Google Maps Platform hanno un tripId (o taskId) nell'intestazione della richiesta. Scopri di più qui.
Verifica se i viaggi (o le attività) sono stati registrati correttamente. Dipende dal Pacchetto Mobilità in uso:
- Mobility Starter e Optimize o Accelerate (Trip Based): è richiesta l'integrazione con l'API ReportBillableEvent. Ciò significa che, ogni volta che una corsa viene completata correttamente, è necessario effettuare una richiesta a questa API. Per verificare se il problema sta accadendo correttamente, devi seguire la procedura descritta qui.
- Accelerazione della mobilità (basata sulle attività): la fatturazione non deve essere attivata da una chiamata API. Ciò avviene automaticamente quando il risultato di un'attività è impostato su RIUSCITA per un'attività di consegna. Di conseguenza, è 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. Con 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 tuoi sistemi di backend stanno impostando correttamente le attività su SUCCEEDED.

Nota: è importante tuttavia verificare se il conteggio delle corse o delle attività effettivamente completate corrisponde al numero di chiamate conteggiate. A volte vediamo che vengono registrati eventi di fatturazione, che però non corrispondono al numero totale di viaggi o attività effettivamente completate nel mondo reale (sottostima dei dati).

Stato di integrità dell'integrazione

Una migrazione in produzione riuscita non solo dovrebbe garantire che la fatturazione funzioni correttamente, ma che anche le API non vengano eseguite correttamente. 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 query seguente:

jsonPayload.errorResponse.code:*

In questo modo dovrebbero essere elencate tutte le voci di log che presentano problemi. Ad esempio:

Esecuzione di query sugli errori con Cloud Logging — **Errori di query con Cloud Logging**

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

Creazione di metriche dalla query di Cloud Logging — **Creazione di metriche dalla query Cloud Logging**

Poiché si tratta di prodotti Google Cloud, potrebbero essere addebitati costi aggiuntivi. Per maggiore chiarezza, puoi rivolgerti al tuo partner o al tuo rappresentante di Google.

Configurazione dell'account di fatturazione

Se ora tutti i tuoi sistemi segnalano correttamente Viaggi o Tasks 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 di cui abbiamo parlato nelle sezioni precedenti di questo documento.

Nota: se collabori con un partner di Maps, quest'ultimo può assisterti a questo punto. Non devi necessariamente seguire la procedura descritta di seguito. Se collabori direttamente con Google, cosa che può avvenire in alcune regioni, puoi seguire i passaggi successivi:

Per farlo, segui questi passaggi:

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

Il tuo progetto potrebbe avere un aspetto diverso da quello riportato sopra.
In Fatturazione > Fai clic sull'icona con tre puntini accanto a un progetto di produzione creato e scegli "Modifica account di fatturazione":
Fatturazione > in Account di fatturazione, scegli nell'elenco a discesa il codice dell'account di fatturazione che hai ricevuto nella Lettera di benvenuto. Quindi, fai clic su "IMPOSTA ACCOUNT":
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 non è ancora stata eseguita la convalida della fatturazione, non collegare ancora l'account di fatturazione.
Una volta aggiunto il nuovo metodo di fatturazione, vai a "Panoramica > Panoramica dei pagamenti" e "Impostazioni di pagamento" per verificare che i dati siano corretti. Per saperne di più sull'aggiornamento di fatturazione e pagamenti, consulta questo link.
Per qualsiasi problema relativo alla fatturazione, invia una billing per la fatturazione o collabora con il tuo partner o un rappresentante di Google.

Report di fatturazione

I report di fatturazione consentono di comprendere i costi associati all'account di fatturazione collegato al progetto.

Nota: se collabori con un partner di Maps, assicurati che ti vengano forniti 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:

In questo caso, l'impostazione principale da tenere a mente è il filtro Raggruppa per per SKU, che mostra informazioni dettagliate su Viaggi e Tasks, nonché su altre API se utilizzate, incluse informazioni sull'eventuale presenza di superamento della soglia, come spiegato in precedenza:

Le informazioni del report vengono aggiornate ogni giorno. Se sono necessarie informazioni infragiornaliere, le query di Cloud Logging possono essere utilizzate per vedere quanti eventi fatturabili si sono verificati durante il giorno. Per informazioni, consulta le sezioni precedenti.

Piano di applicazione graduale

Un punto importante da menzionare è il piano di applicazione graduale. È normale che non tutto il traffico venga migrato al progetto di mobilità, a seconda della natura dell'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 del traffico sarà indirizzato al nuovo progetto.

Inoltre, in molti casi, non tutto il traffico appartiene a un caso d'uso relativo alla mobilità, come accade per gli store locator, il ritiro all'esterno e altre soluzioni interne. Questi indirizzi devono indirizzare a un account di fatturazione Google Maps Platform, in quanto il traffico deve essere mantenuto separato dall'account di fatturazione per gli spostamenti.

È importante che tu rispetti le seguenti norme di implementazione:

Trip Based Model - "La soluzione On-demand Rides and Deliveries è destinata all'uso in servizi di consegna e trasporto commerciali on demand. Tali servizi in genere includono (a) i consumatori che inviano richieste di una corsa verso una determinata destinazione (o la consegna di un articolo specifico) e (b) i conducenti che vengono abbinati a richieste e che guidano un veicolo per completare i servizi."
Task basato sul modello: "La soluzione Last Mile Fleet di Google Maps Platform è concepita per l'utilizzo nei servizi di consegna commerciale dell'ultimo miglio e di ritiro del primo miglio. Tali servizi in genere includono (a) un parco di Veicoli per le consegne di proprietà o sotto contratto dal Cliente, (b) consegne basate su un percorso pianificato, (c) una rete di centri di distribuzione con team operativi che supportano le operazioni di consegna e (d) consumatori che tracciano le spedizioni e ricevono le spedizioni."

Devi quindi capire quale dei tuoi sistemi deve puntare all'account di fatturazione di Google Maps Platform e quali invece devono puntare all'account di fatturazione per gli spostamenti. È comune avere più progetti e ciascuno di essi rimanda all'account di fatturazione corretto.

Ad esempio, considera che ogni viaggio / attività include 10 richieste di geocodifica oggi 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 puoi chiamare l'API Geocoding 1 milione di volte. Tuttavia, se la tua attività 5 milioni di geocodifica richiede quella differenza (4 milioni) come superamento della soglia. Ecco due opzioni:

Aumenti il numero di Viaggi / Attività che ci stai segnalando (acceleri il piano di applicazione graduale), quindi si applicano limiti più elevati, in questo caso dovresti segnalare 500.000 Viaggi / Attività al mese.
Puoi negoziare limiti più elevati durante le negoziazioni dei contratti, come spiegato prima.
Devi indirizzare le richieste dell'API Geocoding a un'API Google Maps Platform per usufruire di livelli di sconto più elevati e pagare in modo più economico rispetto all'eccedenza.

Sappiamo che la stima dei costi dipende dalle dimensioni e dalla complessità della tua azienda e i casi d'uso possono essere complessi. Collabora con il tuo partner o la tua controparte Google per determinare qual è il modo migliore per prepararti al lancio della produzione utilizzando i tuoi progetti esistenti.

Riassumendo, per poter creare un piano di applicazione graduale adeguato, è necessario seguire questi passaggi: 1. Identifica quali casi d'uso sono relativi alla mobilità e quali non sono conformi alle norme di implementazione. 2. Identifica quali API di Google Maps Platform vengono utilizzate oggi per i casi d'uso pertinenti e i relativi volumi. 3. Identifica se le API di Google Maps Platform saranno ancora necessarie dopo l'implementazione della soluzione di mobilità. Ad esempio, il calcolo dell'orario di arrivo stimato avviene automaticamente su Fleet Engine, potresti non doverlo più fare con l'API Directions. 4. Identifica quanto tempo ci vorrà per eseguire la migrazione completa dei casi d'uso relativi alla mobilità alla nuova piattaforma di mobilità al tuo fianco. 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 raggruppate all'account di fatturazione relativo alla mobilità per i casi d'uso relativi alla mobilità.

Conclusione

In conclusione, configurare correttamente l'account di fatturazione è essenziale per la prevedibilità e la trasparenza dei prezzi. Utilizzando la nostra tecnologia di mobilità, che integra i migliori servizi di geolocalizzazione del settore, le aziende possono essere certi che i loro processi di fatturazione saranno accurati ed efficienti. Questo non solo aiuta a ridurre i costi, ma fornisce anche i dati e gli insight necessari per prendere decisioni aziendali consapevoli. Inoltre, la trasparenza offerta da un tale sistema consente alle aziende di avere una chiara comprensione delle proprie spese, con un conseguente miglioramento della gestione del budget.

Azioni successive

Configura il tuo account di fatturazione nella console Google Cloud.
Puoi trovare ulteriori dettagli sulla fatturazione in generale all'indirizzo
- Documentazione commerciale relativa ai servizi di mobilità
- Abilita, disabilita o modifica la fatturazione per un progetto bookmark_Border.