Domande frequenti su Google Maps Platform

Per iniziare

Comprendere i Termini di servizio

Limiti di utilizzo e fatturazione

Utilizzo di Google Maps Platform

Errori e risoluzione dei problemi

Servizi Google Maps Platform

API Maps JavaScript

Google Maps SDK for iOS

Google Maps SDK for Android

Firma URL

Per iniziare

Che cos'è Google Maps Platform?

Google Maps Platform è un insieme di API e SDK che consente agli sviluppatori di incorporare Google Maps in app mobile e pagine web o per 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:

Mappe:

Percorsi:

Luoghi:

Ambiente:

Come faccio a iniziare a utilizzare Google Maps Platform?

Consulta la Guida introduttiva a Google Maps Platform.

Quale API devo avere?

Per informazioni su come trovare l'API giusta in base ai tuoi requisiti funzionali, consulta dai un'occhiata al 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 l'API o l'SDK che stai utilizzando che ti interessa. Ad esempio, consulta le guide per Maps SDK for Android oppure API Maps JavaScript.

Quali paesi copre Google Maps Platform?

Il team di Google Maps invia costantemente nuovi dati sulle mappe e aumenta la nostra copertura internazionale. Consulta il Google Maps dati sulla copertura per avere informazioni aggiornate sulla copertura. Puoi filtrare i dati con la casella di filtro nella parte superiore della pagina. Tieni presente che i dati sulla copertura possono cambiare se cambiano i contratti di licenza con i fornitori di dati.

Vedi anche:

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

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

Come faccio a pubblicare applicazioni Maps sui dispositivi mobili?

Per incorporare le mappe in un'applicazione Android, utilizza la SDK Maps per Android.

Per incorporare le mappe in un'applicazione iOS nativa, utilizza la SDK Maps per iOS.

Lo L'API Maps JavaScript è stata sviluppata per essere adattata ai dispositivi mobili ed è adatto per applicazioni browser destinate sia a desktop e dispositivi che includono un browser web con un linguaggio JavaScript completo 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 in formato GIF, JPG e PNG, compresi gli indicatori e le polilinee. Tieni presente che l'utilizzo dell'API Maps Static al di fuori del browser richiede il collegamento dell'immagine della mappa a Google Maps.

Quali browser web utilizzano l'API Maps JavaScript e Supporto dell'API Maps Embed?

Supporto dell'API Maps JavaScript e dell'API Maps Embed i seguenti browser web:

Computer
  • La versione attuale di Microsoft Edge (Windows), esclusa la modalità IE.
  • Le due versioni stabili più recenti di Firefox (Windows, macOS, Linux).
  • Le due versioni stabili più recenti di Chrome (Windows, macOS, Linux).
  • Le due principali versioni stabili più recenti di Safari (macOS).
di Gemini Advanced. Android
  • La versione attuale di Chrome su Android 4.1 o versioni successive.
  • Chrome WebView su Android 4.4 e versioni successive.
di Gemini Advanced. iOS
  • Safari per dispositivi mobili sulle principali versioni 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 mappe dall'API Maps JavaScript?

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

Come faccio a ricevere una notifica in caso di modifiche ai prodotti di Google Maps Platform?

Devi abbonarti al Piattaforma di Google Maps Blog per gli aggiornamenti sulle notizie relative alle varie offerte per gli sviluppatori Google geografici.

Come faccio a contattare l'assistenza tecnica?

Per informazioni, consulta la pagina Assistenza e risorse di Google Maps Platform sulle opzioni di assistenza disponibili.

Quando è disponibile l'assistenza tecnica?
Il team di assistenza è disponibile 24 ore su 24, 5 giorni su 7 (nei giorni feriali da lunedì 9:00 ora di Tokyo a Venerdì 17:00 Pacifico) escluse le festività regionali per "servizio inutilizzabile" che le applicazioni presentino problemi di prestazioni.
Come faccio a recuperare l'accesso al mio Account Google?

Se non riesci più ad accedere al tuo Account Google (ad es. joe@mycompany.com o joe@gmail.com), puoi provare ripristinando l'accesso all'account recuperando o reimpostando la password. Visita il Come recuperare l'Account Google o Gmail nella Guida di Account Google.

Come posso recuperare l'accesso a un progetto specifico?

Se non riesci più ad accedere al progetto in cui gestisci l'implementazione di Google Maps Platform, puoi provare a recuperarlo.

Se hai accesso all'Account Google associato al progetto:

Se non hai accesso all'Account Google associato al progetto:

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

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

