Domande frequenti su Google Maps Platform

Per iniziare

Informazioni sui 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. 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:

Percorsi:

Luoghi:

Ambiente:

Come faccio a iniziare a utilizzare Google Maps Platform?

Consulta la Guida introduttiva a Google Maps Platform.

Di quale API ho bisogno?

Per trovare l'API giusta in base ai tuoi requisiti funzionali, consulta il selettore API.

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 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 i 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. Tieni presente che i dati sulla copertura possono variare se cambiano i contratti di licenza con i fornitori di dati.

Vedi anche:

Posso mettere 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. Ulteriori informazioni sono disponibili qui.

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

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

Per incorporare le mappe in un'applicazione iOS nativa, 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 che ai dispositivi che includono un browser web con un'implementazione completa di JavaScript, 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 delle 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:

Computer
  • La versione corrente di Microsoft Edge (Windows), esclusa la modalità IE.
  • Le due ultime versioni principali stabili di Firefox (Windows, macOS, Linux).
  • Le due ultime versioni principali stabili 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 mobile sulle versioni principali attuali e precedenti di iOS.
  • UIWebView e WKWebView nelle versioni principali attuali e precedenti 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 della stampa non è coerente nei 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 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 le 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. mariorossi@aziendamia.com o mariorossi@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 all'Account Google associato al progetto:

Posso utilizzare Maps e Places SDK for iOS su Mac basati su ARM?

Lo sviluppo sui nuovi Mac basati su ARM è possibile, ma richiede la compilazione e l'esecuzione su un dispositivo iOS fisico. Si tratta di una limitazione temporanea mentre valutiamo la possibilità di aggiungere ulteriore supporto per lo sviluppo su simulatori.

Informazioni sui Termini di servizio

Quali sono i Termini di servizio dei 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 la piattaforma Google Maps all'interno delle tue applicazioni a condizione che il tuo sito soddisfi i Termini di servizio della piattaforma Google Maps.

Tuttavia, ci sono alcuni utilizzi della piattaforma Google Maps che non vogliamo vedere: ad esempio, mappe che identificano i luoghi in cui acquistare droghe illegali in una città o qualsiasi altra attività illegale. Rispettiamo inoltre la privacy delle persone, pertanto la piattaforma Google Maps non deve essere utilizzata per identificare informazioni private su privati.

Prima di sviluppare e lanciare la tua applicazione, rivolgiti al tuo consulente 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 fornire consulenza legale. Google si riserva il diritto di sospendere o interrompere il tuo utilizzo del servizio in qualsiasi momento, pertanto leggi attentamente i Termini delle API di Maps.

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

Non puoi accedere ai tessere della mappa o alle immagini satellitari tramite nessun altro meccanismo oltre a Google Maps Platform (ad esempio la creazione della tua API di mappatura o l'utilizzo di uno script di download collettivo dei tessere). L'accesso della tua applicazione alle schede verrà bloccato se avviene 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 ci sono 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, Percorsi, Luoghi e Ambiente 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 includa i dati della piattaforma Google Maps in un documento?

Se la tua applicazione genera un documento, in formato elettronico o stampato, nel documento non possono essere inclusi dati della piattaforma Google Maps, incluse le immagini. Per ulteriori dettagli, consulta la sezione "Nessun 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 eseguire la disattivazione esplicita, ma ti invitiamo a rimuovere questo parametro al più presto.

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 della mappa utilizzando l'API Maps Static che immagazzino e pubblichi dal mio sito web?

Non puoi memorizzare e pubblicare copie delle 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 messe a disposizione direttamente agli utenti finali da Google.

Limiti di utilizzo e fatturazione

Come faccio a configurare la fatturazione per il mio progetto?
Consulta la sezione Introduzione a Google Maps Platform.
In che modo i clienti del Livello senza costi della piattaforma Google Cloud eseguono l'upgrade a un account a pagamento?
Il programma Livello senza costi della piattaforma Google Cloud offre ai clienti una prova senza costi con un credito di 300 $da utilizzare con qualsiasi servizio Google Cloud, incluse le API di Google Maps Platform (GMP). Al termine del periodo di 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 la console Cloud.
Google Maps Platform ha limiti di utilizzo?

Non esistono limiti giornalieri massimi per il 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 minuto (QPM).

Per la matrice di distanza, il limite è impostato in eventi al minuto (EPM) 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 x numero di destinazioni).

