Class Geocoder

Геокодер

Позволяет конвертировать адрес и географические координаты.
В приведенном ниже примере показано, как с помощью этого класса можно найти девять лучших совпадений для местоположения «Мейн-стрит» в Колорадо, добавить их на карту, а затем встроить в новый документ 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'));

См. также

Методы

Метод Тип возврата Краткое описание
geocode(address) Object Получает приблизительные географические точки для данного адреса.
reverseGeocode(latitude, longitude) Object Получает приблизительные адреса для заданной географической точки.
setBounds(swLatitude, swLongitude, neLatitude, neLongitude) Geocoder Устанавливает границы области, которой следует отдать дополнительное предпочтение в результатах.
setLanguage(language) Geocoder Устанавливает язык, который будет использоваться в результатах.
setRegion(region) Geocoder Устанавливает регион, который будет использоваться при интерпретации названий местоположений.

Подробная документация

geocode(address)

Получает приблизительные географические точки для данного адреса. 

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

Параметры

Имя Тип Описание
address String адрес

Возвращаться

Object — объект JSON, содержащий данные геокодирования, как описано здесь.

reverseGeocode(latitude, longitude)

Получает приблизительные адреса для заданной географической точки. 

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

Параметры

Имя Тип Описание
latitude Number широта точки
longitude Number долгота точки

Возвращаться

Object — объект JSON, содержащий данные обратного геокодирования, как описано здесь.

См. также

setBounds(swLatitude, swLongitude, neLatitude, neLongitude)

Устанавливает границы области, которой следует отдать дополнительное предпочтение в результатах. 

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

Параметры

Имя Тип Описание
swLatitude Number широта юго-западного угла границы
swLongitude Number долгота юго-западного угла границы
neLatitude Number широта северо-восточного угла границ
neLongitude Number долгота северо-восточного угла границ

Возвращаться

Geocoder — объект Геокодера для облегчения цепочки вызовов.

См. также

setLanguage(language)

Устанавливает язык, который будет использоваться в результатах. 

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

Параметры

Имя Тип Описание
language String идентификатор языка BCP-47

Возвращаться

Geocoder — объект Геокодера для облегчения цепочки вызовов.

См. также

setRegion(region)

Устанавливает регион, который будет использоваться при интерпретации названий местоположений. Поддерживаемые коды регионов соответствуют ccTLD, поддерживаемым Google Maps. Например, код региона «uk» соответствует «maps.google.co.uk». 

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

Параметры

Имя Тип Описание
region String код региона, который нужно использовать

Возвращаться

Geocoder — объект Геокодера для облегчения цепочки вызовов.

См. также