Class DirectionFinder

DirectionFinder

위치 간의 경로를 검색할 수 있습니다.
아래 예는 이 클래스를 사용하여 타임 스퀘어에서 다음 목적지까지 가는 길을 찾는 방법을 보여줍니다. 먼저 링컨 센터에 정차한 센트럴 파크가 위치와 경로를 지도에 표시하고 이메일로 보낼 수 있습니다

// Get the directions.
var directions = Maps.newDirectionFinder()
    .setOrigin('Times Square, New York, NY')
    .addWaypoint('Lincoln Center, New York, NY')
    .setDestination('Central Park, New York, NY')
    .setMode(Maps.DirectionFinder.Mode.DRIVING)
    .getDirections();
var route = directions.routes[0];

// Set up marker styles.
var markerSize = Maps.StaticMap.MarkerSize.MID;
var markerColor = Maps.StaticMap.Color.GREEN
var markerLetterCode = 'A'.charCodeAt();

// Add markers to the map.
var map = Maps.newStaticMap();
for (var i = 0; i < route.legs.length; i++) {
  var leg = route.legs[i];
  if (i == 0) {
    // Add a marker for the start location of the first leg only.
    map.setMarkerStyle(markerSize, markerColor, String.fromCharCode(markerLetterCode));
    map.addMarker(leg.start_location.lat, leg.start_location.lng);
    markerLetterCode++;
  }
  map.setMarkerStyle(markerSize, markerColor, String.fromCharCode(markerLetterCode));
  map.addMarker(leg.end_location.lat, leg.end_location.lng);
  markerLetterCode++;
}

// Add a path for the entire route.
map.addPath(route.overview_polyline.points);

// Send the map in an email.
var toAddress = Session.getActiveUser().getEmail();
MailApp.sendEmail(
  toAddress,
  'Directions',
  'Please open: ' + map.getMapUrl() + '&key=YOUR_API_KEY', {
    htmlBody: 'See below.<br/><img src="cid:mapImage">',
    inlineImages: {
      mapImage: Utilities.newBlob(map.getMapImage(), 'image/png')
    }
  }
);

참고 항목

• Google Directions API

메서드

메서드	반환 유형	간략한 설명
addWaypoint(latitude, longitude)	DirectionFinder	점 (위도/경도)을 사용하여 경로가 통과해야 하는 경유지를 추가합니다.
addWaypoint(address)	DirectionFinder	주소를 사용하여 경로가 통과해야 하는 경유지를 추가합니다.
clearWaypoints()	DirectionFinder	현재 경유지 집합을 삭제합니다.
getDirections()	Object	설정된 출발지, 목적지 및 기타 옵션을 사용하여 경로를 가져옵니다.
setAlternatives(useAlternatives)	DirectionFinder	순위가 가장 높은 경로 대신 대체 경로를 반환할지 여부를 설정합니다. route (기본값은 false)입니다.
setArrive(time)	DirectionFinder	원하는 도착 시간을 설정합니다 (해당하는 경우).
setAvoid(avoid)	DirectionFinder	특정 유형의 제한을 피할지 여부를 설정합니다.
setDepart(time)	DirectionFinder	원하는 출발 시간을 설정합니다 (해당하는 경우).
setDestination(latitude, longitude)	DirectionFinder	점 (위도/경도)을 사용하여 경로를 계산할 도착 위치를 설정합니다.
setDestination(address)	DirectionFinder	주소를 사용하여 경로를 계산할 도착 위치를 설정합니다.
setLanguage(language)	DirectionFinder	경로에 사용할 언어를 설정합니다.
setMode(mode)	DirectionFinder	이동 수단을 설정합니다 (기본값은 운전).
setOptimizeWaypoints(optimizeOrder)	DirectionFinder	경유지를 더 많은 지점으로 재정렬하여 제공된 경로를 최적화할지 여부를 설정합니다. 효율적입니다 (기본값은 false임).
setOrigin(latitude, longitude)	DirectionFinder	점 (위도/경도)을 사용하여 경로를 계산할 시작 위치를 설정합니다.
setOrigin(address)	DirectionFinder	주소를 사용하여 경로를 계산할 시작 위치를 설정합니다.
setRegion(region)	DirectionFinder	위치 이름을 해석할 때 사용할 지역을 설정합니다.

