Halaman ini diterjemahkan oleh Cloud Translation API.

Class DirectionFinder

Memungkinkan pengambilan rute antar-lokasi.
Contoh di bawah menunjukkan cara menggunakan class ini untuk mendapatkan rute dari Times Square ke Central Park, dengan berhenti terlebih dahulu di Lincoln Center, memetakan lokasi dan jalur di peta, dan mengirim peta melalui 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 hasil 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 lainnya yang telah ditetapkan.
`setAlternatives(useAlternatives)`	`DirectionFinder`	Menetapkan apakah rute alternatif harus ditampilkan atau tidak, bukan hanya rute dengan peringkat tertinggi (defaultnya adalah salah).
`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 untuk menghitung rute ke sana, menggunakan titik (lat/lng).
`setDestination(address)`	`DirectionFinder`	Menetapkan lokasi akhir untuk menghitung rute ke sana, menggunakan alamat.
`setLanguage(language)`	`DirectionFinder`	Menetapkan bahasa yang akan digunakan untuk rute.
`setMode(mode)`	`DirectionFinder`	Menetapkan mode perjalanan (defaultnya adalah berkendara).
`setOptimizeWaypoints(optimizeOrder)`	`DirectionFinder`	Menetapkan apakah akan mengoptimalkan rute yang disediakan atau tidak dengan menyusun ulang titik jalan dalam urutan yang lebih efisien (defaultnya salah).
`setOrigin(latitude, longitude)`	`DirectionFinder`	Menetapkan lokasi awal untuk menghitung rute, menggunakan titik (lat/lng).
`setOrigin(address)`	`DirectionFinder`	Menetapkan lokasi awal untuk menghitung rute, 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 pembuatan rantai 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 pembuatan rantai 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 pembuatan rantai panggilan

`getDirections()`

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

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

Pulang pergi

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 (defaultnya adalah salah). Jika benar, 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 pembuatan rantai 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 tiba

Pulang pergi

DirectionFinder — objek DirectionFinder untuk memfasilitasi pembuatan rantai 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 konstan dari `Avoid`

Pulang pergi

DirectionFinder — objek DirectionFinder untuk memfasilitasi pembuatan rantai 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 pembuatan rantai panggilan.

Lihat juga

Google Directions API

`setDestination(latitude, longitude)`

Menetapkan lokasi akhir untuk menghitung rute ke sana, 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`	lintang lokasi akhir
`longitude`	`Number`	garis bujur lokasi akhir

Pulang pergi

DirectionFinder — objek DirectionFinder untuk memfasilitasi pembuatan rantai panggilan

`setDestination(address)`

Menetapkan lokasi akhir untuk menghitung rute ke sana, 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 pembuatan rantai 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 pembuatan rantai panggilan

Lihat juga

Dukungan Bahasa di Google Maps API

`setMode(mode)`

Menetapkan mode perjalanan (defaultnya adalah berkendara).

// 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 konstan dari `Mode`

Pulang pergi

DirectionFinder — objek DirectionFinder untuk memfasilitasi pembuatan rantai 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 (defaultnya salah).

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

Parameter

Nama	Jenis	Deskripsi
`optimizeOrder`	`Boolean`	true untuk mengoptimalkan urutan, atau false jika tidak

Pulang pergi

DirectionFinder — objek DirectionFinder untuk memfasilitasi pembuatan rantai panggilan

Lihat juga

Google Directions API

`setOrigin(latitude, longitude)`

Menetapkan lokasi awal untuk menghitung rute, 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`	lintang lokasi awal
`longitude`	`Number`	garis bujur lokasi awal

Pulang pergi

DirectionFinder — objek DirectionFinder untuk memfasilitasi pembuatan rantai panggilan

`setOrigin(address)`

Menetapkan lokasi awal untuk menghitung rute, 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 rantai 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 pembuatan rantai panggilan

Lihat juga

Google Directions API