Route - Post Route Range

Referensi

Layanan:: Maps

Versi API:: 2024-07-01-preview

Berlaku untuk: lihat harga tingkat.

ROUTE Range API membuat poligon yang menggambarkan area yang dapat dijangkau dari lokasi tertentu dalam ambang batas tertentu berdasarkan anggaran waktu atau jarak 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 pemfilteran spasial untuk mencari fitur yang menarik dalam Isochrone yang disediakan.

Untuk informasi tentang ketersediaan perutean di negara/wilayah, lihat cakupan perutean Azure Maps.

Penting

Dengan menggunakan fitur ini, Anda menyetujui persyaratan hukum pratinjau. Lihat Ketentuan Tambahan Pratinjau untuk detail tambahan.

POST https://atlas.microsoft.com/route/range?api-version=2024-07-01-preview

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
api-version	query	True	string	Nomor versi Azure Maps API.

Header Permintaan

Media Types: "application/geo+json"

Nama	Diperlukan	Jenis	Deskripsi
x-ms-client-id		string	Menentukan akun mana yang ditujukan untuk penggunaan bersama dengan model keamanan ID Microsoft Entra. Ini mewakili ID unik untuk akun Azure Maps dan dapat diambil dari API Akun sarana manajemen Azure Maps. Untuk menggunakan keamanan ID Microsoft Entra di Azure Maps, lihat artikel berikut ini untuk panduan.

Isi Permintaan

Media Types: "application/geo+json"

Nama	Diperlukan	Jenis	Deskripsi
geometry	True	RouteRangePointGeometry	Menentukan objek `GeoJSON` Point Geometry. Lihat RFC 7946 untuk detailnya.
properties	True	InputRouteRangeProperties	Menentukan parameter yang akan digunakan untuk perhitungan poligon isochrone.
type	True	FeaturesItemTypeEnum	Menentukan jenis `GeoJSON`. Satu-satunya jenis objek yang didukung adalah Fitur. Untuk informasi selengkapnya, lihat RFC 7946.

Respons

Nama	Jenis	Deskripsi
200 OK	RouteRangeResponse	OKE Media Types: "application/geo+json", "application/json"
Other Status Codes	MapsErrorResponse	Terjadi kesalahan tak terduga. Media Types: "application/geo+json", "application/json" Header x-ms-error-code: string

Nama

Jenis

Deskripsi

200 OK

RouteRangeResponse

OKE

Media Types: "application/geo+json", "application/json"

Other Status Codes

MapsErrorResponse

Terjadi kesalahan tak terduga.

Media Types: "application/geo+json", "application/json"

Header

x-ms-error-code: string

Keamanan

AADToken

Ini adalah Microsoft Entra OAuth 2.0 Flows. Saat dipasangkan dengan akses berbasis peran Azure kontrol dapat digunakan untuk mengontrol akses ke REST API Azure Maps. Kontrol akses berbasis peran Azure digunakan untuk menunjuk akses ke satu atau beberapa akun sumber daya Atau sub-sumber daya Azure Maps. Setiap pengguna, grup, atau perwakilan layanan dapat diberikan akses melalui peran bawaan atau peran kustom yang terdiri dari satu atau beberapa izin ke REST API Azure Maps.

Untuk menerapkan skenario, sebaiknya lihat konsep autentikasi . Singkatnya, definisi keamanan ini menyediakan solusi untuk memodelkan aplikasi melalui objek yang mampu mengontrol akses pada API dan cakupan tertentu.

Nota

