Class Geocoder

Геокодер

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

См. также

Методы

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

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

geocode(address)

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

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

Параметры

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

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

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

reverse Geocode(latitude, longitude)

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

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

Параметры

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

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

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

См. также

set Bounds(swLatitude, swLongitude, neLatitude, neLongitude)

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

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

Параметры

Имя Тип Описание
sw Latitude Number широта юго-западного угла границы
sw Longitude Number долгота юго-западного угла границы
ne Latitude Number широта северо-восточного угла границ
ne Longitude Number долгота северо-восточного угла границ

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

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

См. также

set Language(language)

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

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

Параметры

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

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

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

См. также

set Region(region)

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

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

Параметры

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

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

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

См. также