Comprendere i 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 Google Maps Platform all'interno delle tue applicazioni a condizione che Il tuo sito rispetti i Termini di servizio di Google Maps Platform.

Tuttavia, ci sono alcuni utilizzi di Google Maps Platform che semplicemente non vogliamo per vedere: mappe che identificano i luoghi in cui acquistare sostanze stupefacenti illegali in una città, per o qualsiasi altra attività illegale. Rispettiamo anche la privacy delle persone, quindi Google Maps Platform non deve essere utilizzato per identificare informazioni private singoli utenti.

Consulta il tuo consulente per determinare se la tua domanda è conforme ai Termini di servizio di Google Maps Platform prima di sviluppare e avviarlo. I tecnici di Google possono solo offrire assistenza tecnica e non di fornire consulenza legale. Google si riserva il diritto di sospendere o interrompere l'utilizzo del servizio in qualsiasi momento, pertanto ti invitiamo a leggere l' Termini delle API di Google Maps attentamente.

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

Non puoi accedere ai riquadri di mappe o alle immagini satellitari tramite altri meccanismi Google Maps Platform (ad esempio, la creazione di un'API di mappatura o l'utilizzo di uno script per il download di riquadri collettivi). L'accesso della tua applicazione ai riquadri verrà bloccato se vi accede all'esterno di Google Maps Platform. Consulta le Termini di servizio di Google Maps Platform per ulteriori dettagli.

Posso utilizzare i prodotti Google Maps Platform per monitorare le applicazioni?

Non sono previste limitazioni alla visualizzazione dei dati in tempo reale (monitoraggio) con Google Maps Platform prodotti 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 di 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 in esecuzione in uno dei browser supportati.

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

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

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

Se la tua richiesta genera un documento, in formato elettronico o cartaceo, Nel documento non possono essere inclusi dati di Google Maps Platform, comprese le immagini. Consulta le Termini di servizio di Google Maps Platform "Nessuno scraping" per ulteriori dettagli.

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

Non raccogliamo più questi dati. L'utilizzo del indexing è stato deprecato e non ha alcun effetto. Non è più necessario fare la disattivazione in modo esplicito, ma ti invitiamo a rimuovere questo parametro al più presto la praticità.

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 di mappa utilizzando l'API Maps Static che archiviare e pubblicare gli annunci 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 le immagini statiche devono collegare l'attributo src di un codice HTML img o l'attributo background-image CSS di un HTML div direttamente nell'API Maps Static in modo che tutte le immagini delle mappe vengono visualizzate all'interno del contenuto HTML della pagina web e disponibili direttamente per gli utenti finali da Google.

Limiti di utilizzo e fatturazione

Come faccio a configurare la fatturazione per il mio progetto?
Consulta la Guida introduttiva a Google Maps Platform.
In che modo i clienti del livello senza costi di Google Cloud Platform possono eseguire l'upgrade a un account a pagamento?
Il Livello senza costi di Google Cloud Platform offre ai clienti una prova senza costi con un credito di 300 $da utilizzare per qualsiasi servizio Google Cloud, incluse le API di Google Maps Platform (GMP). Al termine del periodo di prova senza costi, dovrai 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 ci sono limiti giornalieri massimi al numero di richieste che puoi effettuare I prodotti Google Maps Platform e gli unici limiti di utilizzo riguardano le il numero massimo di query al minuto (QPM).

Per Distance Matrix, il limite viene impostato in eventi al minuto (EPM) calcolato come la somma le query lato client e lato server.

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

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

API Limite di utilizzo
Convalida degli indirizzi 6000 QPM
Vista aerea: ricerca video 180 QPM e 100.000 QPD
Vista aerea: rendering del video 100 QPM e 100 QPD
Qualità dell'aria 6000 QPM
Directions 3000 QPM
Distance Matrix 60.000 EPM
Dynamic Maps 30.000 Q/M
Elevazione 6000 QPM
Geocoding 3000 QPM
Geolocalizzazione 6000 QPM
API Map Tiles: riquadri 2D e riquadri Street View 6000 QPM e 15.000 QPD
API Map Tiles: riquadri 3D fotorealistici 10.000 QPD
API Map Tiles: riquadri 3D fotorealistici: Renderer 12.000 QPM
Luoghi 6000 QPM
Polline 6000 QPM
Strade 30.000 QPM
Route: route Compute 3000 QPM
Route: 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 tramite Google Cloud CLI o tramite l'API Compute Engine.

Il deployment dei prodotti Google Maps Platform deve essere eseguito 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 Foglio dei prezzi.

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

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

