이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Class Geocoder

주소와 지리적 좌표 간의 변환을 허용합니다.
아래 예에서는 이 클래스를 사용하여 콜로라도의 'Main St' 위치와 일치하는 상위 9개 항목을 찾아 지도에 추가한 후 새 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'));

참고 항목

Google Geocoding API

메서드

메서드	반환 유형	간략한 설명
`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.
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 객체입니다.

`reverseGeocode(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 객체입니다.

참고 항목

Google Geocoding API

`setBounds(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,
);

매개변수

이름	유형	설명
`swLatitude`	`Number`	경계의 남서쪽 모서리의 위도
`swLongitude`	`Number`	경계의 남서쪽 모서리의 경도
`neLatitude`	`Number`	경계의 북동쪽 모서리의 위도
`neLongitude`	`Number`	경계의 북동쪽 모서리의 경도

리턴

Geocoder: 호출 체이닝을 용이하게 하는 Geocoder 객체입니다.

참고 항목

Google Geocoding API

`setLanguage(language)`

결과에 사용할 언어를 설정합니다.

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

매개변수

이름	유형	설명
`language`	`String`	BCP-47 언어 식별자

리턴

Geocoder: 호출 체이닝을 용이하게 하는 Geocoder 객체입니다.

참고 항목

인코딩된 폴리라인 형식

`setRegion(region)`

위치 이름을 해석할 때 사용할 지역을 설정합니다. 지원되는 지역 코드는 Google 지도에서 지원되는 ccTLD에 해당합니다. 예를 들어 지역 코드 'uk'는 'maps.google.co.uk'에 해당합니다.

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

매개변수

이름	유형	설명
`region`	`String`	사용할 지역 코드

리턴

Geocoder: 호출 체이닝을 용이하게 하는 Geocoder 객체

참고 항목

Google Geocoding API