Definisi keamanan ini mengharuskan penggunaan header x-ms-client-id untuk menunjukkan sumber daya Azure Maps mana yang diminta akses aplikasi. Ini dapat diperoleh dari API manajemen Maps.
Authorization URL khusus untuk instans cloud publik Azure. Sovereign cloud memiliki URL Otorisasi yang unik dan konfigurasi ID Microsoft Entra.
Kontrol akses berbasis peran Azure dikonfigurasi dari bidang manajemen Azure melalui portal Microsoft Azure, PowerShell, CLI, Azure SDK, atau REST API.
Penggunaan Azure Maps Web SDK memungkinkan penyiapan berbasis konfigurasi aplikasi untuk beberapa kasus penggunaan.
Untuk informasi selengkapnya tentang platform identitas Microsoft, lihat gambaran umum platform identitas Microsoft .

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
https://atlas.microsoft.com/.default	https://atlas.microsoft.com/.default

subscription-key

Ini adalah kunci bersama yang disediakan saat membuat sumber daya Azure Maps melalui bidang manajemen Azure melalui portal Microsoft Azure, PowerShell, CLI, Azure SDK, atau REST API.

Dengan kunci ini, aplikasi apa pun berwenang untuk mengakses semua REST API. Dengan kata lain, ini saat ini dapat diperlakukan sebagai kunci master ke akun tempat mereka dikeluarkan.

Untuk aplikasi yang diekspos secara publik, rekomendasi kami adalah menggunakan akses server-ke-server DARI REST API Azure Maps tempat kunci ini dapat disimpan dengan aman.

Jenis: apiKey
Dalam: header

SAS Token

Ini adalah token tanda tangan akses bersama dibuat dari operasi Daftar SAS pada sumber daya Azure Maps melalui bidang manajemen Azure melalui portal Microsoft Azure, PowerShell, CLI, Azure SDK, atau REST API.

Dengan token ini, aplikasi apa pun berwenang untuk mengakses dengan kontrol akses berbasis peran Azure dan kontrol butir halus ke kedaluwarsa, laju, dan wilayah penggunaan untuk token tertentu. Dengan kata lain, Token SAS dapat digunakan untuk memungkinkan aplikasi mengontrol akses dengan cara yang lebih aman daripada kunci bersama.

Untuk aplikasi yang diekspos secara publik, rekomendasi kami adalah mengonfigurasi daftar spesifik asal yang diizinkan pada sumber daya akun peta untuk membatasi penyalahgunaan penyajian dan memperbarui Token SAS secara teratur.

Jenis: apiKey
Dalam: header

Contoh

Successfully retrieve a set of locations that can be reached from the origin point based on the specified conditions

Permintaan sampel

HTTP

POST https://atlas.microsoft.com/route/range?api-version=2024-07-01-preview

{
  "type": "Feature",
  "geometry": {
    "type": "Point",
    "coordinates": [
      5.86605,
      50.9745
    ]
  },
  "properties": {
    "timeBudgetInSec": 6000
  }
}

Respon sampel

