Questa pagina è stata tradotta dall'API Cloud Translation.

Class Geocoder

Consente la conversione tra un indirizzo e le coordinate geografiche.
L'esempio seguente mostra come utilizzare questo corso per trovare le prime nove corrispondenze per la sede "Via Cavour" in Colorado, aggiungerle a una mappa e poi incorporarla in un nuovo documento Google.

// Find the best matches for "Main St" in Colorado.
var 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.
var doc = DocumentApp.create('My Map');
var map = Maps.newStaticMap();

// Add each result to the map and doc.
for (var i = 0; i < response.results.length && i < 9; i++) {
  var 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`	Restituisce i punti geografici approssimativi per un determinato indirizzo.
`reverseGeocode(latitude, longitude)`	`Object`	Restituisce gli indirizzi approssimativi di un determinato punto geografico.
`setBounds(swLatitude, swLongitude, neLatitude, neLongitude)`	`Geocoder`	Imposta i confini di un'area che deve avere 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)`

Restituisce i punti geografici approssimativi per un determinato indirizzo.

// Gets the geographic coordinates for Times Square.
var response = Maps.newGeocoder().geocode('Times Square, New York, NY');
for (var i = 0; i < response.results.length; i++) {
  var 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)`

Restituisce gli indirizzi approssimativi di un determinato punto geografico.

// Gets the address of a point in Times Square.
var response = Maps.newGeocoder().reverseGeocode(40.758577, -73.984464);
for (var i = 0; i < response.results.length; i++) {
  var 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 confini di un'area che deve avere una preferenza aggiuntiva nei risultati.

// Creates a Geocoder that prefers points in the area of Manhattan.
var 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 limiti
`swLongitude`	`Number`	la longitudine dell'angolo sud-ovest dei confini
`neLatitude`	`Number`	la latitudine dell'angolo nord-est dei limiti
`neLongitude`	`Number`	la longitudine dell'angolo nord-est dei confini

Invio

Geocoder: l'oggetto Geocoder per facilitare il concatenamento 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.
var geocoder = Maps.newGeocoder().setLanguage('fr');

Parametri

Nome	Tipo	Descrizione
`language`	`String`	Un identificatore lingua BCP-47

Invio

Geocoder: l'oggetto Geocoder per facilitare il concatenamento 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 i ccTLD supportati da Google Maps. Ad esempio, il codice regione "uk" corrisponde a "maps.google.it".

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

Parametri

Nome	Tipo	Descrizione
`region`	`String`	il codice regione da utilizzare

Invio

Geocoder: l'oggetto Geocoder per facilitare il concatenamento delle chiamate

Vedi anche

API Google Geocoding