Un singolo caricamento di mappa viene addebitato quando si verifica una delle seguenti condizioni:

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

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

  • Per ogni richiesta inviata a Street View viene addebitata una panoramica statica di Street View Visualizza l'API Static per incorporare una panoramica Street View statica (non interattiva).
  • Per ogni istanza di un panorama Street View dinamico viene addebitato un costo panorama in un'API Maps JavaScript, Maps SDK for Android o Maps SDK for per iOS.

Dopo che una pagina web o un'applicazione carica una mappa o un'immagine di mappa statica, oppure una panoramica di Street View, le eventuali interazioni dell'utente con quest'ultima, ad esempio panoramica, zoom o cambio di livello della mappa, non generare caricamenti di mappe aggiuntivi o influire sui limiti di utilizzo.

L'aggiunta di un indicatore non genera ulteriori caricamenti di mappa, ma può generare addebiti per il modo in cui è stata determinata la posizione del segnaposto (ad esempio caricando o ricaricando la classe "google.maps.Map()").

Come faccio a monitorare il mio utilizzo?

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

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

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

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

Per saperne di più, vedi Report di Google Maps Platform e Monitorare l'utilizzo delle API e Limitazione dell'utilizzo delle API.

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

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

Se superi i limiti di QPM per le richieste altrimenti abusare 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 API dei servizi web hanno un equivalente servizio lato client disponibile nell'API Maps JavaScript: Directions, Distance Matrix, Elevation e Geocoding.

Limiti di utilizzo superati

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

Questo messaggio indica che il servizio web ha smesso di fornire risposte normali ed è passato alla restituzione del solo 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 di QPM, valuta la possibilità di ridurre l'utilizzo ottimizzando le applicazioni per un uso maggiore dei prodotti Google Maps Platform in modo efficiente o richiedere di aumentare la quota. Consulta la guida all'ottimizzazione. per ulteriori informazioni.

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

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

Una volta creato l'account di fatturazione, se superi il limite di utilizzo mensile senza costi di 200 $ Non disponi di un metodo di pagamento valido nel 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 verrà calcolato e fatturato l'utilizzo?

L'utilizzo viene calcolato alla fine di ogni giorno e il prezzo è indicato in base alle Foglio dei prezzi. Alla fine di ogni mese, l'utilizzo totale viene addebitato sul metodo di pagamento associati al tuo account di fatturazione. Per ulteriori informazioni, vedi Fatturazione di Google Maps Platform.

Quanto costa utilizzare Google Maps Platform?

Consulta Foglio prezzi per una panoramica del costo per API. Se la tua applicazione genera richieste o volumi di caricamento delle mappe fino a 200 $al mese utilizzo, l'utilizzo non viene addebitato. L'utilizzo che supera il credito mensile di 200 $sarà addebitati sul tuo account di fatturazione. Per ulteriori dettagli, consulta guida alla comprensione Fatturazione Google Maps Platform.

I prezzi sono disponibili in altre valute?

Altre valute possono essere disponibili all'interno della console. Quando selezioni una valuta diversa, le tariffe verranno convertite dall'equivalente in dollari indicato nei nostri Foglio dei prezzi.

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

Google ti addebiterà all'inizio di ogni mese i costi della transazione attività, utilizzando metodo di pagamento specificato. Per i dettagli sulla tua fattura, consulta le nostre guida alla comprensione Fatturazione 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 limiti massimi fatturabili giornalieri. Puoi limitare il limite massimo di utilizzo giornaliero a garantire la protezione contro aumenti imprevisti. Puoi anche impostare avvisi relativi al budget ricevi notifiche email quando gli addebiti sull'account di fatturazione raggiungono un soglia che hai impostato.

Limitazione del limite massimo fatturabile giornaliero:

Per evitare di pagare una fattura di importo elevato, puoi impostare un limite di utilizzo giornaliero per evitare aumenti imprevisti dell'uso. Puoi modifica questo limite nella console Cloud seguendo questi passaggi:

  1. Vai alla pagina API e Dashboard dei 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 il metodo IAM e di amministrazione delle quote.

Impostazione e gestione degli avvisi relativi al budget:

Configura avvisi relativi al budget per inviare notifiche via email agli amministratori della fatturazione quando gli addebiti associati all'account di fatturazione raggiungono la soglia da te impostata. Fatturazione. agli amministratori verrà inviata una notifica via email quando gli addebiti stimati su l'account di fatturazione supera il 50%, il 90% e il 100% della soglia.

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