Kode status:: 200

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          5.86605,
          50.9745
        ]
      },
      "properties": {
        "type": "center"
      }
    },
    {
      "type": "Feature",
      "bbox": [
        3.62838,
        49.83259,
        7.9826,
        52.25674
      ],
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              5.73602,
              52.03704
            ],
            [
              5.59435,
              52.09456
            ],
            [
              5.42279,
              52.16815
            ],
            [
              5.21276,
              52.25047
            ],
            [
              5.15355,
              52.21374
            ],
            [
              4.96687,
              52.25674
            ],
            [
              4.739,
              52.07834
            ],
            [
              4.72513,
              52.05647
            ],
            [
              4.53237,
              51.94553
            ],
            [
              4.31165,
              51.70119
            ],
            [
              4.28917,
              51.5837
            ],
            [
              3.82685,
              51.48463
            ],
            [
              3.62838,
              51.21096
            ],
            [
              3.89244,
              50.6814
            ],
            [
              3.93493,
              50.66791
            ],
            [
              3.98156,
              50.49042
            ],
            [
              4.47995,
              50.30944
            ],
            [
              4.60502,
              50.24448
            ],
            [
              4.89999,
              50.24467
            ],
            [
              5.04206,
              50.08735
            ],
            [
              5.23042,
              49.99214
            ],
            [
              5.40994,
              49.88478
            ],
            [
              5.46178,
              49.85797
            ],
            [
              5.7196,
              49.86279
            ],
            [
              5.74151,
              49.83259
            ],
            [
              5.9387,
              50.22239
            ],
            [
              6.08535,
              50.0011
            ],
            [
              6.12089,
              50.04616
            ],
            [
              6.28373,
              50.09472
            ],
            [
              6.51654,
              49.95863
            ],
            [
              6.61034,
              50.00485
            ],
            [
              6.70295,
              50.00587
            ],
            [
              6.65865,
              50.2947
            ],
            [
              6.79276,
              50.36903
            ],
            [
              7.32163,
              50.31614
            ],
            [
              7.58782,
              50.36737
            ],
            [
              7.7626,
              50.46919
            ],
            [
              7.9826,
              50.96246
            ],
            [
              7.55924,
              51.07086
            ],
            [
              7.58138,
              51.36614
            ],
            [
              7.67861,
              51.52015
            ],
            [
              7.35175,
              51.65781
            ],
            [
              7.21664,
              51.81916
            ],
            [
              7.0467,
              51.9587
            ],
            [
              6.67267,
              51.82713
            ],
            [
              6.48424,
              51.81133
            ],
            [
              6.27316,
              51.9368
            ],
            [
              6.14452,
              52.01701
            ],
            [
              6.09312,
              52.20847
            ],
            [
              6.01297,
              52.23705
            ],
            [
              5.86605,
              50.9745
            ],
            [
              5.73602,
              52.03704
            ]
          ]
        ]
      },
      "properties": {
        "type": "boundary"
      }
    }
  ]
}

Definisi

Nama	Deskripsi
AdrTunnelRestrictionCodeEnum	Kode pembatasan terowongan ADR. ADR adalah perjanjian Eropa mengenai pengangkutan internasional barang berbahaya melalui jalan darat. Kode pembatasan terowongan ADR digunakan untuk menentukan apakah kendaraan diizinkan untuk melewati terowongan dengan pembatasan pengangkutan barang berbahaya.
FeaturesItemTypeEnum	Menentukan jenis `GeoJSON`. Satu-satunya jenis objek yang didukung adalah Fitur. Untuk informasi selengkapnya, lihat RFC 7946.
FeatureTypeEnum	Menentukan jenis `GeoJSON`. Satu-satunya jenis objek yang didukung adalah `FeatureCollection`. Untuk informasi selengkapnya, lihat RFC 7946.
InputRouteRangeProperties	Menentukan parameter yang akan digunakan untuk perhitungan poligon isochrone.
MapsErrorDetail	Detail kesalahan.
MapsErrorResponse	Respons kesalahan umum untuk API Azure Maps untuk mengembalikan detail kesalahan untuk operasi yang gagal.
MapsInnerError	Objek yang berisi informasi yang lebih spesifik daripada objek saat ini tentang kesalahan.
RouteRangeAvoidEnum	Menentukan batasan yang harus dihormati oleh perhitungan rute saat menentukan lokasi yang dapat dijangkau. Hindari mendukung beberapa nilai dalam permintaan. Contoh: "hindari": ["limitedAccessHighways", "tollRoads"]
RouteRangeFeatureProperties	Properti Rentang Rute.
RouteRangeFeaturesItem	Objek fitur GeoJSON yang berisi objek Geometri dan properti tambahan rute.
RouteRangeOptimizeRouteEnum	Menentukan parameter yang akan digunakan untuk mengoptimalkan rute. Jika tidak ditentukan, defaultnya adalah "fastestWithoutTraffic" yang mengembalikan rute untuk meminimalkan waktu perjalanan tanpa menggunakan informasi lalu lintas saat ini. Contoh: "optimizeRoute":"shortest"
RouteRangePointGeometry	Menentukan objek `GeoJSON` Point Geometry. Lihat RFC 7946 untuk detailnya.
RouteRangePolygonGeometry	Menentukan objek Geometri Poligon `GeoJSON`. Lihat RFC 7946 untuk detailnya.
RouteRangeRequest	Menentukan titik awal untuk perhitungan rentang. `GeoJSON` objek fitur dan properti tambahan. Lihat RFC 7946 untuk detailnya.
RouteRangeResponse	Objek ini dikembalikan dari panggilan yang berhasil.
RouteRangeTravelModeEnum	Menentukan profil perjalanan yang perlu dipertimbangkan saat menghitung poligon rentang. Jika tidak ditentukan, nilai defaultnya adalah "mengemudi". Contoh: "travelMode":"mengemudi"
RouteRangeTypeEnum	Jenis fitur untuk objek fitur yang dikembalikan dalam respons.
RouteRangeVehicleSpec	Menentukan atribut kendaraan seperti tinggi kendaraan, berat, kecepatan maks, jenis kargo, dll. untuk dipertimbangkan saat menghitung lokasi yang dapat dijangkau. Ini membantu menghindari izin jembatan rendah, pembatasan jalan, belokan kanan yang sulit untuk menyediakan rute truk yang dioptimalkan berdasarkan spesifikasi kendaraan. Atribut kendaraan ditentukan dalam properti vehicleSpec.
VehicleLoadTypeEnum	Jenis kargo yang mungkin diklasifikasikan sebagai bahan berbahaya dan dibatasi dari beberapa jalan. Nilai vehicleLoadType yang tersedia adalah kelas Hazmat AS 1 hingga 9, ditambah klasifikasi generik untuk digunakan di negara lain. Nilai yang dimulai dengan USHazmat adalah untuk perutean AS sementara otherHazmat harus digunakan untuk semua negara lain. vehicleLoadType mendukung beberapa nilai dalam permintaan.