Per gli SDK di navigazione, ogni destinazione in una richiesta viene conteggiata come una query separata.

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

API Limite di utilizzo
Convalida dell'indirizzo 6000 QPM
Vista aerea: cerca video 180 QPM e 100.000 QPD
Vista aerea: rendering video 100 QPM e 100 QPD
Qualità dell'aria 6000 QPM
Directions 3000 QPM
Distance Matrix 60.000 EPM
Dynamic Maps 30.000 QPM
Elevazione 6000 QPM
Geocoding 3000 QPM
Geolocalizzazione 6000 QPM
API Map Tiles: riquadri 2D e riquadri Street View 6000 QPM e 15000 QPD
API Map Tiles: riquadri 3D fotorealistici 10000 QPD
API Map Tiles: riquadri 3D fotorealistici: Renderer 12.000 QPM
Navigazione: impostare le richieste di destinazione 30.000 QPM
Luoghi 6000 QPM
Polline 6000 QPM
Strade 30.000 QPM
Routes: Compute Routes 3000 QPM
Routes: Compute Route Matrix 3000 EPM
Solare 600 QPM
Static Maps 30.000 QPM
API Street View Image 30.000 QPM
Fuso orario 30.000 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à con gli standard Termini di servizio di Google Maps Platform.

Come viene calcolato il costo di utilizzo?

Per una panoramica dei prezzi dei prodotti Google Maps Platform, consulta la scheda dei prezzi.

Per scoprire di più sulla fatturazione delle API di Google Maps Platform, consulta la pagina Informazioni sulla fatturazione per Maps, Routes, Places e Environment.

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

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

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

I caricamenti delle panoramiche di Street View vengono fatturati separatamente dai caricamenti delle mappe:

  • Viene addebitato un panorama Street View statico per ogni richiesta all'API Static Street View di incorporare una panoramica Street View statica (non interattiva).
  • Viene addebitato un panorama di Street View dinamico 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 statica di una mappa o un panorama di Street View, eventuali interazioni dell'utente, come la panoramica, lo zoom o il passaggio da un livello all'altro, non generano caricamenti aggiuntivi delle mappe o influiscono sui limiti di utilizzo.

L'aggiunta di un indicatore non genera caricamenti aggiuntivi della mappa, ma potrebbe generare addebiti relativi alla modalità di determinazione della 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 di 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 scoprire di più, consulta Report di Google Maps Platform, nonché Monitoraggio dell'utilizzo delle API e Impostazione di un limite di utilizzo delle API.

Che cosa succede se supero i limiti di frequenza delle 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 QPM delle richieste o se fai un uso improprio 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 di servizio web hanno un servizio lato client equivalente disponibile nell'API Maps JavaScript: Directions, Distance Matrix, Elevation e Geocoding.

Limiti di utilizzo superati

Se superi i limiti di utilizzo, riceverai 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à nuovamente consentito un maggiore utilizzo. Questo scenario può verificarsi entro pochi secondi, se l'errore è stato ricevuto perché la tua applicazione ha inviato troppe richieste al minuto.

Se superi regolarmente i limiti di utilizzo in QPM, ti consigliamo di ridurre l'utilizzo ottimizzando le applicazioni per utilizzare i prodotti Google Maps Platform in modo più efficiente o di richiedere l'aumento della quota. 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 familiarizzare con i limiti di utilizzo di qualsiasi componente di Google Maps Platform su cui si basa la tua applicazione.

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

