Domande frequenti su Google Maps Platform

Per iniziare

Comprendere i Termini di servizio

Limiti di utilizzo e fatturazione

Utilizzo di Google Maps Platform

Errori e risoluzione dei problemi

Servizi Google Maps Platform

API Maps JavaScript

Google Maps SDK for iOS

Google Maps SDK for Android

Firma URL

Per iniziare

Che cos'è Google Maps Platform?

Google Maps Platform è un insieme di API e SDK che consente agli sviluppatori di incorporare Google Maps in app mobile e pagine web o di recuperare dati da Google Maps. Le offerte disponibili sono diverse. A seconda delle esigenze, potresti dover utilizzare una sola API e uno di questi SDK o una loro combinazione:

Mappe:

Percorsi:

Luoghi:

Ambiente:

Come faccio a iniziare a utilizzare Google Maps Platform?

Consulta la guida introduttiva a Google Maps Platform.

Quale API mi serve?

Per informazioni su come trovare l'API giusta in base ai tuoi requisiti funzionali, dai un'occhiata al selettore API.

Come faccio a iniziare a utilizzare le API sul mio sito?

Consulta le guide introduttive, iniziali e per gli sviluppatori relative all'API o all'SDK specifici che ti interessano. Ad esempio, consulta le guide relative a SDK Maps per Android o all'API Maps JavaScript.

Quali paesi copre Google Maps Platform?

Il team di Google Maps fornisce costantemente nuovi dati sulle mappe e aumenta la nostra copertura internazionale. Consulta i dati sulla copertura di Google Maps per informazioni sulla copertura più recenti. Puoi filtrare i dati con l'apposita casella nella parte superiore della pagina. Tieni presente che i dati sulla copertura possono cambiare se cambiano i contratti di licenza con i fornitori di dati.

Vedi anche:

Posso inserire Google Maps nel mio sito senza utilizzare i prodotti Google Maps Platform?

Sì. Google Maps ora offre la possibilità di incorporare la mappa visualizzata nel tuo sito web o blog, senza alcuna programmazione o utilizzo di Google Maps Platform. Ulteriori informazioni sono disponibili qui.

Come faccio a pubblicare applicazioni di Google Maps sui dispositivi mobili?

Per incorporare mappe in un'applicazione Android, utilizza Maps SDK for Android.

Per incorporare mappe in un'applicazione iOS nativa, utilizza Maps SDK for iOS.

L' API Maps JavaScript è stata sviluppata per soddisfare le esigenze dei dispositivi mobili ed è adatta per le applicazioni browser destinate sia ai computer desktop sia ai dispositivi che includono un browser web con un'implementazione JavaScript completa, come l'iPhone Apple.

Per le applicazioni destinate a dispositivi non idonei all'utilizzo dell'API Maps JavaScript, l'API Maps Static fornisce immagini delle mappe in formato GIF, JPG e PNG, inclusi indicatori e polilinee. Tieni presente che l'utilizzo dell'API Maps Static al di fuori delle applicazioni basate su browser richiede il collegamento dell'immagine mappa a Google Maps.

Quali browser web supportano l'API Maps JavaScript e l'API Maps Embed?

L'API Maps JavaScript e l'API Maps Embed supportano i seguenti browser web:

Computer
  • La versione corrente di Microsoft Edge (Windows), esclusa la modalità IE.
  • Le due versioni principali stabili più recenti di Firefox (Windows, macOS, Linux).
  • Le due versioni principali stabili più recenti di Chrome (Windows, macOS, Linux).
  • Le due versioni principali stabili più recenti di Safari (macOS).
Android
  • La versione corrente di Chrome su Android 4.1 e versioni successive.
  • Chrome WebView su Android 4.4 e versioni successive.
iOS
  • Safari per dispositivi mobili sulle principali versioni attuali e precedenti di iOS.
  • UIWebView e WKWebView sulle principali versioni attuali e precedenti di iOS.
  • La versione corrente di Chrome per iOS.
Posso stampare mappe dall'API Maps JavaScript?

La stampa dall'API Maps JavaScript non è supportata. Questo perché il supporto per la stampa non è coerente tra i browser di uso comune.

Come faccio a ricevere notifiche quando vengono apportate modifiche ai prodotti Google Maps Platform?

Iscriviti al blog di Google Maps Platform per ricevere aggiornamenti sulle notizie relative alle varie offerte per gli sviluppatori di Google Maps.

Come posso contattare l'assistenza tecnica?

Consulta la pagina Assistenza e risorse di Google Maps Platform per informazioni sulle opzioni di assistenza disponibili.

Quando è disponibile l'assistenza tecnica?
Il team di assistenza è disponibile 24 ore su 24, 5 giorni su 5 (nei giorni feriali dal lunedì alle 9:00 (ora di Tokyo) al venerdì alle 17:00 (fuso orario del Pacifico)) escluse le festività locali per i problemi relativi ai "servizi inutilizzabili".
Come faccio a recuperare l'accesso al mio Account Google?

Se non riesci più ad accedere al tuo Account Google (ad es. giovanni@azienda.it o giovanni@gmail.com), puoi provare a ripristinare l'accesso all'account recuperando o reimpostando la password. Leggi l'articolo Come recuperare l'Account Google o Gmail nella Guida di Account Google.

Come posso recuperare l'accesso a un progetto specifico?

Se hai perso l'accesso al progetto in cui gestisci l'implementazione di Google Maps Platform, puoi provare a recuperarlo.

Se hai accesso al tuo Account Google associato al progetto:

Se non hai accesso al tuo Account Google associato al progetto:

Posso utilizzare l'SDK Maps and Places per iOS su Mac basati su ARM?

Lo sviluppo sui nuovi Mac basati su ARM è possibile, ma richiede la creazione e l'esecuzione su un dispositivo iOS fisico. Si tratta di una limitazione temporanea che stiamo cercando di aggiungere ulteriore supporto per lo sviluppo su simulatori.

Comprendere i Termini di servizio

Quali sono i Termini di servizio per i prodotti Google Maps Platform?

I Termini di servizio di Google Maps Platform sono disponibili all'indirizzo:

https://cloud.google.com/maps-platform/terms

Il mio sito soddisfa i Termini di servizio di Google Maps Platform?

Puoi utilizzare Google Maps Platform nelle tue applicazioni, a condizione che il tuo sito rispetti i Termini di servizio di Google Maps Platform.

Tuttavia, ci sono alcuni usi di Google Maps Platform che non vogliamo prendere in considerazione: ad esempio mappe che identificano i luoghi in cui acquistare sostanze stupefacenti illegali in una città o qualsiasi altra attività illegale. Rispettiamo inoltre la privacy delle persone, pertanto Google Maps Platform non deve essere utilizzato per identificare informazioni private su privati.