AdrTunnelRestrictionCodeEnum

Enumeration

Kode pembatasan terowongan ADR. ADR adalah perjanjian Eropa mengenai pengangkutan internasional barang berbahaya melalui jalan darat. Kode pembatasan terowongan ADR digunakan untuk menentukan apakah kendaraan diizinkan untuk melewati terowongan dengan pembatasan pengangkutan barang berbahaya.

Nilai	Deskripsi
B	Kendaraan dengan kode B dibatasi dari jalan dengan kategori terowongan ADR B, C, D, dan E.
C	Kendaraan dengan kode C dibatasi dari jalan dengan kategori terowongan ADR C, D, dan E
D	Kendaraan dengan kode D dibatasi dari jalan dengan kategori terowongan ADR D dan E.
E	Kendaraan dengan kode E dibatasi dari jalan dengan kategori terowongan ADR E.

FeaturesItemTypeEnum

Enumeration

Menentukan jenis GeoJSON. Satu-satunya jenis objek yang didukung adalah Fitur. Untuk informasi selengkapnya, lihat RFC 7946.

Nilai	Deskripsi
Feature	Menentukan jenis objek Fitur `GeoJSON`.

FeatureTypeEnum

Enumeration

Menentukan jenis GeoJSON. Satu-satunya jenis objek yang didukung adalah FeatureCollection. Untuk informasi selengkapnya, lihat RFC 7946.

Nilai	Deskripsi
FeatureCollection	Menentukan tipe objek `GeoJSONFeatureCollection`.

InputRouteRangeProperties

Objek

Menentukan parameter yang akan digunakan untuk perhitungan poligon isochrone.