Come viene calcolato e fatturato l'utilizzo?

L'utilizzo viene calcolato alla fine di ogni giorno e il prezzo è indicato nel 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 la pagina Fatturazione di Google Maps Platform.

Quanto costa utilizzare Google Maps Platform?

Consulta il foglio dei prezzi per una panoramica del costo per API. Se la tua applicazione genera richieste o volumi di caricamento delle mappe fino a 200 $di utilizzo al mese, l'utilizzo non viene addebitato. L'utilizzo che supera il credito mensile di 200 $verrà addebitato sul tuo account di fatturazione. Per ulteriori dettagli, consulta la nostra guida alla comprensione della 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 configurato la fatturazione. Come faccio a visualizzare la mia fattura?

Google ti addebita l'importo all'inizio di ogni mese per l'attività del mese precedente utilizzando il metodo di pagamento specificato. Per informazioni dettagliate 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 modi per impostare limiti giornalieri per le richieste e per impostare limiti giornalieri massimi fatturabili. Puoi impostare un limite massimo giornaliero per l'utilizzo per proteggerti da eventuali aumenti imprevisti. Puoi anche impostare avvisi relativi al budget per ricevere notifiche via email quando gli addebiti nell'account di fatturazione raggiungono una soglia che hai impostato.

Impostazione di un limite massimo giornaliero fatturabile:

Per evitare una fattura elevata, puoi impostare un limite giornaliero di utilizzo per proteggerti da eventuali aumenti imprevisti dell'utilizzo. Puoi modificare questo limite nella console Cloud seguendo questi passaggi:

  1. Vai alla dashboard API e servizi.
  2. Seleziona un progetto, se richiesto.
  3. Seleziona un'API dall'elenco e 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 delle quote di IAM e amministrazione.

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 che hai impostato. 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 in cui si afferma che il mio progetto è collegato a un "account di transizione Google Maps Platform", ma io non ho accesso a tale account. Che cosa posso fare?

L'account di transizione Google Maps Platform è stato creato per semplificare la transizione di alcuni clienti al nuovo piano con pagamento a consumo. Questo account di transizione ha permesso a Google di offrire 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 $. Quando questo limite viene superato, l'account di fatturazione viene bloccato e l'utente perde l'accesso al servizio. Per evitare interruzioni del servizio, ti invitiamo a configurare tempestivamente un account di fatturazione, per continuare a usufruire del livello senza costi mensili di 200 $. Per modificare l'account di fatturazione per il tuo progetto:

  1. Crea un nuovo account di fatturazione (se ne possiedi già uno, puoi saltare questo passaggio).
  2. Associa l'account di fatturazione al tuo progetto.
Perché il mio limite di quota è impostato su una richiesta al giorno? How can I raise this limit?

Se non hai creato e collegato un account di fatturazione al tuo progetto, le API di 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 a Google Maps Platform.

Dopo aver creato e collegato un account di fatturazione, il limite di 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 faccio a risolvere il problema?

Hai ricevuto questa notifica perché Google ha stabilito che il tuo account utilizza più account di fatturazione. Si tratta di una violazione dei termini di Google, come definito nella sezione 3.2.4 dei Termini di servizio di Google Maps Platform. Ai sensi di questi termini, è vietato creare più account di fatturazione. Per saperne di più, consulta le domande frequenti sulla violazione dell'account per 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 Android, iOS o web e tramite 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:

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

