Annuncio: i nuovi stili delle mappe base saranno presto disponibili su Google Maps Platform. Questo aggiornamento dello stile della mappa include una nuova tavolozza dei colori predefinita, segnaposto moderni e miglioramenti alle esperienze sulla mappa e all'usabilità. Tutti gli stili di mappa verranno aggiornati automaticamente a marzo 2025. Per ulteriori informazioni sulla disponibilità e su come attivare in anteprima la funzionalità, consulta Nuovo stile di mappa per Google Maps Platform.

Questa pagina è stata tradotta dall'API Cloud Translation.

Parametri URL dell'API Maps JavaScript

Questo documento illustra tutti i parametri che puoi specificare nella stringa di query dell'URL di caricamento dello script quando carichi l'API Maps JavaScript. Alcuni parametri sono obbligatori, mentre altri sono facoltativi. Come avviene negli URL, tutti i parametri sono separati utilizzando la e commerciale (&).

Nel seguente URL di esempio sono presenti segnaposto per tutti i possibili parametri:

https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY
&callback=FUNCTION_NAME
&v=VERSION
&libraries="LIBRARIES"
&language="LANGUAGE"
&region="REGION"
&solution_channel="SOLUTION_IDENTIFIER"
&auth_referrer_policy="AUTH_REFERRER_POLICY"

L'URL nel tag script di esempio riportato di seguito carica l'API Maps JavaScript:

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
</script>

Parametri obbligatori

Durante il caricamento dell'API Maps JavaScript sono necessari i seguenti parametri.

key: la tua chiave API. L'API Maps JavaScript non verrà caricata a meno che non venga specificata una chiave API valida.
callback: il nome di una funzione globale da chiamare una volta completata il caricamento completo dell'API Maps JavaScript.

Parametri facoltativi

Utilizza questi parametri per richiedere una versione specifica dell'API Maps JavaScript, caricare ulteriori librerie, localizzare la mappa o specificare il criterio di controllo referrer HTTP

v: la versione dell'API Maps JavaScript da utilizzare.
libraries: un elenco separato da virgole di librerie aggiuntive di API JavaScript da caricare.
language: la lingua da utilizzare. Questo influisce sui nomi dei controlli, sulle note sul copyright, sulle indicazioni stradali e sulle etichette di controllo, nonché sulle risposte alle richieste di servizio. Consulta l'elenco delle lingue supportate.
region: il codice regione da utilizzare. Questo modifica il comportamento della mappa in base a un determinato paese o territorio.
solution_channel: Google Maps Platform offre molti tipi di codice di esempio per aiutarti a iniziare subito. Per monitorare l'adozione dei nostri esempi di codice più complessi e migliorare la qualità della soluzione, Google include il parametro di ricerca solution_channel nelle chiamate API nel codice di esempio.

Nota: questo parametro di ricerca è destinato all'uso da parte di Google. Per ulteriori informazioni, consulta il parametro delle soluzioni di Google Maps Platform.
auth_referrer_policy: i clienti di Maps JS possono configurare le restrizioni dei referrer HTTP in Cloud Console per limitare gli URL autorizzati a utilizzare una chiave API specifica. Per impostazione predefinita, queste limitazioni possono essere configurate in modo da consentire solo ad alcuni percorsi di utilizzare una chiave API. Se qualsiasi URL nello stesso dominio o nella stessa origine può utilizzare la chiave API, puoi impostare auth_referrer_policy=origin per limitare la quantità di dati inviati durante l'autorizzazione delle richieste dall'API Maps JavaScript. Questa funzionalità è disponibile a partire dalla versione 3.46. Se questo parametro è specificato e le limitazioni referrer HTTP sono attivate in Cloud Console, l'API Maps JavaScript potrà essere caricata solo se esiste una limitazione HTTP Referrer che corrisponde al dominio del sito web attuale senza un percorso specificato.