Nama	Jenis	Nilai default	Deskripsi
avoid	RouteRangeAvoidEnum[]		Menentukan batasan yang harus dihormati oleh perhitungan rute saat menentukan lokasi yang dapat dijangkau. Hindari mendukung beberapa nilai dalam permintaan. Contoh: "hindari": ["limitedAccessHighways", "tollRoads"]
departAt	string		Tanggal dan waktu keberangkatan dari titik asal yang diformat sebagai nilai dateTime yang ditentukan oleh RFC 3339, bagian 5,6. Ketika offset zona waktu tidak ditentukan, UTC akan diasumsikan. Jika `departAt` tidak diatur, nilai defaultnya adalah waktu saat ini. Contoh: "departAt": "2023-06-01T09:30:00.000-07:00"
distanceBudgetInMeters	number		Anggaran jarak menentukan rentang maksimum dalam meter yang dapat ditempuh dari titik arah asal. Ini tidak dapat diatur ketika `timeBudgetInSec` ditentukan. Ketika `isSimplifiedPolygon` salah, jarak maksimum yang didukung adalah 360.000 meter; jika tidak, itu adalah 500.000 meter. Contoh: "distanceBudgetInMeters":5000
isSimplifiedPolygon	boolean	true	Gunakan ini untuk menentukan apakah Anda memerlukan poligon yang disederhanakan yang mengurangi jumlah simpul poligon sambil mempertahankan bentuk. API mengembalikan poligon definisi rendah secara default.
optimizeRoute	RouteRangeOptimizeRouteEnum	fastestWithoutTraffic	Menentukan parameter yang akan digunakan untuk mengoptimalkan rute. Jika tidak ditentukan, defaultnya adalah "fastestWithoutTraffic" yang mengembalikan rute untuk meminimalkan waktu perjalanan tanpa menggunakan informasi lalu lintas saat ini. Contoh: "optimizeRoute":"shortest"
timeBudgetInSec	number		Anggaran waktu menentukan waktu maksimum dalam detik yang tersedia untuk perjalanan, menentukan seberapa jauh seseorang dapat pergi dalam batasan waktu ini dari titik arah asal. Ini tidak dapat diatur ketika `distanceBudgetInMeters` ditentukan. Ketika `isSimplifiedPolygon` salah, waktu maksimum yang didukung adalah 14.400 detik; jika tidak, itu adalah 21.600 detik. Contoh: "timeBudgetInSec":3600
travelMode	RouteRangeTravelModeEnum	driving	Menentukan profil perjalanan yang perlu dipertimbangkan saat menghitung poligon rentang. Jika tidak ditentukan, nilai defaultnya adalah "mengemudi". Contoh: "travelMode":"mengemudi"
vehicleSpec	RouteRangeVehicleSpec		Menentukan atribut kendaraan seperti tinggi kendaraan, berat, kecepatan maks, jenis kargo, dll. untuk dipertimbangkan saat menghitung lokasi yang dapat dijangkau. Ini membantu menghindari izin jembatan rendah, pembatasan jalan, belokan kanan yang sulit untuk menyediakan rute truk yang dioptimalkan berdasarkan spesifikasi kendaraan. Atribut kendaraan ditentukan dalam properti vehicleSpec.

MapsErrorDetail

Objek

Detail kesalahan.

Nama	Jenis	Deskripsi
code	string	Salah satu sekumpulan kode kesalahan yang ditentukan server.
details	MapsErrorDetail[]	Array detail tentang kesalahan tertentu yang menyebabkan kesalahan yang dilaporkan ini.
innererror	MapsInnerError	Objek yang berisi informasi yang lebih spesifik daripada objek saat ini tentang kesalahan.
message	string	Representasi kesalahan yang dapat dibaca manusia.
target	string	Target kesalahan.

MapsErrorResponse

Objek

Respons kesalahan umum untuk API Azure Maps untuk mengembalikan detail kesalahan untuk operasi yang gagal.

Nama	Jenis	Deskripsi
error	MapsErrorDetail	Detail kesalahan.

MapsInnerError

Objek

Objek yang berisi informasi yang lebih spesifik daripada objek saat ini tentang kesalahan.

Nama	Jenis	Deskripsi
code	string	Kode kesalahan.
innererror	MapsInnerError	Objek yang berisi informasi yang lebih spesifik daripada objek saat ini tentang kesalahan.

