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

Métodos

MétodoTipo de retornoBreve descrição
geocode(address)ObjectRetorna os pontos geográficos aproximados de um determinado endereço.
reverseGeocode(latitude, longitude)ObjectRetorna os endereços aproximados para 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 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

NomeTipoDescrição
addressStringum 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

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 sudeste 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 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

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