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