Dal giugno 2018 alcuni servizi di Google, tra i quali ad esempio la geo-localizzazione, sono diventati a pagamento per cui è necessario possedere un’apposita chiave di attivazione di Google (ApiKey) per poter continuare ad usufruirne.
In Mago4, vi sono alcune funzionalità che utilizzano tali servizi e si è reso quindi necessario condizionarne l'operatività all'esistenza o meno di questa chiave di attivazione richiesta da Google.
E' stata pertanto introdotta la possibilità di inserire, in un file di configurazione di TaskBuilder, manualmente o tramite Administration Console, l'ApiKey di Google ed abilitare le funzionalità ad essa collegate.
Administration Console
)
Parametri Servizi Google
|
In Administration Console (Informazioni di sistema\Parametri di sistema\Framework), è presente la nuova sezione Google dove è possibile inserire la Chiave di attivazione e scegliere quali servizi attivare.
In particolare:
- nel campo ApiKey è necessario indicare una chiave alfanumerica valida, generata tramite l’account di fatturazione di Google. Se la Keyword non è presente oppure il valore è una stringa vuota i servizi non vengono attivati e, in Mago4, ad esempio la voce di menu per la ricerca di un indirizzo non viene visualizzata;
- Translation: con questa opzione si attivano i servizi di Google Translate per la traduzione automatica;
- Geocoding: abilitando questa opzione sarà possibile da Mago4 cercare le informazioni di localizzazione relative ad un indirizzo e visualizzarne la posizione sulla mappa;
A questo scopo è stata aggiunta una sezione Mappe, alle anagrafiche di Mago4 che contengono un indirizzo, e che permette di visualizzare la mappa direttamente all'interno del documento.
All'apertura del documento la sezione si presenta chiusa ma, se viene aperta, l’indirizzo corrente è passato al servizio di Google per visualizzarne la posizione sulla mappa.
In caso siano state memorizzate le coordinate GPS, queste vengono utilizzate al posto dell’indirizzo.
La mappa viene aggiunta ai seguenti documenti:
- Azienda
- Aziende del gruppo
- Addetti
- Risorse
- Banche
- Contatti
- Fornitori potenziali
- Clienti
- Fornitori
- Produttori
- Depositi
- Vettori
- Route: attivando questo parametro vengono abilitati i servizi di tracciatura del percorso;
A questo scopo è stato aggiunto, sempre nella sezione Mappe, un pulsante per calcolare e visualizzare il percorso (dall'indirizzo impostato in anagrafica azienda a quello localizzato in quel momento).
Per il calcolo del percorso viene sempre utilizzato l’indirizzo anche se sono presenti le coordinate GPS.
- Static: permette di attivare i servizi che consentono di ottenere un’immagine statica, in formato PNG, con una mappa a partire da un indirizzo.
Attualmente in Mago4 questo servizio non è utilizzato, ma è già configurato per i futuri sviluppi.
Il File di configurazione
Le informazioni inserite da Console sono memorizzate, e possono essere gestite anche direttamente, attraverso un file di configurazione di TaskBuilder.
In particolare si tratta del file Google.config (presente nella cartella Standard\TaskBuilder\Framework\TbGeneric\Settings e nella Custom\Companies\AllCompanies\TaskBuilder\Framework\TbGeneric\Settings\AllUsers), che si presenta strutturato in questo modo:
<?xml version="1.0" standalone="yes"?>
<ParameterSettings>
<Section name="Google" localize="">
<Setting name="ApiKey" type="string" hidden="False" localize="" value="" />
<Setting name="Translation" type="bool" hidden="False" localize="" value="1" />
<Setting name="Geocoding" type="bool" hidden="False" localize="" value="1" />
<Setting name="Route" type="bool" hidden="False" localize="" value="1" />
<Setting name="Static" type="bool" hidden="False" localize="" value="1" />
</Section>
</ParameterSettings>
Se il file non viene rilevato i servizi non vengono attivati, ma precisiamo che la visualizzazione delle mappe in un browser esterno è sempre presente e gratuita.
Appendice
Costi
Cloud Translation API
I prezzi per l'API Cloud Translation vengono calcolati mensilmente in base all'utilizzo, che viene misurato in milioni di caratteri, dove un milione = 106 caratteri.
| Utilizzo |
Caratteri |
| |
0-1 miliardi di caratteri |
| Traduzione |
$ 20 per 1.000.000 di caratteri |
| Rilevamento della lingua |
$ 20 per 1.000.000 di caratteri |
Se la valuta utilizzata per il pagamento è diversa da USD, si applicano i prezzi elencati nella valuta locale delle Stock Keeping Units di Google Cloud Platform.
- Vedere qui per la versione in Dollaro US delle SKU (alla stesura del documento aggiornato al 06/12/18 sono confermati i $20 della tabella precedente)
- Vedere qui per la versione in EURO delle SKU (alla stesura del documento aggiornato al 14/11/18 i $20 sono equiparati a € 17.572)
Il prezzo viene calcolato per ogni carattere inviato all'API per l'elaborazione, compresi gli spazi.
Le query vuote vengono addebitate come un carattere.
Le tariffe vengono calcolate da Google in base al numero di caratteri, anche se sono di tipo multibyte, laddove un carattere corrisponde a un punto di codice. Ad esempio, la traduzione di "こんにちは" in inglese viene conteggiata come cinque caratteri ai fini della fatturazione.
Google non addebita costi aggiuntivi per il rilevamento della lingua quando non viene specificata la lingua di origine per il metodo translate. I prezzi per il rilevamento della lingua si applicano alle chiamate al metodo detect.
I prezzi sono di tipo "pro-rata", ovvero calcolati in modo proporzionale e incrementale, e vengono scalati in base al numero di caratteri effettivamente fornito al servizio. Ad esempio, se in un mese vengono inviati 75.000 caratteri per l'elaborazione, vengono addebitati $ 1,50.
Se si ha bisogno della funzione di traduzione o rilevamento della lingua per oltre un miliardo di caratteri al mese, bisogna contattare un rappresentante di vendita per conoscere eventuali sconti sui prezzi.
Quote e limiti
Le quote si suddividono in “Quote per i contenuti” e “Quote per richieste”.
Le quote possono essere modificate fino al valore massimo utilizzando la dashboard di Google Cloud Platform.
Per richiedere un incremento oltre il limite massimo di una quota, bisogna inviare una richiesta dalla pagina della console di Google Cloud Platform.
Quote per i contenuti
Il contenuto viene fornito all'API Translation sotto forma di stringa di testo e sia i prezzi sia l'utilizzo si basano sul numero di caratteri.
Per le quote vengono conteggiati tutti i caratteri inviati all'API Translation, compresi gli spazi.
| Quota per i contenuti |
Valore predefinito |
Valore massimo |
Durata |
Applicabile a |
| Caratteri al giorno |
1 miliardo |
nessun limite |
1 giorno |
progetto |
| Caratteri per 100 secondi per progetto |
1.000.000 di caratteri |
10.000.000 di caratteri |
100 secondi |
progetto |
| Caratteri per 100 secondi per progetto per utente |
100.000 caratteri |
10.000.000 di caratteri |
100 secondi |
utente e progetto |
L'API Translation è ottimizzata per tradurre richieste brevi. La lunghezza massima consigliata per ogni richiesta è di 2 K. L'API Translation rifiuta le richieste di dimensioni molto elevate (con errore 400 INVALID_ARGUMENT), indipendentemente dalla quota disponibile.
Se viene superata la quota, l'API Translation restituisce l'errore 403. Il messaggio di errore indica Daily Limit Exceeded se hai superato il limite giornaliero o User Rate Limit Exceeded se hai superato una delle due quote relative ai "Caratteri per 100 secondi".
Per visualizzare o modificare i limiti di utilizzo relativi al progetto o per richiedere un incremento della quota bisogna:
Quote per le richieste
Oltre alle quote per i contenuti indicate sopra, si applicano quote per l'utilizzo dell'API Translation. In particolare, esiste un limite alla frequenza con cui è possibile richiedere l'elenco delle lingue supportate per la traduzione.
Nota che questa quota non viene applicata al testo inviato per la traduzione. Viene applicata solo alle richieste relative all'elenco delle lingue supportate.
| Quota |
Valore predefinito |
Valore massimo |
Durata |
Applicabile a |
| Richieste dell’elenco delle lingue supportate per 100 secondi |
1000 richieste |
1000 richieste |
100 secondi |
progetto |
Le quote per i contenuti e le richieste sono applicabili a ogni progetto di sviluppatore dell'API Translation e a ogni utente. Inoltre, vengono condivise tra tutte le applicazioni e gli indirizzi IP utilizzati da un determinato progetto di sviluppatore.
Account di fatturazione
Senza un account di fatturazione non è possibile accedere ai prodotti della Google Cloud Platform. Dopo la registrandosi vengono erogati $ 300 omaggio da spendere entro 12 mesi.
Nessun addebito automatico alla fine della prova gratuita.
Durante la registrazione viene richiesto un numero di carta di credito per permettere a Google di verificare che il soggetto è reale ma assicura non verrà addebitato alcun costo finché non sarà effettuato manualmente l’upgrade ad un account di pagamento.
Guida pratica di utilizzo
Per utilizzare i servizi di traduzione di Google bisogna creare un progetto nella Google Cloud Platform e generare una chiave JSON.
Come prima cosa bisogna creare il progetto “MyProject” ed abilitare il servizio “Cloud Translation API” per il progetto “MyProject”.
Per attivare il servizio bisogna avere un account di fatturazione attivo; in caso contrario Google avvisa l’utente con il seguente messaggio:
)
Account
|
Una volta attivato Cloud Translation API sarà possibile scaricare un JSON contente la chiave privata per accedere al servizio.
La chiave privata dovrà quindi essere inserita nel file di configurazione di Mago, così come precedentemente illustrato.
Per ulteriori dettagli fare riferimento a Google Cloud.
Geocoding
Vediamo quali sono i servizi che devono essere abilitati sulla ApiKey di Google per poter utilizzare le funzionalità in Mago. Le Embed API possono essere gratuite (BASIC) oppure a pagamento (ADVANCED).
)
Costi
|
- BASIC: fanno parte della modalità BASIC sia Place Mode che View Mode.
Per visualizzare le mappe Mago utilizza Place Mode.
)
Costi
|
- ADVANCED: fanno parte della modalità ADVANCED Directions Mode, Street View Mode e Seach Mode.
Per calcolare il percorso Mago utilizza Directions Mode.
- Mappe Statiche: le Maps Static API non sono gratuite e i costi sono rappresentati nella seguente tabella:
)
Costi
|
Ad oggi (marzo 2019) anche fornendo un indirizzo di fatturazione a Google la visualizzazione della mappa non è a pagamento. Il pagamento è richiesto solo nel caso si utilizzi le traduzioni, la visualizzazione del percorso o si richiedano mappe statiche.