Route - Get Route Range
Belirli bir eşik içindeki belirli bir noktadan erişilebilen alanı zamana, mesafeye veya yakıt kapasitesine göre gösteren bir harita oluşturmak için kullanın.
Uyarı
Azure Haritalar Route v1 hizmetinin kullanımdan kaldırılması
Azure Haritalar Route v1 hizmeti artık kullanım dışıdır ve 31.03.28 tarihinde kullanımdan kaldırılacaktır. Hizmet kesintilerini önlemek için Route v1 hizmetine yapılan tüm çağrıların 31.03.28'e kadar Route v2025-01-01 kullanacak şekilde güncelleştirilmesi gerekir. Daha fazla bilgi için bkz. Azure Haritalar Yol 1.0 API'lerini geçirme.
Get Route Range (Isochrone) API'si, belirtilen yakıt, enerji, zaman veya mesafe bütçesine göre çıkış noktasından ulaşabileceğiniz konum kümesini hesaplayan bir HTTP GET isteğidir. Çokgen sınır (veya Isochrone) saat yönünün tersine ve çıkış noktasının sonucu olan kesin poligon merkezinde döndürülür.
Döndürülen çokgen, sağlanan isochrone içindeki POI'leri aramak için geometri
GET https://atlas.microsoft.com/route/range/{format}?api-version=1.0&query={query}GET https://atlas.microsoft.com/route/range/{format}?api-version=1.0&query={query}&fuelBudgetInLiters={fuelBudgetInLiters}&energyBudgetInkWh={energyBudgetInkWh}&timeBudgetInSec={timeBudgetInSec}&distanceBudgetInMeters={distanceBudgetInMeters}&departAt={departAt}&routeType={routeType}&traffic={traffic}&avoid={avoid}&travelMode={travelMode}&hilliness={hilliness}&windingness={windingness}&vehicleAxleWeight={vehicleAxleWeight}&vehicleWidth={vehicleWidth}&vehicleHeight={vehicleHeight}&vehicleLength={vehicleLength}&vehicleMaxSpeed={vehicleMaxSpeed}&vehicleWeight={vehicleWeight}&vehicleCommercial={vehicleCommercial}&vehicleLoadType={vehicleLoadType}&vehicleEngineType={vehicleEngineType}&constantSpeedConsumptionInLitersPerHundredkm={constantSpeedConsumptionInLitersPerHundredkm}¤tFuelInLiters={currentFuelInLiters}&auxiliaryPowerInLitersPerHour={auxiliaryPowerInLitersPerHour}&fuelEnergyDensityInMJoulesPerLiter={fuelEnergyDensityInMJoulesPerLiter}&accelerationEfficiency={accelerationEfficiency}&decelerationEfficiency={decelerationEfficiency}&uphillEfficiency={uphillEfficiency}&downhillEfficiency={downhillEfficiency}&constantSpeedConsumptionInkWhPerHundredkm={constantSpeedConsumptionInkWhPerHundredkm}¤tChargeInkWh={currentChargeInkWh}&maxChargeInkWh={maxChargeInkWh}&auxiliaryPowerInkW={auxiliaryPowerInkW}URI Parametreleri
İstek Başlığı
| Name | Gerekli | Tür | Description |
|---|---|---|---|
| x-ms-client-id |
string |
Microsoft Entra ID güvenlik modeliyle kullanılması amaçlanan hesabı belirtir. Azure Haritalar hesabı için bu benzersiz kimlik, Azure Haritalar yönetim düzlemi Hesap API'sinden elde edilebilir. Azure Haritalar'da Microsoft Entra ID güvenliğini kullanma hakkında daha fazla bilgi için bkz. |
Yanıtlar
| Name | Tür | Description |
|---|---|---|
| 200 OK |
Tamam |
|
| Other Status Codes |
Beklenmeyen bir hata oluştu. |
Güvenlik
AADToken
Bunlar Microsoft Entra OAuth 2.0 Akışlarının
Senaryoları uygulamak için
Notlar
- Bu güvenlik tanımı kullanılmasını gerektirir. Bu, Haritalar yönetim API'sindenedinilebilir.
Authorization URL, Azure genel bulut örneğine özgüdür. Bağımsız bulutların benzersiz Yetkilendirme URL'leri ve Microsoft Entra Id yapılandırmaları vardır.
* Azure rol tabanlı erişim denetimi Azure portalı, PowerShell, CLI, Azure SDK'ları veya REST API'leri aracılığıyla azure yönetim düzlemi yapılandırılır.
* Azure Haritalar Web SDK kullanımı, bir uygulamanın birden çok kullanım örneği için yapılandırma tabanlı kurulumuna olanak tanır.
- Microsoft kimlik platformu hakkında daha fazla bilgi için bkz. Microsoft kimlik platformuna genel bakış.
Tür:
oauth2
Akış:
implicit
Yetkilendirme URL’si:
https://login.microsoftonline.com/common/oauth2/authorize
Kapsamlar
| Name | Description |
|---|---|
| https://atlas.microsoft.com/.default | https://atlas.microsoft.com/.default |
subscription-key
Bu, Azure portalında Azure Haritalar hesabı oluşturma veya PowerShell, CLI, Azure SDK'ları veya REST API kullanarak sağlanan paylaşılan bir anahtardır.
Bu anahtarla, tüm uygulamalar tüm REST API'lere erişebilir. Başka bir deyişle, bu anahtar, verildikleri hesapta ana anahtar olarak kullanılabilir.
Herkese açık uygulamalar için, anahtarınızın güvenli bir şekilde depolanabilmesi için Azure Haritalar REST API'lerine erişmek için gizli istemci uygulamaları yaklaşımını kullanmanızı öneririz.
Tür:
apiKey
İçinde:
query
SAS Token
Bu paylaşılan erişim imzası belirteci, Azure portalı, PowerShell, CLI, Azure SDK'ları veya REST API'leri aracılığıyla Azure yönetim düzlemi aracılığıyla Azure Haritalar kaynağı Sas Listeleme işleminden oluşturulur.
Bu belirteçle, tüm uygulamalar Azure rol tabanlı erişim denetimleri ve belirli bir belirteç için kullanım süre sonu, oran ve bölgelere ayrıntılı denetim ile erişim yetkisine sahiptir. Başka bir deyişle SAS Belirteci, uygulamaların erişimi paylaşılan anahtardan daha güvenli bir şekilde denetlemesine izin vermek için kullanılabilir.
Herkese açık uygulamalar için önerimiz, Eşleme hesabı kaynağında izin verilen kaynakların belirli bir listesini yapılandırmayı işleme kötüye kullanımını sınırlamak ve SAS Belirtecini düzenli olarak yenilemektir.
Tür:
apiKey
İçinde:
header
Örnekler
Successfully retrieve a set of locations that can be reached from the origin point based on various conditions
Örnek isteği
GET https://atlas.microsoft.com/route/range/json?api-version=1.0&query=50.97452,5.86605&timeBudgetInSec=6000
Örnek yanıt
{
"formatVersion": "0.0.1",
"reachableRange": {
"center": {
"latitude": 50.9745,
"longitude": 5.86605
},
"boundary": [
{
"latitude": 52.03704,
"longitude": 5.73602
},
{
"latitude": 52.09456,
"longitude": 5.59435
},
{
"latitude": 52.16815,
"longitude": 5.42279
},
{
"latitude": 52.25047,
"longitude": 5.21276
},
{
"latitude": 52.21374,
"longitude": 5.15355
},
{
"latitude": 52.25674,
"longitude": 4.96687
},
{
"latitude": 52.07834,
"longitude": 4.739
},
{
"latitude": 52.05647,
"longitude": 4.72513
},
{
"latitude": 51.94553,
"longitude": 4.53237
},
{
"latitude": 51.70119,
"longitude": 4.31165
},
{
"latitude": 51.5837,
"longitude": 4.28917
},
{
"latitude": 51.48463,
"longitude": 3.82685
},
{
"latitude": 51.21096,
"longitude": 3.62838
},
{
"latitude": 50.6814,
"longitude": 3.89244
},
{
"latitude": 50.66791,
"longitude": 3.93493
},
{
"latitude": 50.49042,
"longitude": 3.98156
},
{
"latitude": 50.30944,
"longitude": 4.47995
},
{
"latitude": 50.24448,
"longitude": 4.60502
},
{
"latitude": 50.24467,
"longitude": 4.89999
},
{
"latitude": 50.08735,
"longitude": 5.04206
},
{
"latitude": 49.99214,
"longitude": 5.23042
},
{
"latitude": 49.88478,
"longitude": 5.40994
},
{
"latitude": 49.85797,
"longitude": 5.46178
},
{
"latitude": 49.86279,
"longitude": 5.7196
},
{
"latitude": 49.83259,
"longitude": 5.74151
},
{
"latitude": 50.22239,
"longitude": 5.9387
},
{
"latitude": 50.0011,
"longitude": 6.08535
},
{
"latitude": 50.04616,
"longitude": 6.12089
},
{
"latitude": 50.09472,
"longitude": 6.28373
},
{
"latitude": 49.95863,
"longitude": 6.51654
},
{
"latitude": 50.00485,
"longitude": 6.61034
},
{
"latitude": 50.00587,
"longitude": 6.70295
},
{
"latitude": 50.2947,
"longitude": 6.65865
},
{
"latitude": 50.36903,
"longitude": 6.79276
},
{
"latitude": 50.31614,
"longitude": 7.32163
},
{
"latitude": 50.36737,
"longitude": 7.58782
},
{
"latitude": 50.46919,
"longitude": 7.7626
},
{
"latitude": 50.96246,
"longitude": 7.9826
},
{
"latitude": 51.07086,
"longitude": 7.55924
},
{
"latitude": 51.36614,
"longitude": 7.58138
},
{
"latitude": 51.52015,
"longitude": 7.67861
},
{
"latitude": 51.65781,
"longitude": 7.35175
},
{
"latitude": 51.81916,
"longitude": 7.21664
},
{
"latitude": 51.9587,
"longitude": 7.0467
},
{
"latitude": 51.82713,
"longitude": 6.67267
},
{
"latitude": 51.81133,
"longitude": 6.48424
},
{
"latitude": 51.9368,
"longitude": 6.27316
},
{
"latitude": 52.01701,
"longitude": 6.14452
},
{
"latitude": 52.20847,
"longitude": 6.09312
},
{
"latitude": 52.23705,
"longitude": 6.01297
}
]
}
}Tanımlar
| Name | Description |
|---|---|
|
Effective |
Bu Rota API'si çağrılırken kullanılan etkili parametre veya veriler. |
|
Error |
Kaynak yönetimi hatası ek bilgileri. |
|
Error |
Hata ayrıntısı. |
|
Error |
Hata yanıtı |
|
Incline |
Heyecan verici rota için tepelik derecesi. Bu parametre yalnızca |
|
Lat |
Enlem ve boylam olarak temsil edilen konum. |
|
Response |
Yanıtın istenen biçimi. Değer json veya xml olabilir. |
|
Route |
Rotayı belirlerken yol hesaplamasının kaçınmaya çalışması gereken bir şeyi belirtir. Bir istekte birden çok kez belirtilebilir, örneğin, '&avoid=otoyollar&avoid=tollRoads&avoid=ferries'. Yol Aralığı isteklerinde zatenUsedRoads değeri kullanılmamalıdır. |
|
Route |
Ulaşılabilir Aralık |
|
Route |
Bu nesne başarılı bir Route Reachable Range çağrısından döndürülür |
|
Route |
Geçerli çağrıda kullanılan geçerli ayarları raporlar. |
|
Route |
İstenen yol türü. |
|
Travel |
İstenen rota için seyahat modu. Tanımlanmamışsa, varsayılan değer 'araba'dır. İstenen travelMode'un tüm rota için kullanılamayabileceğini unutmayın. İstenen travelMode belirli bir bölümde kullanılamadığı durumlarda, bu bölümün yanıtının travelMode öğesi "diğer" olur. Seyahat modlarının otobüs, motosiklet, taksi ve minibüs BETA işlevi olduğunu unutmayın. Tüm alanlarda tam kısıtlama verileri kullanılamaz. |
|
Vehicle |
Aracın motor tipi. Ayrıntılı bir Tüketim Modeli belirtildiğinde, vehicleEngineTypedeğeriyle tutarlı olmalıdır. |
|
Vehicle |
Tehlikeli madde olarak sınıflandırılabilecek ve bazı yollardan kısıtlanmış kargo türleri. Kullanılabilir araçLoadType değerleri, 1 ile 9 arasında ABD Hazmat sınıflarının yanı sıra diğer ülkelerde/bölgelerde kullanılmak üzere genel sınıflandırmalardır. USHazmat ile başlayan değerler ABD yönlendirme içindir, diğer Tüm ülkeler/bölgeler için diğerHazmat kullanılmalıdır. vehicleLoadType birden çok kez belirtilebilir. Bu parametre şu anda yalnızca travelMode=truck için kabul edilmektedir. |
|
Windingness |
Heyecan verici rota için dönüş seviyesi. Bu parametre yalnızca |
EffectiveSetting
Bu Rota API'si çağrılırken kullanılan etkili parametre veya veriler.
| Name | Tür | Description |
|---|---|---|
| key |
string |
Kullanılan parametrenin adı. |
| value |
string |
Kullanılan parametrenin değeri. |
ErrorAdditionalInfo
Kaynak yönetimi hatası ek bilgileri.
| Name | Tür | Description |
|---|---|---|
| info |
object |
Ek bilgiler. |
| type |
string |
Ek bilgi türü. |
ErrorDetail
Hata ayrıntısı.
| Name | Tür | Description |
|---|---|---|
| additionalInfo |
Hata ek bilgileri. |
|
| code |
string |
Hata kodu. |
| details |
Hata ayrıntıları. |
|
| message |
string |
Hata iletisi. |
| target |
string |
Hata hedefi. |
ErrorResponse
Hata yanıtı
| Name | Tür | Description |
|---|---|---|
| error |
Hata nesnesi. |
InclineLevel
Heyecan verici rota için tepelik derecesi. Bu parametre yalnızca routeType=heyecan verici ile birlikte kullanılabilir.
| Değer | Description |
|---|---|
| low |
alçak |
| normal |
normal |
| high |
yüksek |
LatLongPair
Enlem ve boylam olarak temsil edilen konum.
| Name | Tür | Description |
|---|---|---|
| latitude |
number (double) |
Latitude özelliği |
| longitude |
number (double) |
Longitude özelliği |
ResponseFormat
Yanıtın istenen biçimi. Değer json veya xml olabilir.
| Değer | Description |
|---|---|
| json | |
| xml |
RouteAvoidType
Rotayı belirlerken yol hesaplamasının kaçınmaya çalışması gereken bir şeyi belirtir. Bir istekte birden çok kez belirtilebilir, örneğin, '&avoid=otoyollar&avoid=tollRoads&avoid=ferries'. Yol Aralığı isteklerinde zatenUsedRoads değeri kullanılmamalıdır.
| Değer | Description |
|---|---|
| tollRoads |
Ücretli yollardan kaçınıyor. |
| motorways |
Otoyollardan kaçınıyor |
| ferries |
Feribotları önler |
| unpavedRoads |
Kazınmamış yollardan kaçınıyor |
| carpools |
Araç havuzu (HOV/Yüksek Dolu Araç) şeritlerinin kullanılmasını gerektiren rotalardan kaçınıyor. |
| alreadyUsedRoads |
Aynı yolu birden çok kez kullanmaktan kaçınıyor.
|
| borderCrossings |
Rota hesaplamasında sınır geçişlerini önler. |
RouteRange
Ulaşılabilir Aralık
| Name | Tür | Description |
|---|---|---|
| boundary |
Ulaşılabilir aralığın çokgen sınırı, nokta listesi olarak gösterilir. |
|
| center |
Ulaşılabilir aralığın orta noktası |
RouteRangeResult
Bu nesne başarılı bir Route Reachable Range çağrısından döndürülür
| Name | Tür | Description |
|---|---|---|
| formatVersion |
string |
Biçim Sürümü özelliği |
| reachableRange |
Ulaşılabilir Aralık |
|
| report |
Geçerli çağrıda kullanılan geçerli ayarları raporlar. |
RouteReport
Geçerli çağrıda kullanılan geçerli ayarları raporlar.
| Name | Tür | Description |
|---|---|---|
| effectiveSettings |
Bu Rota API'si çağrılırken kullanılan etkili parametreler veya veriler. |
RouteType
İstenen yol türü.
| Değer | Description |
|---|---|
| fastest |
En hızlı yol. |
| shortest |
Mesafeye göre en kısa rota. |
| eco |
Ekonomi ve hız ile dengelenmiş bir rota. |
| thrilling |
İlginç veya zorlu yollar içerir ve mümkün olduğunca az otoyol kullanır. Dahil edilen dönüş düzeyini ve ayrıca tepelik derecesini seçebilirsiniz. Bunun nasıl ayarlanacağına ilişkin engebelilik ve sargı parametrelerine bakın.
|
TravelMode
İstenen rota için seyahat modu. Tanımlanmamışsa, varsayılan değer 'araba'dır. İstenen travelMode'un tüm rota için kullanılamayabileceğini unutmayın. İstenen travelMode belirli bir bölümde kullanılamadığı durumlarda, bu bölümün yanıtının travelMode öğesi "diğer" olur. Seyahat modlarının otobüs, motosiklet, taksi ve minibüs BETA işlevi olduğunu unutmayın. Tüm alanlarda tam kısıtlama verileri kullanılamaz.
| Değer | Description |
|---|---|
| car |
Döndürülen rotalar arabalar için iyileştirilmiştir. |
| truck |
Döndürülen rotalar, kamyonlar gibi ticari araçlar için optimize edilmiştir. |
| taxi |
Döndürülen rotalar taksiler için iyileştirilmiştir. BETA işlevselliği. |
| bus |
Döndürülen rotalar, yalnızca otobüs hatlarının kullanımı dahil olmak üzere otobüsler için iyileştirilmiştir. BETA işlevselliği. |
| van |
Döndürülen yollar minibüsler için iyileştirilmiştir. BETA işlevselliği. |
| motorcycle |
Döndürülen rotalar motosikletler için optimize edilmiştir. BETA işlevselliği. |
VehicleEngineType
Aracın motor tipi. Ayrıntılı bir Tüketim Modeli belirtildiğinde, vehicleEngineTypedeğeriyle tutarlı olmalıdır.
| Değer | Description |
|---|---|
| combustion |
İç yanmalı motor. |
| electric |
Elektrik motoru. |
VehicleLoadType
Tehlikeli madde olarak sınıflandırılabilecek ve bazı yollardan kısıtlanmış kargo türleri. Kullanılabilir araçLoadType değerleri, 1 ile 9 arasında ABD Hazmat sınıflarının yanı sıra diğer ülkelerde/bölgelerde kullanılmak üzere genel sınıflandırmalardır. USHazmat ile başlayan değerler ABD yönlendirme içindir, diğer Tüm ülkeler/bölgeler için diğerHazmat kullanılmalıdır. vehicleLoadType birden çok kez belirtilebilir. Bu parametre şu anda yalnızca travelMode=truck için kabul edilmektedir.
| Değer | Description |
|---|---|
| USHazmatClass1 |
Patlayıcı |
| USHazmatClass2 |
Sıkıştırılmış gaz |
| USHazmatClass3 |
Yanıcı sıvılar |
| USHazmatClass4 |
Yanıcı katılar |
| USHazmatClass5 |
Oksidatörler |
| USHazmatClass6 |
Zehir |
| USHazmatClass7 |
Radyoaktif |
| USHazmatClass8 |
Aşındırıcılar |
| USHazmatClass9 |
Çeşitli |
| otherHazmatExplosive |
Patlayıcı |
| otherHazmatGeneral |
Çeşitli |
| otherHazmatHarmfulToWater |
Suya zararlı |
WindingnessLevel
Heyecan verici rota için dönüş seviyesi. Bu parametre yalnızca routeType=heyecan verici ile birlikte kullanılabilir.
| Değer | Description |
|---|---|
| low |
alçak |
| normal |
normal |
| high |
yüksek |