"Account di transizione Google Maps Platform" è stato creato per aiutare determinati clienti passano al nostro nuovo piano tariffario con pagamento a consumo. Questa transizione di fatturazione ha permesso a Google di fornire a questi clienti un credito una tantum, di poter continuare a utilizzare Google Maps Platform fino al limite di 200 $ senza costi aggiuntivi. Una volta superato questo limite, l'account di fatturazione verrà chiuso perderai l'accesso al servizio. Per evitare interruzioni del servizio, di configurare il tuo account di fatturazione e continuare a usufruire dei $200 mensili senza costi aggiuntivi. Per modificare l'account di fatturazione per il tuo progetto:

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

Se non hai creato e collegato un account di fatturazione al tuo progetto, le API Maps Platform sarà limitata a 1 richiesta al giorno. Puoi aumentare la quota creando e collegando un account . A questo scopo, consulta la Guida introduttiva all'utilizzo di Google Maps Platform.

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

Ho ricevuto un avviso di violazione della fatturazione. Come posso risolvere il problema?

Ti abbiamo inviato questa notifica perché Google ha stabilito che utilizza più account di fatturazione. Si tratta di una violazione delle Termini di Google, come definiti nella sezione 3.2.4 dei Termini di servizio di Google Maps Platform. In base ai presenti termini, è vietato creare più account di fatturazione. Per saperne di più, consulta Fatturazione Domande frequenti sulle violazioni degli account.

Utilizzo di Google Maps Platform

Quali chiavi o credenziali devo utilizzare per diversi elementi di Maps prodotti?

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

Chiave API:

  • Una chiave API è un identificatore univoco che generare utilizzando 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 URL che ti è stato fornito realizzati da Google. Le firme digitali vengono utilizzate con l'API Maps Static e API Street View Static.

Limitazioni:

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

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

API/SDK Credenziale e Limitazione delle applicazioni
SDK Maps per Android Chiave API con limitazione per Android1
SDK Places per Android Chiave API con limitazione per Android1
SDK Maps per iOS Chiave API con limitazione iOS1
SDK Places per iOS Chiave API con limitazione iOS1
API Maps JavaScript Chiave API con limitazione del referrer HTTP1
API Map Tiles Chiave API con limitazione degli indirizzi IP1
API Maps Datasets Token OAuth
API Aerial View Chiave API con limitazione degli indirizzi IP1
API Maps Static Chiave API con limitazione del referrer HTTP1 + firma digitale2
API Street View Static Chiave API con limitazione del referrer HTTP1 + firma digitale2
API Maps Embed Chiave API con limitazione del referrer HTTP1
API Address Validation Chiave API con limitazione degli indirizzi IP1
API Directions Chiave API con limitazione degli indirizzi IP1
API Distance Matrix Chiave API con limitazione degli indirizzi IP1
API Elevation Chiave API con limitazione degli indirizzi IP1
API Geocoding Chiave API con limitazione degli indirizzi IP1
API Geolocation Chiave API con limitazione degli indirizzi IP1
API Places Chiave API con limitazione degli indirizzi IP1
API Roads Chiave API con limitazione degli indirizzi IP1
API Routes Chiave API con limitazione degli indirizzi IP1
API Time Zone Chiave API con limitazione degli indirizzi IP1
API Air Quality Chiave API con limitazione degli indirizzi IP1
API Pollen Chiave API con limitazione degli indirizzi IP1
API Solar Chiave API con limitazione degli indirizzi IP1
1 Limitazioni delle chiavi API sono facoltative, ma ti consigliamo vivamente di limitare tutte le chiavi API per una maggiore sicurezza.
2 In base all'utilizzo, viene eseguita una potrebbe essere necessaria la firma digitale API Maps Static e 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 posso cambiare il tipo di limitazione delle chiavi da referer HTTP a una limitazione degli indirizzi IP?

Importante: se utilizzi una delle API dei servizi web con una chiave API con restrizioni dei referrer, le tue richieste non andranno a buon fine messaggio di errore: "Le chiavi API non possono presentare restrizioni relative ai referrer se utilizzate con questo API". Dovresti passare all'utilizzo di una chiave API con limitazioni di indirizzi IP.

Prima di cambiare il tipo di limitazione della chiave API da referer HTTP a IP assicurati che tutte le API che utilizzano la chiave API supportino il protocollo IP tipo di restrizione. Le API con lo stesso tipo di restrizione possono usare le stesse chiave. Se devi applicare più di una restrizione, aggiungi una chiave separata con la restrizione richiesta. Scopri come aggiungere un nuovo chiave API.

Scopri di più sulla chiave API limitazioni associate ai prodotti Google Maps Platform.

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

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

