Class Maps

Maps

Consente la ricerca della direzione, la geocodifica, il campionamento dell'elevazione e la creazione di immagini di mappe statiche.

Proprietà

Proprietà	Tipo	Descrizione
DirectionFinder	DirectionFinderEnums
StaticMap	StaticMapEnums

Metodi

Metodo	Tipo restituito	Breve descrizione
decodePolyline(polyline)	Number[]	Decodifica una stringa polilinea codificata in un array di punti.
encodePolyline(points)	String	Codifica un array di punti in una stringa.
newDirectionFinder()	DirectionFinder	Crea un nuovo oggetto DirectionFinder.
newElevationSampler()	ElevationSampler	Crea un oggetto ElevationSampler.
newGeocoder()	Geocoder	Crea un nuovo oggetto Geocoder.
newStaticMap()	StaticMap	Crea un nuovo oggetto StaticMap.
resetAuthenticationApiKey()	void	Reimposta le credenziali di autenticazione per utilizzare le quote predefinite.
setAuthenticationByApiKey(apiKey)	void	Consente l'utilizzo di una chiave API per autenticare le richieste e sfruttare quote aggiuntive.
setAuthenticationByApiKey(apiKey, signingKey)	void	Consente l'utilizzo di una chiave API e di una chiave di firma per autenticare le richieste e sfruttare quote aggiuntive in StaticMap.

Metodi ritirati

Metodo	Tipo restituito	Breve descrizione
setAuthentication(clientId, signingKey)	void	Consente l'utilizzo di un account Google Maps APIs Premium Plan stabilito esternamente, per sfruttare quote aggiuntive.

Documentazione dettagliata

decodePolyline(polyline)

Decodifica una stringa polilinea codificata in un array di punti.

// Decodes a string representation of the latitudes and longitudes of
// Minneapolis and Milwaukee respectively.
const polyline = 'qvkpG`qhxPbgyI_zq_@';
const points = Maps.decodePolyline(polyline);
for (let i = 0; i < points.length; i += 2) {
  Logger.log('%s, %s', points[i], points[i + 1]);
}

Parametri

Nome	Tipo	Descrizione
polyline	String	Una polilinea codificata da decodificare.

Indietro

Number[]: un array di coppie di latitudine e longitudine (lat0, long0, lat1, long1, ...).

Vedi anche

• Formato polilinea codificata

---

encodePolyline(points)

Codifica un array di punti in una stringa.

// The latitudes and longitudes of New York and Boston respectively.
const points = [40.77, -73.97, 42.34, -71.04];
const polyline = Maps.encodePolyline(points);

Parametri

Nome	Tipo	Descrizione
points	Number[]	Un array di coppie latitudine/longitudine da codificare.

Indietro

String: una stringa codificata che rappresenta questi punti.

Vedi anche

• Formato polilinea codificata

---

newDirectionFinder()

Crea un nuovo oggetto DirectionFinder.

Indietro

DirectionFinder: un nuovo oggetto di ricerca della direzione.

---

newElevationSampler()

Crea un oggetto ElevationSampler.

Indietro

ElevationSampler: un nuovo oggetto campionatore di elevazione.

---

newGeocoder()

Crea un nuovo oggetto Geocoder.

Indietro

Geocoder: un nuovo oggetto geocoder.

---

newStaticMap()

Crea un nuovo oggetto StaticMap.

Indietro

StaticMap: un nuovo oggetto mappa statica.

---

resetAuthenticationApiKey()

Reimposta le credenziali di autenticazione per utilizzare le quote predefinite. Questo metodo funziona quando utilizzi la chiave API per autenticare le richieste. Questo metodo può essere utilizzato per ripristinare le quote predefinite se vuoi utilizzare i metodi Maps senza fornire credenziali di autenticazione.

Maps.resetAuthenticationApiKey();

Genera

Error: se setAuthentication(clientId, signingKey) viene utilizzato per l'autenticazione.

---

setAuthenticationByApiKey(apiKey)

Consente l'utilizzo di una chiave API per autenticare le richieste e sfruttare quote aggiuntive.

