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 경로 API

방법

메서드	반환 유형	간략한 설명
addWaypoint(latitude, longitude)	DirectionFinder	지점 (위도/경도)을 사용하여 경로가 통과해야 하는 경유지를 추가합니다.
addWaypoint(address)	DirectionFinder	주소를 사용하여 경로가 통과해야 하는 경유지를 추가합니다.
clearWaypoints()	DirectionFinder	현재 경유지 집합을 지웁니다.
getDirections()	Object	출발지, 목적지 및 설정된 기타 옵션을 사용하여 경로를 가져옵니다.
setAlternatives(useAlternatives)	DirectionFinder	최고 순위 경로만 반환하는 대신 대체 경로를 반환해야 하는지 여부를 설정합니다 (기본값은 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 경로 API

---

setAlternatives(useAlternatives)

최고 순위 경로만 반환하는 대신 대체 경로를 반환해야 하는지 여부를 설정합니다 (기본값은 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 경로 API

---

setAvoid(avoid)

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

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

매개변수

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

리턴

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

참고 항목

• Google 경로 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 경로 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 경로 API

---

setOptimizeWaypoints(optimizeOrder)

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

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

매개변수

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

리턴

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

참고 항목

• Google 경로 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 경로 API