Class DirectionFinder

DirectionFinder

Memungkinkan pengambilan rute antarlokasi.
Contoh di bawah menunjukkan cara menggunakan class ini untuk mendapatkan rute dari Times Square ke Central Park, berhenti terlebih dahulu di Lincoln Center, buat plot lokasi dan jalur pada peta, dan kirim peta dalam email.

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

Lihat juga

• Google Directions API

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
addWaypoint(latitude, longitude)	DirectionFinder	Menambahkan titik jalan yang harus dilewati rute, menggunakan titik (lat/lng).
addWaypoint(address)	DirectionFinder	Menambahkan titik jalan yang harus dilewati rute, dengan 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 (default-nya adalah false).
setArrive(time)	DirectionFinder	Menetapkan waktu tiba yang diinginkan (jika ada).
setAvoid(avoid)	DirectionFinder	Menetapkan apakah akan menghindari jenis pembatasan tertentu.
setDepart(time)	DirectionFinder	Menetapkan waktu keberangkatan yang diinginkan (jika ada).
setDestination(latitude, longitude)	DirectionFinder	Menetapkan lokasi akhir yang akan digunakan untuk menghitung arah, menggunakan titik (lat/lng).
setDestination(address)	DirectionFinder	Menetapkan lokasi akhir yang akan digunakan untuk menghitung rute, menggunakan alamat.
setLanguage(language)	DirectionFinder	Menyetel bahasa yang akan digunakan untuk rute.
setMode(mode)	DirectionFinder	Menetapkan mode perjalanan (setelan defaultnya adalah mengemudi).
setOptimizeWaypoints(optimizeOrder)	DirectionFinder	Menetapkan apakah akan mengoptimalkan rute yang disediakan atau tidak dengan menyusun ulang titik jalan dalam urutan yang lebih efisien (default-nya adalah false).
setOrigin(latitude, longitude)	DirectionFinder	Menetapkan lokasi awal untuk menghitung arah rute, menggunakan titik (lat/lng).
setOrigin(address)	DirectionFinder	Menetapkan lokasi awal untuk menghitung rute, dengan menggunakan alamat.
setRegion(region)	DirectionFinder	Menetapkan wilayah yang akan digunakan saat menafsirkan nama lokasi.

Dokumentasi mendetail

addWaypoint(latitude, longitude)

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

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

Parameter

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

Return

DirectionFinder — Objek DirectionFinder untuk memfasilitasi perantaian panggilan.

---

addWaypoint(address)

Menambahkan titik jalan yang harus dilewati rute, dengan menggunakan alamat.

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

Parameter

Nama	Jenis	Deskripsi
address	String	Alamat.

Return

DirectionFinder — Objek DirectionFinder untuk memfasilitasi perantaian panggilan.

---

clearWaypoints()

Menghapus kumpulan titik jalan saat ini.

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

Return

DirectionFinder — objek DirectionFinder untuk memfasilitasi perantaian panggilan

---

getDirections()

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

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

Return

Object — objek JSON yang berisi kumpulan rute untuk rute, 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 (default-nya adalah false). Jika benar, array routes objek yang dihasilkan dapat berisi beberapa entri.

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

Parameter

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

Return

DirectionFinder — objek DirectionFinder untuk memfasilitasi perantaian panggilan

---

setArrive(time)

Menetapkan waktu tiba yang diinginkan (jika ada).

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

Parameter

Nama	Jenis	Deskripsi
time	Date	waktu tiba

Return

DirectionFinder — objek DirectionFinder untuk memfasilitasi perantaian panggilan

Lihat juga

• Google Directions API

---

setAvoid(avoid)

Menetapkan apakah akan menghindari jenis pembatasan tertentu.

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

Parameter

Nama	Jenis	Deskripsi
avoid	String	nilai konstanta dari Avoid

Return

DirectionFinder — objek DirectionFinder untuk memfasilitasi perantaian panggilan

Lihat juga

• Google Directions API

---

setDepart(time)

Menetapkan waktu keberangkatan yang diinginkan (jika ada).

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

Parameter

Nama	Jenis	Deskripsi
time	Date	waktu keberangkatan

Return

DirectionFinder — Objek DirectionFinder untuk memfasilitasi perantaian panggilan.

Lihat juga

• Google Directions API

---

setDestination(latitude, longitude)

Menetapkan lokasi akhir yang akan digunakan untuk menghitung arah, menggunakan titik (lat/lng).

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

Parameter

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

Return

DirectionFinder — objek DirectionFinder untuk memfasilitasi perantaian panggilan

---

setDestination(address)

Menetapkan lokasi akhir yang akan digunakan untuk menghitung rute, menggunakan alamat.

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

Parameter

Nama	Jenis	Deskripsi
address	String	alamat akhir

Return

DirectionFinder — objek DirectionFinder untuk memfasilitasi perantaian panggilan

---

setLanguage(language)

Menyetel bahasa yang akan digunakan untuk rute.

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

Parameter

Nama	Jenis	Deskripsi
language	String	pengidentifikasi bahasa BCP-47

Return

DirectionFinder — objek DirectionFinder untuk memfasilitasi perantaian panggilan

Lihat juga

• Dukungan Bahasa di Google Maps API

---

setMode(mode)

Menetapkan mode perjalanan (setelan defaultnya adalah mengemudi).

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

Parameter

Nama	Jenis	Deskripsi
mode	String	nilai konstanta dari Mode

Return

DirectionFinder — objek DirectionFinder untuk memfasilitasi perantaian panggilan

Lihat juga

• Google Directions API

---

setOptimizeWaypoints(optimizeOrder)

Menetapkan apakah akan mengoptimalkan rute yang disediakan atau tidak dengan menyusun ulang titik jalan dalam urutan yang lebih efisien (default-nya adalah false).

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

Parameter

Nama	Jenis	Deskripsi
optimizeOrder	Boolean	benar untuk mengoptimalkan urutan, atau salah untuk

Return

DirectionFinder — objek DirectionFinder untuk memfasilitasi perantaian panggilan

Lihat juga

• Google Directions API

---

setOrigin(latitude, longitude)

Menetapkan lokasi awal untuk menghitung arah rute, menggunakan titik (lat/lng).

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

Parameter

Nama	Jenis	Deskripsi
latitude	Number	garis lintang lokasi awal
longitude	Number	bujur lokasi awal

Return

DirectionFinder — objek DirectionFinder untuk memfasilitasi perantaian panggilan

---

setOrigin(address)

Menetapkan lokasi awal untuk menghitung rute, dengan menggunakan alamat.

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

Parameter

Nama	Jenis	Deskripsi
address	String	alamat awal

Return

DirectionFinder — instance DirectionFinder untuk memfasilitasi perantaian 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.
var directionFinder = Maps.newDirectionFinder().setRegion('fr');

Parameter

Nama	Jenis	Deskripsi
region	String	kode wilayah untuk menggunakan

Return

DirectionFinder — objek DirectionFinder untuk memfasilitasi perantaian panggilan

Lihat juga

• Google Directions API