Puoi anche controllare a quale versione di Google Maps Platform è stato rilevato un bug specifico Sono stati introdotti e risolti nell'utilizzo dello strumento Issue Tracker di Google Maps Platform all'indirizzo:

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

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

È sufficiente specificare il parametro di callback quando carichi l'API. Ulteriori informazioni e il codice di esempio è disponibile nella Recupero Capitolo iniziato della documentazione dell'API Maps JavaScript.

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

Per impostazione predefinita, l'API tenterà di caricare la lingua più appropriata in base a la posizione dell'utente o le impostazioni del browser. Alcune API ti consentono di impostare in modo esplicito lingua quando effettui una richiesta. Ulteriori informazioni su come impostare la lingua sono disponibili nella documentazione di ciascuna API:

di Gemini Advanced. 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 che aspetto avrà la mappa in una delle lingue elencate sopra in questa esempio applicazione.

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

L'API Maps JavaScript, l'API Maps Static e Le API dei servizi web possono essere accessibile tramite connessioni sicure (HTTPS). Consulta la documentazione per l'API interessata per informazioni su come accedere all'API tramite SSL.

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

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

Se rilevi un comportamento che ritieni possa essere un bug, inizia con pubblicandolo nel forum pertinente. In questo modo consentire ad altri sviluppatori di convalidare il bug ed escludere eventuali problemi con il tuo codice.

Se desideri richiedere una funzione, ti invitiamo a segnalarla prima nel forum pertinente per confermare che una soluzione che soddisfa i tuoi requisiti non è già disponibile.

Dopo aver confermato di aver identificato un nuovo bug o che il tuo I requisiti non possono essere soddisfatti dalla funzionalità esistente di Google Maps Platform prodotti, segnala il bug o la richiesta di funzionalità utilizzando Issue Tracker di Google Maps Platform.

Prima di aggiungere un bug o una richiesta di funzione a Issue Tracker, assicurati di verifica che il bug o la funzionalità in questione non siano già stati aggiunti. In tal caso, puoi aggiungere il problema a Speciali per segnalare il tuo interesse e ricevere una notifica sugli 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 a Le Norme sulla privacy di Google, ad esempio il calcolo giornaliero e la prevenzione dell'abuso dei servizi per utenti attivi negli ultimi 7 giorni. Questi cookie non sono associati ad alcuno dopo aver eseguito l'accesso all'Account Google e che non vengono registrati con il resto delle informazioni raccolte tramite Chiamate API.

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

Il team per le relazioni con gli sviluppatori di Google è sempre presente su Stack Overflow, un sito di domande e risposte modificato in modo collaborativo per i programmatori. È una il luogo ideale in cui porre domande tecniche sullo sviluppo e sulla manutenzione le applicazioni Google Maps. Ulteriori informazioni su come porre domande su Stack Overflow è disponibile nella pagina Assistenza.

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

  • Cerca nelle discussioni correnti. È probabile che qualcun altro abbia riscontrato un problema simile e abbiamo 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, tra cui versioni del browser, errori e tutti altre informazioni che potrebbero essere utili per risolvere il 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 la i seguenti link per trovare spiegazioni sui codici di errore:

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

