RouteURL class

RouteURL mewakili URL ke operasi rute Azure Maps.

Extends

Konstruktor

RouteURL(Pipeline, string)

Membuat instans RouteURL.

Properti yang Diwariskan

mapsUrl

Nilai string URL dasar.

Metode

calculateRouteDirections(Aborter, GeoJSON.Position[], CalculateRouteDirectionsOptions)

Mengembalikan rute antara asal dan tujuan, melewati titik arah jika ditentukan. Rute akan memperhitungkan faktor-faktor seperti lalu lintas saat ini dan kecepatan jalan yang khas pada hari yang diminta dalam seminggu dan waktu hari. Informasi yang dikembalikan mencakup jarak, perkiraan waktu perjalanan, dan representasi geometri rute. Informasi perutean tambahan seperti urutan titik arah yang dioptimalkan atau instruksi putar berdasarkan giliran juga tersedia, tergantung pada opsi yang dipilih.

Layanan perutean menyediakan serangkaian parameter untuk deskripsi terperinci tentang Model Konsumsi khusus kendaraan. Silakan periksa Model Konsumsi untuk penjelasan terperinci tentang konsep dan parameter yang terlibat.

Jika options.postBody ditentukan menggunakan POST Route Directions API: https://docs.microsoft.com/rest/api/maps/route/postroutedirections

Jika tidak, gunakan Get Route Directions API: https://docs.microsoft.com/rest/api/maps/route/getroutedirections

calculateRouteMatrix(Aborter, CalculateRouteMatrixRequestBody, CalculateRouteMatrixOptions)

Catatan: API ini saat ini dalam pratinjau dan mungkin dapat merusak perubahan. Menghitung matriks ringkasan rute untuk sekumpulan rute yang ditentukan oleh lokasi asal dan tujuan. Untuk setiap asal yang diberikan, layanan ini menghitung biaya perutean dari asal tersebut ke setiap tujuan tertentu. Kumpulan asal dan kumpulan tujuan dapat dianggap sebagai header kolom dan baris tabel dan setiap sel dalam tabel berisi biaya perutean dari asal ke tujuan untuk sel tersebut. Untuk setiap rute, waktu dan jarak perjalanan dihitung. Anda dapat menggunakan biaya komputasi untuk menentukan rute mana yang akan dihitung menggunakan API Arah Perutean. Jika parameter waitForResults dalam permintaan diatur ke false (nilai default), API ini mengembalikan kode respons 202 bersama URL pengalihan di bidang Lokasi header respons. URL ini harus diperiksa secara berkala sampai data respons atau informasi kesalahan tersedia. Ukuran maksimum matriks untuk API ini adalah 700 (jumlah asal dikalikan dengan jumlah tujuan). Dengan ingat batasan itu, contoh dimensi matriks yang mungkin adalah: 50x10, 10x10, 28x25. 10x70 (tidak perlu persegi).

Menghitung matriks rute dianggap sebagai operasi yang berjalan lama. Operasi yang berjalan lama menyiratkan bahwa setelah permintaan awal diterima (HTTP 202) hasil akhir akan dijajaki hingga tersedia. Setiap permintaan polling memulai ulang batas waktu aborter, jika ditentukan.

Menggunakan POST Route Matrix API: https://docs.microsoft.com/rest/api/maps/route/postroutematrixpreview

calculateRouteRange(Aborter, GeoJSON.Position, CalculateRouteRangeOptions)

Hitung sekumpulan lokasi yang dapat dicapai dari titik asal berdasarkan anggaran bahan bakar, energi, atau waktu yang ditentukan. Batas poligon (atau Isochrone) dikembalikan dalam orientasi berlawanan arah jarang serta pusat poligon yang tepat yang merupakan hasil dari titik asal. Poligon yang dikembalikan dapat digunakan untuk pemrosesan lebih lanjut seperti Search Inside Geometry untuk mencari POI dalam Isochrone yang disediakan.

Menggunakan Get Route Range API: https://docs.microsoft.com/rest/api/maps/route/getrouterange

Metode yang Diwarisi

newPipeline(Credential, INewPipelineOptions)

Metode statis yang digunakan untuk membuat objek Alur baru dengan Kredensial yang disediakan.

Detail Konstruktor

RouteURL(Pipeline, string)

Membuat instans RouteURL.

new RouteURL(pipeline: Pipeline, mapsUrl?: string)

Parameter

pipeline
Pipeline

Panggil MapsURL.newPipeline() untuk membuat alur default, atau sediakan alur yang disesuaikan.

mapsUrl

string

String URL yang menunjuk ke layanan Azure Maps, defaultnya adalah "https://atlas.microsoft.com". Jika tidak ada protokol yang ditentukan, misalnya "atlas.microsoft.com", maka https akan diasumsikan.

Detail Properti yang Diwariskan

mapsUrl

Nilai string URL dasar.

mapsUrl: string

Nilai Properti

string

Diwarisi DariMapsURL.mapsUrl

Detail Metode

calculateRouteDirections(Aborter, GeoJSON.Position[], CalculateRouteDirectionsOptions)

Mengembalikan rute antara asal dan tujuan, melewati titik arah jika ditentukan. Rute akan memperhitungkan faktor-faktor seperti lalu lintas saat ini dan kecepatan jalan yang khas pada hari yang diminta dalam seminggu dan waktu hari. Informasi yang dikembalikan mencakup jarak, perkiraan waktu perjalanan, dan representasi geometri rute. Informasi perutean tambahan seperti urutan titik arah yang dioptimalkan atau instruksi putar berdasarkan giliran juga tersedia, tergantung pada opsi yang dipilih.