RouteRangeAvoidEnum

Enumeration

Menentukan batasan yang harus dihormati oleh perhitungan rute saat menentukan lokasi yang dapat dijangkau. Hindari mendukung beberapa nilai dalam permintaan.

Contoh: "hindari": ["limitedAccessHighways", "tollRoads"]

Nilai	Deskripsi
borderCrossings	Menghindari perbatasan negara yang melintasi dalam rute.
carTrains	Menghindari kereta mobil.
carpools	Menghindari rute yang memerlukan penggunaan carpool.
ferries	Menghindari penggunaan feri dalam rute.
limitedAccessHighways	Menghindari penggunaan jalan raya akses terbatas dalam rute.
lowEmissionZones	Menghindari zona emisi rendah dalam rute.
tollRoads	Menghindari penggunaan jalan tol di rute.
tunnels	Menghindari penggunaan terowongan dalam rute.
unpavedRoads	Menghindari jalan yang belum diaspal di rute.

RouteRangeFeatureProperties

Objek

Properti Rentang Rute.

Nama	Jenis	Deskripsi
type	RouteRangeTypeEnum	Jenis fitur untuk objek fitur yang dikembalikan dalam respons.

RouteRangeFeaturesItem

Objek

Objek fitur GeoJSON yang berisi objek Geometri dan properti tambahan rute.

Nama	Jenis	Deskripsi
bbox	number[]	Area persegi panjang di bumi didefinisikan sebagai objek kotak pembatas. Sisi persegi panjang didefinisikan oleh nilai garis lintang dan bujur. Untuk informasi selengkapnya, lihat RFC 7946, Bagian 5. Contoh: "bbox": [-10.0, -10.0, 10.0, 10.0]
geometry	RouteRangeGeometry: RouteRangePointGeometry RouteRangePolygonGeometry	Objek Geometri `GeoJSON` yang valid. Silakan lihat RFC 7946 untuk detailnya.
properties	RouteRangeFeatureProperties	Properti Rentang Rute.
type	FeaturesItemTypeEnum	Menentukan jenis `GeoJSON`. Satu-satunya jenis objek yang didukung adalah Fitur. Untuk informasi selengkapnya, lihat RFC 7946.

RouteRangeOptimizeRouteEnum

Enumeration

Menentukan parameter yang akan digunakan untuk mengoptimalkan rute. Jika tidak ditentukan, defaultnya adalah "fastestWithoutTraffic" yang mengembalikan rute untuk meminimalkan waktu perjalanan tanpa menggunakan informasi lalu lintas saat ini.

Contoh: "optimizeRoute":"shortest"

Nilai	Deskripsi
fastestWithTraffic	Rute dihitung untuk meminimalkan waktu menggunakan informasi lalu lintas saat ini. `Note`: Hanya didukung untuk mengemudi dan truk travelMode.
fastestWithoutTraffic	Menemukan rute tercepat, tanpa memperhitungkan informasi lalu lintas.
shortest	Rute dihitung untuk meminimalkan jarak. Informasi lalu lintas tidak digunakan.

RouteRangePointGeometry

Objek

Menentukan objek GeoJSON Point Geometry. Lihat RFC 7946 untuk detailnya.

Nama	Jenis	Deskripsi
coordinates	number[]	`Position` adalah array angka dengan dua elemen atau lebih. Dua elemen pertama adalah bujur dan garis lintang, tepatnya dalam urutan tersebut. Altitude/Elevation adalah elemen ketiga opsional. Silakan lihat RFC 7946 untuk detailnya.
type	string: Point	Menentukan jenis geometri untuk objek Geometri `GeoJSON`. Lihat RFC 7946 untuk detailnya.

RouteRangePolygonGeometry

Objek

Menentukan objek Geometri Poligon GeoJSON. Lihat RFC 7946 untuk detailnya.

