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 apportare assicurati che la configurazione sia corretta, in modo da pagare l'importo corretto per i prodotti che stai utilizzando. 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.

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. Ciò è dovuto al fatto che i prodotti Google Maps sono disponibili tramite questo strumento. 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 al giorno d'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 tutti gli utilizzi di Google Maps e della creazione di una fattura ogni mese in base a tale utilizzo.

Per Mobilità, 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.

Progetto singolo che punta allo stesso account di fatturazione:

Caso d'uso specifico (ad es. casi d'uso relativi alla mobilità)
Fatture separate
Viene applicato uno sconto sul volume in base a 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, visita 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 di mobilità devono continuare a indirizzare al normale account di fatturazione di Google Maps Platform che utilizzi attualmente. Per ottenere un account di fatturazione per la mobilità, è necessario firmare un deal di mobilità 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 scenari. Questi livelli si basano sul volume, quindi paghi 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"
    }
}'

Costi

In 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 di mobilità fatturabili, che si riferiscono ai viaggi o alle attività completate correttamente (spedizioni, non ritiri). Questo viene definito prima della firma del contratto. Se sei un'azienda di ridesharing o di consegna di cibo a domicilio, completare una corsa o una consegna è la tua metrica di successo, che si riferisce a un Trip. Le attività vengono utilizzate per le aziende di logistica e i rivenditori che devono consegnare i pacchi correttamente.

Siamo consapevoli che i clienti della mobilità 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 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 relativa alla mobilità disponibile qui.

Progetti pilota e valutazione