자세한 문서

addWaypoint(latitude, longitude)

점 (위도/경도)을 사용하여 경로가 통과해야 하는 경유지를 추가합니다.

// Creates a DirectionFinder with a wapoint at Lincoln Center.
var directionFinder = Maps.newDirectionFinder().addWaypoint(40.772628, -73.984243);

매개변수

이름	유형	설명
latitude	Number	경유지의 위도입니다.
longitude	Number	경유지의 경도입니다.

리턴

DirectionFinder - 호출 체인을 용이하게 하는 DirectionFinder 객체입니다.

---

addWaypoint(address)

주소를 사용하여 경로가 통과해야 하는 경유지를 추가합니다.

// Creates a DirectionFinder with a wapoint at Lincoln Center.
var directionFinder = Maps.newDirectionFinder().addWaypoint('Lincoln Center, New York, NY');

매개변수

이름	유형	설명
address	String	주소입니다.

리턴

DirectionFinder - 호출 체인을 용이하게 하는 DirectionFinder 객체입니다.

---

clearWaypoints()

현재 경유지 집합을 삭제합니다.

var directionFinder = Maps.newDirectionFinder()
// ...
// Do something interesting here ...
// ...
// Remove all waypoints added with addWaypoint().
directionFinder.clearWaypoints();

리턴

DirectionFinder: 호출 체인을 용이하게 하는 DirectionFinder 객체

---

getDirections()

설정된 출발지, 목적지 및 기타 옵션을 사용하여 경로를 가져옵니다.

// Logs how long it would take to walk from Times Square to Central Park.
var directions = Maps.newDirectionFinder()
    .setOrigin('Times Square, New York, NY')
    .setDestination('Central Park, New York, NY')
    .setMode(Maps.DirectionFinder.Mode.WALKING)
    .getDirections();
Logger.log(directions.routes[0].legs[0].duration.text);

리턴

Object: 여기에 설명된 대로 경로의 경로 집합이 포함된 JSON 객체입니다.

참고 항목

• Google Directions API

---

setAlternatives(useAlternatives)

순위가 가장 높은 경로 대신 대체 경로를 반환할지 여부를 설정합니다. route (기본값은 false)입니다. true인 경우 결과 객체의 routes 배열은 여러 개의 항목이 있습니다.

// Creates a DirectionFinder with alernative routes enabled.
var directionFinder = Maps.newDirectionFinder().setAlternatives(true);

매개변수

이름	유형	설명
useAlternatives	Boolean	대체 경로를 반환하려면 true, 그렇지 않은 경우 false를 반환

리턴

DirectionFinder: 호출 체인을 용이하게 하는 DirectionFinder 객체

---

setArrive(time)

원하는 도착 시간을 설정합니다 (해당하는 경우).

// Creates a DirectionFinder with an arrival time of 2 hours from now.
var now = new Date();
var arrive = new Date(now.getTime() + (2 * 60 * 60 * 1000));
var directionFinder = Maps.newDirectionFinder().setArrive(arrive);

매개변수

이름	유형	설명
time	Date	도착 시간

리턴

DirectionFinder: 호출 체인을 용이하게 하는 DirectionFinder 객체

참고 항목

• Google Directions API

---

setAvoid(avoid)

특정 유형의 제한을 피할지 여부를 설정합니다.

// Creates a DirectionFinder that avoid highways.
var directionFinder = Maps.newDirectionFinder().setAvoid(Maps.DirectionFinder.Avoid.HIGHWAYS);

매개변수

이름	유형	설명
avoid	String	Avoid의 상수 값

리턴

DirectionFinder: 호출 체인을 용이하게 하는 DirectionFinder 객체

참고 항목

• Google Directions API

---

setDepart(time)

원하는 출발 시간을 설정합니다 (해당하는 경우).

