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 do local "Main St" no Colorado, adicioná-las a um mapa e incorporá-lo 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

Métodos

MétodoTipo de retornoBreve descrição
geocode(address)ObjectRecebe os pontos geográficos aproximados de um determinado endereço.
reverseGeocode(latitude, longitude)ObjectRecebe os endereços aproximados de um determinado ponto geográfico.
setBounds(swLatitude, swLongitude, neLatitude, neLongitude)GeocoderDefine os limites de uma área que deve receber preferência extra nos resultados.
setLanguage(language)GeocoderDefine o idioma a ser usado nos resultados.
setRegion(region)GeocoderDefine uma região a ser usada ao interpretar nomes de locais.

Documentação detalhada

geocode(address)

Recebe 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

NomeTipoDescrição
addressStringUm endereço.

Retornar

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

reverseGeocode(latitude, longitude)

Recebe 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

NomeTipoDescrição
latitudeNumberA latitude do ponto.
longitudeNumberA longitude do ponto.

Retornar

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

Consulte também

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

NomeTipoDescrição
swLatitudeNumberA latitude do canto sudoeste dos limites.
swLongitudeNumberA longitude do canto sudoeste dos limites.
neLatitudeNumberA latitude do canto nordeste dos limites.
neLongitudeNumberA longitude do canto nordeste dos limites.

Retornar

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

Consulte também

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

NomeTipoDescrição
languageStringUm identificador de idioma BCP-47.

Retornar

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

Consulte também

setRegion(region)

Define uma região a ser usada ao interpretar nomes de locais. Os códigos de região aceitos 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

NomeTipoDescrição
regionStringO código da região a ser usado.

Retornar

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

Consulte também