Nama	Jenis	Deskripsi
coordinates	number[]	Koordinat untuk jenis geometri `GeoJson Polygon`.
type	string: Polygon	Menentukan jenis geometri untuk objek Geometri `GeoJSON`. Lihat RFC 7946 untuk detailnya.

RouteRangeRequest

Objek

Menentukan titik awal untuk perhitungan rentang. GeoJSON objek fitur dan properti tambahan. Lihat RFC 7946 untuk detailnya.

Nama	Jenis	Deskripsi
geometry	RouteRangePointGeometry	Menentukan objek `GeoJSON` Point Geometry. Lihat RFC 7946 untuk detailnya.
properties	InputRouteRangeProperties	Menentukan parameter yang akan digunakan untuk perhitungan poligon isochrone.
type	FeaturesItemTypeEnum	Menentukan jenis `GeoJSON`. Satu-satunya jenis objek yang didukung adalah Fitur. Untuk informasi selengkapnya, lihat RFC 7946.

RouteRangeResponse

Objek

Objek ini dikembalikan dari panggilan yang berhasil.

Nama	Jenis	Deskripsi
features	RouteRangeFeaturesItem[]	`GeoJSON` objek fitur yang berisi objek Geometri dan properti tambahan. Lihat RFC 7946, Bagian 3.2 untuk detailnya.
type	FeatureTypeEnum	Menentukan jenis `GeoJSON`. Satu-satunya jenis objek yang didukung adalah `FeatureCollection`. Untuk informasi selengkapnya, lihat RFC 7946.

RouteRangeTravelModeEnum

Enumeration

Menentukan profil perjalanan yang perlu dipertimbangkan saat menghitung poligon rentang. Jika tidak ditentukan, nilai defaultnya adalah "mengemudi".

Contoh: "travelMode":"mengemudi"

Nilai	Deskripsi
driving	Profil perutean yang cocok untuk mobil digunakan untuk penghitungan poligon rentang.
truck	Profil perutean yang cocok untuk kendaraan komersial seperti truk digunakan untuk perhitungan poligon rentang.

RouteRangeTypeEnum

Enumeration

Jenis fitur untuk objek fitur yang dikembalikan dalam respons.

Nilai	Deskripsi
boundary	Jenis fitur batas mewakili poligon rentang.
center	Jenis fitur titik tengah mewakili titik yang digunakan untuk perhitungan poligon rentang.

RouteRangeVehicleSpec

Objek

Menentukan atribut kendaraan seperti tinggi kendaraan, berat, kecepatan maks, jenis kargo, dll. untuk dipertimbangkan saat menghitung lokasi yang dapat dijangkau. Ini membantu menghindari izin jembatan rendah, pembatasan jalan, belokan kanan yang sulit untuk menyediakan rute truk yang dioptimalkan berdasarkan spesifikasi kendaraan. Atribut kendaraan ditentukan dalam properti vehicleSpec.

