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 titik arah 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:

    Contoh lembar kerja Excel dengan tabel bernama TestData yang berisi informasi yang diperlukan untuk menempatkan pin titik arah di peta.

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

Ikat sumber data ke kontrol peta.

  1. Membuat aplikasi kanvas. Pastikan aplikasi memenuhi prasyarat Geospasial.

  2. Sisipkan kontrol peta.

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

    Tangkapan layar yang menunjukkan cara mencari titik arah sumber data untuk tersambung ke kontrol peta di Power Apps Studio.

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

    Tangkapan gambar dari panel pemilihan tabel.

  7. Pada tab Tingkat Lanjut, cari RouteWaypointsLabels, RouteWaypointsLatitudes, RouteWaypointsLongitudes, dan RouteWaypointsAddresses, lalu masukkan nama kolom terkait pada 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.

Tangkapan layar peta dengan titik arah yang disematkan dan berlabel ditampilkan di sebelah properti peta.

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.

Tangkapan layar peta dengan rute di antara titik 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 agar titik jalan tetap sesuai urutan yang sumber data, aktifkan properti Pertahankan urutan titik arah 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: RouteMaintainOrder
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: RouteTravelMode
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 diletakkan di objek RouteDirection. Aktivitas OnRouteDirectionChange adalah cara yang disarankan untuk menggunakan output pada 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