Restrizioni:

  • Le restrizioni delle chiavi API sono facoltative, ma ti consigliamo vivamente di applicarle a tutte le chiavi API per una maggiore sicurezza. Per ulteriori dettagli, consulta le best practice per la sicurezza delle API.
  • Puoi aggiungere una limitazione delle applicazioni alla chiave API. Una volta limitata, una chiave funzionerà solo sulle piattaforme che supportano quel tipo di limitazione. Sono disponibili quattro tipi di restrizioni 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 di 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 il Maps SDK for Android.
    • Limitazione delle app per iOS (in base all'identificatore del bundle iOS) da utilizzare con il Maps SDK for iOS.
  • Puoi anche aggiungere una limitazione API alla chiave API. Per ulteriori informazioni, consulta Ottenere, aggiungere e limitare una chiave API.

La tabella seguente indica la chiave/credenziale e la limitazione dell'applicazione per ogni API/SDK di Google Maps Platform.

API/SDK Restrizione di credenziali e applicazioni
SDK Maps per Android Chiave API con limitazione per Android1
SDK Places per 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
SDK Places per iOS Chiave API con limitazione per iOS1
Navigation SDK per 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 Directions Chiave API con limitazione dell'indirizzo IP1
API Distance Matrix 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 Roads Chiave API con limitazione dell'indirizzo IP1
API Routes Chiave API con limitazione dell'indirizzo IP1
API Time Zone 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
1 Le restrizioni delle chiavi API sono facoltative, ma ti consigliamo vivamente di applicarle a 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 richieste.
Come faccio a cambiare il tipo di limitazione della chiave da un referrer HTTP a una limitazione dell'indirizzo IP?

Importante: se utilizzi una delle API di servizio web con una chiave API con limitazioni per i referrer, le richieste non andranno a buon fine e verrà visualizzato il messaggio di errore "Le chiavi API non possono avere limitazioni per i referrer se utilizzate con questa API". Dovresti passare a una chiave API con restrizioni per gli indirizzi IP.

Prima di cambiare il tipo di restrizione della chiave API dal referrer HTTP all'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 limitata. Se devi applicare più di una limitazione, aggiungi una chiave distinta con la limitazione richiesta. Scopri come aggiungere una nuova chiave API.

Scopri di più sulle limitazioni 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, procedi nel seguente modo:

  1. Vai alla pagina Credenziali della console Cloud.
  2. Seleziona il progetto che contiene la chiave API che vuoi modificare.
  3. Nella pagina Credenziali, dall'elenco delle chiavi API, seleziona il nome della chiave API per modificarne i dettagli.
  4. Nella sezione Limitazione 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 la sezione Introduzione a 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 Maps sono disponibili ai seguenti link:

Puoi anche controllare in quale versione di Google Maps Platform è stato introdotto e corretto un determinato bug utilizzando il tracker dei problemi 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 al momento del caricamento dell'API. Puoi trovare maggiori informazioni e codice di esempio nel capitolo Introduzione della documentazione dell'API Maps JavaScript.

Come faccio a mostrare i prodotti di 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 o alle impostazioni del browser dell'utente. 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 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 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
it Inglese ro Rumeno
en-AU Inglese (australiano) ru Russo
en-GB Inglese (Gran Bretagna) sr Serbo
et Estone si Sinhalese
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 l'aspetto della mappa in una delle lingue sopra 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 Web Service tramite connessioni sicure (HTTPS). Consulta la documentazione dell'API in questione per informazioni su come accedere all'API tramite SSL.

Tieni presente che l'API Maps Static non supporta gli URL delle 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 riscontri un comportamento che ritieni possa essere un bug, inizia segnalandolo nel forum pertinente. In questo modo, gli altri sviluppatori potranno convalidare il bug ed escludere eventuali problemi con il codice.

Se vuoi richiedere una funzionalità, prima presentala nel forum pertinente per verificare che non sia già disponibile una soluzione chesoddisfa i tuoi requisiti.

Una volta verificato 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 il tracker dei problemi di Google Maps Platform.

Prima di aggiungere un bug o una richiesta di funzionalità al Tracker dei problemi, assicurati di controllare che il bug o la funzionalità in questione non sia già stato aggiunto. Se è così, puoi aggiungere il problema a Speciali per segnalare il tuo interesse ed essere avvisato degli aggiornamenti.

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

Maps SDK for Android e Maps SDK for iOS utilizzano cookie soggetti alle Norme sulla privacy di Google, ad esempio per il calcolo degli utenti attivi giornalieri e settimanali e la prevenzione di abusi del servizio. Questi cookie non sono associati a nessun Account Google con cui è stato eseguito l'accesso e non vengono registrati con le altre informazioni raccolte dalle chiamate API.

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

Il team di relazioni con gli sviluppatori di Google è presente su Stack Overflow, un sito di domande e risposte per programmatori in cui le risposte vengono modificate in collaborazione. È un ottimo posto per porre domande tecniche sullo sviluppo e sulla manutenzione delle applicazioni Google Maps. Puoi trovare ulteriori informazioni su come porre domande su Stack Overflow nella pagina Assistenza.

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

  • Cercare nelle discussioni attuali. È 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 è facilmente visualizzabile online.
  • Fornisci tutte le informazioni pertinenti, incluse le versioni del browser, gli errori e tutti gli altri elementi che potrebbero essere utili per la risoluzione del problema.

Errori e risoluzione dei problemi

Che cosa significa questo errore?

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

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

In determinate circostanze, potrebbe essere visualizzata una mappa scura o un'immagine di Street View "negativa" con la filigrana "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. La seguente procedura 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 tetto massimo 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 avere 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 visualizzi 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 indirizzo IP, sito o applicazione mobile non è autorizzato a utilizzare questa chiave API"?

Esistono diversi 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 effettuare una richiesta.
  • Hai attivato le restrizioni dei referrer HTTP (sito web) sulla tua chiave API e un referrer non autorizzato sta tentando di effettuare 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 identificatori bundle e un'app per iOS non riconosciuta sta tentando di inviare una richiesta.
  • In precedenza era possibile ricevere questo errore se utilizzavi una delle API di servizio web, con una chiave API con limitazioni per i referrer HTTP. Le richieste a queste API devono essere identificate con una chiave API con limitazioni relative all'indirizzo IP. Passa il tipo di limitazione della chiave da una limitazione del referrer HTTP a una limitazione dell'indirizzo IP. Per ulteriori informazioni sulla limitazione delle chiavi API, consulta Best practice per le chiavi API.

Visualizzare e modificare le credenziali della chiave API

Per visualizzare le tue chiavi API e gestire eventuali limitazioni:

  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 impostate 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 restrizioni per i referrer non possono essere utilizzate con questa API"?

Utilizzi una delle API di servizio web con una chiave API limitata a un referrer HTTP. Per motivi di sicurezza, le API di servizi web devono utilizzare chiavi API limitate a indirizzi IP. Passa 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ì, questa procedura è chiamata "geocodifica". L'API Maps JavaScript include una classe per eseguire 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 in formati JSON e XML.

In quali paesi è disponibile la geocodifica?

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

L'accuratezza delle posizioni geocodificate può variare in base al paese, quindi ti consigliamo di utilizzare il campo location_type restituito per determinare se è stata trovata una corrispondenza sufficiente per le finalità della tua applicazione. Tieni presente che 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 posizioni diverse rispetto a Google Maps?

A volte il geocodificatore dell'API e quello di Google Maps utilizzano set di dati diversi (a seconda del paese). Il geocodificatore dell'API viene aggiornato di tanto in tanto con nuovi dati, pertanto puoi aspettarti che i risultati cambino o migliorino 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. Ti consigliamo quindi di formattare le richieste di geocodifica in conformità con le seguenti linee guida per massimizzare la probabilità di una query andata a buon fine:

  • 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à, piani o appartamenti, che non sono inclusi nell'indirizzo come definito dal servizio postale del paese interessato. In questo modo, potresti ricevere risposte con ZERO_RESULTS.
  • Formatta i codici plus come mostrato qui (i segni più sono codificati in URL come %2B e gli spazi sono codificati in URL come %20):
    • Il codice globale è un codice di area 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 località esplicita (CWC8+R9 Mountain View, CA, USA è CWC8%2BR9%20Mountain%20View%20CA%20USA).
  • Se possibile, utilizza il numero civico di un immobile anziché il nome dell'edificio.
  • Se possibile, utilizza indirizzi con numero civico anziché specificare le strade incrociate.
  • Non fornire "suggerimenti", come i punti di riferimento nelle vicinanze.
Come faccio a formattare un indirizzo degli Stati Uniti 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 di contea: "Co Road NNN" dove NNN è il numero della strada. ad es. "Co Road 82"
  • Autostrade statali: "State NNN" dove Stato è il nome completo dello stato e NNN è il numero dell'autostrada. ad es. "California 82"
  • Autostrade degli Stati Uniti: "U.S. NNN" dove NNN è il numero dell'autostrada. Ad esempio: "U.S. 101"
  • Autostrade statunitensi: "Interstate NNN" dove NNN è il numero dell'autostrada. ad es. "Interstate 280"
Quando devo utilizzare un classe di geocodificatore dell'API e quando devo utilizzare il servizio di geocodifica HTTP?

Consulta il documento Strategie di geocodifica, che illustra i pro e i contro delle diverse strategie di geocodifica.

Come faccio a fornire indicazioni stradali con Google Maps Platform?

Il servizio Calcola percorsi dell'API Routes e dell'API Directions ti consente di fornire indicazioni stradali per tragitti singoli e con più tappe. Le opzioni di routing ti aiutano a definire le indicazioni con una modalità di viaggio (guida), un singolo itinerario o un insieme di itinerari e limitazioni (strade a pedaggio). Questi servizi sono disponibili nelle seguenti forme:

  • L'interfaccia di richiesta/risposta HTTP (utilizzata in applicazioni mobile e altre) è compatibile con Maps SDK for 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 forniscono la stessa funzionalità. Per ulteriori informazioni sulle librerie client, consulta 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 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 Directions e l'API Distance Matrix supportano tutti i partner di Google Transit, tranne quelli in Giappone.

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

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

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

I limiti di dimensioni e complessità per la visualizzazione di KML utilizzando la classe KmlLayer sono descritti qui.

Come faccio a visualizzare su una mappa i 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 su un URL disponibile pubblicamente accessibile o che richiedono l'autenticazione per l'accesso.

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

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 del percorso supportati dall'API Maps Static. Quando utilizzi 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,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 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 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 per informazioni sulla mappa errate o mancanti, ad esempio:
  • Indirizzi o posizioni degli indicatori errati
  • Nomi di strade sbagliati
  • Informazioni sbagliate sul senso di circolazione (strade a senso unico o 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 le richieste critiche o urgenti, invia una richiesta di assistenza con dettagli specifici su cosa deve essere corretto.

In che modo viene monitorato il rendimento dei servizi utilizzati con l'API Maps JavaScript?

Alcune funzionalità lato client sono strumentate per segnalare il successo o l'errore ai fini del calcolo dell'obiettivo del livello di servizio (SLO). Queste informazioni vengono inviate a Google all'indirizzo maps.googleapis.com/maps_api_js_slo/log nelle chiamate che registrano le informazioni sugli SLO. Queste informazioni includono lo stato di esito, la latenza e la versione/il canale dell'API Maps JavaScript in uso. Le chiamate potrebbero essere raggruppate per migliorare le prestazioni. Tieni presente che potrebbe essere necessario consentire maps.googleapis.com nei Criteri di sicurezza del contenuto per assicurarti 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 l'API Maps JavaScript funzionerà dopo essere stata caricata?

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 all'ultima versione il prima possibile. Per maggiori dettagli, consulta la guida alla migrazione.
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 di frame della GPU nello schema Xcode in esecuzione:

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

A partire da iPhone X, gli iPhone hanno una forma dello schermo con angoli arrotondati, un notch nella parte superiore per la cover del sensore 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 al sicuro da eventuali ritagli dovuti alla nuova forma dello schermo.

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

Con la release 2.5 dell'SDK per iOS di Google Maps, questi problemi di layout vengono risolti automaticamente. Quando la tua app viene utilizzata su un iPhone X o modelli successivi, i margini di GMSMapView e GMSPanoramaView vengono aumentati in modo che gli elementi visivi non vengano tagliati.

Per impostazione predefinita, includeremo sempre i tuoi spaziatura. L'SDK di Google Maps per iOS assume che il padding debba essere inserito all'interno dell'area sicura. Se progetti l'interfaccia presupponendo che tutto sia posizionato all'interno dell'area sicura, funzionerà senza alcuno sforzo aggiuntivo.

Se hai progettato un'interfaccia che non funziona con il nostro aggiustamento predefinito, abbiamo introdotto una nuova proprietà in GMSMapView, chiamata paddingAdjustmentBehavior. GMSMapView ora ti consente di scegliere tra uno di tre comportamenti di aggiustamento del rivestimento: "Sempre" (predefinito), "Automatico" e "Mai".

Se GMSMapView è impostato per utilizzare il comportamento di spaziatura "Sempre", aggiungerà sempre gli inserti di area di sicurezza allo spazio. In questo modo puoi progettare la tua interface assumendo che tutti i posizionamenti provengano dai bordi dell'area sicura. Questo è il valore predefinito.

Se GMSMapView è impostato per utilizzare il comportamento di spaziatura "Automatico", sceglierà sempre la spaziatura o l'insetto dell'area di sicurezza maggiore. In questo modo, potrai aggiungere un margine dal bordo dello schermo, assicurandoti sempre che tutti gli elementi rimangano all'interno dell'area di sicurezza.

Se GMSMapView è impostato per utilizzare il comportamento di spaziatura "Mai", non aggiungerà mai gli inset delle aree di sicurezza alla spaziatura. Questo è il comportamento precedente alla release 2.5 e può essere utile se i tuoi spazi di a capo prendono già in considerazione l'area di sicurezza o se gli altri nostri comportamenti non funzionano bene con la tua interfaccia. È tua responsabilità assicurarti che il logo di Google e le notifiche 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 i margini e GMSPanoramaView applicherà sempre i margini necessari per garantire che tutti gli elementi visivi rientrino nell'area di sicurezza.

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 dell'SDK Places per Android è stata disattivata e non è più disponibile. Aggiorna l'app per utilizzare la versione più recente il prima possibile. Per maggiori dettagli, consulta la guida alla migrazione.
La mia app mostra solo riquadri grigi vuoti anziché una mappa. Come faccio a risolvere il problema?

Un motivo comune per cui vengono visualizzati riquadri grigi vuoti anziché una mappa è la presenza di problemi di autenticazione. Per risolvere questi problemi, puoi seguire i passaggi riportati di seguito utilizzando adb logcat.

  1. Assicurati di aver 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 utilizzi un 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". Verranno stampate solo le righe in cui il messaggio di log corrisponde a "API Android di Google Maps". (Facoltativamente, puoi esportare il log in un file di testo aggiungendo: > logcat.txt)
  4. Riproduci il problema sul dispositivo e controlla la presenza di errori comuni, ad esempio:
    • Nel file manifest viene fatto riferimento alla chiave API sbagliata/non prevista.
    • La fatturazione non è abilitata in Project.
    • L'SDK non è abilitato nelle API del progetto.
    • La fingerprint SHA1 errata viene aggiunta alle limitazioni della chiave API.
    • Le dipendenze di Google Play Services non sono incluse nel file build.gradle.

Firma URL

Posso firmare gli URL utilizzando JavaScript?

Ti sconsigliamo vivamente di firmare gli URL utilizzando JavaScript, in quanto ciò potrebbe esporre il segreto di firma dell'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 di servizio web dell'API 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 un piano Premium di Google Maps Platform e 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 non è stata specificata la chiave API del piano Premium di Google Maps Platform associata.