Nama	Jenis	Nilai default	Deskripsi
adrTunnelRestrictionCode	AdrTunnelRestrictionCodeEnum		Kode pembatasan terowongan ADR. ADR adalah perjanjian Eropa mengenai pengangkutan internasional barang berbahaya melalui jalan darat. Kode pembatasan terowongan ADR digunakan untuk menentukan apakah kendaraan diizinkan untuk melewati terowongan dengan pembatasan pengangkutan barang berbahaya.
axleCount	integer		Jumlah as roda pada kendaraan.
axleWeight	integer	0	Berat per sumbu kendaraan dalam kg. Nilai 0 berarti bahwa pembatasan berat per sumbu tidak dipertimbangkan.
height	number	0	Tinggi kendaraan dalam meter. Nilai 0 berarti bahwa pembatasan tinggi tidak dipertimbangkan.
isVehicleCommercial	boolean	False	Apakah kendaraan digunakan untuk tujuan komersial. Kendaraan komersial mungkin tidak diizinkan untuk berkendara di beberapa jalan.
length	number	0	Panjang kendaraan dalam meter. Nilai 0 berarti bahwa pembatasan panjang tidak dipertimbangkan.
loadType	VehicleLoadTypeEnum[]		Jenis kargo yang mungkin diklasifikasikan sebagai bahan berbahaya dan dibatasi dari beberapa jalan. Nilai vehicleLoadType yang tersedia adalah kelas Hazmat AS 1 hingga 9, ditambah klasifikasi generik untuk digunakan di negara lain. Nilai yang dimulai dengan USHazmat adalah untuk perutean AS sementara otherHazmat harus digunakan untuk semua negara lain. vehicleLoadType mendukung beberapa nilai dalam permintaan.
maxSpeed	integer	0	Kecepatan maksimum kendaraan dalam km/jam. Kecepatan maksimum di profil kendaraan digunakan untuk memeriksa apakah kendaraan diizinkan di jalan raya. Nilai 0 berarti bahwa nilai yang sesuai untuk kendaraan akan ditentukan dan diterapkan selama perencanaan rute. Nilai bukan nol dapat ditimpa selama perencanaan rute. Misalnya, arus lalu lintas saat ini adalah 60 km/jam. Jika kecepatan maksimum kendaraan diatur ke 50 km/jam, mesin perutean akan mempertimbangkan 60 km/jam karena ini adalah situasi saat ini. Jika kecepatan maksimum kendaraan disediakan sebagai 80 km/jam tetapi arus lalu lintas saat ini adalah 60 km/jam, maka mesin perutean akan kembali menggunakan 60 km/jam.
weight	integer	0	Berat kendaraan dalam kilogram. Nilai 0 berarti bahwa pembatasan berat tidak dipertimbangkan.
width	number	0	Lebar kendaraan dalam meter. Nilai 0 berarti bahwa pembatasan lebar tidak dipertimbangkan.

VehicleLoadTypeEnum

Enumeration

Jenis kargo yang mungkin diklasifikasikan sebagai bahan berbahaya dan dibatasi dari beberapa jalan. Nilai vehicleLoadType yang tersedia adalah kelas Hazmat AS 1 hingga 9, ditambah klasifikasi generik untuk digunakan di negara lain. Nilai yang dimulai dengan USHazmat adalah untuk perutean AS sementara otherHazmat harus digunakan untuk semua negara lain. vehicleLoadType mendukung beberapa nilai dalam permintaan.

Nilai	Deskripsi
USHazmatClass1	Bahan peledak
USHazmatClass2	Gas terkompresi
USHazmatClass3	Cairan mudah terbakar
USHazmatClass4	Padatan yang mudah terbakar
USHazmatClass5	Pengoksidasi
USHazmatClass6	Racun
USHazmatClass7	Radioaktif
USHazmatClass8	Korelif
USHazmatClass9	Miscellaneous
otherHazmatExplosive	Bahan peledak
otherHazmatGeneral	Miscellaneous
otherHazmatHarmfulToWater	Berbahaya bagi air

Bagikan melalui

Route - Post Route Range

Parameter URI

Header Permintaan

Isi Permintaan

Respons

Keamanan

AADToken

Cakupan

subscription-key

SAS Token

Contoh

Successfully retrieve a set of locations that can be reached from the origin point based on the specified conditions

Permintaan sampel

Respon sampel

Definisi

AdrTunnelRestrictionCodeEnum

FeaturesItemTypeEnum

FeatureTypeEnum

InputRouteRangeProperties

MapsErrorDetail

MapsErrorResponse

MapsInnerError

RouteRangeAvoidEnum

RouteRangeFeatureProperties

RouteRangeFeaturesItem

RouteRangeOptimizeRouteEnum

RouteRangePointGeometry

RouteRangePolygonGeometry

RouteRangeRequest

RouteRangeResponse

RouteRangeTravelModeEnum

RouteRangeTypeEnum

RouteRangeVehicleSpec

VehicleLoadTypeEnum