Ti consigliamo di rivolgerti al tuo consulente legale per stabilire se la tua applicazione rispetta i Termini di servizio di Google Maps Platform prima di svilupparla e lanciarla. I tecnici di Google possono offrire solo assistenza tecnica e non sono qualificati per offrire consulenza legale. Google si riserva il diritto di sospendere o interrompere il tuo utilizzo del servizio in qualsiasi momento. Ti invitiamo quindi a leggere attentamente i Termini delle API di Google Maps.

Posso accedere direttamente ai riquadri della mappa e alle immagini satellitari?

Non puoi accedere ai riquadri della mappa o alle immagini satellitari tramite meccanismi diversi da Google Maps Platform (come la creazione della tua API di mappatura o l'uso di uno script per il download di riquadri collettivi). L'accesso della tua applicazione ai riquadri verrà bloccato se vi accede al di fuori di Google Maps Platform. Per ulteriori dettagli, consulta i Termini di servizio di Google Maps Platform.

Posso utilizzare i prodotti Google Maps Platform per il monitoraggio delle applicazioni?

Non esistono limitazioni alla visualizzazione dei dati in tempo reale (monitoraggio) con i prodotti Google Maps Platform, a condizione che l'applicazione sia conforme ai Termini di servizio di Google Maps Platform.

Posso utilizzare Google Maps nella mia applicazione non web?

Sì, ora i prodotti Google Maps Platform possono essere utilizzati in applicazioni non web, a condizione che rispettino le altre limitazioni dei Termini di servizio di Google Maps Platform.

L'API Maps JavaScript è supportata solo se eseguita in uno dei browser supportati.

Posso utilizzare i prodotti Google Maps Platform su un sito protetto da password?

Sì, i servizi Google Maps, Routes, Places e Environment possono essere utilizzati con applicazioni con accesso privato. Per ulteriori dettagli, consulta i Termini di servizio di Google Maps Platform.

Posso creare un'applicazione che include i dati di Google Maps Platform in un documento?

Se l'applicazione genera un documento, in formato elettronico o stampato, nel documento non possono essere inclusi dati di Google Maps Platform, comprese le immagini. Per ulteriori informazioni, consulta i Termini di servizio di Google Maps Platform.

Come faccio a disattivare l'inclusione dei miei contenuti nei risultati di ricerca di Google?

Non raccogliamo più questi dati. L'utilizzo del parametro indexing è stato deprecato e non ha alcun effetto. Non è più necessario effettuare la disattivazione esplicita, ma ti invitiamo a rimuovere questo parametro il prima possibile.

Per rimuovere la tua pagina o il tuo sito dai risultati di ricerca, segui le istruzioni fornite nel nostro Centro assistenza per i webmaster.

Posso generare un'immagine mappa utilizzando l'API Maps Static che archivio e pubblico dal mio sito web?

Non puoi archiviare e pubblicare copie di immagini generate utilizzando l'API Maps Static dal tuo sito web. Tutte le pagine web che richiedono immagini statiche devono collegare l'attributo src di un tag HTML img o l'attributo CSS background-image di un tag HTML div direttamente all'API Maps Static. In questo modo, tutte le immagini delle mappe vengono visualizzate all'interno dei contenuti HTML della pagina web e pubblicate direttamente da Google agli utenti finali.

Limiti di utilizzo e fatturazione

Come si imposta la fatturazione per il progetto?
Consulta la guida introduttiva a Google Maps Platform.
In che modo i clienti del Livello senza costi di Google Cloud possono eseguire l'upgrade a un account a pagamento?
Il programma Livello senza costi di Google Cloud Platform offre ai clienti una prova senza costi con un credito di 300 $da utilizzare con qualsiasi servizio di Google Cloud Platform (GCP), comprese le API di Google Maps Platform (GMP). Al termine della prova senza costi, devi eseguire l'upgrade a un account a pagamento per continuare a utilizzare questi servizi. Per eseguire l'upgrade a un account a pagamento, visita Cloud Console.
Esistono limiti di utilizzo per Google Maps Platform?

Non sono previsti limiti giornalieri massimi al numero di richieste che puoi inviare ai prodotti Google Maps Platform e gli unici limiti di utilizzo sono relativi al numero massimo di query al secondo (QPS) o query al minuto (QPM).

Per Matrice di distanza, il limite è impostato in eventi al secondo (EPS) calcolati come somma delle query lato client e lato server.

Per Routes:Compute Route Matrix, il limite è espresso in elementi al minuto (EPM), dove il numero di elementi in una richiesta è uguale a: (numero di origini × numero di destinazioni).

La tabella seguente mostra il limite di utilizzo per ogni API.

API Limite di utilizzo
Convalida indirizzo 6000 QPM
Vista aerea: ricerca video 180 QPM e 100.000 QPD
Vista aerea: rendering del video 100 QPM e 100 QPD
Air Quality 6000 QPM
Istruzioni 3000 QPM
Distance Matrix 60.000 EPM
Dynamic Maps 30.000 Q/M
Elevazione 6000 QPM
Geocoding 3000 QPM
Geolocalizzazione 6000 QPM
API Map Tiles: riquadri 2D e riquadri Street View 6000 QPM e 15.000 QPD
API Map Tiles: riquadri 3D fotorealistici 300 QPD
API Map Tiles: riquadri 3D fotorealistici: renderer 12.000 QPM
Luoghi 6000 QPM
Polline 6000 QPM
Strade 30.000 QPM
Route: route di computing 3000 QPM
Route: matrice di route Compute 3000 EPM
Solare 600 q/m
Static Maps 30.000 QPM
API Street View Image 30.000 QPM
Fuso orario 30.000 QPM

Per gestire la spesa, puoi monitorare l'utilizzo delle API e impostare limiti giornalieri per tutte le richieste a qualsiasi API fatturabile.

Il deployment dei prodotti Google Maps Platform deve essere conforme ai Termini di servizio standard di Google Maps Platform.

Come viene calcolato il costo di utilizzo?

Per una panoramica dei prezzi dei prodotti Google Maps Platform, consulta il listino prezzi.

Per saperne di più su come vengono fatturate le API Google Maps Platform, consulta Informazioni sulla fatturazione per Maps, Routes, Places e Environment.

Come vengono conteggiati i caricamenti mappa in Google Maps Platform?

Viene addebitato un singolo caricamento mappa quando si verifica una delle seguenti condizioni:

  • Una pagina web o un'applicazione visualizza una mappa utilizzando l'API Maps JavaScript.
  • Un'applicazione richiede una singola immagine mappa all'API Maps Static.

Le panoramiche di Street View vengono addebitate separatamente dai caricamenti delle mappe:

  • Un panorama di Street View statico viene addebitato a ogni richiesta all'API Street View Static di incorporare una panoramica di Street View statica (non interattiva).
  • Una panoramica dinamica di Street View viene addebitata per ciascuna istanza di un oggetto panoramica in un'API Maps JavaScript, Maps SDK for Android o Maps SDK for iOS.

Dopo che una pagina web o un'applicazione carica una mappa, un'immagine statica della mappa o una panoramica di Street View, le interazioni dell'utente, come la panoramica, lo zoom o il passaggio da un livello all'altro della mappa, non generano ulteriori caricamenti della mappa e non influiscono sui limiti di utilizzo.

L'aggiunta di un indicatore non genera ulteriori caricamenti della mappa, ma potrebbe generare addebiti in base al modo in cui è stata determinata la posizione del segnaposto (ad esempio il caricamento o il ricaricamento della classe "google.maps.Map()").

Come posso monitorare il mio utilizzo?

Puoi monitorare l'utilizzo delle singole API in Google Cloud Console.

  1. Seleziona il progetto che contiene l'API che vuoi esaminare.
  2. Nell'elenco delle API nella dashboard, fai clic sul nome dell'API.
  3. Nella parte superiore della pagina, fai clic su Metriche o Quote.

Per visualizzare un report sul traffico e le informazioni di fatturazione per un intero progetto, segui questi passaggi:

  1. Se non lo hai già fatto, configura la fatturazione.
  2. Vai alla pagina Fatturazione della console Cloud.
  3. Seleziona un progetto.
  4. Nella barra laterale sinistra, fai clic su Report. Utilizza i filtri nella barra laterale destra per visualizzare i report relativi al tuo account di fatturazione.

Per scoprire di più, consulta Reporting di Google Maps Platform, Monitoraggio dell'utilizzo delle API e Limitazione dell'utilizzo delle API.

Che cosa succede se supero i limiti di frequenza delle richieste (QPS)?

Se superi i limiti di QPS di un determinato prodotto Google Maps Platform, l'API restituirà un messaggio di errore. Se superi ripetutamente i limiti, l'accesso all'API potrebbe essere temporaneamente bloccato.

Se superi i limiti di QPS delle richieste o in caso di abuso del servizio, le richieste restituiranno un messaggio di errore specifico. Se continui a superare i limiti, il tuo accesso a Google Maps Platform potrebbe essere bloccato.

Nota: quattro delle API del servizio web dispongono di un servizio lato client equivalente disponibile nell'API Maps JavaScript: Indicazioni stradali, Matrice di distanza, Elevation e Geocodifica.

Limiti di utilizzo superati

Se superi i limiti di utilizzo, riceverai in risposta un codice di stato OVER_QUERY_LIMIT.

Ciò significa che il servizio web smetterà di fornire risposte normali e passerà al solo codice di stato OVER_QUERY_LIMIT di restituzione finché non sarà nuovamente consentito un ulteriore utilizzo. Ciò può accadere entro pochi secondi se l'errore è stato ricevuto perché la tua applicazione ha inviato troppe richieste al secondo.

Se superi regolarmente i limiti di utilizzo di QPS, valuta la possibilità di ridurre l'utilizzo, ottimizzando le applicazioni per utilizzare i prodotti Google Maps Platform in modo più efficiente. Per ulteriori informazioni, consulta la guida all'ottimizzazione.

Il mio sito riceve molto traffico. Posso utilizzare i prodotti Google Maps Platform?

Sì. Tuttavia, ti consigliamo di acquisire familiarità con i limiti di utilizzo di qualsiasi piattaforma Google Maps Platform su cui si basa la tua applicazione.

Una volta che hai un account di fatturazione, se superi il limite di utilizzo mensile senza costi di 200 $ e non disponi di un metodo di pagamento valido sul tuo account di fatturazione (carta di credito, bonifico bancario e così via), l'API cesserà di funzionare finché non aggiungerai un metodo di pagamento valido.

Come verrà calcolato e fatturato l'utilizzo?

L'utilizzo viene calcolato alla fine di ogni giornata e viene calcolato in base a quanto indicato nel listino prezzi. Alla fine di ogni mese, l'utilizzo totale viene addebitato sul metodo di pagamento associato all'account di fatturazione. Per maggiori informazioni, consulta la pagina relativa alla fatturazione di Google Maps Platform.

Quanto costa utilizzare Google Maps Platform?

Per una panoramica del costo per API, consulta il foglio dei prezzi. Se la tua applicazione genera richieste o volumi di caricamento delle mappe fino a 200 $al mese, non ti viene addebitato alcun costo. L'utilizzo che supera i 200 $di credito mensile verrà addebitato sul tuo account di fatturazione. Per maggiori dettagli, consulta la nostra guida alla fatturazione di Google Maps Platform.

I prezzi sono disponibili in altre valute?

Nella console potrebbero essere disponibili altre valute. Se selezioni una valuta diversa, le tariffe verranno convertite a partire dall'equivalente in dollari indicato nel nostro listino prezzi.

Ho impostato la fatturazione. Come si visualizza la mia fattura?

Google ti addebita all'inizio di ogni mese le attività del mese precedente utilizzando il metodo di pagamento specificato. Per i dettagli sulla fattura, consulta la nostra guida alla fatturazione di Google Maps Platform.

Altre risorse:

Come posso evitare di ricevere una bolletta enorme se l'utilizzo aumenta in maniera imprevista?

Google Maps Platform offre la possibilità di impostare limiti di richieste giornalieri e limiti massimi di fatturazione giornalieri. Puoi limitare il limite giornaliero massimo di utilizzo per proteggerti da aumenti imprevisti. Puoi anche impostare avvisi relativi al budget in modo da ricevere notifiche via email quando gli addebiti sull'account di fatturazione raggiungono una soglia da te impostata.

Limite del limite massimo giornaliero fatturabile:

Per evitare di ricevere una fattura di dimensioni elevate, puoi impostare un limite giornaliero di utilizzo per tutelarti da eventuali aumenti imprevisti. Puoi modificare questo limite in Cloud Console seguendo questi passaggi:

  1. Vai alla dashboard API e servizi.
  2. Seleziona un progetto, se richiesto.
  3. Seleziona un'API dall'elenco, poi fai clic sulla scheda Quote.
  4. Fai clic sull'icona di modifica accanto alla quota "Richieste al giorno".

In alternativa, puoi modificare più quote per più API utilizzando la dashboard Quote di IAM e amministrazione.

Impostazione e gestione degli avvisi relativi al budget:

Configura avvisi relativi al budget per inviare notifiche email agli amministratori della fatturazione quando gli addebiti sull'account di fatturazione raggiungono una soglia da te impostata. Gli amministratori della fatturazione riceveranno notifiche via email quando gli addebiti stimati nell'account di fatturazione superano il 50%, il 90% e il 100% della soglia.

Ho ricevuto un messaggio secondo il quale il mio progetto è collegato a un "account di transizione Google Maps Platform", ma io non ho accesso a quell'account. Che cosa posso fare?

L'"account di transizione Google Maps Platform" è stato creato per aiutare alcuni clienti a passare al nuovo piano di pagamento a consumo. Questo account di transizione ha permesso a Google di fornire a questi clienti un credito una tantum, in modo che potessero continuare a utilizzare Google Maps Platform fino al limite del livello senza costi di 200 $. Una volta superato questo limite, l'account di fatturazione verrà disattivato e perderai l'accesso al servizio. Per evitare interruzioni del servizio, ti invitiamo a creare un account di fatturazione e a continuare a usufruire del livello mensile senza costi da $200. Per modificare l'account di fatturazione per il tuo progetto:

  1. Crea un nuovo account di fatturazione (se ne hai già uno, puoi saltare questo passaggio).
  2. Associa l'account di fatturazione al progetto.
Perché il mio limite di quota è impostato su 1 richiesta al giorno? Come faccio ad aumentare questo limite?

Se non hai creato e collegato un account di fatturazione al tuo progetto, le API Maps Platform saranno limitate a una richiesta al giorno. Puoi ottenere una quota più alta creando e collegando un account di fatturazione. Per farlo, consulta la Guida introduttiva all'utilizzo di Google Maps Platform.

Dopo aver creato e collegato un account di fatturazione, il limite della quota giornaliera verrà rimosso. Puoi decidere di impostare un limite per evitare spese impreviste nella console Cloud.

Ho ricevuto una notifica di violazione della fatturazione. Come posso risolvere il problema?

Ti abbiamo inviato questa notifica perché Google ha rilevato che il tuo account utilizza più account di fatturazione. Si tratta di una violazione dei termini di Google, come definiti nella sezione 3.2.4 dei Termini di servizio di Google Maps Platform. In base a questi termini, è vietato creare più account di fatturazione. Per ulteriori informazioni, consulta le Domande frequenti sulla violazione dell'account di fatturazione.

Utilizzo di Google Maps Platform

Quali chiavi o credenziali devo utilizzare per i diversi prodotti Maps?

Ogni volta che utilizzi i prodotti Google Maps Platform, devi includere una chiave API per convalidare la richiesta. Google Maps Platform è disponibile per app per Android, iOS o web e tramite i servizi web HTTP.

Chiave API:

  • Una chiave API è un identificatore univoco generato utilizzando la console Cloud.
  • Esempio di caricamento di un'API con una chiave: &key=AIzaSyBjsINSH5x39Ks6c0_CoS1yr1Mb3cB3cVo

Firma digitale:

  • Una firma digitale viene generata utilizzando un secret di firma URL fornito da Google. Le firme digitali vengono utilizzate con le API Maps Static e l'API Street View Static.

Restrizioni:

  • Le restrizioni relative alle chiavi API sono facoltative, ma consigliamo vivamente di limitare tutte le chiavi API per una maggiore sicurezza. Per ulteriori dettagli, consulta le best practice per la sicurezza delle API.
  • Puoi aggiungere una restrizione dell'applicazione alla chiave API. Una volta limitata, una chiave funzionerà solo sulle piattaforme che supportano quel tipo di limitazione. Sono disponibili quattro tipi di limitazioni per le applicazioni. Le API che applicano lo stesso tipo di limitazione possono utilizzare la stessa chiave limitata.
    • Indirizzi IP (singoli server), da utilizzare con le API del servizio web.
    • Referrer HTTP (siti web), da utilizzare con le API web.
    • Limitazione delle app per Android (per nome del pacchetto e impronta): da utilizzare con Maps SDK for Android.
    • Limitazione delle app per iOS (tramite identificatore bundle iOS): da utilizzare con Maps SDK for iOS.
  • Puoi anche aggiungere una restrizione API alla chiave API. Per maggiori informazioni, consulta Ottenere, aggiungere e limitare una chiave API.

La tabella seguente indica le restrizioni relative a chiave/credenziali e applicazioni per ogni SDK/API Google Maps Platform.

API/SDK Restrizioni relative a credenziali e applicazioni
SDK Maps per Android Chiave API con limitazione Android1
SDK Places per Android Chiave API con limitazione Android1
Maps SDK for iOS Chiave API con limitazione iOS1
SDK Places per iOS Chiave API con limitazione iOS1
API Maps JavaScript Chiave API con limitazione del referrer HTTP1
API Map Tiles Chiave API con limitazione degli indirizzi IP1
API Aerial View Chiave API con limitazione degli indirizzi IP1
API Maps Static Chiave API con limitazione del referrer HTTP1 + firma digitale2
API Street View Static Chiave API con limitazione del referrer HTTP1 + firma digitale2
API Maps Embed Chiave API con limitazione del referrer HTTP1
API Address Validation Chiave API con limitazione degli indirizzi IP1
API Directions Chiave API con limitazione degli indirizzi IP1
API Distanza Matrix Chiave API con limitazione degli indirizzi IP1
API Elevation Chiave API con limitazione degli indirizzi IP1
API Geocoding Chiave API con limitazione degli indirizzi IP1
API Geolocation Chiave API con limitazione degli indirizzi IP1
API Places Chiave API con limitazione degli indirizzi IP1
API Roads Chiave API con limitazione degli indirizzi IP1
API Routes Chiave API con limitazione degli indirizzi IP1
API Time Zone Chiave API con limitazione degli indirizzi IP1
API Air Quality Chiave API con limitazione degli indirizzi IP1
API Pollen Chiave API con limitazione degli indirizzi IP1
API Solar Chiave API con limitazione degli indirizzi IP1
1 Le restrizioni relative alle chiavi API sono facoltative, ma consigliamo vivamente di limitare tutte le chiavi API per una maggiore sicurezza.
2 A seconda dell'utilizzo, potrebbe essere richiesta una firma digitale per l'API Maps Static e l'API Street View Static. Indipendentemente dall'utilizzo, consigliamo vivamente di utilizzare sia una chiave API sia una firma digitale per autenticare le tue richieste.
Come posso cambiare il tipo di limitazione della chiave da un referer HTTP a una restrizione dell'indirizzo IP?

Importante: se utilizzi una qualsiasi delle API dei servizi web con una chiave API con restrizioni relative ai referrer, le richieste non andranno a buon fine e verrà visualizzato il messaggio di errore "Le chiavi API non possono avere limitazioni relative ai referrer quando vengono utilizzate con questa API". Devi passare a una chiave API con limitazioni relative agli indirizzi IP.

Prima di cambiare il tipo di limitazione della chiave API da referrer HTTP a indirizzo IP, assicurati che tutte le API che utilizzano la chiave API supportino il tipo di restrizione IP. Le API dello stesso tipo di limitazione possono utilizzare la stessa chiave con restrizioni. Se devi applicare più di una limitazione, aggiungi una chiave separata con la restrizione richiesta. Scopri come aggiungere una nuova chiave API.

Scopri di più sulle limitazioni delle chiavi API associate ai prodotti Google Maps Platform.

Per passare una chiave API con limitazione del referrer HTTP alla limitazione degli indirizzi IP, segui questi passaggi:

  1. Vai alla pagina Credenziali della console Cloud.
  2. Seleziona il progetto che contiene la chiave API che vuoi modificare.
  3. Nell'elenco delle chiavi API della pagina Credenziali, seleziona il nome della chiave API per modificarne i dettagli.
  4. Nella sezione Limitazione chiave della pagina, seleziona "Indirizzi IP (server web, cron job ecc.)" e inserisci gli indirizzi IP dei server appropriati, quindi fai clic su Salva.
Come posso ottenere una nuova chiave API?
Consulta la guida introduttiva a Google Maps Platform.
Come faccio a trovare le modifiche introdotte in ogni versione delle API di Google Maps?

Le informazioni sulle modifiche della versione per molte delle API di Google Maps sono disponibili ai seguenti link:

Puoi anche verificare quale versione di Google Maps Platform è stato introdotto e corretto un determinato bug utilizzando l'Issue Tracker di Google Maps Platform all'indirizzo:

https://issuetracker.google.com/bookmark-groups/76561

Come faccio a caricare l'API in una pagina in modo asincrono dopo che questa è stata caricata?

È sufficiente specificare il parametro di callback durante il caricamento dell'API. Ulteriori informazioni e codice di esempio sono disponibili nel capitolo Guida introduttiva della documentazione dell'API Maps JavaScript.

Come faccio a mostrare i prodotti Google Maps Platform in una lingua diversa dall'inglese?

Per impostazione predefinita, l'API tenterà di caricare la lingua più appropriata in base alla località dell'utente o alle impostazioni del browser. Alcune API ti consentono di impostare esplicitamente una lingua quando effettui una richiesta. Ulteriori informazioni su come impostare la lingua sono disponibili nella documentazione di ogni API:

Lingue supportate:

Google aggiorna spesso le lingue supportate. Questo elenco potrebbe non essere completo ed è soggetto a modifiche.

Codice della lingua linguaggio Codice della lingua linguaggio
af Afrikaans ja Giapponese
sq Albanese kn Kannada
AM Amarico kk Kazako
ar Arabo km Khmer
hy Armeno ko Coreano
az Azero ky Kirgizo
eu Basco lo Lao
be Bielorusso lv Lettone
bn Bengali lt Lituano
bs Bosniaco mk Macedone
bg Bulgaro ms Malese
my Birmano ml Malayalam
ca Catalano mr Marathi
zh Cinese mn Mongolo
zh-CN Cinese (semplificato) ne Nepalese
zh-HK Cinese (Hong Kong) no Norvegese
zh-TW Cinese (tradizionale) pl Polacco
h Croato pt Portoghese
cs Ceco pt-BR Portoghese (Brasile)
da Danese pt-PT Portoghese (Portogallo)
nl Olandese pa Punjabi
inglese Inglese ro Rumeno
en-AU Inglese (australiano) ru Russo
en-GB Inglese (Gran Bretagna) sr Serbo
et Estone si Singalese
fa Farsi sk Slovacco
fi Finlandese sl Sloveno
fil Filippino es Spagnolo
fr Francese es-419 Spagnolo (America Latina)
fr-CA Francese (Canada) sw Swahili
gl Galiziano sv Svedese
ka Georgiano ta Tamil
de Tedesco te Telugu
el Greco th Thailandese
gu Gujarati tr Turco
iw Ebraico uk Ucraino
hi Hindi ur Urdu
hu Ungherese uz Uzbeco
è Islandese vi Vietnamita
id Indonesiano zu Zulu
it Italiano

Puoi vedere che aspetto avrà la mappa in una qualsiasi delle lingue elencate in questa applicazione di esempio.

È possibile accedere a Google Maps Platform tramite SSL (HTTPS)?

È possibile accedere all'API Maps JavaScript, all'API Maps Static e alle API dei servizi web tramite connessioni sicure (HTTPS). Consulta la documentazione dell'API interessata per informazioni su come accedere all'API tramite SSL.

Tieni presente che l'API Maps Static non supporta gli URL di icone personalizzate che utilizzano HTTPS; verrà visualizzata l'icona predefinita.

Come faccio a segnalare un bug o a richiedere una nuova funzionalità in Google Maps Platform?

Se rilevi un comportamento che ritieni possa essere un bug, inizia a segnalarlo nel forum pertinente. Ciò consente ad altri sviluppatori di convalidare il bug ed escludere eventuali problemi con il codice.

Se vuoi richiedere una funzionalità, invia innanzitutto una segnalazione nel forum pertinente per confermare che non sia già disponibile una soluzione che soddisfi i tuoi requisiti.

Dopo aver confermato di aver identificato un nuovo bug o che i tuoi requisiti non possono essere soddisfatti dalle funzionalità esistenti dei prodotti Google Maps Platform, segnala il bug o la richiesta di funzionalità utilizzando lo strumento di monitoraggio dei problemi di Google Maps Platform.

Prima di aggiungere un bug o una richiesta di funzionalità al Monitoraggio problemi, assicurati che il bug o la funzionalità in questione non siano già stati aggiunti. In caso affermativo, puoi segnalare il problema per comunicarci il tuo interesse e ricevere notifiche relative agli aggiornamenti.

In che modo le API Google Maps Platform utilizzano i cookie dei siti?

L'SDK Maps per Android e l'SDK Maps for iOS utilizzano i cookie soggetti alle Norme sulla privacy di Google, ad esempio per il calcolo degli utenti attivi giornalieri e per 7 giorni e per la prevenzione degli abusi dei servizi. Questi cookie non vengono associati ad alcun Account Google a cui è stato eseguito l'accesso e non vengono registrati insieme alle altre informazioni raccolte dalle chiamate API.

Non riesco a trovare risposta alla mia domanda. Chi devo contattare?

Il team per le relazioni con gli sviluppatori di Google è presente su Stack Overflow, un sito di domande e risposte modificato in modo collaborativo per i programmatori. È un ottimo posto per porre domande tecniche sullo sviluppo e sulla gestione delle applicazioni di Google Maps. Ulteriori informazioni su come porre domande su Stack Overflow sono disponibili nella pagina Assistenza.

Per ottenere risultati ottimali quando richiedi assistenza, tieni presente quanto segue:

  • Cerca tra le discussioni correnti. È probabile che qualcun altro abbia riscontrato un problema simile e trovato una soluzione.
  • Se possibile, invia un link che rimanda al tuo sito. Pubblica snippet di codice solo se il codice non è facilmente visibile online.
  • Fornisci tutte le informazioni pertinenti, tra cui le versioni del browser, gli errori e tutti gli altri dati che possono essere utili per la risoluzione del problema.

Errori e risoluzione dei problemi

Che cosa significa questo errore?

Se si verifica un errore durante il caricamento o l'esecuzione delle API di Google Maps, consulta i seguenti link per trovare spiegazioni sui codici di errore:

Le mie mappe appaiono più scure del solito. Cosa succede?

In alcuni casi, potrebbe essere visualizzata una mappa scura o un'immagine di Street View "negativa" a cui è stata applicata la filigrana con il testo "solo a scopo di sviluppo". Questo comportamento indica in genere problemi con una chiave API o con la fatturazione. Per utilizzare i prodotti Google Maps Platform, devi avere un account di fatturazione e tutte le richieste devono includere una chiave API valida. Per risolvere il problema, segui la procedura riportata di seguito:


Come faccio a risolvere i codici di errore: OVER_DAILY_LIMIT o OVER_QUERY_LIMIT?
Questi codici di errore possono essere restituiti per uno dei seguenti motivi:
  • Chiave API mancante nella richiesta.
  • La chiave API fornita non è valida.
  • Al progetto non è collegato un account di fatturazione.
  • È stato superato un limite di utilizzo impostato da te.
  • Il metodo di pagamento fornito non è più valido (ad esempio, una carta di credito è scaduta).
  • Hai superato i limiti QPS per una determinata API.

Per utilizzare i prodotti Google Maps Platform, devi avere un account di fatturazione e tutte le richieste devono includere una chiave API valida. Per risolvere il problema:

Come faccio a risolvere i codici di errore: kGMSPlacesRateLimitExceeded o 9005 PLACES_API_RATE_LIMIT_EXCEEDED?
Se vedi kGMSPlacesRateLimitExceeded o 9005 PLACES_API_RATE_LIMIT_EXCEEDED, è possibile che tu stia utilizzando una versione deprecata dell'SDK Places for Android o dell'SDK Places for iOS. Scopri di più e trova i nuovi SDK all'indirizzo https://goo.gle/places-sdk-deprecation.
Come posso risolvere l'errore "L'IP, il sito o l'applicazione mobile non è autorizzata a utilizzare questa chiave API"?

Esistono vari scenari che possono causare questo errore:

  • Hai attivato le limitazioni degli indirizzi IP (server) sulla tua chiave API e un indirizzo IP non autorizzato sta tentando di inviare una richiesta.
  • Hai attivato le limitazioni relative ai referrer HTTP (sito web) sulla tua chiave API e un referrer non autorizzato sta tentando di inviare una richiesta.
  • Hai limitato l'utilizzo delle tue app per Android impostando un nome di pacchetto e un'impronta e un'app per Android non autorizzata sta tentando di inviare una richiesta.
  • Hai limitato le richieste provenienti dalle app per iOS specificando identificatori bundle e un'app per iOS non riconosciuta tenta di inviare una richiesta.
  • In precedenza era possibile ricevere questo errore se utilizzavi una delle API del servizio web con una chiave API con restrizioni relative ai referrer HTTP. Le richieste a queste API devono essere identificate con una chiave API con restrizioni relative agli indirizzi IP. Cambia il tipo di limitazione della chiave da una limitazione del referrer HTTP a una limitazione degli indirizzi IP. Per scoprire di più sulla limitazione delle chiavi API, consulta le best practice sulle chiavi API.

Visualizzare e modificare le credenziali della chiave API

Per visualizzare le chiavi API e gestire eventuali restrizioni:

  1. Vai alla pagina Credenziali della console Cloud.
  2. Seleziona il progetto che contiene la chiave API che vuoi esaminare.
  3. Per visualizzare i dettagli delle credenziali, incluse le eventuali limitazioni impostate per la chiave, fai clic sul nome della chiave nell'elenco delle chiavi API.
  4. Vengono visualizzate le credenziali complete della chiave API selezionata, incluse le eventuali limitazioni configurate per la chiave. Da qui, le limitazioni possono essere modificate, eliminate o aggiornate in base alle esigenze.
Come posso risolvere l'errore "Non è possibile utilizzare chiavi API con limitazioni dei referrer con questa API"?

Stai utilizzando una delle API del servizio web con una chiave API limitata a un referer HTTP. Per motivi di sicurezza, le API dei servizi web devono utilizzare chiavi API limitate agli indirizzi IP. Cambia il tipo di limitazione della chiave da una limitazione del referrer HTTP a una limitazione degli indirizzi IP oppure crea una nuova chiave API se la chiave è già utilizzata con l'API Maps JavaScript.

Servizi Google Maps Platform

Devo convertire gli indirizzi in coppie latitudine/longitudine. Posso farlo con Google Maps Platform?

Sì, questo processo è chiamato "geocodifica". L'API Maps JavaScript include una classe per l'esecuzione di un servizio di geocodifica. La classe è: google.maps.Geocoder.

In alternativa, Google fornisce anche l'API Geocoding, che offre un'interfaccia REST in grado di rispondere nei formati JSON e XML.

In quali paesi è disponibile la geocodifica?

Per vedere i paesi attualmente supportati dai geocodificatori di Google Maps Platform, consulta i dati sulla copertura di Google Maps.

La precisione delle località geocodificate può variare in base al paese, pertanto ti consigliamo di utilizzare il campo location_type restituito per determinare se è stata trovata una corrispondenza sufficientemente buona per gli scopi della tua richiesta. Tieni presente che la disponibilità dei dati di geocodifica dipende dai contratti stipulati con i fornitori di dati, pertanto i dati sono soggetti a modifiche.

Perché i geocodificatori di Google Maps Platform forniscono località diverse rispetto a Google Maps?

Il geocodificatore API e quello di Google Maps a volte utilizzano set di dati diversi (a seconda del paese). Di tanto in tanto, il geocodificatore delle API viene aggiornato con nuovi dati, pertanto i risultati potrebbero cambiare o migliorare nel tempo.

Come devo formattare le mie query del geocodificatore per massimizzare il numero di richieste riuscite?

Il geocodificatore è progettato per mappare gli indirizzi stradali alle coordinate geografiche. Pertanto, ti consigliamo di formattare le richieste dei geocodificatori in conformità con le seguenti linee guida per massimizzare le probabilità di riuscita di una query:

  • Specifica gli indirizzi secondo il formato utilizzato dal servizio postale nazionale del paese interessato.
  • Non specificare elementi indirizzo aggiuntivi, come nomi delle attività, numeri di unità, numeri di piani o numeri di appartamenti, che non sono inclusi nell'indirizzo come definito dal servizio postale del paese interessato. altrimenti potrebbero verificarsi risposte con ZERO_RESULTS.
  • Formatta i Plus Code come mostrato qui (i segni più sono preceduti da URL in formato di escape %2B e gli spazi con caratteri di escape URL in %20):
    • Il codice globale è un prefisso di 4 caratteri e un codice locale di almeno 6 caratteri (849VCWC8+R9 è 849VCWC8%2BR9).
    • Il codice composto è un codice locale di almeno 6 caratteri con una posizione esplicita (CWC8+R9 Mountain View, CA, USA è CWC8%2BR9%20Mountain%20View%20CA%20USA).
  • Se possibile, utilizza il numero civico di un edificio anziché il nome dell'edificio.
  • Se possibile, utilizza preferibilmente l'indirizzo del numero civico per indicare le incroci.
  • Non fornire suggerimenti come punti di riferimento nelle vicinanze.
Come devo formattare un indirizzo statunitense su una strada statale numerata per la geocodifica?

Il geocodificatore di Google Maps Platform richiede che le autostrade numerate degli Stati Uniti siano specificate negli indirizzi come segue:

  • Strade di contea: "Co Road NNN" dove NNN è il numero della strada, ad esempio "Co Road 82"
  • Strade statali: "State NNN", dove Stato è il nome completo dello stato e NNN è il numero dell'autostrada, ad esempio "California 82"
  • Autostrade statunitensi: "U.S. NNN", dove NNN è il numero dell'autostrada. Ad esempio: "U.S. 101"
  • Interstate USA: "Interstate NNN", dove NNN è il numero interstatale, ad esempio "Interstate 280"
Quando devo utilizzare una classe codificatore API e quando invece il servizio di geocodifica HTTP?

Consulta il documento: Geocoding Strategies, che descrive nel dettaglio i pro e i contro delle diverse strategie di geocodifica.

Come faccio a fornire indicazioni stradali con Google Maps Platform?

Il servizio Compute Routes dell'API Routes e dell'API Directions ti consentono di fornire indicazioni stradali per percorsi con una o più tappe. Le opzioni di percorso ti consentono di definire le indicazioni stradali con una modalità di viaggio (guida), uno o un insieme di percorsi e limitazioni (nessuna strada a pedaggio). Questi servizi sono disponibili nei seguenti formati:

  • L'interfaccia di richiesta/risposta HTTP (utilizzata in applicazioni mobile e di altro tipo) è compatibile con Maps SDK per Android e con altri servizi web di Google Maps.
  • L'API JavaScript, per le applicazioni lato client, consente di fornire indicazioni stradali tramite la classe google.maps.DirectionsService. La classe DirectionsRenderer può creare automaticamente gli overlay e il riquadro delle indicazioni stradali. Altri esempi sono disponibili nella documentazione.
  • Le interfacce client Java, Python, go e Node.js, per le applicazioni lato server, offrono la stessa funzionalità. Per maggiori informazioni sulle librerie client, consulta la pagina relativa alle librerie client dell'API Directions.
In quali paesi sono disponibili le indicazioni stradali?

Per visualizzare i paesi attualmente supportati dalle indicazioni stradali nei prodotti Google Maps Platform, consulta i dati sulla copertura di Google Maps. Tieni presente che la disponibilità dei dati delle indicazioni stradali dipende dai contratti stipulati con i fornitori di dati ed è soggetta a modifiche.

In quali paesi sono disponibili le indicazioni stradali per il trasporto pubblico?

L'API Directions e l'API Distanza Matrix supportano tutti i partner di Google Transit, ad eccezione di quelli in Giappone.

Quali funzionalità KML e GeoRSS sono supportate nell'API Maps JavaScript?

La classe KmlLayer nell'API Maps JavaScript consente agli sviluppatori di sovrapporre i file KML/KMZ e GeoRSS sulla mappa. La documentazione e gli esempi sono disponibili qui.

Quali sono i limiti di dimensioni e complessità dei file KML che possono essere visualizzati utilizzando la classe Kmllayer dell'API Maps JavaScript?

I limiti di dimensioni e complessità relativi alla visualizzazione dei file KML utilizzando la classe KmlLayer sono indicati qui.

Come faccio a eseguire il rendering su una mappa di file KML ospitati su siti intranet?

La classe KmlLayer che genera overlay KML nell'API Maps JavaScript utilizza un servizio in hosting su Google per recuperare e analizzare i file KML per il rendering. Di conseguenza non è possibile visualizzare file KML che non sono ospitati in un URL accessibile pubblicamente o che richiedono l'autenticazione per l'accesso.

Se hai bisogno di sviluppare applicazioni che utilizzano file KML ospitati su siti intranet, ti consigliamo di eseguire il rendering del file KML sul lato client utilizzando librerie JavaScript di terze parti. Poiché il file KML viene analizzato dal browser, le prestazioni potrebbero essere inferiori rispetto all'uso della classe KmlLayer.

Qual è il numero massimo di indicatori o vertici del percorso supportato dall'API Maps Static?

Non è previsto alcun limite al numero di indicatori o vertici del percorso supportati dall'API Maps Static. Quando utilizzi le icone personalizzate, puoi specificare fino a cinque icone univoche per richiesta, ma ciascuna può essere utilizzata più volte all'interno della mappa.

Tieni presente che gli URL dell'API Maps Static possono contenere un massimo di circa 8192 caratteri,limitando il numero di indicatori e vertici del percorso che possono essere specificati in base al numero di posizioni decimali utilizzate durante la specifica di ciascuna coppia di latitudine/longitudine. Per informazioni su come il numero di posizioni decimali utilizzato si riferisce alla precisione sulla Terra, consulta l'articolo di Wikipedia sui gradi decimali.

Perché non riesco ad accedere ai prodotti Google Maps Platform per determinati paesi?

Le API di Google Maps non possono essere utilizzate nei Territori vietati. Fai riferimento anche ai Termini di servizio.

Come faccio a segnalare un problema nella mappa di base di Google?
Invia un feedback tramite Google Maps in caso di informazioni errate o mancanti sulla mappa, ad esempio:
  • Indirizzi o posizioni degli indicatori errati
  • Nomi di strade sbagliati
  • Informazioni errate sulle strade a senso unico e a doppio senso
  • Strada tracciata in modo errato
  • Strade chiuse
  • Strade che non esistono

Per correggere un luogo o una scheda di attività commerciale, suggerisci una modifica.

Se è necessario rimuovere contenuti di Maps per motivi legali, invia una richiesta di tipo legale.

Per le richieste critiche o urgenti, invia una richiesta di assistenza con dettagli specifici sugli aspetti da correggere.

Come vengono monitorate le prestazioni dei servizi utilizzati con l'API Maps JavaScript?

Alcune funzionalità lato client sono strumentate per segnalare l'esito positivo o negativo al fine di calcolare lo SLO (obiettivo del livello di servizio). Queste informazioni vengono inviate a Google all'indirizzo maps.googleapis.com/maps_api_js_slo/log durante le chiamate che registrano le informazioni sullo SLO. Queste informazioni includono lo stato di esito positivo, la latenza e la versione/canale dell'API Maps JavaScript in uso. Le chiamate possono essere raggruppate per migliorare le prestazioni. Tieni presente che potrebbe essere necessario consentire maps.googleapis.com nei Criteri di sicurezza del contenuto per garantire che queste chiamate non vengano bloccate a livello di browser. Ad esempio: Content-Security-Policy: default-src 'self' maps.googleapis.com; con intestazioni HTTP o <meta http-equiv="Content-Security-Policy" content="default-src 'self' maps.googleapis.com;"> con meta tag HTML.

API Maps JavaScript

Quanto tempo funzionerà l'API Maps JavaScript dopo il caricamento?

Devi aggiornare la pagina che carica l'API Maps JavaScript almeno una volta ogni 5 giorni.

Google Maps SDK for iOS

Come faccio a risolvere l'errore: kGMSPlacesRateLimitExceeded?
Se viene visualizzato questo errore, è possibile che tu stia utilizzando una versione deprecata dell'SDK Places per iOS. La versione 2.7.0 di Places SDK for iOS è stata disattivata e non è più disponibile. Aggiorna l'app il prima possibile per utilizzare la versione più recente. Consulta la guida alla migrazione per maggiori dettagli.
Ricevo arresti anomali durante il debug con un dispositivo iOS 8.x. Che cosa devo fare?

Se riscontri problemi durante il debug con dispositivi che eseguono iOS 8.x, segui questi passaggi per disattivare l'acquisizione dei frame GPU nello schema XCode in esecuzione:

  1. In XCode, scegli Prodotto, Schema, Gestisci schemi.
  2. Seleziona uno schema e scegli Modifica....
  3. Imposta l'opzione GPU Frame Capture su Disabled (Disattivata). Tieni presente che questa opzione potrebbe non essere presente per tutti i dispositivi.
Opzione Xcode GPU Frame Capture nella pagina Dispositivo iOS generico
Qual è l'impatto degli schermi arrotondati e più larghi dell'SDK Google Maps per iOS?

A partire dall'iPhone X, la forma dello schermo dell'iPhone è caratterizzata da angoli arrotondati, un'incavo in alto per l'alloggiamento dei sensori del dispositivo e un indicatore nella parte inferiore dello schermo per accedere alla schermata Home. A partire dall'SDK per iOS 11.0, Apple ha aggiunto l'API Safe Area, che consente agli sviluppatori di posizionare gli elementi in un'area che non può essere tagliata dalla nuova forma dello schermo.

L'SDK Google Maps per iOS ha molti elementi visivi e controlli, ad esempio un selettore per interni e il link Segnala un problema. Con la versione 2.4, questi elementi visivi e controlli possono essere estratti dalla nuova forma dello schermo. In modalità Orizzontale, il selettore del piano per interni può essere agganciato all'indicatore del pulsante Home o della tacca.

Con la release 2.5 dell'SDK Google Maps per iOS, questi problemi di layout vengono risolti automaticamente. Quando l'app viene utilizzata su iPhone X o versioni successive, la spaziatura interna in GMSMapView e GMSPanoramaView viene aumentata in modo che gli elementi visivi non vengano tagliati.

Per impostazione predefinita, includeremo sempre la spaziatura interna. L'SDK Google Maps per iOS presuppone che la spaziatura interna debba essere riempita dall'area sicura. Se progettati l'interfaccia partendo dal presupposto che tutto sia posizionato all'interno dell'area di sicurezza, potrai farlo senza alcuno sforzo in più.

Se hai progettato un'interfaccia che non funziona con l'aggiustamento predefinito, abbiamo introdotto in GMSMapView una nuova proprietà, chiamata paddingAdjustBehavior. GMSMapView ora consente di scegliere uno dei tre comportamenti di aggiustamento della spaziatura interna: "Sempre" (impostazione predefinita), "Automatico" e "Mai".

Se GMSMapView è impostato per utilizzare il comportamento di spaziatura interna "Sempre", aggiungerà sempre i riquadri dell'area di sicurezza alla spaziatura interna. Questo ti consente di progettare l'interfaccia partendo dal presupposto che il posizionamento avvenga dai bordi dell'area di sicurezza. Questo è il valore predefinito.

Se GMSMapView è impostato per utilizzare il comportamento di spaziatura interna "Automatico", sceglierà sempre il riempimento o il riquadro dell'area di sicurezza più grandi. In questo modo potrai aggiungere una spaziatura interna dal bordo dello schermo, assicurandoti sempre che tutti gli elementi rimangano nell'area di sicurezza.

Se GMSMapView è impostato per utilizzare il comportamento di spaziatura interna "Mai", non aggiungerà mai i riquadri dell'area di sicurezza alla spaziatura interna. Questo è il comportamento precedente alla release 2.5 e può essere utile se la spaziatura interna prende già in considerazione l'area di sicurezza o se gli altri nostri comportamenti non funzionano bene con la tua interfaccia. È tua responsabilità garantire che il logo di Google e le note sul copyright siano sempre visibili, come specificato nei Termini di servizio di Google Maps Platform.

Al contrario, GMSPanoramaView non dispone di una proprietà di spaziatura interna facoltativa. Ciò significa che non è necessaria alcuna spaziatura interna da regolare e GMSPanoramaView applicherà sempre la spaziatura interna necessaria per garantire che tutti gli elementi visivi si trovino nell'area di sicurezza.

Google Maps SDK for Android

Come faccio a risolvere l'errore: 9005 PLACES_API_RATE_LIMIT_EXCEEDED?
Se viene visualizzato questo errore, è possibile che tu stia utilizzando una versione deprecata dell'SDK Places for Android. La versione Google Play Services dell'SDK Places per Android è stata disattivata e non è più disponibile. Aggiorna l'app all'ultima versione appena possibile. Consulta la guida alla migrazione per i dettagli.
Nella mia app vengono mostrati solo riquadri grigi vuoti anziché una mappa. Come posso risolvere il problema?

Un motivo comune per cui vengono visualizzati riquadri grigi vuoti al posto di una mappa è dovuto ai problemi di autenticazione. Per risolvere questi problemi, puoi seguire i passaggi riportati di seguito utilizzando adb logcat.

  1. Assicurati di avere installato ADB. In caso contrario, puoi seguire la guida qui.
  2. Installa l'app che mostra il problema su un dispositivo o un emulatore Android. Se usi l'emulatore Android, assicurati che nelle impostazioni dell'emulatore sia incluso il Play Store.
  3. Nel terminale Android Studio, esegui adb logcat -e "Google Maps Android API". Verranno stampate solo le righe in cui il messaggio di log corrisponde a "API Google Maps per Android" (facoltativamente, puoi generare il log in un file di testo aggiungendo: > logcat.txt)
  4. Riproduci il problema sul dispositivo e controlla se sono presenti errori comuni, ad esempio:
    • Nel file manifest viene fatto riferimento alla chiave API errata o non intenzionale.
    • La fatturazione non è attivata nel progetto.
    • L'SDK non è abilitato nelle API del progetto.
    • L'impronta SHA1 errata viene aggiunta alle limitazioni relative alle chiavi API.
    • Le dipendenze di Google Play Service non sono incluse nel file build.gradle.

Firma URL

Posso firmare gli URL utilizzando JavaScript?

Sconsigliamo vivamente di firmare gli URL utilizzando JavaScript, in quanto il secret di firma degli URL potrebbe essere esposto agli utenti finali. Di conseguenza, le firme dovrebbero essere generate solo dai componenti lato server.

Perché ricevo una risposta HTTP 403 Forbidden alle mie richieste di servizio web dell'API di Google Maps?

Una risposta HTTP 403 indica un problema di autorizzazione, probabilmente perché non è stato possibile verificare la firma per questa richiesta. I motivi potrebbero essere i seguenti:

  1. Per questa richiesta è stata specificata una firma che però non è corretta.
  2. La richiesta specifica un piano premium di Google Maps Platform una chiave API, ma non specifica una firma e il servizio chiamato richiede che le richieste effettuate utilizzando una chiave API includano una firma valida.
  3. È stata specificata una firma, ma la chiave API del piano Premium di Google Maps Platform associata non è stata specificata.