Menghitung rute di antara pin titik arah pada peta (pratinjau)

[Topik ini adalah dokumentasi prarilis dan dapat berubah.]

Kontrol peta dalam aplikasi kanvas dapat menambahkan pin titik arah menggunakan data yang diimpor dari tabel di buku kerja Excel. Kontrol dapat menghitung rute antara titik titik arah, menyusun ulang titik arah, dan menghitung ulang rute untuk meningkatkan waktu perjalanan atau jarak.

Penting

• Ini adalah fitur pratinjau.
• Fitur pratinjau tidak dibuat untuk penggunaan produksi dan mungkin memiliki fungsionalitas yang dibatasi. Fitur ini tersedia sebelum rilis resmi agar pelanggan bisa memperoleh akses awal dan memberikan tanggapan.

Anda memerlukan daftar sumber data berisi tabel bernama dengan kolom berikut. Setiap kolom berkaitan dengan properti lanjutan kontrol peta. Setiap baris disematkan sebagai titik arah di peta.

Nama kolom	Berkaitan dengan	Wajib
Nama (atau label)	RouteWaypointsLabels	Opsional
Bujur	RouteWaypointsLongitudes	Opsional (diperlukan jika Alamat tidak diberikan)
Lintang	RouteWaypointsLatitudes	Opsional (diperlukan jika Alamat tidak diberikan)
Alamat	RouteWaypointsAddresses	Opsional (diperlukan jika Garis Bujur dan Garis Lintang tidak diberikan)

Catatan

Semua properti bersifat opsional secara teknis. Namun, sekurangnya salah satu alamat atau garis lintang/garis bujur harus diberikan agar lokasi titik titik arah diplot.

Mengimpor pin titik arah dari tabel Excel

Dalam contoh ini, kita akan mengimpor data waypoint dari tabel Excel bernama TestData.

Buat sumber data

1. Buat tabel di Excel dengan data berikut. Beri nama tabel TestData.

   Nama	Bujur	Lintang	Alamat
   Kerja	-122.156481	47.663448	1 Microsoft Way, Redmond, WA 98052
   Pertemuan	-122.221037	47.57137
   Berenang	-122.144133	47.600373
   Tenis	-122.137265	47.616115

   Tabel Anda seharusnya akan terlihat seperti ini:

   

2. Simpan buku kerja ke OneDrive for Business dan tutup file.

Ikat sumber data ke kontrol peta.

1. Buat aplikasi kanvas. Pastikan memenuhi prasyarat geospasial.

2. Sisipkan kontrol peta.

3. Pada tab Properti kontrol , pilih kotak Route waypoints(Items) dan ketik excel.

   

4. Pilih Impor dari Excel.

5. Navigasikan ke OneDrive for Business lalu pilih buku kerja Excel yang Anda simpan sebelumnya.

6. Pilih tabel TestData, lalu pilih Hubungkan.

   

7. Pada tab Lanjutan, temukan RouteWaypointsLabels,RouteWaypointsLatitudes,RouteWaypointsLongitudes, dan RouteWaypointsAddressesdan masukkan nama kolom yang sesuai dalam tabel. (Dalam contoh ini, masukkan Nama di RouteWaypointsLabels,Latitude di RouteWaypointsLatitudes , dan sebagainya.) Lampirkan nama kolom dalam tanda kutip.

   Catatan

   Alamat dapat saling dipertukarkan dengan Garis Lintang dan Garis Bujur. Jika Garis Lintang dan Garis Bujur diberikan, maka Alamat tidak digunakan. Jika alamat diberikan, maka garis lintang dan garis bujur tidak dibutuhkan. Ada batas jumlah titik arah yang dapat ditampilkan saat menggunakan alamat, jadi gunakan Garis Lintang dan Garis Bujur bila mungkin.

Pin akan muncul di peta di lokasi yang dijelaskan berdasarkan koordinat atau alamat pada tabel. Jika tabel menyertakan label, pin akan diberi label. Pin dinomori dalam urutan lokasi titik arah muncul dalam tabel.

Hitung rute di antara titik arah

Dengan kontrol peta yang dipilih, buka tab Properti dan aktifkan Aktifkan perutean.

Kontrol menghitung rute antara titik arah yang disematkan.

Catatan

Secara default, kontrol peta menyusun ulang titik arah tengah untuk mengurangi waktu perjalanan atau jarak tempuh. Titik arah pertama dan terakhir dianggap sebagai asal dan tujuan dan tidak dapat diurutkan ulang. Untuk menjaga titik jalan dalam urutan yang diberikan dalam sumber data, aktifkan properti Pertahankan pesanan titik jalan kontrol .

Properti

Mengubah cara penghitungan rute menggunakan properti.

Properti	Description	Tipe	Tab
Aktifkan perutean	Menghitung rute di antara titik arah.	Boolean	Properti; Lanjutan: UseRouting
Pertahankan urutan titik arah	Menentukan apakah rute hitung akan mempertahankan titik arah dalam urutan yang diberikan dalam sumber data.	Boolean	Properti; Lanjutan: RuteMaintainOrder
Optimalkan rute	Menentukan apakah rute hitung dioptimalkan untuk jarak, waktu, atau tidak dioptimalkan.	Daftar tarik-turun	Properti; Lanjutan: RouteOptimization
Rutekan mode perjalanan	Menentukan apakah rute dihitung untuk mobil atau truk, yang mungkin memerlukan menghindari jembatan dengan batasan tinggi atau berat tertentu.	Daftar tarik-turun	Properti; Lanjutan: RuteTravelMode
Tampilkan Pin Rute	Menentukan apakah pin ditampilkan pada titik arah rute.	Boolean	Properti; Lanjutan: ShowRoutePins

Properti output

Beberapa properti menjadi hanya tersedia bila rute hitung berubah. Properti output ini ditempatkan di objek RouteDirection . Peristiwa OnRouteDirectionChange adalah cara yang direkomendasikan untuk menggunakan output di kontrol lain atau untuk menyesuaikan pengalaman aplikasi.

Properti	Description	Tipe	Tab
OnRouteDirectionChange	Berisi kode yang berjalan saat rute diubah.	Kejadian	Tingkat lanjut
RouteDirection	Menjelaskan output perutean: LengthInMeters: panjang dalam beberapa kilometer dari seluruh rute TravelTimeInSeconds: waktu perjalanan yang diperkirakan dalam detik dari seluruh rute RouteGeoJSON: String yang mendeskripsikan rute dalam format GeoJSON RouteLegs: tabel yang menjelaskan setiap kaki rute: Indeks: jumlah yang mewakili urutan kaki dalam rute LengthInMeters: Panjang kaki dalam meter TravelTimeInSeconds: waktu perjalanan kaki dalam detik StartLabel: label titik mulai kaki StartLatitude: Garis lintang titik mulai kaki StartLongitude: Garis bujur titik awal kaki StartAddress: Alamat titik awal kaki EndLabel: label titik akhir kaki EndLatitude: garis lintang titik akhir kaki EndLongitude: garis bujur titik akhir kaki EndAddress: alamat titik akhir kaki OrderedWaypoints: Tabel yang menjelaskan setiap titik arah setelah titik arah diurutkan: Indeks: jumlah yang mewakili urutan titik arah dalam rute Label: label titik arah Garis lintang: garis lintang titik arah Garis Bujur: garis bujur titik arah Alamat: alamat titik arah	Objek	Tidak berlaku (hanya properti output)

Baca juga

Kontrol peta interaktif