Questo metodo viene utilizzato per impostare una chiave API che viene utilizzata per autenticare le richieste. Quando viene chiamato questo metodo, il consumo di quota e la fatturazione vengono addebitati al progetto Google Cloud associato alla chiave API fornita in base al foglio dei prezzi. Puoi utilizzare i metodi Maps con le quote predefinite senza fornire credenziali di autenticazione. Se utilizzi StaticMap, utilizza invece il metodo setAuthenticationByApiKey(apiKey, signingKey).

Nota: se utilizzi l'ID client per autenticare le richieste, tieni presente che l'ID client è deprecato dal 26 maggio 2025 e non potrà più essere utilizzato dopo il 31 maggio 2026. Anziché utilizzare un ID client, devi utilizzare le credenziali della chiave API per autenticare il traffico del servizio API di Google Maps. Per maggiori dettagli, consulta la guida.

Maps.setAuthenticationByApiKey('BBdgJpSbLtAtmkBFjgLt310qT6iekggfDdVqLC0');

Parametri

Nome	Tipo	Descrizione
apiKey	String	Una chiave API che può essere ottenuta dalla console Google Cloud seguendo i passaggi menzionati nella guida rapida.

Genera

Error: se apiKey è null o se setAuthentication(clientId, signingKey) è già in uso per l'autenticazione

---

setAuthenticationByApiKey(apiKey, signingKey)

Consente l'utilizzo di una chiave API e di una chiave di firma per autenticare le richieste e sfruttare quote aggiuntive in StaticMap. Sebbene signingKey sia obbligatorio per le richieste all'API Static Maps, questo metodo può essere utilizzato anche per autenticare altri servizi Maps. In questi casi, il parametro signingKey viene ignorato.

Questo metodo viene utilizzato per impostare una chiave API e una chiave di firma utilizzate per autenticare le richieste. La chiave di firma è necessaria per StaticMap, accetta un numero ridotto di richieste senza firma a scopo di test, ma iniziano a non funzionare una volta raggiunto il limite nella produzione. Puoi trovare ulteriori dettagli qui.

Maps.setAuthenticationByApiKey('BBdgJpSbLtAtmkBFjgLt310qT6iekggfDdVqLC0',
'7_pry-Skg0PKxds-7nvdl91mB5=');

Parametri

Nome	Tipo	Descrizione
apiKey	String	Una chiave API che può essere ottenuta dalla console Google Cloud seguendo i passaggi menzionati nella guida rapida.
signingKey	String	Una chiave di firma che può essere ottenuta dalla console Google Cloud seguendo i passaggi descritti nella guida alla firma digitale. Questo è necessario per StaticMap e viene ignorato per altri servizi Maps.

Genera

Error: se apiKey è null o se setAuthentication(clientId, signingKey) è già in uso per l'autenticazione

Vedi anche

• setAuthenticationByApiKey(apiKey)

Metodi ritirati

setAuthentication(clientId, signingKey)

Deprecato. Utilizza invece setAuthenticationByApiKey(apiKey), che utilizza la chiave API per l'autenticazione.

Consente l'utilizzo di un account Google Maps APIs Premium Plan stabilito esternamente, per sfruttare quote aggiuntive. L'ID client e la chiave di firma possono essere ottenuti dalla sezione Maps della console Google Cloud. Imposta questi valori su null per tornare a utilizzare le quote predefinite.

Nota: questo metodo non funziona con le chiavi API. Inoltre, tieni presente che il piano Premium non è più disponibile per i nuovi clienti. Se non disponi già di una licenza del piano Premium, non chiamare il numero setAuthentication(clientId, signingKey). Puoi utilizzare i metodi Maps con le quote predefinite.

Maps.setAuthentication('gme-123456789', 'VhSEZvOXVSdnlxTnpJcUE');

Parametri

Nome	Tipo	Descrizione
clientId	String	Un identificatore client.
signingKey	String	Una chiave di firma privata.

Genera

Error: se setAuthenticationByApiKey(apiKey) è già in uso per l'autenticazione