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 interpretare i nomi dei luoghi.

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 interpretare i nomi dei luoghi. 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