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.

  • 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.