Domande frequenti su Google Maps Platform

Per iniziare

Comprendi i Termini di servizio

Limiti di utilizzo e fatturazione (quote)

Utilizza 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. Sono disponibili diverse offerte. A seconda delle tue esigenze, potresti utilizzare una di queste API o uno di questi SDK oppure una relativa combinazione:

Maps:

Route:

Luoghi:

Ambiente:

Come faccio a iniziare a utilizzare Google Maps Platform?

Consulta Inizia a utilizzare Google Maps Platform.

Quale API mi serve?

Per assistenza nella ricerca dell'API giusta in base ai tuoi requisiti funzionali, dai un'occhiata a Capabilities Explorer.

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

Consulta la Guida introduttiva, quella Panoramica e quella per gli sviluppatori per informazioni sull'API o sull'SDK specifico di tuo interesse. Ad esempio, dai un'occhiata alle guide per Maps SDK for Android o l'API Maps JavaScript.

A quali paesi si estende la copertura di Google Maps Platform?

Il team di Google Maps lancia costantemente nuovi dati sulle mappe e aumenta la nostra copertura internazionale. Consulta l'articolo Dati sulla copertura di Google Maps per le ultime informazioni sulla copertura. Puoi filtrare i dati tramite l'apposita casella nella parte superiore della pagina. I dati sulla copertura possono variare se cambiano i contratti di licenza con i fornitori di dati.

Vedi anche:

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

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

Come faccio a pubblicare applicazioni Maps sui dispositivi mobili?

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

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

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

Per le applicazioni destinate a dispositivi non adatti all'utilizzo dell'API Maps JavaScript, l'API Maps Static fornisce immagini di mappe nei formati 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 che l'immagine della mappa sia collegata a Google Maps.

Quali browser web sono supportati dall'API Maps JavaScript e dall'API Maps Embed?

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

Desktop
  • La versione attuale di Microsoft Edge (Windows), esclusa la modalità IE.
  • Le due versioni stabili principali più recenti di Firefox (Windows, macOS, Linux).
  • Le due versioni stabili principali più recenti di Chrome (Windows, macOS, Linux).
  • Le due versioni stabili principali più recenti di Safari (macOS).
Android
  • La versione attuale di Chrome su Android 4.1 e versioni successive.
  • Chrome WebView su Android 4.4 e versioni successive.
iOS
  • Mobile Safari sulla versione principale attuale e precedente di iOS.
  • UIWebView e WKWebView nelle versioni principali attuale e precedente di iOS.
  • La versione attuale di Chrome per iOS.
Posso stampare le 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 una notifica quando vengono apportate modifiche ai prodotti Google Maps Platform?

Ti consigliamo di iscriverti al blog di Google Maps Platform per ricevere aggiornamenti sulle varie offerte per gli sviluppatori di Google Geo.

Come faccio a contattare l'assistenza tecnica?

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

Quando è disponibile l'assistenza tecnica?
Il team di assistenza è disponibile 24 ore su 24 per 5 giorni alla settimana (giorni infrasettimanali dal lunedì alle 09:00, ora di Tokyo, al venerdì alle 17:00, ora del Pacifico USA), escludendo festività regionali per problemi di tipo "servizio inutilizzabile".
Come faccio a recuperare l'accesso al mio Account Google?

Se non riesci più ad accedere al tuo Account Google (ad es. mario@miaazienda.com o mario@gmail.com), puoi provare a ripristinare l'accesso all'account recuperando o reimpostando la password. Consulta l'articolo Come recuperare l'Account Google o Gmail nella guida dell'Account Google.

Come faccio a 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 Maps SDK e Places SDK for iOS su Mac basati su Arm?

Lo sviluppo sui nuovi Mac basati su Arm è possibile, tuttavia richiede la creazione e l'esecuzione su un dispositivo iOS fisico. Si tratta di una limitazione temporanea, mentre valutiamo l'aggiunta di un maggiore supporto per lo sviluppo su simulatori.

Comprendi 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 è conforme ai Termini di servizio di Google Maps Platform?

Puoi utilizzare Google Maps Platform all'interno delle tue applicazioni, purché il tuo sito soddisfi i Termini di servizio di Google Maps Platform.

Tuttavia, esistono alcuni utilizzi di Google Maps Platform che non vogliamo vedere. Ad esempio, mappe che identificano i luoghi in cui acquistare sostanze stupefacenti illegali in una città o qualsiasi altra attività illegale. Rispettiamo anche la privacy delle persone, pertanto Google Maps Platform non deve essere utilizzata per identificare informazioni private sugli individui.

Prima di sviluppare e lanciare la tua applicazione, devi rivolgerti al tuo consulente legale per determinare se è conforme ai Termini di servizio di Google Maps Platform. Gli ingegneri di Google possono offrire solo assistenza tecnica e non sono qualificati per offrire consulenza legale. Google si riserva il diritto di sospendere o interrompere l'utilizzo del servizio da parte tua in qualsiasi momento, pertanto leggi attentamente i Termini delle API di Google Maps.

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

