หน้านี้ได้รับการแปลโดย Cloud Translation API

Class DirectionFinder

อนุญาตให้ดึงข้อมูลเส้นทางระหว่างสถานที่ต่างๆ
ตัวอย่างด้านล่างแสดงวิธีใช้คลาสนี้เพื่อขอเส้นทางจากไทม์สแควร์ไปเซ็นทรัลปาร์ก โดยแวะพักที่ลินคอล์นเซ็นเตอร์ก่อน วางตำแหน่งและเส้นทางบนแผนที่ และส่งแผนที่ทางอีเมล

// Get the directions.
const 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();
const route = directions.routes[0];

// Set up marker styles.

let markerLetterCode = 'A'.charCodeAt();

// Add markers to the map.
const map = Maps.newStaticMap();
for (let i = 0; i < route.legs.length; i++) {
  const leg = route.legs[i];
  if (i === 0) {
    // Add a marker for the start location of the first leg only.
    map.setMarkerStyle(
        Maps.StaticMap.MarkerSize.MID,
        Maps.StaticMap.Color.GREEN,
        String.fromCharCode(markerLetterCode),
    );
    map.addMarker(leg.start_location.lat, leg.start_location.lng);
    markerLetterCode++;
  }
  map.setMarkerStyle(
      Maps.StaticMap.MarkerSize.MID,
      Maps.StaticMap.Color.GREEN,
      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.
const 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`	เพิ่มจุดอ้างอิงที่เส้นทางต้องผ่านโดยใช้จุด (lat/lng)
`addWaypoint(address)`	`DirectionFinder`	เพิ่มจุดสังเกตที่เส้นทางต้องผ่านโดยใช้ที่อยู่
`clearWaypoints()`	`DirectionFinder`	ล้างชุดจุดแวะพักปัจจุบัน
`getDirections()`	`Object`	รับเส้นทางโดยใช้ต้นทาง ปลายทาง และตัวเลือกอื่นๆ ที่ตั้งไว้
`setAlternatives(useAlternatives)`	`DirectionFinder`	ตั้งค่าว่าควรแสดงเส้นทางอื่นแทนเส้นทางที่มีอันดับสูงสุดหรือไม่ (ค่าเริ่มต้นคือเท็จ)
`setArrive(time)`	`DirectionFinder`	กำหนดเวลาที่ต้องการถึง (หากมี)
`setAvoid(avoid)`	`DirectionFinder`	ตั้งค่าว่าจะหลีกเลี่ยงข้อจำกัดบางประเภทหรือไม่
`setDepart(time)`	`DirectionFinder`	ตั้งค่าเวลาออกเดินทางที่ต้องการ (หากมี)
`setDestination(latitude, longitude)`	`DirectionFinder`	กำหนดสถานที่สิ้นสุดที่จะคำนวณเส้นทางโดยใช้จุด (lat/lng)
`setDestination(address)`	`DirectionFinder`	กำหนดสถานที่สิ้นสุดที่จะคำนวณเส้นทางโดยใช้ที่อยู่
`setLanguage(language)`	`DirectionFinder`	ตั้งค่าภาษาที่จะใช้สำหรับเส้นทาง
`setMode(mode)`	`DirectionFinder`	กำหนดโหมดการเดินทาง (ค่าเริ่มต้นคือขับรถ)
`setOptimizeWaypoints(optimizeOrder)`	`DirectionFinder`	ตั้งค่าว่าจะเพิ่มประสิทธิภาพเส้นทางที่ระบุหรือไม่โดยการจัดเรียงจุดแวะพักใหม่ในลำดับที่มีประสิทธิภาพมากขึ้น (ค่าเริ่มต้นคือเท็จ)
`setOrigin(latitude, longitude)`	`DirectionFinder`	กำหนดตำแหน่งเริ่มต้นที่จะคำนวณเส้นทางโดยใช้จุด (lat/lng)
`setOrigin(address)`	`DirectionFinder`	กำหนดจุดเริ่มต้นที่จะคำนวณเส้นทางโดยใช้ที่อยู่
`setRegion(region)`	`DirectionFinder`	ตั้งค่าภูมิภาคที่จะใช้เมื่อตีความชื่อสถานที่

เอกสารประกอบโดยละเอียด

`addWaypoint(latitude, longitude)`

เพิ่มจุดอ้างอิงที่เส้นทางต้องผ่านโดยใช้จุด (lat/lng)

// Creates a DirectionFinder with a wapoint at Lincoln Center.
const 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.
const directionFinder = Maps.newDirectionFinder().addWaypoint(
    'Lincoln Center, New York, NY',
);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`address`	`String`	ที่อยู่

รีเทิร์น

DirectionFinder — ออบเจ็กต์ DirectionFinder เพื่อช่วยให้การเรียกใช้แบบต่อเนื่องง่ายขึ้น

`clearWaypoints()`

ล้างชุดจุดแวะพักปัจจุบัน

const 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.
const 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)`

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

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

พารามิเตอร์

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

รีเทิร์น

DirectionFinder — ออบเจ็กต์ DirectionFinder เพื่อช่วยในการต่อสายเรียกเข้า

`setArrive(time)`

กำหนดเวลาที่ต้องการถึง (หากมี)

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`time`	`Date`	เวลาถึง

รีเทิร์น

DirectionFinder — ออบเจ็กต์ DirectionFinder เพื่อช่วยในการต่อสายเรียกเข้า

ดูเพิ่มเติม

Google Directions API

`setAvoid(avoid)`

ตั้งค่าว่าจะหลีกเลี่ยงข้อจำกัดบางประเภทหรือไม่

// Creates a DirectionFinder that avoid highways.
const 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.
const now = new Date();
const depart = new Date(now.getTime() + 1 * 60 * 60 * 1000);
const directionFinder = Maps.newDirectionFinder().setDepart(depart);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`time`	`Date`	เวลาออกเดินทาง

รีเทิร์น

DirectionFinder — ออบเจ็กต์ DirectionFinder เพื่อช่วยให้การเรียกใช้แบบต่อเนื่องง่ายขึ้น

ดูเพิ่มเติม

Google Directions API

`setDestination(latitude, longitude)`

ตั้งค่าสถานที่สิ้นสุดที่จะคำนวณเส้นทางโดยใช้จุด (lat/lng)

// Creates a DirectionFinder with the destination set to Central Park.
const 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.
const directionFinder = Maps.newDirectionFinder().setDestination(
    'Central Park, New York, NY',
);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`address`	`String`	ที่อยู่สิ้นสุด

รีเทิร์น

DirectionFinder — ออบเจ็กต์ DirectionFinder เพื่อช่วยในการต่อสายเรียกเข้า

`setLanguage(language)`

ตั้งค่าภาษาที่จะใช้สำหรับเส้นทาง

// Creates a DirectionFinder with the language set to French.
const 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.
const directionFinder = Maps.newDirectionFinder().setMode(
    Maps.DirectionFinder.Mode.WALKING,
);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`mode`	`String`	ค่าคงที่จาก `Mode`

รีเทิร์น

DirectionFinder — ออบเจ็กต์ DirectionFinder เพื่อช่วยในการต่อสายเรียกเข้า

ดูเพิ่มเติม

Google Directions API

`setOptimizeWaypoints(optimizeOrder)`

ตั้งค่าว่าจะเพิ่มประสิทธิภาพเส้นทางที่ระบุหรือไม่โดยการจัดเรียงจุดแวะพักใหม่ในลำดับที่มีประสิทธิภาพมากขึ้น (ค่าเริ่มต้นคือเท็จ)

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`optimizeOrder`	`Boolean`	จริงเพื่อเพิ่มประสิทธิภาพลําดับ หรือเท็จหากไม่

รีเทิร์น

DirectionFinder — ออบเจ็กต์ DirectionFinder เพื่อช่วยในการต่อสายเรียกเข้า

ดูเพิ่มเติม

Google Directions API

`setOrigin(latitude, longitude)`

กำหนดตำแหน่งเริ่มต้นที่จะคำนวณเส้นทางโดยใช้จุด (lat/lng)

// Creates a DirectionFinder with the origin set to Times Square.
const 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.
const 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.
const directionFinder = Maps.newDirectionFinder().setRegion('fr');

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`region`	`String`	รหัสภูมิภาคที่จะใช้

รีเทิร์น

DirectionFinder — ออบเจ็กต์ DirectionFinder เพื่อช่วยในการต่อสายเรียกเข้า

ดูเพิ่มเติม

Google Directions API