I clienti possono eseguire un piccolo progetto pilota (proof of concept, 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 desideri 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 lanciato ufficialmente in produzione, il progetto pilota dovrà essere pagato come da 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. Questo 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, pagherai per le eccedenze. 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 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 dalla tua parte che può:

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.
Accedere al nuovo ID account di fatturazione fornito nella lettera di benvenuto generata dopo la firma del contratto.
Accesso al progetto Google Cloud corrispondente all'ambiente di produzione in cui verranno segnalati i viaggi o le attività.

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

Configurazione nuovo progetto

Creazione del progetto

[Tu] Crea un nuovo progetto Google Cloud nella Console Google Cloud per ogni nuovo ambiente. Ad esempio, produzione, gestione temporanea e qualità garanzia.
[Partner o team di Google] Aggiungi nuovi progetti a una lista consentita a cui accedere i prodotti per la mobilità. Collabora con il tuo rappresentante di vendita di Google oppure partner e fornisci l'ID progetto creato nel passaggio precedente.
[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:

[Tu] Creare account di servizio, inclusa l'associazione della mobilità corretta Identifica e Ruoli di Access Management (IAM) (trip) e attività )
- come è stato fatto nell'ambiente di sviluppo o con una strategia e se necessario - vedere questa sezione.
[Tu] Creare chiavi API, come avveniva nell'ambiente di sviluppo o con una segregazione degli accessi più strutturata (ad es.per prodotto, dominio ecc.) se necessario.
[Tu] abiliti API come "Local Rides and Deliveries" e altre API di Google Maps Platform necessarie (ad es. Geocoding, Autocomplete, Address Validation).
[Tu] Quota: se hai bisogno di aumenti QPM (query al minuto) 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. Le quote predefinite sono visibili qui
[Tu] Se hai sviluppato sistemi che utilizzavano le credenziali del di sviluppo, assicurati che questi sistemi siano in grado di indirizzare le nuove credenziali create per i nuovi progetti creati. 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

Supponiamo che tu abbia già firmato un contratto con Google direttamente (ove 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.

[Tu] Verifica di aver ricevuto un ID account di fatturazione per la mobilità nell'ambito della 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 questa persona di fornirti l'ID account di fatturazione, ovvero una serie di caratteri e numeri separati da un trattino.
[Tu] Collabora con Google o con il 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 nella sezione successiva.
[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:

È in corso la verifica se le richieste alle API Google Maps Platform hanno un tripId (o taskId) nell'intestazione della richiesta. Scopri di più qui.
Stiamo verificando se le corse (o le attività) vengono segnalate correttamente. Dipende dal pacchetto Mobility utilizzato:
- 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, deve essere effettuata una richiesta a questa API. Per verificare se il problema si svolge correttamente, devi seguire i passaggi descritti qui.
- Mobility Accelerate (in base alle 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 NON RIUSCITA o RIUSCITA. 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 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 delle corse o delle attività completate correttamente corrisponde al numero di chiamate registrate. A volte, gli eventi di fatturazione vengono registrati ma non corrispondono al numero totale di viaggi o attività effettivamente completati nel mondo reale (sottostima).

Stato di integrità dell'integrazione

Una migrazione in produzione non dovrebbe solo garantire il corretto funzionamento della fatturazione, ma anche che le API non vengono 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 seguente query:

jsonPayload.errorResponse.code:*

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

Esecuzione di query sugli errori con Cloud Logging — **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 dalla 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 maggiori 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 sono presenti 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, cosa che può verificarsi in alcune regioni, puoi seguire questi passaggi:

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ò essere 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 "Cambia account di fatturazione":
Fatturazione > nell'account di fatturazione, scegli il codice dell'account di fatturazione che hai ricevuto nella lettera di benvenuto nell'elenco a discesa. Quindi, fai clic su "IMPOSTA ACCOUNT":
Il progetto verrà collegato al nuovo account di fatturazione:

Importante: d'ora in poi, tutti i viaggi o le attività riportati in questo progetto verranno fatturati come spiegato in precedenza. Se la convalida della fatturazione non è stata ancora eseguita, non collegare ancora l'account di fatturazione.
Una volta aggiunto il nuovo metodo di fatturazione, vai a "Panoramica > Panoramica dei pagamenti" e "Impostazioni pagamenti" per verificare se le informazioni sono corrette. Per saperne di più sull'aggiornamento della fatturazione e dei pagamenti, fai clic su questo link. Per qualsiasi problema relativo alla fatturazione, invia una richiesta di assistenza per la fatturazione o rivolgiti al tuo partner o al tuo 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:

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:

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

Piano di applicazione graduale

Un punto importante da menzionare è il tuo piano di applicazione graduale. È 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 filiali, in franchising, negozi, uffici ecc., il che significa che parte del traffico utilizzerà i vecchi sistemi e parte del traffico sarà destinata al nuovo progetto.

Inoltre, in molti casi non tutto il traffico appartiene a un caso d'uso di mobilità, come nel caso di store locator, ritiro all'esterno 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 che tu rispetti le Norme di implementazione:

Modello basato sui viaggi: "La soluzione On-demand Rides and Deliveries è destinata all'utilizzo nei servizi commerciali di trasporto e a domicilio 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) conducenti che vengono abbinati alle richieste e che guidano un veicolo per completare i servizi.
Modello basato su attività: "La soluzione Last Mile Fleet di Google Maps Platform è destinata all'uso nei servizi commerciali di consegna dell'ultimo miglio e di ritiro del primo miglio. Tali servizi in genere includono (a) un parco di Veicoli per la consegna di proprietà del Cliente o a contratto, (b) consegne basate su un percorso pianificato, (c) una rete di centri di distribuzione con team operativi che supportano l'esecuzione delle consegne e (d) consumatori che tracciano 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 oggi ogni viaggio / attività include 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 azienda 5 milioni di geocodifica richiede che la differenza (4 milioni) venga segnalata come eccedenza. Ecco due possibili opzioni:

Aumenti il numero di Viaggi / Attività che ci stai segnalando (accelera il piano di applicazione graduale), quindi si applicano limiti più elevati, in questo caso dovrai registrare 500.000 viaggi / attività al mese.
Negozia limiti più elevati durante le negoziazioni contrattuali, come spiegato in precedenza.
Devi indirizzare le richieste dell'API Geocoding a un'API di Google Maps Platform per usufruire di livelli di sconto più elevati e pagare meno rispetto al superamento della soglia.

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. Identificare quali casi d'uso sono legati alla mobilità e quali non sono conformi 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. Identifica quanto tempo sarà necessario per eseguire la migrazione completa dei casi d'uso relativi alla mobilità alla nuova piattaforma di mobilità dal tuo lato. 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. 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 sistema di questo tipo consente alle aziende di comprendere in modo chiaro le spese, migliorando la gestione del budget.

Azioni successive

Configura il tuo account di fatturazione nella console di Google Cloud.
Per ulteriori informazioni sulla fatturazione in generale, consulta la pagina
- Documentazione commerciale sui servizi di mobilità
- Attiva, disattiva o modifica la fatturazione per un progetto bookmark_border.