RouteURL class
RouteURL mewakili URL ke operasi rute Azure Maps.
- Extends
Konstruktor
RouteURL(Pipeline, string) | Membuat instans RouteURL. |
Properti yang Diwariskan
maps |
Nilai string URL dasar. |
Metode
calculate |
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 Jika tidak, gunakan Get Route Directions API: https://docs.microsoft.com/rest/api/maps/route/getroutedirections |
calculate |
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 |
calculate |
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
new |
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
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.
- options
- CalculateRouteDirectionsOptions
Mengembalikan
Promise<CalculateRouteDirectionsResponse>
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.
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.
- options
- CalculateRouteMatrixOptions
Mengembalikan
Promise<CalculateRouteMatrixResponse>
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.
- options
- CalculateRouteRangeOptions
Mengembalikan
Promise<CalculateRouteRangeResponse>
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