Class DirectionFinder

DirectionFinder

Memungkinkan pengambilan rute antarlokasi.
Contoh di bawah menunjukkan cara menggunakan kelas ini untuk mendapatkan rute dari Times Square ke Central Park, berhenti dulu di Lincoln Center, merencanakan lokasi dan jalur pada peta, lalu mengirimnya peta melalui 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

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
addWaypoint(latitude, longitude)DirectionFinderMenambahkan titik jalan yang harus dilewati rute, menggunakan titik (lat/lng).
addWaypoint(address)DirectionFinderMenambahkan titik jalan yang harus dilewati rute, menggunakan alamat.
clearWaypoints()DirectionFinderMengosongkan kumpulan titik jalan saat ini.
getDirections()ObjectMendapatkan rute menggunakan asal, tujuan, dan opsi lain yang ditetapkan.
setAlternatives(useAlternatives)DirectionFinderMenetapkan apakah rute alternatif harus ditampilkan atau tidak, bukan hanya peringkat tertinggi rute (default-nya adalah false).
setArrive(time)DirectionFinderMenetapkan waktu tiba yang diinginkan (jika berlaku).
setAvoid(avoid)DirectionFinderMenetapkan apakah akan menghindari jenis pembatasan tertentu.
setDepart(time)DirectionFinderMenetapkan waktu keberangkatan yang diinginkan (jika berlaku).
setDestination(latitude, longitude)DirectionFinderMenetapkan lokasi akhir untuk menghitung rute, menggunakan titik (lat/lng).
setDestination(address)DirectionFinderMenetapkan lokasi akhir untuk menghitung rute, menggunakan alamat.
setLanguage(language)DirectionFinderMenetapkan bahasa yang akan digunakan untuk rute.
setMode(mode)DirectionFinderMenetapkan mode perjalanan (default-nya adalah mengemudi).
setOptimizeWaypoints(optimizeOrder)DirectionFinderMenetapkan apakah akan mengoptimalkan rute yang disediakan atau tidak dengan menyusun ulang titik jalan dalam urutan yang efisien (default-nya adalah false).
setOrigin(latitude, longitude)DirectionFinderMenetapkan lokasi awal untuk menghitung rute, menggunakan titik (lat/lng).
setOrigin(address)DirectionFinderMenetapkan lokasi awal untuk menghitung rute, menggunakan alamat.
setRegion(region)DirectionFinderMenetapkan 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

NamaJenisDeskripsi
latitudeNumberLintang titik jalan.
longitudeNumberBujur titik jalan.

Pulang pergi

DirectionFinder — Objek DirectionFinder untuk memfasilitasi perantaian panggilan.


addWaypoint(address)

Menambahkan titik jalan yang harus dilewati rute, menggunakan alamat.

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

Parameter

NamaJenisDeskripsi
addressStringAlamat.

Pulang pergi

DirectionFinder — Objek DirectionFinder untuk memfasilitasi perantaian panggilan.


clearWaypoints()

Mengosongkan kumpulan titik jalan saat ini.

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

Pulang pergi

DirectionFinder — objek DirectionFinder untuk memfasilitasi perantaian panggilan


getDirections()

Mendapatkan rute menggunakan asal, tujuan, dan opsi lain yang 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);

Pulang pergi

Object — objek JSON yang berisi kumpulan rute untuk rute, seperti yang dijelaskan di sini

Lihat juga


setAlternatives(useAlternatives)

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

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

Parameter

NamaJenisDeskripsi
useAlternativesBooleantrue untuk menampilkan rute alternatif, false jika tidak

Pulang pergi

DirectionFinder — objek DirectionFinder untuk memfasilitasi perantaian panggilan


setArrive(time)

Menetapkan waktu tiba yang diinginkan (jika berlaku).

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

NamaJenisDeskripsi
timeDatewaktu tiba

Pulang pergi

DirectionFinder — objek DirectionFinder untuk memfasilitasi perantaian panggilan

Lihat juga


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

NamaJenisDeskripsi
avoidStringnilai konstanta dari Avoid

Pulang pergi

DirectionFinder — objek DirectionFinder untuk memfasilitasi perantaian panggilan

Lihat juga


setDepart(time)

Menetapkan waktu keberangkatan yang diinginkan (jika berlaku).

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

NamaJenisDeskripsi
timeDatewaktu keberangkatan

Pulang pergi

DirectionFinder — Objek DirectionFinder untuk memfasilitasi perantaian panggilan.

Lihat juga


setDestination(latitude, longitude)

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

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

Parameter

NamaJenisDeskripsi
latitudeNumberlintang lokasi akhir
longitudeNumberbujur lokasi akhir

Pulang pergi

DirectionFinder — objek DirectionFinder untuk memfasilitasi perantaian panggilan


setDestination(address)

Menetapkan lokasi akhir 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

NamaJenisDeskripsi
addressStringalamat akhir

Pulang pergi

DirectionFinder — objek DirectionFinder untuk memfasilitasi perantaian panggilan


setLanguage(language)

Menetapkan bahasa yang akan digunakan untuk rute.

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

Parameter

NamaJenisDeskripsi
languageStringID bahasa BCP-47

Pulang pergi

DirectionFinder — objek DirectionFinder untuk memfasilitasi perantaian panggilan

Lihat juga


setMode(mode)

Menetapkan mode perjalanan (default-nya adalah mengemudi).

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

Parameter

NamaJenisDeskripsi
modeStringnilai konstanta dari Mode

Pulang pergi

DirectionFinder — objek DirectionFinder untuk memfasilitasi perantaian panggilan

Lihat juga


setOptimizeWaypoints(optimizeOrder)

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

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

Parameter

NamaJenisDeskripsi
optimizeOrderBooleantrue untuk mengoptimalkan pesanan, atau false jika tidak

Pulang pergi

DirectionFinder — objek DirectionFinder untuk memfasilitasi perantaian panggilan

Lihat juga


setOrigin(latitude, longitude)

Menetapkan lokasi awal untuk menghitung 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

NamaJenisDeskripsi
latitudeNumberlintang lokasi awal
longitudeNumberbujur lokasi awal

Pulang pergi

DirectionFinder — objek DirectionFinder untuk memfasilitasi perantaian panggilan


setOrigin(address)

Menetapkan lokasi awal untuk menghitung rute, menggunakan alamat.

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

Parameter

NamaJenisDeskripsi
addressStringalamat awal

Pulang pergi

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

NamaJenisDeskripsi
regionStringkode wilayah untuk menggunakan

Pulang pergi

DirectionFinder — objek DirectionFinder untuk memfasilitasi perantaian panggilan

Lihat juga