Route - Post Route Directions
Belirtilen herhangi bir yol noktasından geçerek belirli bir çıkış noktası ile hedef arasındaki yolu hesaplamak için kullanın.
Post Route Directions
API,bir kaynak ile hedef arasında bir yol döndüren ve belirtilirse yol noktalarından geçen bir HTTP POST
isteğidir. Rota, istenen haftanın günü ve günün saatinde geçerli trafik ve tipik yol hızları gibi faktörleri hesaba katacaktı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. İlgili kavramların ve parametrelerin ayrıntılı açıklaması için lütfen Tüketim Modeli denetleyin.
POST https://atlas.microsoft.com/route/directions/{format}?api-version=1.0&query={query}
POST https://atlas.microsoft.com/route/directions/{format}?api-version=1.0&query={query}&maxAlternatives={maxAlternatives}&alternativeType={alternativeType}&minDeviationDistance={minDeviationDistance}&minDeviationTime={minDeviationTime}&instructionsType={instructionsType}&language={language}&computeBestOrder={computeBestOrder}&routeRepresentation={routeRepresentation}&computeTravelTimeFor={computeTravelTimeFor}&vehicleHeading={vehicleHeading}&report=effectiveSettings§ionType={sectionType}&arriveAt={arriveAt}&departAt={departAt}&vehicleAxleWeight={vehicleAxleWeight}&vehicleLength={vehicleLength}&vehicleHeight={vehicleHeight}&vehicleWidth={vehicleWidth}&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 |
|
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 gereklidir. İlki kaynak, sonuncusu ise rotanın hedefidir. aralarındaki isteğe bağlı koordinatlar, rotada WayPoint olarak hareket eder. 150 WayPoint'e kadar geçiş yapabilirsiniz. |
acceleration
|
query |
number double |
Araç hızlandığında (kineticEnergyGained/ChemicalEnergyConsumed) yakıtta depolanan kimyasal enerjinin kinetik enerjiye dönüştürülmesinin verimliliğini belirtir. ChemicalEnergyConsumed, fuelEnergyDensityInMJoulesPerLiterkullanılarak tüketilen yakıtın kimyasal enerjiye dönüştürülmesiyle elde edilir. yavaşlamaEfficiencyile eşleştirilmelidir. İzin verilen değer aralığı 0,0 - 1/yavaşlamaEfficiency'dır. Duyarlı Değerler : Yanma Modeli için: 0,33, Elektrik Modeli için: 0,66 |
|
alternative
|
query |
Başvuru yolu ile karşılaştırıldığında, hesaplanan alternatiflerin belirli planlama ölçütlerine göre en uygun olanını denetler. |
||
arrive
|
query |
string date-time |
hedef noktasına varış tarihi ve saati, isteğe bağlı saat dilimi uzaklığıyla RFC 3339, bölüm 5.6'de tanımlandığı şekilde Örnekler:
|
|
auxiliary
|
query |
number double |
Kilowatt cinsinden (kW) yardımcı sistemlerin sürdürülmesi için tüketilen güç miktarını 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ı saatte litre cinsinden belirtir. Ac sistemleri, radyo, ısıtma vb. cihazlar ve sistemler nedeniyle tüketimi belirtmek için kullanılabilir. Duyarlı Değerler : 0.2 |
|
avoid
|
query |
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. |
||
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ısaile birlikte kullanıldığında en iyi sonuçları verir. Kaynağın 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ıp 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 ile birlikte kullanılmasına izin verilmez yok. |
|
compute
|
query |
Farklı tür trafik bilgileri (yok, tarihi, 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 oranı çiftlerinin sıralanmamış bir listesi olarak sağlanır. Liste, tüketim eğrisi üzerindeki noktaları tanımlar. Listede bulunmayan hızların tüketim oranları aşağıdaki gibi bulunur:
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 en yüksek hızı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. Duyarlı Değerler: 50,8.2:130,21.3 Bu parametre, Elektrik tüketim modeliiçin gereklidir. |
|
constant
|
query |
string |
Tüketimin hıza bağımlı bileşenini belirtir. İki nokta üst üste sınırlanmış 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ın tüketim oranları aşağıdaki gibi bulunur:
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 en yüksek hızı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. Duyarlı Değerler: 50,6,3:130,11,5 |
|
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 Duyarlı Değerler : 43 |
|
current
|
query |
number double |
Litre olarak yakıtın geçerli tedarikini belirtir. Duyarlı Değerler : 55 |
|
deceleration
|
query |
number double |
Araç (örneğin ChemicalEnergySaved/KineticEnergyLost) yavaşladığında kinetik enerjinin tasarruflu (tüketilmeyen) yakıta dönüştürülmesinin verimliliğini belirtir. ChemicalEnergySaved, fuelEnergyDensityInMJoulesPerLiterkullanılarak tasarruf edilen (tüketilmeyen) yakıtın enerjiye dönüştürülmesiyle elde edilir. hızlandırmaEfficiencyile eşleştirilmelidir. İzin verilen değer aralığı 0,0 - 1/accelerationEfficiency'dı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ığıyla RFC 3339, bölüm 5.6içinde tanımlandığı şekilde
Örnekler:
|
|
downhill
|
query |
number double |
Araç yükselme kaybettiğinde (yani ChemicalEnergySaved/PotentialEnergyLost) potansiyel enerjiyi tasarruflu (tüketilmeyen) yakıta dönüştürmenin verimliliğini belirtir. ChemicalEnergySaved, fuelEnergyDensityInMJoulesPerLiterkullanılarak tasarruf edilen (tüketilmeyen) yakıtın enerjiye dönüştürülmesiyle elde edilir. uphillEfficiencyile eşleştirilmelidir. İzin verilen değer aralığı 0,0 ile 1/yokuş yukarıEfficiency'dı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. *Efficiency parametresi ayarlandıysa bu parametre gereklidir. Duyarlı Değerler : 34.2 |
|
hilliness
|
query |
Heyecan verici rota için tepelik derecesi. Bu parametre yalnızca |
||
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 |
dil parametresi, kılavuz iletilerinin dilini belirler. Düzgün isimleri (sokakların, plazaların, vb.) etkilemez instructionsType=coded olduğunda hiçbir etkisi olmaz. İzin verilen değerler IETF dil etiketlerinin (bir alt kümesi) açıklanmıştır |
|
max
|
query |
integer |
Hesaplanacak istenen alternatif yolların sayısı. Varsayılan: 0, en az: 0 ve en fazla: 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 currentChargeInkWhdeğerinden büyük veya buna eşit olması gerekir. Duyarlı 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 çıkış 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 çıkış noktasından başvuru yolunu (bkz. POST İstekleri bölümüne bakın) en az bu sayıda 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. 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. |
||
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'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. |
||
uphill
|
query |
number double |
Araç yükselme (örneğin PotentialEnergyGained/ChemicalEnergyConsumed) kazandığında yakıtta depolanan kimyasal enerjinin potansiyel enerjiye dönüştürülmesinin verimliliğini belirtir. ChemicalEnergyConsumed, fuelEnergyDensityInMJoulesPerLiterkullanılarak tüketilen yakıtın kimyasal enerjiye dönüştürülmesiyle elde edilir. downhillEfficiencyile eşleştirilmelidir. İzin verilen değer aralığı 0,0 ile 1/downhillEfficiency'dır. Duyarlı Değerler : Yanma Modeli için: 0,27, Elektrik Modeli için: 0,74 |
|
vehicle
|
query |
integer |
Kg cinsinden aracın aks başına ağırlığı. 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, vehicleEngineTypedeğeriyle tutarlı olmalıdır. |
||
vehicle
|
query |
integer |
Aracın yön yönü, doğru Kuzey'den başlayıp saat yönünde devam eden dereceler halindedir. 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 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. |
||
vehicle
|
query |
integer |
Aracın km/saat cinsinden 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.
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 |
İ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 rehberlik için aşağıdaki |
İstek Gövdesi
Name | Tür | Description |
---|---|---|
allowVignette |
string[] |
Bu liste 3 karakterli, ISO 3166-1, ülke/bölgelerin alfa-3 ülke kodlarının listesidir ve vinyetli ücretli yollara izin verilir, örneğin "AUS,CHE". Bazı ülkeler/bölgeler X ile allowVignette |
avoidAreas |
Kaçınılması gereken alanların listesini temsil eden bir GeoJSON MultiPolygon. Yalnızca dikdörtgen çokgenler desteklenir. Dikdörtgenin en büyük boyutu yaklaşık 160x160 km'dir. En fazla 10 |
|
avoidVignette |
string[] |
Bu liste 3 karakterli, ISO 3166-1, ülke/bölgelerin alfa-3 ülke kodlarının listesidir. Bu kodlar, vinyetli tüm ücretli yollardan kaçınılması gereken bölgelerdir, örneğin "AUS,CHE". Listede olmayan ülkelerde/bölgelerde vinyet içeren ücretli yollar etkilenmez. Not: hem avoidVignette hem de allowVignette |
supportingPoints |
Rota yeniden oluşturma ve bu başvuru yoluna sıfır veya daha fazla alternatif yolu hesaplamak için giriş olarak kullanılan koordinat dizisini temsil eden bir GeoJSON Geometri koleksiyonu.
|
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ı , uygulamanın erişim istediği Azure Haritalar kaynağını belirtmek için
x-ms-client-id
üst bilgisinin 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
- 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
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 route between an origin and a destination with additional parameters in the body
Örnek isteği
POST https://atlas.microsoft.com/route/directions/json?api-version=1.0&query=52.50931,13.42936:52.50274,13.43872&report=effectiveSettings
{
"supportingPoints": {
"type": "GeometryCollection",
"geometries": [
{
"type": "Point",
"coordinates": [
13.42936,
52.5093
]
},
{
"type": "Point",
"coordinates": [
13.42859,
52.50844
]
}
]
},
"avoidVignette": [
"AUS",
"CHE"
],
"avoidAreas": {
"type": "MultiPolygon",
"coordinates": [
[
[
[
-122.39456176757811,
47.489368981370724
],
[
-122.00454711914061,
47.489368981370724
],
[
-122.00454711914061,
47.65151268066222
],
[
-122.39456176757811,
47.65151268066222
],
[
-122.39456176757811,
47.489368981370724
]
]
],
[
[
[
100,
0
],
[
101,
0
],
[
101,
1
],
[
100,
1
],
[
100,
0
]
]
]
]
}
}
Örnek yanıt
{
"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 yolu ile karşılaştırıldığında, hesaplanan alternatiflerin belirli planlama ölçütlerine göre en uygun olanını denetler. |
Compute |
Farklı tür trafik bilgileri (yok, tarihi, 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. |
Delay |
Olayın neden olduğu gecikmenin büyüklüğü. Bu değerler, Trafik Olayı Ayrıntısı API'sini almayanıt alanı ty değerlerine karşılık gelir. |
Driving |
Manevra noktasında sola ve sağ tarafa doğru sürüşü gösterir. |
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ı |
Geo |
Geçerli bir |
Geo |
Geçerli bir |
Geo |
Geçerli bir |
Geo |
Geçerli bir |
Geo |
Geçerli bir |
Geo |
Geçerli bir |
Geo |
Geçerli bir |
Geo |
Geçerli bir |
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 |
Junction |
Manevranın gerçekleştiği kavşağın türü. Daha büyük kavşaklar için, yuvarlak kavşak girmek ve çı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. 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 |
Response |
Bildirilen yol yanıtının bölüm türleri |
Response |
Hesaplanan rota için seyahat modu. bu bölümde istenen aktarım modu mümkün değilse değer |
Route | |
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 |
Yol tarifleri için gövde sonrası parametreleri. |
Route |
Bu nesne başarılı bir Yol Tarifleri çağrısından döndürülür |
Route |
Rehberlikle ilgili öğeleri içerir. Bu alan yalnızca rehberlik istendiğinde ve kullanılabilir olduğunda bulunur. |
Route |
Bir manevrayı açıklayan bir dizi öznitelik, örneğin 'Sağa dön', 'Sola dön', 'Feribota bin', 'Otoyola çık', 'Var'. |
Route |
Birbiriyle ilişkili yönerge öğelerinin bir dizisini gruplandırır. Sıra aralığı firstInstructionIndex ve lastInstructionIndex ile kısıtlanır. İnsan tarafından okunabilen metin iletileri yönergeler için istendiğinde (instructionType=text veya etiketli), varsa instructionGroup'ta bir özet iletisi döndürülür. |
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 bir rota parçası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ı raporlar. |
Route |
Yanıt olarak sağlanan yol kümesinin gösterimini belirtir. |
Route |
Rota bölümleri, bir yolun parçaları hakkında ek bilgiler içerir. Her bölüm, |
Route |
TPEG2-TEC standardındaki 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. Simgeografiyi 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'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 |
AlternativeRouteType
Başvuru yolu ile karşılaştırıldığında, hesaplanan alternatiflerin belirli planlama ölçütlerine göre en uygun olanını denetler.
Name | Tür | Description |
---|---|---|
anyRoute |
string |
Başvuru yolu ile en iyi duruma göre 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ür trafik bilgileri (yok, tarihi, 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.
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ı API'sini almayanıt alanı ty değerlerine karşılık gelir.
Name | Tür | Description |
---|---|---|
0 |
string |
Bilinmeyen. |
1 |
string |
Küçük. |
2 |
string |
Ilımlı. |
3 |
string |
Binbaşı. |
4 |
string |
Tanımsız, yol kapatmalar ve diğer süresiz gecikmeler için kullanılır. |
DrivingSide
Manevra noktasında sola ve sağ tarafa doğru sürüşü gösterir.
Name | Tür | Description |
---|---|---|
LEFT |
string |
Sol taraf. |
RIGHT |
string |
Sağ tarafa. |
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. |
GeoJsonGeometry
Geçerli bir GeoJSON
geometri nesnesi. Tür yedi geçerli GeoJSON geometri türünden biri olmalıdır: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon ve GeometryCollection. Ayrıntılar için lütfen RFC 7946 bakın.
Name | Tür | Description |
---|---|---|
type |
Geo |
|
GeoJsonGeometryCollection
Geçerli bir GeoJSON GeometryCollection
nesne türü. Ayrıntılar için lütfen RFC 7946 bakın.
Name | Tür | Description |
---|---|---|
geometries | GeoJsonGeometry[]: |
Geçerli |
type |
string:
Geometry |
|
GeoJsonLineString
Geçerli bir GeoJSON LineString
geometri türü. Ayrıntılar için lütfen RFC 7946 bakın.
Name | Tür | Description |
---|---|---|
coordinates |
number[] |
|
type |
string:
Line |
|
GeoJsonMultiLineString
Geçerli bir GeoJSON MultiLineString
geometri türü. Ayrıntılar için lütfen RFC 7946 bakın.
Name | Tür | Description |
---|---|---|
coordinates |
number[] |
|
type |
string:
Multi |
|
GeoJsonMultiPoint
Geçerli bir GeoJSON MultiPoint
geometri türü. Ayrıntılar için lütfen RFC 7946 bakın.
Name | Tür | Description |
---|---|---|
coordinates |
number[] |
|
type |
string:
Multi |
|
GeoJsonMultiPolygon
Geçerli bir GeoJSON MultiPolygon
nesne türü. Ayrıntılar için lütfen RFC 7946 bakın.
Name | Tür | Description |
---|---|---|
coordinates |
number[] |
Geçerli |
type |
string:
Multi |
|
GeoJsonPoint
Geçerli bir GeoJSON Point
geometri türü. Ayrıntılar için lütfen RFC 7946 bakın.
Name | Tür | Description |
---|---|---|
coordinates |
number[] |
|
type |
string:
Point |
|
GeoJsonPolygon
Geçerli bir GeoJSON Polygon
geometri türü. Ayrıntılar için lütfen RFC 7946 bakın.
Name | Tür | Description |
---|---|---|
coordinates |
number[] |
|
type |
string:
Polygon |
|
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ış konumu. |
LOCATION_WAYPOINT |
string |
Yol noktası konumu. |
ROAD_CHANGE |
string |
Yol Değişikliği. |
TURN |
string |
Dönmek. |
GuidanceManeuver
Manevrayı tanımlayan bir kod.
Name | Tür | Description |
---|---|---|
ARRIVE |
string |
Geldiniz. |
ARRIVE_LEFT |
string |
Geldiniz. Hedefiniz sol tarafta. |
ARRIVE_RIGHT |
string |
Geldiniz. Hedefiniz sağ tarafta. |
BEAR_LEFT |
string |
Ayı gitti. |
BEAR_RIGHT |
string |
Ayı sağ. |
DEPART |
string |
Ayrılmak. |
ENTER_FREEWAY |
string |
Otobana bin. |
ENTER_HIGHWAY |
string |
Otobana bin. |
ENTER_MOTORWAY |
string |
Otoyola çık. |
ENTRANCE_RAMP |
string |
Rampadan çıkın. |
FOLLOW |
string |
Takip etmek. |
KEEP_LEFT |
string |
Sola doğru devam edin. |
KEEP_RIGHT |
string |
Sağa doğru devam edin. |
MAKE_UTURN |
string |
U dönüşü yapın. |
MOTORWAY_EXIT_LEFT |
string |
Sol çıkışa geçin. |
MOTORWAY_EXIT_RIGHT |
string |
Doğru çıkışa çık. |
ROUNDABOUT_BACK |
string |
Kavşak etrafından dolaş. |
ROUNDABOUT_CROSS |
string |
Kavşağa geç. |
ROUNDABOUT_LEFT |
string |
Kavşakta soldan çıkışa geçin. |
ROUNDABOUT_RIGHT |
string |
Kavşakta sağ taraftaki çıkışa doğru inin. |
SHARP_LEFT |
string |
Keskin sola 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. |
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 routeType
=heyecan verici ile birlikte kullanılabilir.
Name | Tür | Description |
---|---|---|
high |
string |
yüksek |
low |
string |
alçak |
normal |
string |
normal |
JunctionType
Manevranın gerçekleştiği kavşağın türü. Daha büyük kavşaklar için, yuvarlak kavşak girmek ve çıkmak için iki ayrı yönerge oluşturulur.
Name | Tür | Description |
---|---|---|
BIFURCATION |
string |
Çatallanma |
REGULAR |
string |
düzenli |
ROUNDABOUT |
string |
atlıkarınca |
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. 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
Name | Tür | Description |
---|---|---|
json |
string |
JavaScript Nesne Gösterimi Veri Değişim Biçimi |
xml |
string |
Genişletilebilir biçimlendirme dili |
ResponseSectionType
Bildirilen yol yanıtının bölüm türleri
Name | Tür | Description |
---|---|---|
CARPOOL |
string |
Yolun, araç havuzu (HOV/Yüksek Dolu Araç) ş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 |
Ücretin ödenmesini gerektiren rota bölümleri. |
TOLL_VIGNETTE |
string |
Rotanın ücretli bir vinyet gerektiren bölümleri. |
TRAFFIC |
string |
Yolun trafik bilgilerini içeren bölümleri. |
TRAVEL_MODE |
string |
|
TUNNEL |
string |
Yolun tünel olan bölümleri. |
URBAN |
string |
Kentsel alanların içinde yer alan rotanın bölümleri. |
ResponseTravelMode
Hesaplanan rota için seyahat modu. bu bölümde istenen aktarım modu mümkün değilse değer other
olarak ayarlanır
Name | Tür | Description |
---|---|---|
bicycle |
string |
Döndürülen rotalar, bisiklet şeritlerinin kullanımı dahil olmak üzere bisikletler için optimize edilmiş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şlevselliği. |
car |
string |
Döndürülen rotalar arabalar için iyileştirilmiştir. |
motorcycle |
string |
Döndürülen rotalar motosikletler için optimize edilmiştir. BETA işlevselliği. |
other |
string |
Bu bölümde verilen taşıma modu mümkün değildir |
pedestrian |
string |
Geri dönen yollar, kaldırım kullanımı dahil olmak üzere yayalar için optimize edilmiş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 optimize edilmiştir. |
van |
string |
Döndürülen yollar minibüsler için iyileştirilmiştir. BETA işlevselliği. |
Route
Name | Tür | Description |
---|---|---|
guidance |
Rehberlikle ilgili öğeleri içerir. Bu alan yalnızca rehberlik istendiğinde ve kullanılabilir olduğunda bulunur. |
|
legs |
Route |
Bacaklar dizisi |
sections |
Sections dizisi |
|
summary |
Özet nesnesi |
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.
Name | Tür | Description |
---|---|---|
alreadyUsedRoads |
string |
Aynı yolu birden çok kez kullanmaktan kaçınıyor.
|
borderCrossings |
string |
Rota hesaplamasında sınır geçişlerini önler. |
carpools |
string |
Araç havuzu (HOV/Yüksek Dolu Araç) şeritlerinin kullanılmasını gerektiren rotalardan kaçınıyor. |
ferries |
string |
Feribotları önler |
motorways |
string |
Otoyollardan kaçınıyor |
tollRoads |
string |
Ücretli yollardan kaçınıyor. |
unpavedRoads |
string |
Kazınmamış yollardan kaçınıyor |
RouteDirectionParameters
Yol tarifleri için gövde sonrası parametreleri.
Name | Tür | Description |
---|---|---|
allowVignette |
string[] |
Bu liste 3 karakterli, ISO 3166-1, ülke/bölgelerin alfa-3 ülke kodlarının listesidir ve vinyetli ücretli yollara izin verilir, örneğin "AUS,CHE". Bazı ülkeler/bölgeler X ile allowVignette |
avoidAreas |
Kaçınılması gereken alanların listesini temsil eden bir GeoJSON MultiPolygon. Yalnızca dikdörtgen çokgenler desteklenir. Dikdörtgenin en büyük boyutu yaklaşık 160x160 km'dir. En fazla 10 |
|
avoidVignette |
string[] |
Bu liste 3 karakterli, ISO 3166-1, ülke/bölgelerin alfa-3 ülke kodlarının listesidir. Bu kodlar, vinyetli tüm ücretli yollardan kaçınılması gereken bölgelerdir, örneğin "AUS,CHE". Listede olmayan ülkelerde/bölgelerde vinyet içeren ücretli yollar etkilenmez. Not: hem avoidVignette hem de allowVignette |
supportingPoints |
Rota yeniden oluşturma ve bu başvuru yoluna sıfır veya daha fazla alternatif yolu hesaplamak için giriş olarak kullanılan koordinat dizisini temsil eden bir GeoJSON Geometri koleksiyonu.
|
RouteDirections
Bu nesne başarılı bir Yol Tarifleri çağrısından döndürülür
Name | Tür | Description |
---|---|---|
formatVersion |
string |
Biçim Sürümü özelliği |
optimizedWaypoints |
Yol noktalarının iyileştirilmiş sırası. Ö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ü, birinci" olur. |
|
report |
Geçerli çağrıda kullanılan geçerli ayarları raporlar. |
|
routes |
Route[] |
Rotalar dizisi |
RouteGuidance
Rehberlikle ilgili öğeleri içerir. Bu alan yalnızca rehberlik istendiğinde ve kullanılabilir olduğunda bulunur.
Name | Tür | Description |
---|---|---|
instructionGroups |
Birbiriyle ilişkili yönerge öğelerinin bir dizisini gruplandırır. |
|
instructions |
Manevraları açıklayan yönergelerin listesi. |
RouteInstruction
Bir manevrayı açıklayan bir dizi öznitelik, örneğin 'Sağa dön', 'Sola dön', 'Feribota bin', 'Otoyola çık', 'Var'.
Name | Tür | Description |
---|---|---|
combinedMessage |
string |
Manevra için insan tarafından okunabilen bir ileti, sonraki yönergedeki mesajla birleştirildi. Bazen birbirini izleyen iki yönergeyi tek bir yönergede birleştirmek mümkündür ve bu da izlemeyi kolaylaştırır. Bu durumda, olasıCombineWithNext bayrağı true olur. Mesela:
Yönerge 10'da possibleCombineWithNext bayrağı true. Bu, kodlanmış kılavuzun istemcilerine yönerge 11 ile birleştirilebileceğini gösterir. yönergeler, insan 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 sola ve sağ tarafa doğru sürüşü gösterir. |
|
exitNumber |
string |
Geçerli manevra tarafından alınan bir otoyol çıkışının sayıları. Bir çıkışta 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, yuvarlak kavşak girmek ve çıkmak için iki ayrı yönerge oluşturulur. |
|
maneuver |
Manevrayı tanımlayan bir kod. |
|
message |
string |
Manevra için okunabilir 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 numarası(lar). Örnek: ["E34", "N205"] |
roundaboutExitNumber |
integer |
Bu, bir kavşakta hangi çıkışın alınacak olduğunu gösterir. |
routeOffsetInMeters |
integer |
Yolun başlangıcından yönerge noktasına olan uzaklık. |
signpostText |
string |
Bir işaret direğindeki, manevrayla veya takip edilmesi gereken yönde en ilgili olan metin. |
stateCode |
string |
Bir 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 bir sonraki önemli yol segmentinin veya izlenmesi gereken caddenin sokak adı. |
travelTimeInSeconds |
integer |
RouteOffsetInMeters'e karşılık gelen noktaya kadar olan 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 gruplandırır. Sıra aralığı firstInstructionIndex ve lastInstructionIndex ile kısıtlanır. İnsan tarafından okunabilen metin iletileri yönergeler için istendiğinde (instructionType=text veya etiketli), varsa instructionGroup'ta bir özet iletisi döndürülür.
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 yönergeler için 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 |
düz metin olarak insan tarafından okunabilen iletiler içeren ham yönergeler verilerini döndürür. |
RouteLeg
Bir nokta listesinden oluşan bir rota parçası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 olarak ayarlanı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. PilConsumptionInkWh değeri geri kazanılmış 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 yeniden iyileşme eşlenir. MaxChargeInkWh veya 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 olarak ayarlanı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 eklenir. |
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 eklenir. |
noTrafficTravelTimeInSeconds |
integer |
Tahmini seyahat süresi, trafik koşullarından (örn. tıkanıklık) dolayı rotada gecikme yaşanmaz gibi hesaplanır. Yalnızca computeTravelTimeFor = tümü sorguda kullanılıyorsa eklenir. |
trafficDelayInSeconds |
integer |
Trafik bilgilerine göre gerçek zamanlı olayların neden olduğu saniye cinsinden tahmini gecikme. Gelecekte kalkış saati ile 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ğinde bile 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ı raporlar.
Name | Tür | Description |
---|---|---|
effectiveSettings |
Bu Rota API'si çağrılırken kullanılan etkili parametreler veya veriler. |
RouteRepresentationForBestOrder
Yanıt olarak sağlanan yol kümesinin gösterimini belirtir.
Name | Tür | Description |
---|---|---|
none |
string |
Yalnızca iyileştirilmiş yol noktası dizinlerini içerir, ancak yanıta rota geometrisini içermez. Bu parametre değeri yalnızca computeBestOrder=true ile birlikte kullanılabilir. |
polyline |
string |
Yanıta rota geometrisi ekler. |
summaryOnly |
string |
Çok çizgiye göre özet, ancak yanıttaki yollar için nokta geometrisi öğelerini hariç tutarak. |
RouteSection
Rota bölümleri, bir yolun parçaları hakkında ek bilgiler içerir. Her bölüm, startPointIndex
, endPointIndex
ve sectionType
öğelerini içerir.
Name | Tür | Description |
---|---|---|
delayInSeconds |
integer |
Olayın neden olduğu saniyeler içinde gecikme. |
effectiveSpeedInKmh |
integer |
Olayın km/s cinsinden etkin hızı, uzunluğunun tamamı boyunca ortalamadı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ı API'sini almayanı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ındaki tanımları kullanarak trafik olayının ayrıntıları. effectCode içerebilir ve öğelere neden olabilir. |
|
travelMode |
Hesaplanan rota için seyahat modu. bu bölümde istenen aktarım modu mümkün değilse değer |
RouteSectionTec
TPEG2-TEC standardındaki 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. Simgeografiyi ve açıklamaları tanımlamak için kullanılabilir.
Name | Tür | Description |
---|---|---|
mainCauseCode |
integer |
Trafik olayının temel 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 olarak ayarlanır. |
departureTime |
string |
Rota veya bacak için tahmini kalkış saati. Saat UTC olarak ayarlanı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ış saati ile 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ğinde bile 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 |
İ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.
|
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. Bir istekte birden çok kez belirtilebilir, örneğin, '§ionType=carTrain§ionType=yaya§ionType=otoyol'. 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 Dolu Araç) ş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 |
Ücretin ödenmesini gerektiren rota bölümleri. |
tollVignette |
string |
Rotanın ücretli bir vinyet gerektiren bölümleri. |
traffic |
string |
Yolun trafik bilgilerini içeren bölümleri. |
travelMode |
string |
|
tunnel |
string |
Yolun tünel olan bölümleri. |
urban |
string |
Kentsel alanların içinde yer alan rotanın 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 |
Başka. |
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'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.
Name | Tür | Description |
---|---|---|
bicycle |
string |
Döndürülen rotalar, bisiklet şeritlerinin kullanımı dahil olmak üzere bisikletler için optimize edilmiş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şlevselliği. |
car |
string |
Döndürülen rotalar arabalar 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 optimize edilmiş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 optimize edilmiştir. |
van |
string |
Döndürülen yollar minibüsler için iyileştirilmiş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.
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 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.
Name | Tür | Description |
---|---|---|
USHazmatClass1 |
string |
Patlayıcı |
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 |
USHazmatClass8 |
string |
Aşındırıcılar |
USHazmatClass9 |
string |
Çeşitli |
otherHazmatExplosive |
string |
Patlayıcı |
otherHazmatGeneral |
string |
Çeşitli |
otherHazmatHarmfulToWater |
string |
Suya zararlı |
WindingnessLevel
Heyecan verici rota için dönüş seviyesi. Bu parametre yalnızca routeType
=heyecan verici ile birlikte kullanılabilir.
Name | Tür | Description |
---|---|---|
high |
string |
yüksek |
low |
string |
alçak |
normal |
string |
normal |