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

Metodi

MetodoTipo restituitoBreve descrizione
geocode(address)ObjectRecupera i punti geografici approssimativi per un determinato indirizzo.
reverseGeocode(latitude, longitude)ObjectRecupera gli indirizzi approssimativi per un determinato punto geografico.
setBounds(swLatitude, swLongitude, neLatitude, neLongitude)GeocoderImposta i limiti di un'area a cui deve essere data una preferenza aggiuntiva nei risultati.
setLanguage(language)GeocoderImposta la lingua da utilizzare nei risultati.
setRegion(region)GeocoderImposta 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

NomeTipoDescrizione
addressStringun 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

NomeTipoDescrizione
latitudeNumberla latitudine del punto
longitudeNumberla longitudine del punto

Invio

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

Vedi anche

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

NomeTipoDescrizione
swLatitudeNumberla latitudine dell'angolo sud-ovest dei confini
swLongitudeNumberla longitudine dell'angolo sud-ovest dei confini
neLatitudeNumberla latitudine dell'angolo nord-est dei confini
neLongitudeNumberla longitudine dell'angolo nord-est dei limiti

Invio

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

Vedi anche

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

NomeTipoDescrizione
languageStringun identificatore di lingua BCP-47

Invio

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

Vedi anche

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

NomeTipoDescrizione
regionStringil codice regione da utilizzare

Invio

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

Vedi anche