Class DirectionFinder

DirectionFinder

Memungkinkan pengambilan rute di antara lokasi.
Contoh di bawah menunjukkan cara menggunakan class ini untuk mendapatkan petunjuk arah dari Times Square ke Central Park, berhenti terlebih dahulu di Lincoln Center, memetakan lokasi dan jalur di peta, serta mengirim peta dalam email.

// 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'),
      },
    },
);

Lihat juga

• Google Directions API

Metode

Metode	Jenis nilai yang ditampilkan	Deskripsi singkat
addWaypoint(latitude, longitude)	DirectionFinder	Menambahkan titik jalan yang harus dilalui rute, menggunakan titik (lat/lng).
addWaypoint(address)	DirectionFinder	Menambahkan titik jalan yang harus dilalui rute, menggunakan alamat.
clearWaypoints()	DirectionFinder	Menghapus kumpulan titik jalan saat ini.
getDirections()	Object	Mendapatkan rute menggunakan asal, tujuan, dan opsi lain yang telah ditetapkan.
setAlternatives(useAlternatives)	DirectionFinder	Menetapkan apakah rute alternatif harus ditampilkan atau tidak, bukan hanya rute dengan peringkat tertinggi (defaultnya adalah false).
setArrive(time)	DirectionFinder	Menetapkan waktu tiba yang diinginkan (jika berlaku).
setAvoid(avoid)	DirectionFinder	Menetapkan apakah akan menghindari jenis batasan tertentu.
setDepart(time)	DirectionFinder	Menetapkan waktu keberangkatan yang diinginkan (jika berlaku).
setDestination(latitude, longitude)	DirectionFinder	Menetapkan lokasi akhir yang digunakan untuk menghitung rute ke lokasi tersebut, menggunakan titik (lat/lng).
setDestination(address)	DirectionFinder	Menetapkan lokasi akhir untuk menghitung rute ke lokasi tersebut, menggunakan alamat.
setLanguage(language)	DirectionFinder	Menetapkan bahasa yang akan digunakan untuk rute.
setMode(mode)	DirectionFinder	Menetapkan moda perjalanan (defaultnya adalah mengemudi).
setOptimizeWaypoints(optimizeOrder)	DirectionFinder	Menetapkan apakah akan mengoptimalkan rute yang disediakan dengan menyusun ulang titik jalan dalam urutan yang lebih efisien (defaultnya adalah false).
setOrigin(latitude, longitude)	DirectionFinder	Menetapkan lokasi awal dari mana arah akan dihitung, menggunakan titik (lat/lng).
setOrigin(address)	DirectionFinder	Menetapkan lokasi awal dari mana rute akan dihitung, menggunakan alamat.
setRegion(region)	DirectionFinder	Menetapkan wilayah yang akan digunakan saat menafsirkan nama lokasi.

Dokumentasi mendetail

addWaypoint(latitude, longitude)

Menambahkan titik jalan yang harus dilalui rute, menggunakan titik (lat/lng).

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

Parameter

Nama	Jenis	Deskripsi
latitude	Number	Lintang titik jalan.
longitude	Number	Bujur titik jalan.

Pulang pergi

DirectionFinder — Objek DirectionFinder untuk memfasilitasi pengaitan panggilan.

---

addWaypoint(address)

Menambahkan titik jalan yang harus dilalui rute, menggunakan alamat.

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

Parameter

Nama	Jenis	Deskripsi
address	String	Alamat.

Pulang pergi

DirectionFinder — Objek DirectionFinder untuk memfasilitasi pengaitan panggilan.

---

clearWaypoints()

Menghapus kumpulan titik jalan saat ini.

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

Pulang pergi

DirectionFinder — Objek DirectionFinder untuk memfasilitasi pengaitan panggilan.

---

getDirections()

Mendapatkan rute menggunakan asal, tujuan, dan opsi lain yang telah ditetapkan.

// Logs how long it takes 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);

Pulang pergi

Object — Objek JSON yang berisi kumpulan rute untuk petunjuk arah, seperti yang dijelaskan di sini.

Lihat juga

• Google Directions API

---

setAlternatives(useAlternatives)

Menetapkan apakah rute alternatif harus ditampilkan atau tidak, bukan hanya rute dengan peringkat tertinggi (defaultnya adalah false). Jika true, array routes objek yang dihasilkan dapat berisi beberapa entri.

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

Parameter

Nama	Jenis	Deskripsi
useAlternatives	Boolean	true untuk menampilkan rute alternatif, false jika tidak.

Pulang pergi

