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	กำหนดว่าควรแสดงเส้นทางอื่นหรือไม่ แทนที่จะแสดงเฉพาะอันดับสูงสุด เส้นทาง (ค่าเริ่มต้นคือ 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)

กำหนดว่าควรแสดงเส้นทางอื่นหรือไม่ แทนที่จะแสดงเฉพาะอันดับสูงสุด เส้นทาง (ค่าเริ่มต้นคือ false) หากเป็นจริง อาร์เรย์ routes ของออบเจ็กต์ผลลัพธ์อาจ มีหลายรายการ

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
useAlternatives	Boolean	true เพื่อส่งคืนเส้นทางอื่น เป็นเท็จ หากไม่เป็นเช่นนั้น

รีเทิร์น

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 Maps 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	"จริง" เพื่อเพิ่มประสิทธิภาพลำดับ หรือ "เท็จ" หากไม่เป็นเช่นนั้น

รีเทิร์น

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)

ตั้งค่าภูมิภาคที่จะใช้เมื่อแปลความหมายชื่อตำแหน่ง รหัสภูมิภาคที่รองรับสอดคล้องกับ ccTLD ที่ Google Maps รองรับ เช่น รหัสภูมิภาค "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