Class Geocoder

Geocodificatore

Consente la conversione tra un indirizzo e coordinate geografiche.
L'esempio riportato di seguito mostra come utilizzare questa classe per trovare le nove corrispondenze migliori per la località "Main St" in Colorado, aggiungerle a una mappa e poi incorporarle in un nuovo documento Google.

// Find the best matches for "Main St" in Colorado.
const response = Maps.newGeocoder()
                     // The latitudes and longitudes of southwest and northeast
                     // corners of Colorado, respectively.
                     .setBounds(36.998166, -109.045486, 41.001666, -102.052002)
                     .geocode('Main St');

// Create a Google Doc and map.
const doc = DocumentApp.create('My Map');
const map = Maps.newStaticMap();

// Add each result to the map and doc.
for (let i = 0; i < response.results.length && i < 9; i++) {
  const result = response.results[i];
  map.setMarkerStyle(null, null, i + 1);
  map.addMarker(result.geometry.location.lat, result.geometry.location.lng);
  doc.appendListItem(result.formatted_address);
}

// Add the finished map to the doc.
doc.appendImage(Utilities.newBlob(map.getMapImage(), 'image/png'));

Vedi anche

• API Google Geocoding

Metodi

Metodo	Tipo restituito	Breve descrizione
geocode(address)	Object	Recupera i punti geografici approssimativi per un determinato indirizzo.
reverseGeocode(latitude, longitude)	Object	Recupera gli indirizzi approssimativi per un determinato punto geografico.
setBounds(swLatitude, swLongitude, neLatitude, neLongitude)	Geocoder	Imposta i limiti di un'area a cui deve essere data una preferenza aggiuntiva nei risultati.
setLanguage(language)	Geocoder	Imposta la lingua da utilizzare nei risultati.
setRegion(region)	Geocoder	Imposta una regione da utilizzare per l'interpretazione dei nomi delle località.

Documentazione dettagliata

geocode(address)

Recupera i punti geografici approssimativi per un determinato indirizzo.

// Gets the geographic coordinates for Times Square.
const response = Maps.newGeocoder().geocode('Times Square, New York, NY');
for (let i = 0; i < response.results.length; i++) {
  const result = response.results[i];
  Logger.log(
      '%s: %s, %s',
      result.formatted_address,
      result.geometry.location.lat,
      result.geometry.location.lng,
  );
}

Parametri

Nome	Tipo	Descrizione
address	String	un indirizzo

Invio

Object: un oggetto JSON contenente i dati di geocodifica, come descritto qui

---

reverseGeocode(latitude, longitude)

Recupera gli indirizzi approssimativi per un determinato punto geografico.

// Gets the address of a point in Times Square.
const response = Maps.newGeocoder().reverseGeocode(40.758577, -73.984464);
for (let i = 0; i < response.results.length; i++) {
  const result = response.results[i];
  Logger.log(
      '%s: %s, %s',
      result.formatted_address,
      result.geometry.location.lat,
      result.geometry.location.lng,
  );
}

Parametri

Nome	Tipo	Descrizione
latitude	Number	la latitudine del punto
longitude	Number	la longitudine del punto

Invio

Object: un oggetto JSON contenente i dati di geocodifica inversa, come descritto qui

Vedi anche

• API Google Geocoding

---

setBounds(swLatitude, swLongitude, neLatitude, neLongitude)

Imposta i limiti di un'area a cui deve essere data una preferenza aggiuntiva nei risultati.

// Creates a Geocoder that prefers points in the area of Manhattan.
const geocoder = Maps.newGeocoder().setBounds(
    40.699642,
    -74.021072,
    40.877569,
    -73.908548,
);

Parametri

Nome	Tipo	Descrizione
swLatitude	Number	la latitudine dell'angolo sud-ovest dei confini
swLongitude	Number	la longitudine dell'angolo sud-ovest dei confini
neLatitude	Number	la latitudine dell'angolo nord-est dei confini
neLongitude	Number	la longitudine dell'angolo nord-est dei limiti

Invio

Geocoder: l'oggetto Geocoder per facilitare l'accodamento delle chiamate

Vedi anche

• API Google Geocoding

---

setLanguage(language)

Imposta la lingua da utilizzare nei risultati.

// Creates a Geocoder with the language set to French.
const geocoder = Maps.newGeocoder().setLanguage('fr');

Parametri

Nome	Tipo	Descrizione
language	String	un identificatore di lingua BCP-47

Invio

Geocoder: l'oggetto Geocoder per facilitare l'accodamento delle chiamate.

Vedi anche

• Formato polilinea codificato

---

setRegion(region)

Imposta una regione da utilizzare per l'interpretazione dei nomi delle località. I codici regione supportati corrispondono ai ccTLD supportati da Google Maps. Ad esempio, il codice regione "uk" corrisponde a "maps.google.co.uk".

// Creates a Geocoder with the region set to France.
const geocoder = Maps.newGeocoder().setRegion('fr');

Parametri

Nome	Tipo	Descrizione
region	String	il codice regione da utilizzare

Invio

Geocoder: l'oggetto Geocoder per facilitare l'accodamento delle chiamate

Vedi anche

• API Google Geocoding