In determinate circostanze, una mappa oscurata o "negativa" Immagine di Street View con filigrana con il testo "solo a scopo di sviluppo", potrebbero essere visualizzati. Questo comportamento in genere indica 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 è collegato un account di fatturazione.
  • È stato superato un limite di utilizzo autoimpostato.
  • Il metodo di pagamento indicato non è più valido (ad esempio, la 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 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 obsoleta di Places SDK per Android o Places SDK per 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 abilitato le limitazioni relative all'indirizzo IP (server) sulla chiave API. e un indirizzo IP non autorizzato sta tentando di richiedere una richiesta.
  • Hai attivato le restrizioni per i referrer HTTP (sito web) sulla tua chiave API. e un referrer non autorizzato sta tentando di inviare una richiesta.
  • Hai limitato l'utilizzo delle app Android impostando un nome del pacchetto e impronta e un'app per Android non autorizzata sta tentando di effettuare una richiesta.
  • Hai limitato le richieste da app iOS specificando il bundle e un'app per iOS non riconosciuta sta tentando di inviare una richiesta.
  • In passato era possibile ottenere questo errore se utilizzavi uno dei API dei servizi web, con una chiave API con restrizioni del referrer HTTP. Richieste a queste API Deve essere identificato con una chiave API con un indirizzo IP. limitazioni. Cambiare il tipo di limitazione delle chiavi da una limitazione dei referrer HTTP a una restrizione degli indirizzi IP. Per ulteriori informazioni sulla limitazione delle chiavi API, consulta Best practice relative alle chiavi API.

Visualizzare e modificare le credenziali chiave API

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

  1. Vai alla sezione 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 restrizioni impostate per la chiave, Nell'elenco delle chiavi API, fai clic sul nome della chiave.
  4. Vengono visualizzate le credenziali complete della chiave API selezionata, inclusi eventuali restrizioni impostate per la chiave. Da qui, le limitazioni possono essere possono essere modificate, eliminate o aggiornate in base alle esigenze.
Come posso risolvere l'errore "Le chiavi API con restrizioni dei referrer non possono essere utilizzate con questa API."?

Stai utilizzando uno qualsiasi dei API dei servizi web con una chiave API limitata a un referer HTTP. Per motivi di sicurezza, il servizio web Le API devono utilizzare chiavi API limitate a indirizzi IP. Cambiare il tipo di limitazione delle chiavi da un referrer HTTP limitazione a una restrizione relativa all'indirizzo IP, oppure crea una nuova chiave API è già utilizzata con l'API Maps JavaScript.

Servizi Google Maps Platform

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

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

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

In quali paesi è disponibile il geocodifica?

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

La precisione delle posizioni geocodificate può variare in base al paese, pertanto ti consigliamo di utilizzare location_type per determinare se è stata trovata una corrispondenza sufficientemente buona ai fini della tua applicazione. Tieni presente che la disponibilità i dati di geocodifica dipendono dai nostri contratti con i fornitori di dati, pertanto sono soggetti per cambiare.

Perché i geocodificatori di Google Maps Platform forniscono località diverse da quelle di Google Maps?

A volte il geocodificatore API e il geocodificatore di Google Maps utilizzano set di dati diversi (in base al paese). Il geocodificatore API viene aggiornato occasionalmente con nuovi dati, quindi i risultati potrebbero cambiare o migliorare nel tempo.

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

Il geocodificatore è progettato per mappare gli indirizzi stradali alle coordinate geografiche. Consigliamo quindi di formattare le richieste del geocodificatore in base alle le linee guida riportate di seguito per massimizzare la probabilità di esito positivo della query:

  • Specifica gli indirizzi nel formato utilizzato dalle del paese in questione.
  • Non specificare altri elementi dell'indirizzo, come nome dell'attività, unità numeri di piano, numeri di piano o numeri di appartamento non inclusi nei Indirizzo come definito dal servizio postale del paese interessato. Questa operazione potrebbe comportare risposte con ZERO_RESULTS.
  • Formatta i plus code come mostrato qui (i segni più vengono caratterizzati dai caratteri di escape in %2B) e gli spazi sono preceduti da caratteri di escape in %20):
    • Il codice globale è un prefisso di 4 caratteri e di almeno 6 caratteri il codice locale (849VCWC8+R9 è 849VCWC8%2BR9).
    • compound code è un codice locale di almeno 6 caratteri con un località esplicita (CWC8+R9 Mountain View, CA, USA è CWC8%2BR9%20Mountain%20View%20CA%20USA).
  • Utilizza il numero civico di un locale preferito rispetto al nome dell'edificio in cui possibile.
  • Utilizza l'indirizzo del numero civico anziché specificare le strade trasversali in cui possibile.
  • Non fornire "suggerimenti" ad esempio punti di riferimento nelle vicinanze.
Come faccio a formattare un indirizzo statunitense su un'autostrada numerata per la geocodifica?

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

  • Strade contee: "Co Road NNN" dove NNN è il numero della strada. ad es. "Co Road 82"
  • Autostrade statali: "State NNN" dove Stato è il nome completo del e NNN è il numero dell'autostrada. ad es. "California 82"
  • Stati Uniti Autostrade: "U.S. NNN" dove NNN è il numero dell'autostrada. Ad esempio: "U.S. 101"
  • Stati Uniti Interstatali: "Interstate NNN" dove NNN è l'interstatale numero. ad es. "Interstate 280"
Quando devo utilizzare una classe di geocodifica API e quando devo utilizzare HTTP servizio di geocodifica?

Vedi il documento: Geocodifica Strategie, che illustra in dettaglio i pro e i contro dei diversi metodi di geocodifica strategie.

