Class Geocoder

Geocoder

Permite a conversão entre um endereço e coordenadas geográficas.
O exemplo abaixo mostra como usar essa classe para encontrar as nove principais correspondências para o local "Main St" no Colorado, adicioná-las a um mapa e incorporá-las a um novo documento do 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'));

Consulte também

• API Geocoding do Google

Métodos

Método	Tipo de retorno	Breve descrição
geocode(address)	Object	Retorna os pontos geográficos aproximados de um determinado endereço.
reverseGeocode(latitude, longitude)	Object	Retorna os endereços aproximados para um determinado ponto geográfico.
setBounds(swLatitude, swLongitude, neLatitude, neLongitude)	Geocoder	Define os limites de uma área que deve receber preferência extra nos resultados.
setLanguage(language)	Geocoder	Define o idioma a ser usado nos resultados.
setRegion(region)	Geocoder	Define uma região a ser usada ao interpretar nomes de local.

Documentação detalhada

geocode(address)

Retorna os pontos geográficos aproximados de um determinado endereço.

// 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,
  );
}

Parâmetros

Nome	Tipo	Descrição
address	String	um endereço

Retornar

Object: um objeto JSON que contém os dados de geocodificação, conforme descrito aqui.

---

reverseGeocode(latitude, longitude)

Retorna os endereços aproximados de um determinado ponto geográfico.

// 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,
  );
}

Parâmetros

Nome	Tipo	Descrição
latitude	Number	a latitude do ponto
longitude	Number	a longitude do ponto

Retornar

Object: um objeto JSON que contém os dados de geocodificação reversa, conforme descrito aqui.

Consulte também

• API Geocoding do Google

---

setBounds(swLatitude, swLongitude, neLatitude, neLongitude)

Define os limites de uma área que deve receber preferência extra nos resultados.

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

Parâmetros

Nome	Tipo	Descrição
swLatitude	Number	a latitude do canto sudeste dos limites
swLongitude	Number	a longitude do canto sudoeste dos limites
neLatitude	Number	a latitude do canto nordeste dos limites
neLongitude	Number	a longitude do canto nordeste dos limites

Retornar

Geocoder: o objeto Geocoder para facilitar o encadeamento de chamadas.

Consulte também

• API Geocoding do Google

---

setLanguage(language)

Define o idioma a ser usado nos resultados.

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

Parâmetros

Nome	Tipo	Descrição
language	String	um identificador de idioma BCP-47

Retornar

Geocoder: o objeto Geocoder para facilitar o encadeamento de chamadas.

Consulte também

• Formato de polilinha codificada

---

setRegion(region)

Define uma região a ser usada ao interpretar nomes de local. Os códigos de região compatíveis correspondem aos ccTLDs aceitos pelo Google Maps. Por exemplo, o código de região "uk" corresponde a "maps.google.co.uk".

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

Parâmetros

Nome	Tipo	Descrição
region	String	o código da região a ser usado

Retornar

Geocoder: o objeto Geocoder para facilitar o encadeamento de chamadas.

Consulte também

• API Geocoding do Google