DirectionFinder — Objek DirectionFinder untuk memfasilitasi pengaitan panggilan.

---

setArrive(time)

Menetapkan waktu tiba yang diinginkan (jika berlaku).

// 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);

Parameter

Nama	Jenis	Deskripsi
time	Date	Waktu kedatangan.

Pulang pergi

DirectionFinder — Objek DirectionFinder untuk memfasilitasi pengaitan panggilan.

Lihat juga

• Google Directions API

---

setAvoid(avoid)

Menetapkan apakah akan menghindari jenis batasan tertentu.

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

Parameter

Nama	Jenis	Deskripsi
avoid	String	Nilai konstanta dari Avoid.

Pulang pergi

DirectionFinder — Objek DirectionFinder untuk memfasilitasi pengaitan panggilan.

Lihat juga

• Google Directions API

---

setDepart(time)

Menetapkan waktu keberangkatan yang diinginkan (jika berlaku).

// 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);

Parameter

Nama	Jenis	Deskripsi
time	Date	Waktu keberangkatan.

Pulang pergi

DirectionFinder — Objek DirectionFinder untuk memfasilitasi pengaitan panggilan.

Lihat juga

• Google Directions API

---

setDestination(latitude, longitude)

Menetapkan lokasi akhir yang digunakan untuk menghitung rute ke lokasi tersebut, menggunakan titik (lat/lng).

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

Parameter

Nama	Jenis	Deskripsi
latitude	Number	Garis lintang lokasi akhir.
longitude	Number	Garis bujur lokasi akhir.

Pulang pergi

DirectionFinder — Objek DirectionFinder untuk memfasilitasi pengaitan panggilan.

---

setDestination(address)

Menetapkan lokasi akhir untuk menghitung rute ke lokasi tersebut, menggunakan alamat.

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

Parameter

Nama	Jenis	Deskripsi
address	String	Alamat akhir.

Pulang pergi

DirectionFinder — Objek DirectionFinder untuk memfasilitasi pengaitan panggilan.

---

setLanguage(language)

Menetapkan bahasa yang akan digunakan untuk rute.

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

Parameter

Nama	Jenis	Deskripsi
language	String	ID bahasa BCP-47.

Pulang pergi

DirectionFinder — Objek DirectionFinder untuk memfasilitasi pengaitan panggilan.

Lihat juga

• Dukungan Bahasa di Google Maps API

---

setMode(mode)

Menetapkan moda perjalanan (defaultnya adalah mengemudi).

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

Parameter

Nama	Jenis	Deskripsi
mode	String	Nilai konstanta dari Mode.

Pulang pergi

DirectionFinder — Objek DirectionFinder untuk memfasilitasi pengaitan panggilan.

Lihat juga

• Google Directions API

---

setOptimizeWaypoints(optimizeOrder)

Menetapkan apakah akan mengoptimalkan rute yang disediakan dengan menyusun ulang titik jalan dalam urutan yang lebih efisien (defaultnya adalah false).

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

Parameter

Nama	Jenis	Deskripsi
optimizeOrder	Boolean	true untuk mengoptimalkan pesanan, atau false jika tidak.

Pulang pergi

DirectionFinder — Objek DirectionFinder untuk memfasilitasi pengaitan panggilan.

Lihat juga

• Google Directions API

---

setOrigin(latitude, longitude)

Menetapkan lokasi awal dari mana arah akan dihitung, menggunakan titik (lat/lng).

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

Parameter

Nama	Jenis	Deskripsi
latitude	Number	Garis lintang lokasi awal.
longitude	Number	Garis bujur lokasi awal.

Pulang pergi

DirectionFinder — Objek DirectionFinder untuk memfasilitasi pengaitan panggilan.

---

setOrigin(address)

Menetapkan lokasi awal dari mana rute akan dihitung, menggunakan alamat.

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

Parameter

Nama	Jenis	Deskripsi
address	String	Alamat awal.

Pulang pergi

DirectionFinder — Instance DirectionFinder untuk memfasilitasi rangkaian panggilan.

---

setRegion(region)

Menetapkan wilayah yang akan digunakan saat menafsirkan nama lokasi. Kode wilayah yang didukung sesuai dengan ccTLD yang didukung oleh Google Maps. Misalnya, kode wilayah "uk" sesuai dengan "maps.google.co.uk".

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

Parameter

Nama	Jenis	Deskripsi
region	String	Kode wilayah yang akan digunakan.

Pulang pergi

DirectionFinder — Objek DirectionFinder untuk memfasilitasi pengaitan panggilan.

Lihat juga

• Google Directions API