// Creates a DirectionFinder with a departure time of 1 hour from now.
var now = new Date();
var depart = new Date(now.getTime() + (1 * 60 * 60 * 1000));
var directionFinder = Maps.newDirectionFinder().setDepart(depart);

매개변수

이름	유형	설명
time	Date	출발 시간

리턴

DirectionFinder - 호출 체인을 용이하게 하는 DirectionFinder 객체입니다.

참고 항목

• Google Directions API

---

setDestination(latitude, longitude)

점 (위도/경도)을 사용하여 경로를 계산할 도착 위치를 설정합니다.

// Creates a DirectionFinder with the destination set to Central Park.
var directionFinder = Maps.newDirectionFinder().setDestination(40.777052, -73.975464);

매개변수

이름	유형	설명
latitude	Number	목적지의 위도
longitude	Number	목적지의 경도

리턴

DirectionFinder: 호출 체인을 용이하게 하는 DirectionFinder 객체

---

setDestination(address)

주소를 사용하여 경로를 계산할 도착 위치를 설정합니다.

// Creates a DirectionFinder with the destination set to Central Park.
var directionFinder = Maps.newDirectionFinder().setDestination('Central Park, New York, NY');

매개변수

이름	유형	설명
address	String	도착지 주소

리턴

DirectionFinder: 호출 체인을 용이하게 하는 DirectionFinder 객체

---

setLanguage(language)

경로에 사용할 언어를 설정합니다.

// Creates a DirectionFinder with the language set to French.
var directionFinder = Maps.newDirectionFinder().setLanguage('fr');

매개변수

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

리턴

DirectionFinder: 호출 체인을 용이하게 하는 DirectionFinder 객체

참고 항목

• Google 지도 API의 언어 지원

---

setMode(mode)

이동 수단을 설정합니다 (기본값은 운전).

// Creates a DirectionFinder with the mode set to walking.
var directionFinder = Maps.newDirectionFinder().setMode(Maps.DirectionFinder.Mode.WALKING);

매개변수

이름	유형	설명
mode	String	Mode의 상수 값

리턴

DirectionFinder: 호출 체인을 용이하게 하는 DirectionFinder 객체

참고 항목

• Google Directions API

---

setOptimizeWaypoints(optimizeOrder)

경유지를 더 많은 지점으로 재정렬하여 제공된 경로를 최적화할지 여부를 설정합니다. 효율적입니다 (기본값은 false임).

// Creates a DirectionFinder with wapoint optimization enabled.
var directionFinder = Maps.newDirectionFinder().setOptimizeWaypoints(true);

매개변수

이름	유형	설명
optimizeOrder	Boolean	순서를 최적화하려면 true, 그렇지 않으면 false를 반환합니다.

리턴

DirectionFinder: 호출 체인을 용이하게 하는 DirectionFinder 객체

참고 항목

• Google Directions API

---

setOrigin(latitude, longitude)

점 (위도/경도)을 사용하여 경로를 계산할 시작 위치를 설정합니다.

// Creates a DirectionFinder with the origin set to Times Square.
var directionFinder = Maps.newDirectionFinder().setOrigin(40.759011, -73.984472);

매개변수

이름	유형	설명
latitude	Number	출발지의 위도
longitude	Number	출발지의 경도

리턴

DirectionFinder: 호출 체인을 용이하게 하는 DirectionFinder 객체

---

setOrigin(address)

주소를 사용하여 경로를 계산할 시작 위치를 설정합니다.

// Creates a DirectionFinder with the origin set to Times Square.
var directionFinder = Maps.newDirectionFinder().setOrigin('Times Square, New York, NY');

매개변수

이름	유형	설명
address	String	출발지 주소

리턴

DirectionFinder: 호출 체인을 용이하게 하는 DirectionFinder 인스턴스

---

setRegion(region)

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

// Creates a DirectionFinder with the region set to France.
var directionFinder = Maps.newDirectionFinder().setRegion('fr');

매개변수

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

리턴

DirectionFinder: 호출 체인을 용이하게 하는 DirectionFinder 객체

참고 항목

• Google Directions API