Route - Get Route Directions
Belirtilen bir çıkış noktası ile hedef arasında, belirtilen herhangi bir yol noktasından geçen bir yolu hesaplamak için kullanın.
Get Route Directions
API, bir kaynak ile hedef arasında bir yol döndüren ve belirtilirse yol noktalarından geçen bir HTTP GET
isteğidir. Rota, geçerli trafik ve istenen haftanın günü ve günün saati üzerindeki tipik yol hızları gibi faktörleri dikkate alır.
Döndürülen bilgiler mesafeyi, tahmini seyahat süresini ve rota geometrisinin bir gösterimini içerir. Seçilen seçeneklere bağlı olarak, iyileştirilmiş yol noktası sırası veya sırayla çevirme yönergeleri gibi ek yönlendirme bilgileri de sağlanır.
Yönlendirme hizmeti, araca özgü tüketim modelinin ayrıntılı açıklaması için bir dizi parametre sağlar. Daha fazla bilgi için bkz . Tüketim Modeli.
GET https://atlas.microsoft.com/route/directions/{format}?api-version=1.0&query={query}
GET https://atlas.microsoft.com/route/directions/{format}?api-version=1.0&query={query}&maxAlternatives={maxAlternatives}&alternativeType={alternativeType}&minDeviationDistance={minDeviationDistance}&arriveAt={arriveAt}&departAt={departAt}&minDeviationTime={minDeviationTime}&instructionsType={instructionsType}&language={language}&computeBestOrder={computeBestOrder}&routeRepresentation={routeRepresentation}&computeTravelTimeFor={computeTravelTimeFor}&vehicleHeading={vehicleHeading}&report=effectiveSettings§ionType={sectionType}&vehicleAxleWeight={vehicleAxleWeight}&vehicleWidth={vehicleWidth}&vehicleHeight={vehicleHeight}&vehicleLength={vehicleLength}&vehicleMaxSpeed={vehicleMaxSpeed}&vehicleWeight={vehicleWeight}&vehicleCommercial={vehicleCommercial}&windingness={windingness}&hilliness={hilliness}&travelMode={travelMode}&avoid={avoid}&traffic={traffic}&routeType={routeType}&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 |
string |
Yolun hesaplandığı koordinatlar, iki nokta üst üste ile ayrılmıştır. En az iki koordinat gerekir. İlki çıkış noktası, sonuncusu ise yolun hedefidir. aralarındaki isteğe bağlı koordinatlar, rotada WayPoint olarak hareket eder. En fazla 150 WayPoint geçirebilirsiniz. |
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 |
|
alternative
|
query |
Başvuru yoluyla karşılaştırıldığında, hesaplanan alternatiflerin verilen planlama ölçütlerine göre en uygunluğu denetler. |
||
arrive
|
query |
string date-time |
İsteğe bağlı saat dilimi uzaklığıyla RFC 3339, bölüm 5.6'da tanımlandığı gibi bir Örnekler:
|
|
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. |
||
compute
|
query |
boolean |
Rota uzunluğunu azaltmak için hızlı bir buluşsal algoritma kullanarak rota yol noktalarını yeniden sıralayın. routeType en kısa ile birlikte kullanıldığında en iyi sonuçları verir. Kaynak ve hedefin iyileştirilmiş yol noktası dizinlerinin dışında bırakıldıklarına dikkat edin. Yanıta kaynak ve hedef eklemek için lütfen kaynağı hesaba katmak için tüm dizinleri 1 artırın ve ardından hedefi son dizin olarak ekleyin. Olası değerler true veya false olabilir. True, mümkünse daha iyi bir sıra hesaplar, ancak 0'dan büyük maxAlternatives değeriyle birlikte veya daire yol noktalarıyla birlikte kullanılmasına izin verilmez. False belirtilen sırada konumları kullanır ve routeRepresentation none ile birlikte kullanılmasına izin verilmez. |
|
compute
|
query |
Farklı türdeki trafik bilgileri (yok, geçmiş, canlı) ve varsayılan en iyi tahmini seyahat süresi kullanılarak ek seyahat sürelerinin döndürülip döndürülmeyeceğini belirtir. |
||
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 RFC 3339, bölüm 5.6'da tanımlandığı gibi bir değer olarak
Örnekler:
|
|
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 |
|
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 |
||
instructions
|
query |
Belirtilirse kılavuz yönergeleri döndürülür. instructionsType parametresinin routeRepresentation=none ile birlikte kullanılamadığını unutmayın |
||
language
|
query |
string |
language parametresi, kılavuz iletilerinin dilini belirler. Uygun adlar (sokakların, plazaların, vb. adları) belirtilen dilde döndürülür veya bu ad kullanılamıyorsa, buna yakın bir dilde döndürülür. İzin verilen değerler IETF dil etiketleridir (bir alt kümesi). Şu anda desteklenen diller Desteklenen diller bölümünde listelenmiştir. Varsayılan değer: en-GB |
|
max
|
query |
integer |
Hesaplanacak istenen alternatif yolların sayısı. Varsayılan: 0, en az: 0 ve maksimum: 5 |
|
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 |
|
min
|
query |
integer |
Döndürülen tüm alternatif yollar, en az bu sayıda ölçüm için calculateRoute isteğinin başlangıç noktasından başvuru yolunu izler (bkz. POST İstekleri bölümüne bakın). Yalnızca bir yolu yeniden oluştururken kullanılabilir. minDeviationDistance parametresi, arriveAt ile birlikte kullanılamaz |
|
min
|
query |
integer |
Döndürülen tüm alternatif yollar, calculateRoute isteğinin başlangıç noktasından başvuru yolunu (bkz. POST İstekleri bölümüne bakın) en az bu kadar saniye boyunca izler. Yalnızca bir yolu yeniden oluştururken kullanılabilir. minDeviationTime parametresi, arriveAt ile birlikte kullanılamaz. Varsayılan değer 0'dır. )minDeviationTime_ sıfırdan büyük bir değere ayarlanması aşağıdaki sonuçları doğurabilir:
|
|
report
|
query |
Tanılama amacıyla hangi verilerin raporlanması gerektiğini belirtir. Tek olası değer effectiveSettings'tir. API çağrılırken kullanılan etkili parametreleri veya verileri raporlar. Varsayılan parametreler söz konusu olduğunda, parametrenin çağıran tarafından belirtilmediğinde varsayılan değer yansıtılır. |
||
route
|
query |
Yanıt olarak sağlanan yol kümesinin gösterimini belirtir. Bu parametre değeri yalnızca computeBestOrder=true ile birlikte kullanılabilir. |
||
route
|
query |
İstenen yol türü. |
||
section
|
query |
Yol yanıtında hangi bölüm türlerinin bildirilmiş olduğunu belirtir. |
||
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. 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 |
integer |
Aracın yön yönü, gerçek Kuzey'den başlayan ve saat yönünde devam eden dereceler halinde. Kuzey 0 derece, doğu 90 derece, güney 180 derece, batı 270 derece. Olası değerler 0-359 |
|
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 kilogram ağırlığı.
Duyarlı 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 =thrilling ile |
İstek Başlığı
Name | Gerekli | Tür | Description |
---|---|---|---|
x-ms-client-id |
string |
Hangi hesabın Microsoft Entra ID güvenlik modeliyle birlikte 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 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 denetimiyle 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şimi tanımlamak için kullanılır. Herhangi bir kullanıcı, grup veya hizmet sorumlusuna yerleşik bir rol veya REST API'lerini Azure Haritalar 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ı modellemeye yönelik bir çözüm sağlar.
Notlar
- Bu güvenlik tanımı, uygulamanın erişim isteğinde
x-ms-client-id
bulunduğu Azure Haritalar kaynağı belirtmek için üst bilginin kullanılmasını gerektirir. Bu, Haritalar yönetim API'sinden edinilebilir.
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 platformu genel bakış.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
https://atlas.microsoft.com/.default | https://atlas.microsoft.com/.default |
subscription-key
Bu, Azure portal bir Azure Haritalar hesabı İçerik Oluşturucu 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 gizli istemci uygulamaları yaklaşımını kullanarak Azure Haritalar REST API'lerine erişmenizi öneririz.
Type:
apiKey
In:
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 belirtecin kullanım süresi, oranı ve bölgelerine yönelik ayrıntılı denetim ile erişim yetkisine sahip olur. 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, uygunsuz işlemeyi 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ırmanızdır.
Type:
apiKey
In:
header
Örnekler
Successfully retrieve a route between an origin and a destination
Sample Request
GET https://atlas.microsoft.com/route/directions/json?api-version=1.0&query=52.50931,13.42936:52.50274,13.43872&report=effectiveSettings
Sample Response
{
"formatVersion": "0.0.12",
"routes": [
{
"summary": {
"lengthInMeters": 1147,
"travelTimeInSeconds": 162,
"trafficDelayInSeconds": 0,
"departureTime": "2017-09-07T16:56:58+00:00",
"arrivalTime": "2017-09-07T16:59:40+00:00"
},
"legs": [
{
"summary": {
"lengthInMeters": 1147,
"travelTimeInSeconds": 162,
"trafficDelayInSeconds": 0,
"departureTime": "2017-09-07T16:56:58+00:00",
"arrivalTime": "2017-09-07T16:59:40+00:00"
},
"points": [
{
"latitude": 52.50931,
"longitude": 13.42937
},
{
"latitude": 52.50904,
"longitude": 13.42912
},
{
"latitude": 52.50894,
"longitude": 13.42904
},
{
"latitude": 52.50867,
"longitude": 13.42879
},
{
"latitude": 52.5084,
"longitude": 13.42857
},
{
"latitude": 52.50791,
"longitude": 13.42824
},
{
"latitude": 52.50757,
"longitude": 13.42772
},
{
"latitude": 52.50735,
"longitude": 13.42823
},
{
"latitude": 52.5073,
"longitude": 13.42836
},
{
"latitude": 52.50573,
"longitude": 13.43194
},
{
"latitude": 52.50512,
"longitude": 13.43336
},
{
"latitude": 52.50464,
"longitude": 13.43451
},
{
"latitude": 52.5045,
"longitude": 13.43481
},
{
"latitude": 52.50443,
"longitude": 13.43498
},
{
"latitude": 52.50343,
"longitude": 13.43737
},
{
"latitude": 52.50274,
"longitude": 13.43872
}
]
}
],
"sections": [
{
"startPointIndex": 0,
"endPointIndex": 15,
"sectionType": "TRAVEL_MODE",
"travelMode": "car"
}
]
}
]
}
Tanımlar
Name | Description |
---|---|
Alternative |
Başvuru yoluyla karşılaştırıldığında, hesaplanan alternatiflerin verilen planlama ölçütlerine göre en uygun olanını denetler. |
Compute |
Farklı türdeki trafik bilgileri (yok, geçmiş, canlı) ve varsayılan en iyi tahmin edilen seyahat süresi kullanılarak ek seyahat sürelerinin döndürülip döndürülmeyeceğini belirtir. |
Delay |
Olayın neden olduğu gecikmenin büyüklüğü. Bu değerler , Trafik Olayı Ayrıntısı Alma API'sinin yanıt alanı ty değerlerine karşılık gelir. |
Driving |
Manevra noktasında sol ve sağ taraftaki sürüşü gösterir. |
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ı |
Guidance |
Yönergenin türü, örneğin yol formunun değiştirilmesi veya değiştirilmesi. |
Guidance |
Manevrayı tanımlayan bir kod. |
Incline |
Heyecan verici rota için tepelik derecesi. Bu parametre yalnızca =heyecan verici ile |
Junction |
Manevranın gerçekleştiği kavşağın türü. Daha büyük kavşaklar için, kavşak girmek ve kavşaktan çıkmak için iki ayrı yönerge oluşturulur. |
Lat |
Enlem ve boylam olarak temsil edilen konum. |
Report |
Tanılama amacıyla hangi verilerin raporlanması gerektiğini belirtir. Tek olası değer effectiveSettings'tir. API çağrılırken kullanılan etkili parametreleri veya verileri raporlar. Varsayılan parametreler söz konusu olduğunda, parametrenin çağıran tarafından belirtilmediğinde varsayılan değer yansıtılır. |
Response |
Yanıtın istenen biçimi. Değer json veya xml olabilir. |
Response |
Bildirilen yol yanıtının bölüm türleri |
Response |
Hesaplanan rota için seyahat modu. İstenen aktarım modu bu bölümde mümkün değilse değer olarak ayarlanır |
Route | |
Route |
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. |
Route |
Bu nesne başarılı bir Yol Tarifleri çağrısından döndürülür |
Route |
Kılavuzla ilgili öğeleri içerir. Bu alan yalnızca rehberlik istendiğinde bulunur ve kullanılabilir durumdadır. |
Route |
Bir manevrayı açıklayan bir öznitelik kümesi, örneğin 'Sağa dön', 'Sola tut', 'Feribota bin', 'Otoyola bin', 'Var'. |
Route |
Birbiriyle ilişkili yönerge öğelerinin bir dizisini Gruplar. Sıra aralığı firstInstructionIndex ve lastInstructionIndex ile kısıtlanır. İnsan tarafından okunabilen metin iletileri rehberlik için istendiğinde (instructionType=text veya etiketli), yönerge Grubu kullanılabilir olduğunda döndürülen bir özet iletiye sahiptir. |
Route |
Belirtilirse, kılavuz yönergeleri döndürülür. instructionsType parametresinin routeRepresentation=none ile birlikte kullanılamadığını unutmayın |
Route |
Bir nokta listesinden oluşan rotanın bir bölümünün açıklaması. İstekte sağlanan her ek yol noktası, döndürülen rotada ek bir bacakla sonuçlanır. |
Route |
Yol bölümü için özet nesnesi. |
Route |
İyileştirilmiş yol noktası nesnesi. |
Route |
Geçerli çağrıda kullanılan geçerli ayarları bildirir. |
Route |
Yanıt olarak sağlanan yol kümesinin gösterimini belirtir. Bu parametre değeri yalnızca computeBestOrder=true ile birlikte kullanılabilir. |
Route |
Yol bölümleri, bir yolun bölümleri hakkında ek bilgiler içerir. Her bölüm en az , |
Route |
TPEG2-TEC standardında tanımları kullanarak trafik olayının ayrıntıları. effectCode içerebilir ve öğelere neden olabilir. |
Route |
Trafik olayının nedeni. mainCauseCode ve subCauseCode öğelerini içerebilir. Simge ve açıklamaları tanımlamak için kullanılabilir. |
Route |
Özet nesnesi |
Route |
İstenen yol türü. |
Section |
Yol yanıtında hangi bölüm türlerinin bildirilmiş olduğunu belirtir. |
Simple |
Olayın türü. Şu anda JAM, ROAD_WORK, ROAD_CLOSURE veya OTHER olabilir. Ayrıntılı bilgi için "tec" bölümüne bakın. |
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ü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. |
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 ise 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 =heyecan verici ile |
AlternativeRouteType
Başvuru yoluyla karşılaştırıldığında, hesaplanan alternatiflerin verilen planlama ölçütlerine göre en uygun olanını denetler.
Name | Tür | Description |
---|---|---|
anyRoute |
string |
En iyi durumdaki başvuru rotası ile karşılaştırması ne olursa olsun herhangi bir alternatif yolun döndürülebilmesine izin verin. |
betterRoute |
string |
Alternatif bir yol döndürmek için verilen planlama ölçütlerine göre başvuru yolundan daha iyi olması gerekir. |
ComputeTravelTime
Farklı türdeki trafik bilgileri (yok, geçmiş, canlı) ve varsayılan en iyi tahmin edilen seyahat süresi kullanılarak ek seyahat sürelerinin döndürülip döndürülmeyeceğini belirtir.
Name | Tür | Description |
---|---|---|
all |
string |
Tüm trafik bilgisi türleri için seyahat sürelerini hesaplar ve yol yanıtında özetlere dahil edilen noTrafficTravelTimeInSeconds, historicTrafficTravelTimeInSeconds ve liveTrafficIncidentsTravelTimeInSeconds alanlarındaki tüm sonuçları belirtir. |
none |
string |
Ek seyahat sürelerini hesaplamaz. |
DelayMagnitude
Olayın neden olduğu gecikmenin büyüklüğü. Bu değerler , Trafik Olayı Ayrıntısı Alma API'sinin yanıt alanı ty değerlerine karşılık gelir.
Name | Tür | Description |
---|---|---|
0 |
string |
Bilinmiyor. |
1 |
string |
Küçük. |
2 |
string |
Orta. |
3 |
string |
Büyük. |
4 |
string |
Tanımsız, yol kapatma ve diğer belirsiz gecikmeler için kullanılır. |
DrivingSide
Manevra noktasında sol ve sağ taraftaki sürüşü gösterir.
Name | Tür | Description |
---|---|---|
LEFT |
string |
Sol tarafta. |
RIGHT |
string |
Sağ tarafta. |
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. |
GuidanceInstructionType
Yönergenin türü, örneğin yol formunun değiştirilmesi veya değiştirilmesi.
Name | Tür | Description |
---|---|---|
DIRECTION_INFO |
string |
Yön bilgileri. |
LOCATION_ARRIVAL |
string |
Varış konumu. |
LOCATION_DEPARTURE |
string |
Kalkış yeri. |
LOCATION_WAYPOINT |
string |
Yol noktası konumu. |
ROAD_CHANGE |
string |
Yol Değişikliği. |
TURN |
string |
Dön. |
GuidanceManeuver
Manevrayı tanımlayan bir kod.
Name | Tür | Description |
---|---|---|
ARRIVE |
string |
Sen geldin. |
ARRIVE_LEFT |
string |
Sen geldin. Hedefiniz sol tarafta. |
ARRIVE_RIGHT |
string |
Sen geldin. Hedefiniz sağ tarafta. |
BEAR_LEFT |
string |
Ayı sola. |
BEAR_RIGHT |
string |
Ayı sağa. |
DEPART |
string |
Bırak. |
ENTER_FREEWAY |
string |
Otobana bin. |
ENTER_HIGHWAY |
string |
Otobana bin. |
ENTER_MOTORWAY |
string |
Otoyola bin. |
ENTRANCE_RAMP |
string |
Rampayı al. |
FOLLOW |
string |
Izleyin. |
KEEP_LEFT |
string |
Sola doğru devam edin. |
KEEP_RIGHT |
string |
Sağa doğru devam edin. |
MAKE_UTURN |
string |
U dönüşü yap. |
MOTORWAY_EXIT_LEFT |
string |
Sol çıkışa geçin. |
MOTORWAY_EXIT_RIGHT |
string |
Doğru çıkışa geçin. |
ROUNDABOUT_BACK |
string |
Kavşakta dolaş. |
ROUNDABOUT_CROSS |
string |
Kavşakta çapraz. |
ROUNDABOUT_LEFT |
string |
Kavşakta soldan çıkışa geçin. |
ROUNDABOUT_RIGHT |
string |
Kavşakta sağdan çıkışa geçin. |
SHARP_LEFT |
string |
Sola doğru keskin dön. |
SHARP_RIGHT |
string |
Sağa doğru keskin dön. |
STRAIGHT |
string |
Dümdüz devam edin. |
SWITCH_MAIN_ROAD |
string |
Ana yola geç. |
SWITCH_PARALLEL_ROAD |
string |
Paralel yola geçin. |
TAKE_EXIT |
string |
Çıkışa geçin. |
TAKE_FERRY |
string |
Feribota bin. |
TRY_MAKE_UTURN |
string |
U dönüşü yapmayı deneyin. |
TURN_LEFT |
string |
Sola dönün. |
TURN_RIGHT |
string |
Sağa dönün. |
WAYPOINT_LEFT |
string |
Yol noktasına ulaştınız. Sol tarafta. |
WAYPOINT_REACHED |
string |
Yol noktasına ulaştınız. |
WAYPOINT_RIGHT |
string |
Yol noktasına ulaştınız. Sağ tarafta. |
InclineLevel
Heyecan verici rota için tepelik derecesi. Bu parametre yalnızca =heyecan verici ile routeType
birlikte kullanılabilir.
Name | Tür | Description |
---|---|---|
high |
string |
yüksek |
low |
string |
Düşük |
normal |
string |
Normal |
JunctionType
Manevranın gerçekleştiği kavşağın türü. Daha büyük kavşaklar için, kavşak girmek ve kavşaktan çıkmak için iki ayrı yönerge oluşturulur.
Name | Tür | Description |
---|---|---|
BIFURCATION |
string |
Çatallanma |
REGULAR |
string |
Normal |
ROUNDABOUT |
string |
Roundabout |
LatLongPair
Enlem ve boylam olarak temsil edilen konum.
Name | Tür | Description |
---|---|---|
latitude |
number |
Latitude özelliği |
longitude |
number |
Longitude özelliği |
Report
Tanılama amacıyla hangi verilerin raporlanması gerektiğini belirtir. Tek olası değer effectiveSettings'tir. API çağrılırken kullanılan etkili parametreleri veya verileri raporlar. Varsayılan parametreler söz konusu olduğunda, parametrenin çağıran tarafından belirtilmediğinde varsayılan değer yansıtılır.
Name | Tür | Description |
---|---|---|
effectiveSettings |
string |
API çağrılırken kullanılan etkili parametreleri veya verileri raporlar. |
ResponseFormat
Yanıtın istenen biçimi. Değer json veya xml olabilir.
Name | Tür | Description |
---|---|---|
json |
string |
|
xml |
string |
ResponseSectionType
Bildirilen yol yanıtının bölüm türleri
Name | Tür | Description |
---|---|---|
CARPOOL |
string |
Yolun, araç havuzu (HOV/Yüksek Doluluk Aracı) şeritlerinin kullanılmasını gerektiren bölümleri. |
CAR_TRAIN |
string |
Rotanın arabalar veya trenler olan bölümleri. |
COUNTRY |
string |
Rotanın hangi ülkelerde/bölgelerde olduğunu gösteren bölümler. |
FERRY |
string |
Rotanın feribot olan bölümleri. |
MOTORWAY |
string |
Yolun otoyollar olan bölümleri. |
PEDESTRIAN |
string |
Rotanın yalnızca yayalar için uygun bölümleri. |
TOLL_ROAD |
string |
Rotanın ücretli ödeme gerektiren bölümleri. |
TOLL_VIGNETTE |
string |
Yolun ücretli bir vignette bulunmasını gerektiren bölümleri. |
TRAFFIC |
string |
Yolun trafik bilgilerini içeren bölümleri. |
TRAVEL_MODE |
string |
İstek parametresiyle |
TUNNEL |
string |
Yolun tünel olan bölümleri. |
URBAN |
string |
Yolun kentsel alanlar içinde yer alan bölümleri. |
ResponseTravelMode
Hesaplanan rota için seyahat modu. İstenen aktarım modu bu bölümde mümkün değilse değer olarak ayarlanır other
Name | Tür | Description |
---|---|---|
bicycle |
string |
Döndürülen rotalar, bisiklet kulvarlarının kullanımı da dahil olmak üzere bisikletler için iyileştirilmiştir. |
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. |
other |
string |
Verilen aktarım modu bu bölümde mümkün değildir |
pedestrian |
string |
Geri dönen yollar, kaldırım kullanımı dahil olmak üzere yayalar için iyileştirilmiştir. |
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. |
Route
Name | Tür | Description |
---|---|---|
guidance |
Kılavuzla ilgili öğeleri içerir. Bu alan yalnızca rehberlik istendiğinde bulunur ve kullanılabilir durumdadır. |
|
legs |
Route |
Bacaklar dizisi |
sections |
Bölümler dizisi |
|
summary |
Özet nesnesi |
RouteAvoidType
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.
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ı) şeritlerinin kullanılmasını gerektiren rotalardan kaçınır. |
ferries |
string |
Feribotları önler |
motorways |
string |
Otoyolları önler |
tollRoads |
string |
Ücretli yollardan kaçınıyor. |
unpavedRoads |
string |
Unpaved yolları önler |
RouteDirections
Bu nesne başarılı bir Yol Tarifleri çağrısından döndürülür
Name | Tür | Description |
---|---|---|
formatVersion |
string |
Format Version özelliği |
optimizedWaypoints |
İyileştirilmiş yol noktası dizisi. Özgün ve iyileştirilmiş liste için kullanıcı tarafından sağlanan yol noktası dizisinin dizinini gösterir. Örneğin, bir yanıt:
, özgün dizinin [0, 1, 2] ve iyileştirilmiş sıranın [1, 2, 0] olduğu anlamına gelir. Dizin 0 ile başladığından, özgün "birinci, ikinci, üçüncü", iyileştirilmiş ise "ikinci, üçüncü, ilk" şeklindedir. |
|
report |
Geçerli çağrıda kullanılan geçerli ayarları bildirir. |
|
routes |
Route[] |
Rotalar dizisi |
RouteGuidance
Kılavuzla ilgili öğeleri içerir. Bu alan yalnızca rehberlik istendiğinde bulunur ve kullanılabilir durumdadır.
Name | Tür | Description |
---|---|---|
instructionGroups |
Birbiriyle ilişkili yönerge öğelerinin bir dizisini Gruplar. |
|
instructions |
Manevraları açıklayan yönergelerin listesi. |
RouteInstruction
Bir manevrayı açıklayan bir öznitelik kümesi, örneğin 'Sağa dön', 'Sola tut', 'Feribota bin', 'Otoyola bin', 'Var'.
Name | Tür | Description |
---|---|---|
combinedMessage |
string |
Manevra için insan tarafından okunabilen bir ileti, bir sonraki yönergedeki mesajla birleştirildi. Bazen iki ardışık yönergeyi tek bir yönergede birleştirmek mümkündür ve bu da izlemeyi kolaylaştırır. Bu durumda possibleCombineWithNext bayrağı true olur. Örnek:
10. yönergedeki possibleCombineWithNext bayrağı true. Bu, kodlanmış kılavuzun istemcilerine yönerge 11 ile birleştirilebileceğini gösterir. Yönergeler, insanlar tarafından okunabilir rehberlik isteyen istemciler için otomatik olarak birleştirilir. combinedMessage alanı birleştirilmiş iletiyi içerir:
|
countryCode |
string |
3 karakterli ISO 3166-1 alfa-3 ülke kodu. Örneğin ABD. |
drivingSide |
Manevra noktasında sol ve sağ taraftaki sürüşü gösterir. |
|
exitNumber |
string |
Geçerli manevra tarafından alınan bir otoyol çıkışının sayısı... Bir çıkışın birden çok çıkış numarası varsa, bunlar "" ile ayrılır ve büyük olasılıkla "-" ile toplanır; örneğin, "10, 13-15". |
instructionType |
Yönergenin türü, örneğin yol formunun değiştirilmesi veya değiştirilmesi. |
|
junctionType |
Manevranın gerçekleştiği kavşağın türü. Daha büyük kavşaklar için, kavşak girmek ve kavşaktan çıkmak için iki ayrı yönerge oluşturulur. |
|
maneuver |
Manevrayı tanımlayan bir kod. |
|
message |
string |
Manevra için insan tarafından okunabilen bir mesaj. |
point |
Enlem ve boylam olarak temsil edilen konum. |
|
pointIndex |
integer |
Yönergenin noktasına karşılık gelen çok çizgili "noktalar" listesindeki noktanın dizini. |
possibleCombineWithNext |
boolean |
İsteğe bağlı olarak yönergeyi bir sonraki yönergeyle birleştirmek mümkündür. Bu, "Sola dön ve sonra sağa dön" gibi iletiler oluşturmak için kullanılabilir. |
roadNumbers |
string[] |
Manevradan sonraki bir sonraki önemli yol segmentlerinin veya izlenecek yolların yol sayıları... Örnek: ["E34", "N205"] |
roundaboutExitNumber |
string |
Bu, dönel kavşakta hangi çıkışın alınacak olduğunu gösterir. |
routeOffsetInMeters |
integer |
Yolun başlangıcından yönergenin noktasına uzaklık. |
signpostText |
string |
Manevrayla veya takip edilmesi gereken yöne en uygun işaret direğindeki metin. |
stateCode |
string |
ISO 3166-2 kodunun ikinci bölümüyle temsil edilen ülkenin alt bölümü (örneğin, eyalet). Bu yalnızca ABD, Kanada ve Meksika gibi bazı ülkelerde/bölgelerde kullanılabilir. |
street |
string |
Manevradan sonraki sonraki önemli yol segmentinin veya izlenmesi gereken caddenin sokak adı. |
travelTimeInSeconds |
integer |
RouteOffsetInMeters'e karşılık gelen noktaya kadar tahmini seyahat süresi. |
turnAngleInDecimalDegrees |
integer |
Yönergenin yönünü gösterir. junctionType bir dönüş yönergesi gösteriyorsa:
JunctionType bir çarpım yönergesi gösteriyorsa:
|
RouteInstructionGroup
Birbiriyle ilişkili yönerge öğelerinin bir dizisini Gruplar. Sıra aralığı firstInstructionIndex ve lastInstructionIndex ile kısıtlanır. İnsan tarafından okunabilen metin iletileri rehberlik için istendiğinde (instructionType=text veya etiketli), yönerge Grubu kullanılabilir olduğunda döndürülen bir özet iletiye sahiptir.
Name | Tür | Description |
---|---|---|
firstInstructionIndex |
integer |
Yönergelerdeki ilk yönergenin dizini ve bu gruba ait. |
groupLengthInMeters |
integer |
Grubun uzunluğu. |
groupMessage |
string |
İnsan tarafından okunabilen metin iletileri için rehberlik istendiğinde (instructionType=text veya etiketli) özet ileti. |
lastInstructionIndex |
integer |
Yönergelerdeki ve bu gruba ait olan son yönergenin dizini. |
RouteInstructionsType
Belirtilirse, kılavuz yönergeleri döndürülür. instructionsType parametresinin routeRepresentation=none ile birlikte kullanılamadığını unutmayın
Name | Tür | Description |
---|---|---|
coded |
string |
İnsan tarafından okunabilen iletiler olmadan ham yönerge verilerini döndürür. |
tagged |
string |
Biçimlendirmeye izin vermek için etiketli insan tarafından okunabilir iletiler içeren ham yönerge verilerini döndürür. İnsan tarafından okunabilir bir ileti, yinelenebilir tanımlanmış öğelerden oluşturulur. Bunlar, istemci uygulamalarının bunları doğru biçimlendirmesine izin vermek için etiketlenir. InstructionsType=tagged olduğunda aşağıdaki ileti bileşenleri etiketlenir: street, roadNumber, signpostText, exitNumber, roundaboutExitNumber. Etiketli 'Sola dön' iletisi örneği:
|
text |
string |
İnsan tarafından okunabilen iletiler içeren ham yönergeler verilerini düz metin olarak döndürür. |
RouteLeg
Bir nokta listesinden oluşan rotanın bir bölümünün açıklaması. İstekte sağlanan her ek yol noktası, döndürülen rotada ek bir bacakla sonuçlanır.
Name | Tür | Description |
---|---|---|
points |
Nokta dizisi |
|
summary |
Yol bölümü için özet nesnesi. |
RouteLegSummary
Yol bölümü için özet nesnesi.
Name | Tür | Description |
---|---|---|
arrivalTime |
string |
Rota veya bacak için tahmini varış zamanı. Saat UTC olarakdır. |
batteryConsumptionInkWh |
number |
Elektrik Tüketimi Modeli kullanılarak kilowatt saat (kWh) cinsinden tahmini elektrik enerjisi tüketimi. vehicleEngineType elektrikli olarak ayarlanırsa ve constantSpeedConsumptionInkWhPerHundredkm belirtilirse dahil edilir. BatteryConsumptionInkWh değeri, iyileştirilmiş elektrik enerjisini içerir ve bu nedenle negatif olabilir (bu da enerji kazandığını gösterir). Hem maxChargeInkWh hem de currentChargeInkWh belirtilirse, pil şarj düzeyinin maxChargeInkWh değerini asla aşmadığından emin olmak için yenileme sınırlanır. Ne maxChargeInkWh ne de currentChargeInkWh belirtilmezse, tüketim hesaplamasında kısıtlanmamış geri alma varsayılır. |
departureTime |
string |
Rota veya bacak için tahmini kalkış saati. Saat UTC olarakdır. |
fuelConsumptionInLiters |
number |
Yanma Tüketimi Modeli kullanılarak litre cinsinden tahmini yakıt tüketimi. VehicleEngineType yanma olarak ayarlanırsa ve constantSpeedConsumptionInLitersPerHundredkm belirtilirse dahil edilir. Değer negatif olmayacaktır. |
historicTrafficTravelTimeInSeconds |
integer |
Zamana bağlı geçmiş trafik verileri kullanılarak hesaplanan tahmini seyahat süresi. Yalnızca computeTravelTimeFor = tümü sorguda kullanılıyorsa dahil edilir. |
lengthInMeters |
integer |
Metre cinsinden Uzunluk özelliği |
liveTrafficIncidentsTravelTimeInSeconds |
integer |
Gerçek zamanlı hız verileri kullanılarak hesaplanan tahmini seyahat süresi. Yalnızca computeTravelTimeFor = tümü sorguda kullanılıyorsa dahil edilir. |
noTrafficTravelTimeInSeconds |
integer |
Tahmini seyahat süresi, trafik koşullarından (ör. tıkanıklık) dolayı rotada gecikme yaşanmaz gibi hesaplanır. Yalnızca computeTravelTimeFor = tümü sorguda kullanılıyorsa dahil edilir. |
trafficDelayInSeconds |
integer |
Trafik bilgilerine göre gerçek zamanlı olayların neden olduğu saniye cinsinden tahmini gecikme. Gelecekte kalkış saatiyle planlanan rotalar için gecikmeler her zaman 0'dır. Farklı trafik bilgisi türlerini kullanarak ek seyahat süreleri döndürmek için computeTravelTimeFor=all parametresinin eklenmesi gerekir. |
travelTimeInSeconds |
integer |
Gerçek zamanlı trafik nedeniyle gecikmeyi içeren saniye cinsinden tahmini seyahat süresi özelliği. Traffic=false travelTimeInSeconds yine de trafik nedeniyle gecikmeyi içerdiğini unutmayın. DepartAt gelecekteyse seyahat süresi zamana bağlı geçmiş trafik verileri kullanılarak hesaplanır. |
RouteOptimizedWaypoint
İyileştirilmiş yol noktası nesnesi.
Name | Tür | Description |
---|---|---|
optimizedIndex |
integer |
Sistemden iyileştirilmiş yol noktası dizini. |
providedIndex |
integer |
Kullanıcı tarafından sağlanan yol noktası dizini. |
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. |
RouteRepresentationForBestOrder
Yanıt olarak sağlanan yol kümesinin gösterimini belirtir. Bu parametre değeri yalnızca computeBestOrder=true ile birlikte kullanılabilir.
Name | Tür | Description |
---|---|---|
none |
string |
Yalnızca iyileştirilmiş yol noktası dizinlerini içerir, ancak yanıta rota geometrisini içermez. |
polyline |
string |
Yanıta rota geometrisi ekler. |
summaryOnly |
string |
Çok hatlı olarak özet, ancak yanıttaki rotalar için nokta geometrisi öğelerini hariç tutarak. |
RouteSection
Yol bölümleri, bir yolun bölümleri hakkında ek bilgiler içerir. Her bölüm en az , endPointIndex
ve sectionType
öğelerini startPointIndex
içerir.
Name | Tür | Description |
---|---|---|
delayInSeconds |
integer |
Olayın neden olduğu saniyelerdeki gecikme. |
effectiveSpeedInKmh |
integer |
Olayın km/s cinsinden etkin hızı, tüm uzunluğunun ortalamasını alır. |
endPointIndex |
integer |
Bu bölümün uygulandığı yoldaki son noktanın (uzaklık 0) dizini. |
magnitudeOfDelay |
Olayın neden olduğu gecikmenin büyüklüğü. Bu değerler , Trafik Olayı Ayrıntısı Alma API'sinin yanıt alanı ty değerlerine karşılık gelir. |
|
sectionType |
Bildirilen yol yanıtının bölüm türleri |
|
simpleCategory |
Olayın türü. Şu anda JAM, ROAD_WORK, ROAD_CLOSURE veya OTHER olabilir. Ayrıntılı bilgi için "tec" bölümüne bakın. |
|
startPointIndex |
integer |
Bu bölümün uygulandığı yoldaki ilk noktanın (uzaklık 0) dizini. |
tec |
TPEG2-TEC standardında tanımları kullanarak trafik olayının ayrıntıları. effectCode içerebilir ve öğelere neden olabilir. |
|
travelMode |
Hesaplanan rota için seyahat modu. İstenen aktarım modu bu bölümde mümkün değilse değer olarak ayarlanır |
RouteSectionTec
TPEG2-TEC standardında tanımları kullanarak trafik olayının ayrıntıları. effectCode içerebilir ve öğelere neden olabilir.
Name | Tür | Description |
---|---|---|
causes |
Diziye neden olur |
|
effectCode |
integer |
Trafik akışı üzerindeki etkisi. TPEG2-TEC standardında tanımlandığı gibi tec001:EffectCode tablosunda bir değer içerir. Trafik olaylarını önem derecesine göre renklendirmek için kullanılabilir. |
RouteSectionTecCause
Trafik olayının nedeni. mainCauseCode ve subCauseCode öğelerini içerebilir. Simge ve açıklamaları tanımlamak için kullanılabilir.
Name | Tür | Description |
---|---|---|
mainCauseCode |
integer |
Trafik olayının ana nedeni. TPEG2-TEC standardında tanımlandığı gibi tec002:CauseCode tablosunda bir değer içerir. |
subCauseCode |
integer |
Trafik olayının alt parçası. TPEG2-TEC standardında tanımlandığı gibi mainCauseCode tarafından tanımlanan alt neden tablosunda bir değer içerir. |
RouteSummary
Özet nesnesi
Name | Tür | Description |
---|---|---|
arrivalTime |
string |
Rota veya bacak için tahmini varış zamanı. Saat UTC olarakdır. |
departureTime |
string |
Rota veya bacak için tahmini kalkış saati. Saat UTC olarakdır. |
lengthInMeters |
integer |
Metre cinsinden Uzunluk özelliği |
trafficDelayInSeconds |
integer |
Trafik bilgilerine göre gerçek zamanlı olayların neden olduğu saniye cinsinden tahmini gecikme. Gelecekte kalkış saatiyle planlanan rotalar için gecikmeler her zaman 0'dır. Farklı trafik bilgisi türlerini kullanarak ek seyahat süreleri döndürmek için computeTravelTimeFor=all parametresinin eklenmesi gerekir. |
travelTimeInSeconds |
integer |
Gerçek zamanlı trafik nedeniyle gecikmeyi içeren saniye cinsinden tahmini seyahat süresi özelliği. Traffic=false travelTimeInSeconds yine de trafik nedeniyle gecikmeyi içerdiğini unutmayın. DepartAt gelecekteyse seyahat süresi zamana bağlı geçmiş trafik verileri kullanılarak hesaplanır. |
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 |
İlgi çekici 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 |
SectionType
Yol yanıtında hangi bölüm türlerinin bildirilmiş olduğunu belirtir.
Örneğin sectionType = yaya ise yalnızca yayalar için uygun olan bölümler döndürülür. Birden çok tür kullanılabilir. Varsayılan sectionType, travelMode girişine başvurur. Varsayılan olarak travelMode, araba olarak ayarlanır
Name | Tür | Description |
---|---|---|
carTrain |
string |
Rotanın arabalar veya trenler olan bölümleri. |
carpool |
string |
Yolun, araç havuzu (HOV/Yüksek Doluluk Aracı) şeritlerinin kullanılmasını gerektiren bölümleri. |
country |
string |
Rotanın hangi ülkelerde/bölgelerde olduğunu gösteren bölümler. |
ferry |
string |
Rotanın feribot olan bölümleri. |
motorway |
string |
Yolun otoyollar olan bölümleri. |
pedestrian |
string |
Rotanın yalnızca yayalar için uygun bölümleri. |
tollRoad |
string |
Rotanın ücretli ödeme gerektiren bölümleri. |
tollVignette |
string |
Rotanın ücretli bir vignette bulunmasını gerektiren bölümleri. |
traffic |
string |
Yolun trafik bilgilerini içeren bölümleri. |
travelMode |
string |
İstek parametresiyle |
tunnel |
string |
Yolun tünel olan bölümleri. |
urban |
string |
Yolun kentsel alanlarda bulunan bölümleri. |
SimpleCategory
Olayın türü. Şu anda JAM, ROAD_WORK, ROAD_CLOSURE veya OTHER olabilir. Ayrıntılı bilgi için "tec" bölümüne bakın.
Name | Tür | Description |
---|---|---|
JAM |
string |
Trafik sıkışıklığı. |
OTHER |
string |
Diğer. |
ROAD_CLOSURE |
string |
Yol kapatma. |
ROAD_WORK |
string |
Yol çalışması. |
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ü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.
Name | Tür | Description |
---|---|---|
bicycle |
string |
Döndürülen rotalar, bisiklet kulvarlarının kullanımı da dahil olmak üzere bisikletler için iyileştirilmiştir. |
bus |
string |
Döndürülen rotalar, yalnızca otobüs şeritlerinin kullanımı dahil olmak üzere otobüsler için iyileştirilmiştir. BETA işlevselliği. |
car |
string |
Döndürülen rotalar otomobiller için iyileştirilmiştir. |
motorcycle |
string |
Döndürülen rotalar motosikletler için optimize edilmiştir. BETA işlevselliği. |
pedestrian |
string |
Geri dönen yollar, kaldırım kullanımı dahil olmak üzere yayalar için iyileştirilmiştir. |
taxi |
string |
Döndürülen rotalar taksiler için iyileştirilmiştir. BETA işlevselliği. |
truck |
string |
Döndürülen rotalar, kamyonlar gibi ticari araçlar için iyileştirilmiştir. |
van |
string |
Döndürülen yollar, van'lar için iyileştirilmiştir. BETA işlevselliği. |
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 ise 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 =heyecan verici ile routeType
birlikte kullanılabilir.
Name | Tür | Description |
---|---|---|
high |
string |
yüksek |
low |
string |
Düşük |
normal |
string |
Normal |