Non puoi accedere ai Map Tiles o alle immagini satellitari tramite meccanismi diversi da Google Maps Platform (ad esempio, la creazione di una tua API di Google Maps o l'utilizzo di uno script di download collettivo dei Map Tiles). L'accesso dell'applicazione ai riquadri verrà bloccato se l'accesso avviene al di fuori di Google Maps Platform. Per maggiori dettagli, consulta i Termini di servizio di Google Maps Platform.

Posso utilizzare i prodotti Google Maps Platform per le applicazioni di monitoraggio?

Non esistono limitazioni alla visualizzazione di 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ì, i prodotti Google Maps Platform ora 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 ed Environment possono essere utilizzati con applicazioni ad accesso privato. Per maggiori dettagli, consulta i Termini di servizio di Google Maps Platform.

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

Se la tua applicazione genera un documento, in formato elettronico o stampato, nessun dato di Google Maps Platform, incluse le immagini, può essere incluso nel documento. Per maggiori dettagli, consulta la sezione "Nessuno scraping" dei 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 ritirato e non ha alcun effetto. Non è più necessario disattivare esplicitamente la funzionalità, ma ti consigliamo di 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.

Posso generare un'immagine della mappa utilizzando l'API Maps Static che memorizzo 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 modo che tutte le immagini della mappa vengano visualizzate all'interno dei contenuti HTML della pagina web e fornite direttamente agli utenti finali da Google.

Limiti di utilizzo e fatturazione

Come faccio a configurare la fatturazione per il mio progetto?
Consulta Inizia a utilizzare Google Maps Platform.
Che cos'è la prova senza costi di Google Cloud e in che modo gli utenti della prova senza costi possono eseguire l'upgrade a un account a pagamento?

La prova senza costi di Google Cloud è un programma di 91 giorni che consente ai nuovi utenti di provare i prodotti Google Cloud più popolari, incluse le API di Google Maps Platform (GMP), senza alcun impegno finanziario. La registrazione alla prova senza costi crea un account di fatturazione per la prova senza costi precaricato con 300 $di credito di benvenuto senza costi, che puoi spendere per GMP.

Se non esegui l'upgrade a un account di fatturazione a pagamento prima che siano trascorsi 91 giorni o se spendi i 300 $di credito senza costi, il tuo account di fatturazione della prova senza costi verrà chiuso e tutti i progetti e le risorse associati verranno interrotti. Per mantenere le risorse create durante la prova senza costi e i servizi in esecuzione senza interruzioni, esegui l'upgrade a un account di fatturazione a pagamento. Scopri di più sulla prova senza costi.

Google Maps Platform ha limiti di utilizzo (quote)?

Non esistono limiti giornalieri massimi per il numero di richieste che puoi effettuare ai prodotti Google Maps Platform e gli unici limiti di utilizzo sono correlati al numero massimo di query al minuto (QPM).

La tabella seguente mostra il limite di utilizzo per ogni API. Puoi visualizzare e modificare i limiti delle quote nella console Cloud.

API Limite di utilizzo
Address Validation 6000 QPM
Aerial View: Lookup Video 180 QPM e 100.000 QPD
Aerial View: esegui il rendering del video 100 QPM e 100 QPD
Qualità dell'aria 6000 QPM
API Maps JavaScript: mappe 3D 30.000 QPM
API Maps JavaScript: Mappe dinamiche 30.000 QPM
Elevazione 6000 QPM
Geocoding 3000 QPM
Geolocalizzazione 6000 QPM
Maps Grounding Lite: cerca luoghi, controlla il meteo, calcola i percorsi 300 QPM per strumento
Maps Grounding Lite: Risolvi i nomi, Risolvi gli URL di Maps 600 QPM per metodo
Map Tiles API: 2D Map Tiles 6000 QPM e 15.000 QPD
Map Tiles API: Street View Tiles 6000 QPM e 15.000 QPD
API Map Tiles: riquadri 3D fotorealistici 12.000 QPM e 10.000 richieste root al giorno.
Navigazione: richieste di impostazione della destinazione 30.000 QPM
Places 6000 QPM
Places Aggregate 1200 QPM
Pollen 6000 QPM
Strade 30.000 QPM
Routes: Compute Routes 3000 QPM
Routes: Compute Route Matrix 3000 EPM
Solar 600 QPM
Static Maps 30.000 QPM
API Street View Image 30.000 QPM
Fuso orario 30.000 QPM
Meteo 6000 QPM

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

I prodotti Google Maps Platform devono essere implementati in conformità ai Termini di servizio di Google Maps Platform standard.

Come viene calcolato il costo di utilizzo?

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

Per scoprire di più sulla fatturazione delle API Google Maps Platform, consulta la panoramica sulla fatturazione e sui prezzi di Google Maps Platform.

Come vengono conteggiati i caricamenti di mappe su Google Maps Platform?

Un singolo caricamento della mappa viene addebitato quando si verifica uno dei seguenti eventi:

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

Le panoramiche in Street View vengono addebitate separatamente dai caricamenti mappa:

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

Dopo che una pagina web o un'applicazione ha caricato una mappa, un'immagine di mappa statica o una panoramica in Street View, le interazioni dell'utente con la mappa, ad esempio la panoramica, lo zoom o il cambio dei livelli della mappa, non generano caricamenti di mappe aggiuntivi né influiscono sui limiti di utilizzo.

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

Come faccio a monitorare il mio utilizzo?

Puoi monitorare l'utilizzo delle singole API nella console Google Cloud.

  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 i dati di fatturazione per un intero progetto, segui questi passaggi:

  1. Se non l'hai ancora fatto, configura la fatturazione.
  2. Vai alla pagina di fatturazione della console Cloud.
  3. Seleziona un progetto.
  4. Nella barra laterale a sinistra, fai clic su Report. Utilizza i filtri nella barra laterale a destra per visualizzare i report sul tuo account di fatturazione.

Per saperne di più, consulta Report di Google Maps Platform, Monitoraggio di Google Maps Platform e Imposta un limite di quota.

Che cosa succede se supero i limiti del tasso di richieste (QPM)?

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

Se superi i limiti di QPM delle richieste o se utilizzi il servizio in modo improprio, 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: le seguenti API di servizio web hanno un servizio lato client equivalente disponibile nell'API Maps JavaScript: Elevation, Geocoding.

Limiti di utilizzo superati

Se superi i limiti di utilizzo, ricevi un codice di stato OVER_QUERY_LIMIT come risposta.

Questo messaggio indica che il servizio web ha smesso di fornire risposte normali e ha iniziato a restituire solo il codice di stato OVER_QUERY_LIMIT finché non sarà consentito un maggiore utilizzo. Questo scenario può verificarsi nel giro di pochi secondi se l'errore è stato ricevuto perché l'applicazione ha inviato troppe richieste al minuto.

Se superi regolarmente i limiti di utilizzo delle QPM, valuta la possibilità di ridurre l'utilizzo ottimizzando le applicazioni per utilizzare i prodotti Google Maps Platform in modo più efficiente oppure richiedi un aumento della quota. Per saperne di più, 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 API di Google Maps Platform su cui si basa la tua applicazione.

Una volta creato un account di fatturazione, se superi il limite di utilizzo senza costi e non hai un metodo di pagamento valido nel tuo account di fatturazione (ad esempio una carta di credito o un bonifico bancario), l'API smette di funzionare finché non aggiungi un metodo di pagamento valido.

Come verrà calcolato e fatturato l'utilizzo?

L'utilizzo viene calcolato alla fine di ogni giornata e il prezzo viene stabilito in base al listino prezzi. Alla fine di ogni mese, l'utilizzo totale viene addebitato sul metodo di pagamento associato al tuo account di fatturazione. Per ulteriori informazioni, consulta Fatturazione di Google Maps Platform.

Quanto costa utilizzare Google Maps Platform?

Consulta il listino prezzi per una panoramica dei costi per API. Se la tua applicazione genera richieste o volumi di caricamento delle mappe fino al limite di utilizzo senza costi per un determinato mese, non ti verrà addebitato alcun costo per l'utilizzo. L'utilizzo che supera il limite di utilizzo senza costi viene addebitato sul tuo account di fatturazione. Per scoprire di più, consulta la sezione Fatturazione di Google Maps Platform.

I prezzi sono disponibili in altre valute?

Nella console potrebbero essere disponibili valute aggiuntive. Quando selezioni una valuta diversa, le tariffe vengono convertite dall'equivalente in USD indicato nel nostro listino prezzi.

Ho configurato la fatturazione. Come faccio a visualizzare la mia fattura?

Google ti addebita all'inizio di ogni mese l'importo relativo all'attività del mese precedente, utilizzando il metodo di pagamento specificato. Per i dettagli sulla fattura, consulta la sezione 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 modi per impostare limiti di richieste giornaliere e limiti di fatturazione giornalieri massimi. Puoi impostare un limite massimo giornaliero per l'utilizzo per proteggerti da aumenti imprevisti. Puoi anche impostare avvisi relativi al budget per ricevere notifiche via email quando gli addebiti sull'account di fatturazione raggiungono una soglia impostata da te.

Limitazione del limite massimo giornaliero fatturabile:

Per evitare una fattura elevata, puoi impostare un limite giornaliero di utilizzo per proteggerti da aumenti imprevisti. Puoi modificare questo limite nella console Cloud

Impostazione e gestione degli avvisi relativi al budget:

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

Ho ricevuto un messaggio che indica che il mio progetto è collegato all'"Account di transizione di Google Maps Platform", ma non ho accesso a questo account. Che cosa posso fare?

L'"Account di transizione di Google Maps Platform" è stato creato per aiutare alcuni clienti a passare al nostro piano tariffario di pagamento a consumo. Questo account di transizione ha consentito 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. Una volta superato questo limite, l'account di fatturazione verrà chiuso e perderai l'accesso al servizio. Per evitare interruzioni del servizio, ti invitiamo a configurare il tuo account di fatturazione e continuare a usufruire del limite di utilizzo mensile senza costi. Per modificare l'account di fatturazione per il tuo progetto:

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

Se non hai creato e collegato un account di fatturazione al tuo progetto, le tue API di Maps Platform saranno limitate a 1 richiesta al giorno. Puoi ottenere una quota più elevata creando e collegando un account di fatturazione. Per farlo, consulta Inizia a utilizzare Google Maps Platform.

Una volta creato e collegato un account di fatturazione, il limite di quota giornaliero 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 comunicazione perché Google ha stabilito che il tuo account utilizza più account di fatturazione. Si tratta di una violazione dei Termini di Google, come definito nei Termini di servizio di Google Maps Platform. In base a questi termini, è vietato creare più account di fatturazione. Per saperne di più, consulta le domande frequenti sulle violazioni dell'account di fatturazione.

Utilizza 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 Android, iOS o web e per servizi web HTTP.

Chiave API:

  • Una chiave API è un identificatore univoco che generi 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 l'API Maps Static e l'API Street View Static.

Restrizioni:

  • Le restrizioni alle chiavi API sono facoltative, ma ti 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 delle applicazioni alla chiave API. Una volta applicata la restrizione, la chiave funzionerà solo sulle piattaforme che supportano quel tipo di restrizione. Sono disponibili quattro tipi di restrizioni delle applicazioni. Le API che applicano lo stesso tipo di limitazione possono utilizzare la stessa chiave con limitazioni.
    • Indirizzi IP (singoli server) da utilizzare con le API dei servizi web.
    • Referrer HTTP (siti web): da utilizzare con le API web.
    • Limitazione per app per Android (per nome del pacchetto e fingerprint): da utilizzare con Maps SDK for Android.
    • Limitazione per app per iOS (per identificatore pacchetto iOS): da utilizzare con Maps SDK for iOS.
  • Puoi anche aggiungere una restrizione API alla chiave API. Per saperne di più, consulta Ottieni, aggiungi e limita una chiave API.

La tabella seguente indica la chiave/credenziale e la limitazione delle applicazioni per ogni API/SDK di Google Maps Platform.

API/SDK Restrizione delle credenziali e delle applicazioni
Maps SDK for Android Chiave API con limitazione per Android1
Places SDK for Android Chiave API con limitazione per Android1
Navigation SDK for Android Chiave API con limitazione per Android1
Maps SDK for iOS Chiave API con limitazione per iOS1
Places SDK for iOS Chiave API con limitazione per iOS1
Navigation SDK for iOS Chiave API con limitazione per iOS1
API Maps JavaScript Chiave API con limitazione del referrer HTTP1
API Map Tiles Chiave API con limitazione dell'indirizzo IP1
API Maps Datasets Token OAuth
API Aerial View Chiave API con limitazione dell'indirizzo 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 dell'indirizzo IP1
API Elevation Chiave API con limitazione dell'indirizzo IP1
API Geocoding Chiave API con limitazione dell'indirizzo IP1
API Geolocation Chiave API con limitazione dell'indirizzo IP1
API Places Chiave API con limitazione dell'indirizzo IP1
API Places Aggregate Chiave API con limitazione dell'indirizzo IP1
API Roads Chiave API con limitazione dell'indirizzo IP1
API Routes Chiave API con limitazione dell'indirizzo IP1
API Fuso Orario Chiave API con limitazione dell'indirizzo IP1
API Air Quality Chiave API con limitazione dell'indirizzo IP1
API Pollen Chiave API con limitazione dell'indirizzo IP1
API Solar Chiave API con limitazione dell'indirizzo IP1
API Weather Chiave API con limitazione dell'indirizzo IP1
1 Le restrizioni delle chiavi API sono facoltative, ma ti consigliamo vivamente di limitare tutte le chiavi API per una maggiore sicurezza.
2 A seconda dell'utilizzo, potrebbe essere necessaria una firma digitale per l'API Maps Static e l'API Street View Static. Indipendentemente dall'utilizzo, ti consigliamo vivamente di utilizzare sia una chiave API sia una firma digitale per autenticare le tue richieste.
Come faccio a cambiare il tipo di restrizione della chiave da un referrer HTTP a una restrizione dell'indirizzo IP?

Importante: se utilizzi una delle API dei servizi web con una chiave API con limitazioni dei referrer, le tue richieste non andranno a buon fine e verrà visualizzato il messaggio di errore: "Le chiavi API non possono avere limitazioni dei referrer se utilizzate con questa API". Ti consigliamo di passare all'utilizzo di una chiave API con restrizioni per gli indirizzi IP.

Prima di cambiare il tipo di restrizione 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 restrizione possono utilizzare la stessa chiave con restrizioni. Se devi applicare più di una limitazione, aggiungi una chiave separata con la limitazione richiesta. Scopri come aggiungere una nuova chiave API.

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

Per passare da una chiave API con limitazione del referrer HTTP a una con limitazione dell'indirizzo 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. Nella pagina Credenziali, seleziona il nome della chiave API dall'elenco delle chiavi API per modificarne i dettagli.
  4. Nella sezione Restrizione delle chiavi della pagina, seleziona "Indirizzi IP (server web, cron job ecc.)" e inserisci gli indirizzi IP del server appropriati, quindi fai clic su Salva.
Come faccio a ottenere una nuova chiave API?
Consulta Inizia a utilizzare Google Maps Platform.
Come faccio a trovare le modifiche introdotte in ogni versione delle API di Google Maps?

Le informazioni sulle modifiche alle versioni di molte API di Google Maps sono disponibili ai seguenti link:

Puoi anche controllare in 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 il caricamento della pagina?

Basta specificare il parametro di callback durante il caricamento dell'API. Per ulteriori informazioni e codice campione, consulta la sezione Inizia della documentazione dell'API Maps JavaScript.

Come faccio a visualizzare 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 posizione dell'utente o alle impostazioni del browser. Alcune API ti consentono di impostare esplicitamente una lingua quando effettui una richiesta. Per saperne di più su come impostare la lingua, consulta la documentazione di ogni API:

Lingue supportate:

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

Codice della lingua Lingua Codice della lingua Lingua
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 Bengalese 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
it Inglese ro Rumeno
en-AU Inglese (australiano) ru Russo
en-GB Inglese (Gran Bretagna) sr Serbo (cirillico)
et Estone sr-Latn Serbo (alfabeto latino)
fa Farsi si Sinhalese
fi Finlandese sk Slovacco
fil Filippino sl Sloveno
fr Francese es Spagnolo
fr-CA Francese (Canada) es-419 Spagnolo (America Latina)
gl Galiziano sw Swahili
ka Georgiano sv Svedese
de Tedesco ta Tamil
el Greek te Telugu
gu Gujarati th Thailandese
iw Ebraico tr Turco
hi Hindi uk Ucraino
hu Ungherese UK Urdu
è Islandese uz Uzbeco
id Indonesiano vi Vietnamita
it Italiano zu Zulu

Puoi vedere l'aspetto della mappa in una qualsiasi delle lingue elencate sopra in questa applicazione di esempio.

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

Tutte le API di Google Maps Platform possono e devono essere accessibili tramite HTTPS. Per garantire la compatibilità futura delle tue applicazioni, ti consigliamo vivamente di utilizzare TLS 1.3 per HTTPS. Anche se le versioni TLS precedenti sono ancora supportate, sconsigliamo di fare affidamento sulle versioni TLS legacy 1.0 e 1.1 deprecate.

Il protocollo SSL deprecato non è più supportato.

Per saperne di più, consulta le domande frequenti sulla migrazione della CA principale di Google Maps Platform e le domande frequenti su Google Trust Services.

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

Se riscontri un comportamento che ritieni possa essere un bug, inizia segnalandolo nel forum pertinente. In questo modo, altri sviluppatori potranno convalidare il bug ed escludere eventuali problemi con il tuo codice.

Per richiedere una funzionalità, segnalala prima nel forum pertinente per verificare 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 dalla funzionalità esistente dei prodotti Google Maps Platform, segnala il bug o la richiesta di funzionalità utilizzando l'Issue Tracker di Google Maps Platform.

Prima di aggiungere un bug o una richiesta di funzionalità a Issue Tracker ,assicurati di controllare che il bug o la funzionalità in questione non siano già stati aggiunti. In questo caso, puoi aggiungere una stella al problema per registrare il tuo interesse e ricevere notifiche sugli aggiornamenti.

In che modo le API di Google Maps Platform utilizzano i cookie del sito?

Maps SDK for Android e Maps SDK for iOS utilizzano i cookie soggetti alle Norme sulla privacy di Google, ad esempio per calcolare gli utenti attivi giornalieri e nell'arco di 7 giorni e per prevenire l'abuso dei servizi. Questi cookie non sono associati ad alcun Account Google che ha eseguito l'accesso e non vengono registrati con il resto delle informazioni raccolte dalle chiamate API.

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

Il team Developer Relations di Google è presente su Stack Overflow, un sito di domande e risposte per programmatori con modifica collaborativa. È un ottimo posto per porre domande tecniche sullo sviluppo e sulla manutenzione delle applicazioni Google Maps. Maggiori informazioni su come porre domande su Stack Overflow sono disponibili nella pagina Assistenza.

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

  • Cercare nelle discussioni in corso. È probabile che qualcun altro abbia riscontrato un problema simile e abbia trovato una soluzione.
  • Se possibile, invia un link al tuo sito. Pubblica snippet di codice solo se il codice non è visualizzabile online.
  • Fornisci tutte le informazioni pertinenti, tra cui le versioni del browser, gli errori e tutti gli altri dati che potrebbero 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 dei codici di errore:

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

In determinate circostanze, potrebbe essere visualizzata una mappa oscurata o un'immagine di Street View "negativa" con la filigrana "Solo per scopi di sviluppo". Questo comportamento in genere indica problemi con una chiave API o con la fatturazione. Per utilizzare i prodotti Google Maps Platform, devi disporre di un account di fatturazione e tutte le richieste devono includere una chiave API valida. Il seguente flusso ti aiuterà a risolvere il problema:


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:
  • Nella richiesta manca una chiave API.
  • La chiave API fornita non è valida.
  • Al progetto non è associato un account di fatturazione.
  • È stato superato un limite di utilizzo autoimposto.
  • Il metodo di pagamento fornito non è più valido (ad esempio, una carta di credito è scaduta).
  • Hai superato i limiti di quota per una determinata API.

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

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 di Places SDK for Android o Places SDK for iOS. Scopri di più e trova i nuovi SDK all'indirizzo https://goo.gle/places-sdk-deprecation.
Come faccio a risolvere l'errore "Questo IP, sito o applicazione mobile non è autorizzato 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 una richiesta.
  • Hai attivato le limitazioni dei referrer HTTP (sito web) sulla tua chiave API e un referrer non autorizzato sta tentando una richiesta.
  • Hai limitato l'utilizzo alle tue app per Android impostando un nome del pacchetto e un'impronta e un'app per Android non autorizzata sta tentando di effettuare una richiesta.
  • Hai limitato le richieste provenienti da app per iOS specificando gli identificatori pacchetto e un'app per iOS non riconosciuta sta tentando di inviare una richiesta.
  • In passato era possibile ricevere questo errore se utilizzavi una delle API dei servizi web con una chiave API con limitazioni dei referrer HTTP. Le richieste a queste API devono essere identificate con una chiave API con restrizioni relative agli indirizzi IP. Cambia il tipo di restrizione della chiave da una restrizione del referrer HTTP a una restrizione dell'indirizzo IP. Per saperne di più sulla limitazione delle chiavi API, consulta Best practice per le chiavi API.

Visualizza e modifica le credenziali della chiave API

Per visualizzare le chiavi API e gestire eventuali limitazioni, segui questi passaggi:

  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 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 eventuali limitazioni configurate per la chiave. Da qui, le limitazioni possono essere modificate, eliminate o aggiornate in base alle esigenze.
Come faccio a risolvere l'errore: "Le chiavi API con limitazioni dei referrer non possono essere utilizzate con questa API"?

Utilizzi una delle API dei servizi web con una chiave API limitata a un referrer HTTP. Per motivi di sicurezza, le API dei servizi web devono utilizzare chiavi API limitate agli indirizzi IP. Cambia il tipo di restrizione della chiave da una restrizione del referrer HTTP a una restrizione dell'indirizzo IP o crea una nuova chiave API se la tua chiave è già utilizzata con l'API Maps JavaScript.

Servizi Google Maps Platform

Devo convertire gli indirizzi in coppie di 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 visualizzare i paesi 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 applicazione. La disponibilità dei dati di geocodifica dipende dai nostri contratti con i fornitori di dati, pertanto è soggetta a modifiche.

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

Il geocodificatore dell'API e quello di Google Maps a volte utilizzano set di dati diversi (a seconda del paese). Il geocodificatore dell'API viene aggiornato occasionalmente con nuovi dati, quindi puoi aspettarti di vedere i risultati cambiare o migliorare nel tempo.

Come devo formattare le query del geocodificatore per massimizzare il numero di richieste andate a buon fine?

Il geocodificatore è progettato per mappare gli indirizzi alle coordinate geografiche. Pertanto, ti consigliamo di formattare le richieste del geocodificatore in base alle seguenti linee guida per massimizzare la probabilità di una query riuscita:

  • Specifica gli indirizzi in conformità al formato utilizzato dal servizio postale nazionale del paese interessato.
  • Non specificare elementi aggiuntivi dell'indirizzo, come nomi di attività, numeri di unità, numeri di piano o numeri di suite che non sono inclusi nell'indirizzo definito dal servizio postale del paese in questione. In questo modo, potresti ricevere risposte con ZERO_RESULTS.
  • Formatta i Plus Code come mostrato qui (i segni più vengono convertiti in caratteri di escape dell'URL in %2B e gli spazi vengono convertiti in caratteri di escape dell'URL in %20):
    • Un codice globale è un prefisso di 4 caratteri e un codice locale di almeno 6 caratteri (849VCWC8+R9 è 849VCWC8%2BR9).
    • Un codice composto è un codice locale di almeno sei 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.
  • Se possibile, utilizza l'indirizzo con il numero civico anziché specificare gli incroci.
  • Non fornire "indizi" come punti di riferimento nelle vicinanze.
Come devo formattare un indirizzo statunitense su un'autostrada 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 provinciali: "Co Road NNN" dove NNN è il numero della strada, ad esempio "Co Road 82"
  • Autostrade statali: "State NNN" dove Stato è il nome completo dello stato e NNN è il numero dell'autostrada, ad esempio "California 82"
  • Autostrade statunitensi: "US NNN" dove NNN è il numero dell'autostrada. Ad esempio: "US 101"
  • Autostrade interstatali degli Stati Uniti: "Interstate NNN" dove NNN è il numero dell'autostrada interstatale, ad esempio "Interstate 280"
Quando devo utilizzare una classe di geocodifica dell'API e quando devo utilizzare il servizio di geocodifica HTTP?

Consulta il documento Strategie di geocodifica, che descrive in dettaglio i vantaggi e i limiti delle diverse strategie di geocodifica.

Come faccio a fornire indicazioni stradali con Google Maps Platform?

Il servizio Compute Routes dell'API Routes ti consente di fornire indicazioni stradali per percorsi con una o più tappe. Le opzioni di routing ti aiutano a definire le indicazioni stradali con una modalità di viaggio (in auto), un singolo percorso o un insieme di percorsi e limitazioni (nessuna strada a pedaggio). Questi servizi sono disponibili nelle seguenti forme:

Interfaccia di richiesta/risposta HTTP (utilizzata nelle applicazioni mobile e di altro tipo) compatibile con Maps SDK for Android e con altri servizi web di Google Maps.

In quali paesi sono disponibili le indicazioni stradali?

Per visualizzare i paesi supportati dalle indicazioni stradali nei prodotti Google Maps Platform, consulta i dati di copertura di Google Maps. La disponibilità dei dati sulle indicazioni stradali dipende dai nostri contratti con i fornitori di dati ed è soggetta a modifiche.

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

L'API Routes supporta tutti i partner di Google Transit, ad eccezione della Indian Railway Catering and Tourism Corporation e di quelli in Giappone.

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

Non esiste un limite al numero di indicatori o vertici di percorso supportati dall'API Maps Static. Quando utilizzi icone personalizzate, puoi specificare fino a cinque icone uniche per richiesta, ma ognuna 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,il che limita il numero di indicatori e vertici del percorso che possono essere specificati in base al numero di cifre decimali utilizzate per specificare ogni coppia di latitudine/longitudine. Per informazioni su come il numero di cifre decimali utilizzate è correlato 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. Consulta anche i Termini di servizio.

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

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

Se i contenuti di Maps devono essere rimossi per motivi legali, invia una richiesta di tipo legale.

Per richieste critiche o urgenti, invia una richiesta di assistenza con dettagli specifici su ciò che deve essere corretto.

In che modo 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 ai fini del calcolo dello SLO (obiettivo del livello di servizio). Queste informazioni vengono inviate a Google all'indirizzo maps.googleapis.com/maps_api_js_slo/log nelle chiamate che registrano le informazioni SLO. Queste informazioni includono lo stato di esito positivo, la latenza e la versione/il canale dell'API Maps JavaScript in uso. Le chiamate possono essere raggruppate per migliorare le prestazioni. Potresti dover consentire maps.googleapis.com nella tua Content Security Policy in modo 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

Per 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 visualizzi questo errore, è possibile che tu stia utilizzando una versione deprecata di Places SDK for iOS. La versione 2.7.0 di Places SDK for iOS è stata disattivata e non è più disponibile. Aggiorna l'app per utilizzare l'ultima versione il prima possibile. Consulta la guida alla migrazione per ulteriori dettagli.
Si verificano arresti anomali durante il debug con un dispositivo iOS 8.x. Che cosa devo fare?

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

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

A partire dall'iPhone X, gli iPhone hanno una forma dello schermo con angoli arrotondati, un notch nella parte superiore per l'alloggiamento dei sensori del dispositivo e un indicatore nella parte inferiore dello schermo per accedere alla schermata Home. A partire dall'SDK iOS 11.0, Apple ha aggiunto l'API Safe Area che consente agli sviluppatori di posizionare gli elementi in un'area che non rischia di essere ritagliata dalla nuova forma dello schermo.

L'SDK Google Maps per iOS include molti elementi visivi e controlli, come un selettore di interni e il link per segnalare un problema. Con la versione 2.4, questi elementi visivi e controlli potrebbero essere ritagliati dalla nuova forma dello schermo. In modalità Orizzontale, il selettore dei piani interni potrebbe essere tagliato dal notch o dall'indicatore del pulsante Home.

Con la release 2.5 di Google Maps SDK for iOS, questi problemi di layout vengono risolti automaticamente. Quando la tua app viene utilizzata su un iPhone X o modelli successivi, il padding su GMSMapView e GMSPanoramaView viene aumentato in modo che gli elementi visivi non vengano ritagliati.

Per impostazione predefinita, includeremo sempre il padding. L'SDK Google Maps per iOS presuppone che il padding sia destinato a essere applicato dall'interno dell'area protetta. Se progetti l'interfaccia partendo dal presupposto che tutto sia posizionato all'interno dell'area sicura, funzionerà senza ulteriori sforzi.

Se hai progettato un'interfaccia che non funziona con la nostra regolazione predefinita, abbiamo introdotto una nuova proprietà in GMSMapView, chiamata paddingAdjustmentBehavior. Utilizza GMSMapView per scegliere uno dei tre comportamenti di regolazione del padding: "Sempre" (predefinito), "Automatico" e "Mai".

Se GMSMapView è impostato per utilizzare il comportamento di spaziatura interna "Sempre", aggiungerà sempre gli inserti dell'area protetta alla spaziatura interna. Questa impostazione ti consente di progettare l'interfaccia partendo dal presupposto che tutti i posizionamenti avvengano dai bordi dell'area sicura. Questo è il valore predefinito.

Se GMSMapView è impostato per utilizzare il comportamento di spaziatura interna "Automatico", sceglierà sempre il valore maggiore tra la spaziatura interna o l'inset dell'area sicura. Questa impostazione ti consente di aggiungere un padding dal bordo dello schermo, assicurandoti al contempo che tutti gli elementi rimangano all'interno dell'area sicura.

Se GMSMapView è impostato per utilizzare il comportamento di spaziatura interna "Never", non aggiungerà mai gli inserti dell'area protetta alla spaziatura interna. Questo è il comportamento precedente alla release 2.5 e può essere utile se il padding tiene già conto dell'area sicura o se gli altri nostri comportamenti non funzionano bene con la tua interfaccia. È tua responsabilità assicurarti che il logo Google e le note sul copyright siano sempre visibili, come specificato nei Termini di servizio di Google Maps Platform.

Al contrario, GMSPanoramaView non ha una proprietà di spaziatura interna facoltativa. Ciò significa che non è necessario regolare il padding e GMSPanoramaView applicherà sempre il padding necessario in modo che tutti gli elementi visivi rientrino nell'area sicura.

Google Maps SDK for Android

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

Un motivo comune per cui vengono mostrati riquadri grigi vuoti anziché una mappa sono i problemi di autenticazione. Puoi seguire i passaggi riportati di seguito per risolvere questi problemi utilizzando adb logcat.

  1. Assicurati di aver installato adb. In caso contrario, puoi seguire la guida adb per Android.
  2. Installa l'app che mostra il problema su un dispositivo o un emulatore Android. Se utilizzi l'emulatore Android, assicurati che le impostazioni dell'emulatore includano il Play Store.
  3. Nel terminale di Android Studio, esegui adb logcat -e "Google Maps Android API". In questo modo verranno stampate solo le righe in cui il messaggio di log corrisponde a "Google Maps Android API" (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 manifest viene fatto riferimento alla chiave API errata/non prevista.
    • La fatturazione non è abilitata per il progetto.
    • L'SDK non è abilitato nelle API del progetto.
    • La fingerprint SHA-1 errata viene aggiunta alle restrizioni della chiave API.
    • Le dipendenze di Google Play Services non sono incluse nel file build.gradle.
L'accelerazione hardware è obbligatoria per Google Maps SDK for Android?
Sì, hardwareAccelerated deve essere impostato su true nel file AndroidManifest.xml della tua app per evitare problemi con il caricamento della mappa.
Per saperne di più, consulta la pagina Accelerazione hardware nella documentazione per lo sviluppo Android.

Firma URL

Posso firmare gli URL utilizzando JavaScript?

Sconsigliamo vivamente di firmare gli URL utilizzando JavaScript, in quanto ciò esporrebbe il secret di firma URL agli utenti finali. Pertanto, le firme devono essere generate solo dai componenti lato server.

Perché ricevo una risposta HTTP 403 Forbidden alle mie richieste ai servizi web delle API di 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. È stata specificata una firma, ma non è corretta per questa richiesta.
  2. La richiesta specifica una chiave API del piano Premium di Google Maps Platform, 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 non la chiave API del piano Premium di Google Maps Platform associata.