Come faccio a fornire indicazioni stradali con Google Maps Platform?

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

  • Interfaccia di richiesta/risposta HTTP (utilizzata in applicazioni per dispositivi mobili e in altre applicazioni) è compatibile con Maps SDK per Android e con altri servizi web di Google Maps.
  • L'API JavaScript, per le applicazioni lato client, ti consente di fornire indicazioni stradali tramite google.maps.DirectionsService. La DirectionsRenderer classe può creare automaticamente gli overlay e il riquadro delle indicazioni stradali per te. Ulteriori esempi sono forniti nella documentazione.
  • Interfacce client Java, Python, go e Node.js, per le applicazioni lato server, offrono la stessa funzionalità. Per ulteriori informazioni sulle librerie client, consulta Librerie client dell'API Directions.
In quali paesi sono disponibili le indicazioni stradali?

Per vedere i paesi attualmente supportati dalle indicazioni stradali nei prodotti Google Maps Platform: consulta i dati sulla copertura di Google Maps. Tieni presente che la disponibilità dei dati delle indicazioni stradali dipende dai nostri contratti con i dati ed è soggetto a modifica.

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

La API Directions e API Distance Matrix supportare tutti i partner di Google Transit, tranne quelle in Giappone.

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

La KmlLayer nell'API Maps JavaScript consente agli sviluppatori di sovrapporre file KML/KMZ e File GeoRSS nella parte superiore della mappa. Sono disponibili documentazione ed esempi qui

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

I limiti di dimensione e complessità relativi alla visualizzazione di KML tramite KmlLayer corso è documentato qui.

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

Lo KmlLayer che genera overlay KML nella L'API Maps JavaScript utilizza un servizio in hosting da 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 accessibili o che richiedono l'autenticazione per accedere.

Se hai bisogno di sviluppare applicazioni che utilizzano file KML ospitati su una rete intranet ti consigliamo di eseguire il rendering del file KML sul lato client utilizzando librerie JavaScript di terze parti. Quando il file KML viene analizzato le prestazioni del browser potrebbero essere inferiori rispetto a quelle KmlLayer corso.

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

Non esiste alcun limite al numero di indicatori o di vertici del percorso supportati API Maps Static. Quando utilizzi le icone personalizzate, è possibile fino a cinque icone uniche essere specificati per ogni richiesta, ma ciascuno può essere utilizzato più volte all'interno mappa.

Tieni presente che gli URL dell'API Maps Static possono contenere un massimo di circa 8.192 caratteri,il che limita il numero di indicatori vertici del percorso che possono essere specificati in base al numero di posizioni decimali utilizzata quando si specifica ciascuna coppia latitudine/longitudine. Per informazioni su come il numero di cifre decimali utilizzato è relativo alla precisione sulla Terra, vedi le Articolo di Wikipedia su 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 feedback tramite Google Maps sulle informazioni errate o mancanti sulla mappa, ad esempio:
  • Indirizzi o posizioni degli indicatori errati
  • Nomi di strade sbagliati
  • Informazioni errate sulle strade a senso unico o a doppio senso
  • Strada tracciata in modo errato
  • Strade chiuse
  • Strade che non esistono

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

Se devi rimuovere i contenuti di Maps per motivi legali, invia una richiesta di tipo legale.

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

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

Alcune funzionalità lato client sono strumenti 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 sullo 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. Tieni presente che potrebbe essere necessario consentire maps.googleapis.com nei tuoi Criterio di sicurezza del contenuto per garantire queste chiamate non vengono bloccate a livello di browser. Ad esempio: Content-Security-Policy: default-src 'self' maps.googleapis.com; con intestazioni HTTP oppure <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 una volta caricata?

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

Google Maps SDK for iOS

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

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

  1. In XCode, scegli Product (Prodotto), Scheme (Schema), Gestisci schemi.
  2. Seleziona uno schema e scegli Modifica....
  3. Imposta l'opzione GPU Frame Capture su Disabled (Disabilitata). Tieni presente che potrebbe non essere presente per tutti i dispositivi.
Opzione Xcode GPU Frame Capture nella pagina relativa ai dispositivi iOS generici
Che impatto hanno gli schermi arrotondati e più ampi dell'SDK Google Maps per iOS?

A partire dall'iPhone X, Gli iPhone hanno una forma dello schermo con angoli arrotondati, una tacca nella parte superiore per dell'alloggiamento del sensore e un indicatore nella parte inferiore dello schermo per accedere Schermata Home. A partire dall'SDK per iOS 11.0, Apple ha aggiunto l'API Safe Area che consente agli sviluppatori di posizionare elementi in un'area che non può essere tagliata dalla nuova schermata forma.