Layanan perutean menyediakan serangkaian parameter untuk deskripsi terperinci tentang Model Konsumsi khusus kendaraan. Silakan periksa Model Konsumsi untuk penjelasan terperinci tentang konsep dan parameter yang terlibat.

Jika options.postBody ditentukan menggunakan POST Route Directions API: https://docs.microsoft.com/rest/api/maps/route/postroutedirections

Jika tidak, gunakan Get Route Directions API: https://docs.microsoft.com/rest/api/maps/route/getroutedirections

function calculateRouteDirections(aborter: Aborter, coordinates: GeoJSON.Position[], options?: CalculateRouteDirectionsOptions): Promise<CalculateRouteDirectionsResponse>

Parameter

aborter
Aborter

Buat instans Aborter baru dengan Aborter.none atau Aborter.timeout(), goto dokumen Aborter untuk contoh selengkapnya tentang pembatalan permintaan.

coordinates

GeoJSON.Position[]

Array koordinat tempat rute dihitung. Setiap koordinat adalah array dari [longitude, latitude]. Diperlukan minimal dua koordinat. Yang pertama adalah asal dan yang terakhir adalah tujuan rute. Koordinat opsional di antara bertindak sebagai WayPoints dalam rute. Anda dapat meneruskan hingga 150 WayPoints.

Mengembalikan

calculateRouteMatrix(Aborter, CalculateRouteMatrixRequestBody, CalculateRouteMatrixOptions)

Catatan: API ini saat ini dalam pratinjau dan mungkin dapat merusak perubahan. Menghitung matriks ringkasan rute untuk sekumpulan rute yang ditentukan oleh lokasi asal dan tujuan. Untuk setiap asal yang diberikan, layanan ini menghitung biaya perutean dari asal tersebut ke setiap tujuan tertentu. Kumpulan asal dan kumpulan tujuan dapat dianggap sebagai header kolom dan baris tabel dan setiap sel dalam tabel berisi biaya perutean dari asal ke tujuan untuk sel tersebut. Untuk setiap rute, waktu dan jarak perjalanan dihitung. Anda dapat menggunakan biaya komputasi untuk menentukan rute mana yang akan dihitung menggunakan API Arah Perutean. Jika parameter waitForResults dalam permintaan diatur ke false (nilai default), API ini mengembalikan kode respons 202 bersama URL pengalihan di bidang Lokasi header respons. URL ini harus diperiksa secara berkala sampai data respons atau informasi kesalahan tersedia. Ukuran maksimum matriks untuk API ini adalah 700 (jumlah asal dikalikan dengan jumlah tujuan). Dengan ingat batasan itu, contoh dimensi matriks yang mungkin adalah: 50x10, 10x10, 28x25. 10x70 (tidak perlu persegi).

Menghitung matriks rute dianggap sebagai operasi yang berjalan lama. Operasi yang berjalan lama menyiratkan bahwa setelah permintaan awal diterima (HTTP 202) hasil akhir akan dijajaki hingga tersedia. Setiap permintaan polling memulai ulang batas waktu aborter, jika ditentukan.

Menggunakan POST Route Matrix API: https://docs.microsoft.com/rest/api/maps/route/postroutematrixpreview

function calculateRouteMatrix(aborter: Aborter, body: CalculateRouteMatrixRequestBody, options?: CalculateRouteMatrixOptions): Promise<CalculateRouteMatrixResponse>

Parameter

aborter
Aborter

Buat instans Aborter baru dengan Aborter.none atau Aborter.timeout(), goto dokumen Aborter untuk contoh selengkapnya tentang pembatalan permintaan.

body
CalculateRouteMatrixRequestBody

Matriks koordinat asal dan tujuan untuk menghitung jarak rute, waktu perjalanan, dan ringkasan lainnya untuk setiap sel matriks berdasarkan parameter input. Jumlah sel minimum dan maksimum yang didukung masing-masing adalah 1 dan 700. Misalnya, bisa 35 asal dan 20 tujuan atau 25 asal dan 25 tujuan.

Mengembalikan

calculateRouteRange(Aborter, GeoJSON.Position, CalculateRouteRangeOptions)

Hitung sekumpulan lokasi yang dapat dicapai dari titik asal berdasarkan anggaran bahan bakar, energi, atau waktu yang ditentukan. Batas poligon (atau Isochrone) dikembalikan dalam orientasi berlawanan arah jarang serta pusat poligon yang tepat yang merupakan hasil dari titik asal. Poligon yang dikembalikan dapat digunakan untuk pemrosesan lebih lanjut seperti Search Inside Geometry untuk mencari POI dalam Isochrone yang disediakan.

Menggunakan Get Route Range API: https://docs.microsoft.com/rest/api/maps/route/getrouterange

function calculateRouteRange(aborter: Aborter, center: GeoJSON.Position, options?: CalculateRouteRangeOptions): Promise<CalculateRouteRangeResponse>

Parameter

aborter
Aborter

Buat instans Aborter baru dengan Aborter.none atau Aborter.timeout(), goto dokumen Aborter untuk contoh selengkapnya tentang pembatalan permintaan.

center
GeoJSON.Position

Koordinat dari mana perhitungan rentang harus dimulai.

Mengembalikan

Detail Metode yang Diwarisi

newPipeline(Credential, INewPipelineOptions)

Metode statis yang digunakan untuk membuat objek Alur baru dengan Kredensial yang disediakan.

static function newPipeline(credential: Credential, pipelineOptions?: INewPipelineOptions): Pipeline

Parameter

credential
Credential

Seperti SubscriptionKeyCredential, TokenCredential, dan MapControlCredential.

pipelineOptions
INewPipelineOptions

Mengembalikan

Objek Alur baru.

Diwarisi DariMapsURL.newPipeline