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.
Get Route Range
(Isochrone) API,belirtilen yakıt, enerji, zaman veya mesafe bütçesine göre çıkış noktasından ulaşılacak konum kümesini hesaplayan bir HTTP GET
isteğidir. Çokgen bir sınır (veya Isochrone) hem saat yönünün tersine hem de çıkış noktasının sonucu olan kesin çokgen merkezi olarak döndürülür.
Döndürülen çokgen, sağlanan isochrone içindeki POI'leri aramak için Geometri İçinde Ara gibi daha fazla işlem için kullanılabilir.
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
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
format
|
path | True |
Yanıtın istenen biçimi. Değer json veya xml olabilir. |
|
api-version
|
query | True |
string |
Azure Haritalar API'sinin sürüm numarası. |
query
|
query | True |
number[] |
Aralık hesaplamasının başlaması gereken Koordinat. |
acceleration
|
query |
number double |
Araç hızlandığında yakıtta depolanan kimyasal enerjiyi kinetik enerjiye dönüştürmenin verimliliğini belirtir (örn. KineticEnergyGained/ChemicalEnergyConsumed). ChemicalEnergyConsumed , tüketilen yakıtın fuelEnergyDensityInMJoulesPerLiter kullanılarak kimyasal enerjiye dönüştürülmesiyle elde edilir. DecelerationEfficiency ile eşlenmelidir. İzin verilen değer aralığı 0,0 - 1/decelerationEfficiency değerleridir. Mantıklı Değerler : Yanma Modeli için : 0.33, Elektrik Modeli için : 0.66 |
|
auxiliary
|
query |
number double |
Yardımcı sistemlerin sürdürülmesi için kullanılan güç miktarını kilowatt (kW) cinsinden belirtir. Ac sistemleri, radyo, ısıtma vb. cihazlar ve sistemler nedeniyle tüketimi belirtmek için kullanılabilir. Mantıklı Değerler : 1.7 |
|
auxiliary
|
query |
number double |
Aracın yardımcı sistemlerinin sürdürülmesi için tüketilen yakıt miktarını litre/saat cinsinden belirtir. Ac sistemleri, radyo, ısıtma vb. cihazlar ve sistemler nedeniyle tüketimi belirtmek için kullanılabilir. Mantıklı Değerler : 0.2 |
|
avoid
|
query |
Yol hesaplamasının yolu belirlerken 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. |
||
constant
|
query |
string |
Tüketimin hıza bağımlı bileşenini belirtir. Hız/tüketim hızı çiftlerinin sırasız bir listesi olarak sağlanır. Liste, tüketim eğrisi üzerindeki noktaları tanımlar. Listede bulunmayan hızlar için tüketim oranları aşağıdaki gibidir:
Liste 1 ile 25 nokta (dahil) arasında olmalı ve aynı hızda yinelenen noktalar içermeyebilir. Yalnızca tek bir nokta içeriyorsa, bu noktanın tüketim oranı daha fazla işlenmeden kullanılır. En büyük hız için belirtilen tüketim, en büyük penultimate hızının değerinden büyük veya buna eşit olmalıdır. Bu, tahminin negatif tüketim oranlarına yol açmamasını sağlar. Benzer şekilde, listedeki en küçük iki hız için belirtilen tüketim değerleri, daha küçük hızlar için negatif tüketim oranına yol açamaz. Tüketim değerleri için geçerli aralık (kWh/100km cinsinden ifade edilir) 0,01 ile 100000,0 arasındadır. Mantıklı Değerler: 50,8.2:130,21.3 Bu parametre Elektrik tüketim modeli için gereklidir. |
|
constant
|
query |
string |
Tüketimin hıza bağımlı bileşenini belirtir. İki nokta üst üste ayrılmış hız & tüketim oranı çiftlerinin sıralanmamış bir listesi olarak sağlanır. Liste, tüketim eğrisi üzerindeki noktaları tanımlar. Listede bulunmayan hızlar için tüketim oranları aşağıdaki gibidir:
Liste 1 ile 25 nokta (dahil) arasında olmalı ve aynı hızda yinelenen noktalar içermeyebilir. Yalnızca tek bir nokta içeriyorsa, bu noktanın tüketim oranı daha fazla işlenmeden kullanılır. En büyük hız için belirtilen tüketim, en büyük penultimate hızının değerinden büyük veya buna eşit olmalıdır. Bu, tahminin negatif tüketim oranlarına yol açmamasını sağlar. Benzer şekilde, listedeki en küçük iki hız için belirtilen tüketim değerleri, daha küçük hızlar için negatif tüketim oranına yol açamaz. Tüketim değerleri için geçerli aralık (l/100km cinsinden ifade edilir) 0,01 ile 100000,0 arasındadır. Mantıklı Değerler: 50,6,3:130,11,5 Not : Bu parametre Yanma Tüketim Modeli için gereklidir. |
|
current
|
query |
number double |
Geçerli elektrik enerji kaynağını kilowatt saat (kWh) cinsinden belirtir. Bu parametre maxChargeInkWh parametresiyle birlikte bulunur. İzin verilen değer aralığı 0,0 ile maxChargeInkWh arasındadır. Mantıklı Değerler : 43 |
|
current
|
query |
number double |
Litre olarak yakıtın geçerli tedarikini belirtir. Mantıklı Değerler : 55 |
|
deceleration
|
query |
number double |
Araç yavaşladığında kinetik enerjiyi tasarruflu (tüketilmemiş) yakıta dönüştürmenin verimliliğini belirtir (örneğin, ChemicalEnergySaved/KineticEnergyLost). ChemicalEnergySaved , tasarruf edilen (tüketilmeyen) yakıtın fuelEnergyDensityInMJoulesPerLiter kullanılarak enerjiye dönüştürülmesiyle elde edilir. AccelerationEfficiency ile eşlenmelidir. İzin verilen değer aralığı 0,0 ile 1/accelerationEfficiency arasındadır. Duyarlı Değerler : Yanma Modeli için : 0,83, Elektrik Modeli için : 0,91 |
|
depart
|
query |
string date-time |
Çıkış noktasından çıkış tarihi ve saati, isteğe bağlı saat dilimi uzaklığı ile RFC 3339, bölüm 5.6'da tanımlandığı gibi bir
Örnekler:
|
|
distance
|
query |
number double |
Sürüş mesafesi kullanılarak seyahat edilebilecek maksimum mesafeyi belirleyen metreler halinde mesafe bütçesi. Tüketim Modeli yalnızca routeType eko olduğunda aralığı etkiler. |
|
downhill
|
query |
number double |
Araç yükselmeyi kaybettiğinde (örneğin ChemicalEnergySaved/PotentialEnergyLost) potansiyel enerjiyi tasarruf edilen (tüketilmeyen) yakıta dönüştürmenin verimliliğini belirtir. ChemicalEnergySaved , tasarruf edilen (tüketilmeyen) yakıtın fuelEnergyDensityInMJoulesPerLiter kullanılarak enerjiye dönüştürülmesiyle elde edilir. Yokuş yukarı verimlilik ile eşlenmelidir. İzin verilen değer aralığı 0,0 ile 1/uphillEfficiency arasındadır. Duyarlı Değerler : Yanma Modeli için : 0,51, Elektrik Modeli için : 0,73 |
|
energy
|
query |
number double |
Belirtilen Elektrik Tüketimi Modeli kullanılarak seyahat edilebilecek maksimum aralığı belirleyen kilowatt saat (kWh) cinsinden elektrik enerjisi bütçesi. |
|
fuel
|
query |
number double |
Belirtilen Yanma Tüketimi Modeli kullanılarak seyahat edilebilecek maksimum aralığı belirleyen litre cinsinden yakıt bütçesi. |
|
fuel
|
query |
number double |
Megajoules (MJ) cinsinden bir litre yakıtta depolanan kimyasal enerji miktarını belirtir. Kaydedilen veya tüketilen enerji ile yakıt arasındaki dönüşümler için *Verimlilik parametreleriyle birlikte kullanılır. Örneğin, enerji yoğunluğu benzin için 34,2 MJ/l ve Dizel yakıt için 35,8 MJ/l'dir. Herhangi bir *Efficiency parametresi ayarlandıysa bu parametre gereklidir. Mantıklı Değerler : 34.2 |
|
hilliness
|
query |
Heyecan verici rota için tepelik derecesi. Bu parametre yalnızca =heyecan verici ile |
||
max
|
query |
number double |
Aracın aküsünde depolanabilecek maksimum elektrik enerji kaynağını kilowatt saat (kWh) cinsinden belirtir. Bu parametre currentChargeInkWh parametresiyle birlikte bulunur. Minimum değerin currentChargeInkWh değerinden büyük veya buna eşit olması gerekir. Mantıklı Değerler : 85 |
|
route
|
query |
İstenen yol türü. |
||
time
|
query |
number double |
Sürüş süresi kullanılarak seyahat edilebilecek maksimum aralığı belirleyen saniye olarak zaman bütçesi. Tüketim Modeli yalnızca routeType eko olduğunda aralığı etkiler. |
|
traffic
|
query |
boolean |
Olası değerler:
|
|
travel
|
query |
İstenen rota için seyahat modu. Tanımlanmamışsa, varsayılan değer 'araba'dır. İstenen travelMode öğesinin tüm rota için kullanılamayabileceğini unutmayın. İstenen travelMode belirli bir bölüm için kullanılamıyorsa, bu bölüm için yanıtın travelMode öğesi "diğer" olur. Seyahat modlarının veri yolu, motosiklet, taksi ve van BETA işlevi olduğunu unutmayın. Tüm alanlarda tam kısıtlama verileri kullanılamaz. |
||
uphill
|
query |
number double |
Araç yükselme kazandığında yakıtta depolanan kimyasal enerjiyi potansiyel enerjiye dönüştürme verimliliğini belirtir (örneğin, PotentialEnergyGained/ChemicalEnergyConsumed). ChemicalEnergyConsumed , tüketilen yakıtın fuelEnergyDensityInMJoulesPerLiter kullanılarak kimyasal enerjiye dönüştürülmesiyle elde edilir. DownhillEfficiency ile eşlenmelidir. İzin verilen değer aralığı 0,0 ile 1/downhillEfficiency arasındadır. Duyarlı Değerler : Yanma Modeli için : 0.27, Elektrik Modeli için : 0.74 |
|
vehicle
|
query |
integer |
Aracın aks başına ağırlığı kg cinsindendir. 0 değeri, aks başına ağırlık kısıtlamalarının dikkate alınmadığı anlamına gelir. |
|
vehicle
|
query |
boolean |
Aracın ticari amaçlarla kullanılıp kullanılmadığı. Ticari araçların bazı yollarda sürmesine izin verilmiyor olabilir. |
|
vehicle
|
query |
Aracın motor tipi. Ayrıntılı bir Tüketim Modeli belirtildiğinde , vehicleEngineType değeriyle tutarlı olmalıdır. |
||
vehicle
|
query |
number double |
Aracın metre cinsinden yüksekliği. 0 değeri, yükseklik kısıtlamalarının dikkate alınmadığı anlamına gelir. |
|
vehicle
|
query |
number double |
Aracın metre cinsinden uzunluğu. 0 değeri, uzunluk kısıtlamalarının dikkate alınmadığı anlamına gelir. |
|
vehicle
|
query |
Tehlikeli madde olarak sınıflandırılabilecek ve bazı yollardan kısıtlanmış kargo türleri. Kullanılabilir vehicleLoadType 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 ise diğerHazmat kullanılmalıdır. vehicleLoadType birden çok kez belirtilebilir. Bu parametre şu anda yalnızca travelMode=truck için kabul edilmektedir. |
||
vehicle
|
query |
integer |
Aracın km/saat maksimum hızı. Araç profilindeki maksimum hız, otoyollarda bir araca izin verilip verilmediğini kontrol etmek için kullanılır.
|
|
vehicle
|
query |
integer |
Aracın ağırlığı kilogram olarak.
Mantıklı Değerler : Yanma Modeli için : 1600, Elektrik Modeli için : 1900 |
|
vehicle
|
query |
number double |
Aracın metre cinsinden genişliği. 0 değeri, genişlik kısıtlamalarının dikkate alınmadığı anlamına gelir. |
|
windingness
|
query |
Heyecan verici rota için dönüş seviyesi. Bu parametre yalnızca =heyecan verici ile |
İstek Başlığı
Name | Gerekli | Tür | Description |
---|---|---|---|
x-ms-client-id |
string |
Microsoft Entra ID güvenlik modeliyle birlikte hangi hesabın kullanıma yönelik olduğunu belirtir. Azure Haritalar hesabı için benzersiz bir kimliği temsil eder ve Azure Haritalar yönetim düzlemi Hesap API'sinden alınabilir. Azure Haritalar'da Microsoft Entra ID güvenliğini kullanmak için kılavuz için aşağıdaki makalelere bakın. |
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ıdır. Azure rol tabanlı erişim denetimi ile eşleştirildiğinde, Azure Haritalar REST API'lerine erişimi denetlemek için kullanılabilir. Azure rol tabanlı erişim denetimleri, bir veya daha fazla Azure Haritalar kaynak hesabına veya alt kaynağına erişim belirtmek için kullanılır. Tüm kullanıcılara, gruplara veya hizmet sorumlularına yerleşik bir rol veya Azure Haritalar REST API'leri için bir veya daha fazla izinden oluşan özel bir rol aracılığıyla erişim verilebilir.
Senaryoları uygulamak için kimlik doğrulama kavramlarını görüntülemenizi öneririz. Özetle, bu güvenlik tanımı belirli API'ler ve kapsamlar üzerinde erişim denetimi yapabilen nesneler aracılığıyla uygulamaları modellemek için bir çözüm sağlar.
Notlar
- Bu güvenlik tanımı, uygulamanın erişim istediği Azure Haritalar kaynağını belirtmek için üst bilgi kullanımını
x-ms-client-id
gerektirir. Bu, Haritalar yönetim API'sinden alınabilir.
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üzleminden yapılandırılır.
* Azure Haritalar Web SDK'sının 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 Bir Azure Haritalar hesabı oluşturduğunuzda veya PowerShell, CLI, Azure SDK'ları veya REST API'leri kullandığınızda 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 Gizli istemci uygulamaları yaklaşımını kullanarak Azure Haritalar REST API'lerine erişmenizi ö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ğındaki 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ölgeler için ayrıntılı denetim ile erişim yetkisine sahip olur. Başka bir deyişle SAS Belirteci, uygulamaların paylaşılan anahtardan daha güvenli bir şekilde erişimi denetlemesine izin vermek için kullanılabilir.
Herkese açık uygulamalar için önerimiz, işleme kötüye kullanımını sınırlamak ve SAS Belirtecini düzenli olarak yenilemek için Harita hesabı kaynağında izin verilen kaynakların belirli bir listesini yapılandırmayı önermektedir.
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 Yol 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 =thrilling ile |
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. '&avoid=otoyollar&avoid=tollRoads&avoid=ferries' gibi bir istekte birden çok kez belirtilebilir. Yol Aralığı isteklerinde zatenUsedRoads değeri kullanılmamalıdır. |
Route |
Ulaşılabilir Aralık |
Route |
Bu nesne başarılı bir Yol Ulaşılabilir Aralığı çağrısından döndürülür |
Route |
Geçerli çağrıda kullanılan geçerli ayarları bildirir. |
Route |
İstenen yol türü. |
Travel |
İstenen rota için seyahat modu. Tanımlanmamışsa, varsayılan değer 'araba'dır. İstenen travelMode öğesinin tüm rota için kullanılamayabileceğini unutmayın. İstenen travelMode belirli bir bölümde kullanılamadığı durumlarda, bu bölüm için yanıtın travelMode öğesi "diğer" olacaktır. Seyahat modları otobüs, motosiklet, taksi ve minibüs BETA işlevselliği 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 , vehicleEngineType değ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 vehicleLoadType 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 =thrilling ile |
EffectiveSetting
Bu Yol 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 =thrilling ile routeType
birlikte kullanılabilir.
Name | Tür | Description |
---|---|---|
high |
string |
yüksek |
low |
string |
alçak |
normal |
string |
normal |
LatLongPair
Enlem ve boylam olarak temsil edilen konum.
Name | Tür | Description |
---|---|---|
latitude |
number |
Latitude özelliği |
longitude |
number |
Longitude özelliği |
ResponseFormat
Yanıtın istenen biçimi. Değer json veya xml olabilir.
Name | Tür | Description |
---|---|---|
json |
string |
|
xml |
string |
RouteAvoidType
Rotayı belirlerken yol hesaplamasının kaçınmaya çalışması gereken bir şeyi belirtir. '&avoid=otoyollar&avoid=tollRoads&avoid=ferries' gibi bir istekte birden çok kez belirtilebilir. Yol Aralığı isteklerinde zatenUsedRoads değeri kullanılmamalıdır.
Name | Tür | Description |
---|---|---|
alreadyUsedRoads |
string |
Aynı yolu birden çok kez kullanmaktan kaçınıyor. =heyecan verici ile |
borderCrossings |
string |
Rota hesaplamasında sınır geçişlerini önler. |
carpools |
string |
Araç havuzu (HOV/Yüksek Doluluk Aracı) kulvarlarının kullanılmasını gerektiren rotalardan kaçınıyor. |
ferries |
string |
Feribotlardan kaçınıyor |
motorways |
string |
Otoyollardan kaçınıyor |
tollRoads |
string |
Ücretli yollardan kaçınıyor. |
unpavedRoads |
string |
Unpaved yolları önler |
RouteRange
Ulaşılabilir Aralık
Name | Tür | Description |
---|---|---|
boundary |
Nokta listesi olarak gösterilen ulaşılabilir aralığın çokgen sınırı. |
|
center |
Ulaşılabilir aralığın orta noktası |
RouteRangeResult
Bu nesne başarılı bir Yol Ulaşılabilir Aralığı çağrısından döndürülür
Name | Tür | Description |
---|---|---|
formatVersion |
string |
Format Version özelliği |
reachableRange |
Ulaşılabilir Aralık |
|
report |
Geçerli çağrıda kullanılan geçerli ayarları bildirir. |
RouteReport
Geçerli çağrıda kullanılan geçerli ayarları bildirir.
Name | Tür | Description |
---|---|---|
effectiveSettings |
Bu Yol API'si çağrılırken kullanılan geçerli parametreler veya veriler. |
RouteType
İstenen yol türü.
Name | Tür | Description |
---|---|---|
eco |
string |
Ekonomi ve hız ile dengelenmiş bir rota. |
fastest |
string |
En hızlı yol. |
shortest |
string |
Mesafeye göre en kısa rota. |
thrilling |
string |
İ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. =heyecan verici ile planlanan |
TravelMode
İstenen rota için seyahat modu. Tanımlanmamışsa, varsayılan değer 'araba'dır. İstenen travelMode öğesinin tüm rota için kullanılamayabileceğini unutmayın. İstenen travelMode belirli bir bölümde kullanılamadığı durumlarda, bu bölüm için yanıtın travelMode öğesi "diğer" olacaktır. Seyahat modları otobüs, motosiklet, taksi ve minibüs BETA işlevselliği olduğunu unutmayın. Tüm alanlarda tam kısıtlama verileri kullanılamaz.
Name | Tür | Description |
---|---|---|
bus |
string |
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şlevi. |
car |
string |
Döndürülen rotalar arabalar için iyileştirilmiştir. |
motorcycle |
string |
Döndürülen rotalar motosikletler için iyileştirilmiştir. BETA işlevi. |
taxi |
string |
Döndürülen rotalar taksiler için iyileştirilmiştir. BETA işlevi. |
truck |
string |
Döndürülen rotalar, kamyonlar gibi ticari araçlar için optimize edilmiştir. |
van |
string |
Döndürülen yollar, minibüsler için iyileştirilmiştir. BETA işlevi. |
VehicleEngineType
Aracın motor tipi. Ayrıntılı bir Tüketim Modeli belirtildiğinde , vehicleEngineType değeriyle tutarlı olmalıdır.
Name | Tür | Description |
---|---|---|
combustion |
string |
İç yanmalı motor. |
electric |
string |
Elektrik motoru. |
VehicleLoadType
Tehlikeli madde olarak sınıflandırılabilecek ve bazı yollardan kısıtlanmış kargo türleri. Kullanılabilir vehicleLoadType 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.
Name | Tür | Description |
---|---|---|
USHazmatClass1 |
string |
Patlayıcılar |
USHazmatClass2 |
string |
Sıkıştırılmış gaz |
USHazmatClass3 |
string |
Yanıcı sıvılar |
USHazmatClass4 |
string |
Yanıcı katılar |
USHazmatClass5 |
string |
Oksidatörler |
USHazmatClass6 |
string |
Zehir |
USHazmatClass7 |
string |
Radyoaktif maddeler |
USHazmatClass8 |
string |
Aşındırıcılar |
USHazmatClass9 |
string |
Çeşitli |
otherHazmatExplosive |
string |
Patlayıcılar |
otherHazmatGeneral |
string |
Çeşitli |
otherHazmatHarmfulToWater |
string |
Suya zararlı |
WindingnessLevel
Heyecan verici rota için dönüş seviyesi. Bu parametre yalnızca =thrilling ile routeType
birlikte kullanılabilir.
Name | Tür | Description |
---|---|---|
high |
string |
yüksek |
low |
string |
alçak |
normal |
string |
normal |