L'SDK di Google Maps per iOS ha molti elementi visivi e controlli, ad esempio una selettore di interni e link Segnala un problema. Con la versione 2.4, queste immagini elementi e controlli potrebbero essere tagliati dalla nuova forma dello schermo. In orizzontale modalità, il selettore del pavimento degli interni può essere ritagliato dall'incavo o dalla .

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

Per impostazione predefinita, includeremo sempre la spaziatura interna. L'SDK Google Maps per iOS presuppone che la spaziatura interna sia destinata a riempire l'area di sicurezza. Se progettare l'interfaccia partendo dal presupposto che tutto si trovi all'interno nell'area sicura, questa operazione funzionerà senza alcuno sforzo in più.

Se hai progettato un'interfaccia che non funziona con le nostre abbiamo introdotto una nuova proprietà in GMSMapView, chiamata paddingAdjustmentBehavior. GMSMapView ora ti permette di scegliere tra uno dei tre comportamenti di regolazione della spaziatura interna: "Sempre" (impostazione predefinita), "Automatico", e "Mai".

Se GMSMapView è impostato per utilizzare il parametro "Sempre" di spaziatura interna, verrà sempre aggiungi i riquadri dell'area di sicurezza alla spaziatura interna. Questo ti consente di progettare partendo dal presupposto che tutti i posizionamenti provengono dai bordi geografica specifica. Questo è il valore predefinito.

Se GMSMapView è impostato per utilizzare il parametro "Automatico" di spaziatura interna, verrà sempre scegli la spaziatura interna o l'area di sicurezza più grande. Potrai aggiungere spaziatura interna dal bordo dello schermo garantendo sempre che tutti gli elementi rimangano all'interno dell'area sicura.

Se GMSMapView è impostato per utilizzare il campo "Mai" di spaziatura interna, non aggiungerà mai l'area sicura viene inserita nella spaziatura interna. Questo è il comportamento precedente alla versione 2.5, e può essere utile se la spaziatura interna tiene già conto del area sicura o se altri nostri comportamenti non funzionano bene con l'interfaccia. È tua responsabilità garantire che il logo Google e le note sul copyright siano sempre visibile, come specificato nella sezione Google Maps Platform Termini di servizio.

Al contrario, GMSPanoramaView non ha una proprietà di spaziatura interna facoltativa. Questo significa che non è presente spaziatura interna da regolare e GMSPanoramaView viene sempre applicato. eventuale spaziatura interna necessaria per garantire che tutti gli elementi visivi siano all'interno geografica specifica.

Google Maps SDK for Android

Come faccio a risolvere l'errore 9005 PLACES_API_RATE_LIMIT_EXCEEDED?
Se viene visualizzato questo errore, è possibile che tu stia utilizzando una versione deprecata del SDK Places per Android. La versione di Google Play Services del L'SDK Places per Android è stato disattivato e non è più disponibile. Aggiorna l'app il prima possibile per utilizzare l'ultima versione. Consulta le guida alla migrazione per maggiori dettagli.
La mia app mostra solo riquadri grigi vuoti invece di una mappa. Come posso risolvere il problema?

Spesso vengono visualizzati riquadri grigi vuoti al posto di una mappa, a causa dei 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 usi l'emulatore Android, assicurati che nelle impostazioni dell'emulatore sia incluso il Play Store.
  3. Esegui adb logcat -e "Google Maps Android API" nel terminale Android Studio. Verranno stampate solo le righe in cui il messaggio di log corrisponde a "API Google Maps Android" (Facoltativamente, puoi generare il log in un file di testo aggiungendo: > logcat.txt)
  4. Riproduci il problema sul dispositivo e verifica la presenza di errori comuni, ad esempio:
    • Nel file manifest viene fatto riferimento alla chiave API sbagliata o non intenzionale.
    • La fatturazione non è abilitata nel progetto.
    • L'SDK non è abilitato nelle API del progetto.
    • L'impronta SHA1 errata viene aggiunta alle limitazioni delle chiavi API.
    • Le dipendenze di Google Play Service non sono incluse nel file build.gradle.

Firma URL

Posso firmare URL utilizzando JavaScript?

Consigliamo vivamente di non firmare gli URL utilizzando JavaScript perché il tuo secret di firma URL agli utenti finali. Di conseguenza, le firme essere generati solo dai componenti lato server.

Perché ricevo una risposta HTTP 403 Forbidden al mio Richieste al servizio web dell'API di Google Maps?

Una risposta HTTP 403 indica un problema di autorizzazione, probabilmente perché impossibile verificare la firma per questa richiesta. Il motivo potrebbe essere uno dei seguenti:

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