Route - Get Route Directions

Hizmet:

Maps

API Sürümü:

1.0

Belirtilen herhangi bir yol noktasından geçerek, belirtilen bir çıkış noktası ile hedef arasındaki yolu hesaplamak için kullanın.

Uyarı

Azure Haritalar Route v1 hizmetinin kullanımdan kaldırılması

Azure Haritalar Route v1 hizmeti artık kullanım dışıdır ve 31.03.28 tarihinde kullanımdan kaldırılacaktır. Hizmet kesintilerini önlemek için Route v1 hizmetine yapılan tüm çağrıların 31.03.28'e kadar Route v2025-01-01 kullanacak şekilde güncelleştirilmesi gerekir. Daha fazla bilgi için bkz. Azure Haritalar Yol 1.0 API'lerini geçirme.

Get Route Directions API'si, 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}

İsteğe bağlı parametrelerle:

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&sectionType={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}&currentFuelInLiters={currentFuelInLiters}&auxiliaryPowerInLitersPerHour={auxiliaryPowerInLitersPerHour}&fuelEnergyDensityInMJoulesPerLiter={fuelEnergyDensityInMJoulesPerLiter}&accelerationEfficiency={accelerationEfficiency}&decelerationEfficiency={decelerationEfficiency}&uphillEfficiency={uphillEfficiency}&downhillEfficiency={downhillEfficiency}&constantSpeedConsumptionInkWhPerHundredkm={constantSpeedConsumptionInkWhPerHundredkm}&currentChargeInkWh={currentChargeInkWh}&maxChargeInkWh={maxChargeInkWh}&auxiliaryPowerInkW={auxiliaryPowerInkW}

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
format	path	True	ResponseFormat	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 gereklidir. İlki kaynak, sonuncusu ise rotanın hedefidir. aralarındaki isteğe bağlı koordinatlar, rotada yol noktası görevi görür. 150 yol noktasına kadar geçiş yapabilirsiniz.
accelerationEfficiency	query		number (double) minimum: 0 maximum: 1	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
alternativeType	query		AlternativeRouteType	Başvuru yolu ile karşılaştırıldığında, hesaplanan alternatiflerin belirli planlama ölçütlerine göre en uygun olanını denetler.
arriveAt	query		string (date-time)	hedef noktasına varış tarihi ve saati, isteğe bağlı saat dilimi uzaklığıyla dateTime'de tanımlandığı şekilde değeri olarak biçimlendirilir. Bir saat dilimi uzaklığı belirtilmediğinde, hedef noktanın bu olduğu varsayılır. Örnekler: 2023-12-19T16:39:57 2023-12-19T16:39:57-08:00 arriveAt parametresi departAt, minDeviationDistance veya minDeviationTimeile birlikte kullanılamaz.
auxiliaryPowerInkW	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
auxiliaryPowerInLitersPerHour	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		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.
computeBestOrder	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.
computeTravelTimeFor	query		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.
constantSpeedConsumptionInkWhPerHundredkm	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: verilen hız listedeki iki hız arasındaysa doğrusal ilişkilendirmeye göre aksi takdirde doğrusal tahmine göre, listedeki en yakın iki nokta tarafından belirlenen bir sabit (ΔConsumption/ΔSpeed) varsayarsak 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.
constantSpeedConsumptionInLitersPerHundredkm	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: verilen hız listedeki iki hız arasındaysa doğrusal ilişkilendirmeye göre aksi takdirde doğrusal tahmine göre, listedeki en yakın iki nokta tarafından belirlenen bir sabit (ΔConsumption/ΔSpeed) varsayarsak 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 Not: Bu parametre yanma tüketim modeliiçin gereklidir.
currentChargeInkWh	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 maxChargeInkWharasındadır. Duyarlı Değerler : 43
currentFuelInLiters	query		number (double)	Litre olarak yakıtın geçerli tedarikini belirtir. Duyarlı Değerler : 55
decelerationEfficiency	query		number (double) minimum: 0 maximum: 1	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
departAt	query		string (date-time)	çıkış noktasından çıkış tarihi ve saati, isteğe bağlı saat dilimi uzaklığıyla dateTimeiçinde tanımlandığı şekilde değeri olarak biçimlendirilir. Saat dilimi uzaklığı belirtilmediğinde, çıkış noktasının bu olduğu varsayılır. Varsayılan değer: şimdi Diğer değer: dateTime Örnekler: 2023-12-19T16:39:57 2023-12-19T16:39:57-08:00 departAt parametresi arriveAtile birlikte kullanılamaz.
downhillEfficiency	query		number (double) minimum: 0 maximum: 1	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
fuelEnergyDensityInMJoulesPerLiter	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		InclineLevel	Heyecan verici rota için tepelik derecesi. Bu parametre yalnızca routeType=heyecan verici ile birlikte kullanılabilir.
instructionsType	query		RouteInstructionsType	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 adlar (sokakların, plazaların, vb. adları) belirtilen dilde döndürülür veya kullanılabilir değilse, buna yakın olan kullanılabilir bir dilde döndürülür. İzin verilen değerler IETF dil etiketleridir (alt kümesi). Şu anda desteklenen dillerDesteklenen diller bölümünde listelenir. Varsayılan değer: en-GB
maxAlternatives	query		integer minimum: 0 maximum: 5	Hesaplanacak istenen alternatif yolların sayısı. Varsayılan: 0, en az: 0 ve en fazla: 5
maxChargeInkWh	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
minDeviationDistance	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
minDeviationTime	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: calculateRoute İsteği çıkış noktasının giriş başvuru yolunda (veya çok yakınında) olması gerekir. Bu durumda bir hata döndürülür. Ancak çıkış noktasının giriş referans rotasının başında olması gerekmez (referans rotası üzerindeki geçerli araç konumu olarak düşünülebilir). calculateRoute Yanıtı ilk yol olarak döndürülen başvuru yolu, calculateRoute İsteğinde belirtilen kaynak noktasında başlar. Giriş başvuru yolunun başlangıç bölümü, çıkış noktası Yanıttan dışlanana kadar yukarı doğru ilerler. minDeviationDistance ve minDeviationTime değerleri, alternatif yolların kaynak noktasından itibaren başvuru yolunu ne kadar takip edeceğine karar verir. Rota,departAt kullanmalıdır. vehicleHeading yoksayılır.
report	query		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.
routeRepresentation	query		RouteRepresentationForBestOrder	Yanıt olarak sağlanan yol kümesinin gösterimini belirtir.
routeType	query		RouteType	İstenen yol türü.
sectionType	query		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
traffic	query		boolean	Olası değerler: true - Yönlendirme sırasında tüm kullanılabilir trafik bilgilerini dikkate alın false - Yönlendirme sırasında geçerli trafik verilerini yoksayın. Yönlendirme sırasında geçerli trafik verileri yoksayılsa da, geçmiş trafiğin etkili yol hızları üzerindeki etkisinin yine de dahil olduğunu unutmayın.
travelMode	query		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.
uphillEfficiency	query		number (double) minimum: 0 maximum: 1	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
vehicleAxleWeight	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.
vehicleCommercial	query		boolean	Aracın ticari amaçlarla kullanılıp kullanılmadığı. Ticari araçların bazı yollarda sürmesine izin verilmiyor olabilir.
vehicleEngineType	query		VehicleEngineType	Aracın motor tipi. Ayrıntılı bir Tüketim Modeli belirtildiğinde, vehicleEngineTypedeğeriyle tutarlı olmalıdır.
vehicleHeading	query		integer minimum: 0 maximum: 359	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
vehicleHeight	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.
vehicleLength	query		number (double)	Aracın metre cinsinden uzunluğu. 0 değeri, uzunluk kısıtlamalarının dikkate alınmadığı anlamına gelir.
vehicleLoadType	query		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.
vehicleMaxSpeed	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. 0 değeri, rota planlaması sırasında araç için uygun bir değerin belirleneceği ve uygulanacağı anlamına gelir. Rota planlaması sırasında sıfır olmayan bir değer geçersiz kılınabilir. Örneğin, geçerli trafik akışı 60 km/saattir. Araç maksimum hızı 50 km/saat olarak ayarlanırsa, rota motoru geçerli durum olduğu için 60 km/saat değerini dikkate alır. Aracın maksimum hızı 80 km/saat olarak sağlanıyorsa ancak geçerli trafik akışı 60 km/saat ise yönlendirme motoru tekrar 60 km/saat kullanacaktır.
vehicleWeight	query		integer	Aracın ağırlığı kilogram olarak. *Verimlilik parametrelerinden herhangi biri ayarlanırsa zorunludur. Tüketim Modeli bağlamında kullanıldığında kesinlikle pozitif olmalıdır. Ağırlık kısıtlamaları dikkate alınır. Ayrıntılı Tüketim Modeli belirtilmezse ve araçWeight değeri sıfır değilse ağırlık kısıtlamaları dikkate alınır. Diğer tüm durumlarda bu parametre yoksayılır. Duyarlı Değerler : Yanma Modeli için: 1600, Elektrik Modeli için: 1900
vehicleWidth	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		WindingnessLevel	Heyecan verici rota için dönüş seviyesi. Bu parametre yalnızca routeType=heyecan verici ile birlikte kullanılabilir.

İstek Başlığı

Name	Gerekli	Tür	Description
x-ms-client-id		string	Microsoft Entra ID güvenlik modeliyle kullanılması amaçlanan hesabı belirtir. Azure Haritalar hesabı için bu benzersiz kimlik, Azure Haritalar yönetim düzlemi Hesap API'sinden elde edilebilir. Azure Haritalar'da Microsoft Entra ID güvenliğini kullanma hakkında daha fazla bilgi için bkz.

Yanıtlar

Name	Tür	Description
200 OK	RouteDirections	Tamam
Other Status Codes	ErrorResponse	Beklenmeyen bir hata oluştu.

Güvenlik

AADToken

Bunlar Microsoft Entra OAuth 2.0 Akışlarının . 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şim belirtmek için kullanılır. Tüm kullanıcılara, gruplara veya hizmet sorumlularına yerleşik bir rol veya Azure Haritalar REST API'leri için bir veya daha fazla izinden oluşan özel bir rol aracılığıyla erişim verilebilir.

Senaryoları uygulamak içinkimlik doğrulama kavramlarını görüntülemenizi öneririz. Özetle, bu güvenlik tanımı belirli API'ler ve kapsamlar üzerinde erişim denetimi yapabilen nesneler aracılığıyla uygulamaları modellemek için bir çözüm sağlar.

Notlar

• Bu güvenlik tanımı kullanılmasını gerektirir. Bu, Haritalar yönetim API'sindenedinilebilir.

Authorization URL, Azure genel bulut örneğine özgüdür. Bağımsız bulutların benzersiz Yetkilendirme URL'leri ve Microsoft Entra Id yapılandırmaları vardır. * Azure rol tabanlı erişim denetimi Azure portalı, PowerShell, CLI, Azure SDK'ları veya REST API'leri aracılığıyla azure yönetim düzlemi yapılandırılır. * Azure Haritalar Web SDK kullanımı, bir uygulamanın birden çok kullanım örneği için yapılandırma tabanlı kurulumuna olanak tanır.

• Microsoft kimlik platformu hakkında daha fazla bilgi için bkz. Microsoft kimlik platformuna genel bakış.

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name	Description
https://atlas.microsoft.com/.default	https://atlas.microsoft.com/.default

subscription-key

Bu, Azure portalında Azure Haritalar hesabı oluşturma veya PowerShell, CLI, Azure SDK'ları veya REST API kullanarak sağlanan paylaşılan bir anahtardır.

Bu anahtarla, tüm uygulamalar tüm REST API'lere erişebilir. Başka bir deyişle, bu anahtar, verildikleri hesapta ana anahtar olarak kullanılabilir.

Herkese açık uygulamalar için, anahtarınızın güvenli bir şekilde depolanabilmesi için Azure Haritalar REST API'lerine erişmek için gizli istemci uygulamaları yaklaşımını kullanmanızı öneririz.

Tür: apiKey
İçinde: query

SAS Token

Bu paylaşılan erişim imzası belirteci, Azure portalı, PowerShell, CLI, Azure SDK'ları veya REST API'leri aracılığıyla Azure yönetim düzlemi aracılığıyla Azure Haritalar kaynağı Sas Listeleme işleminden oluşturulur.

Bu belirteçle, tüm uygulamalar Azure rol tabanlı erişim denetimleri ve belirli bir belirteç için kullanım süre sonu, oran ve bölgelere ayrıntılı denetim ile erişim yetkisine sahiptir. Başka bir deyişle SAS Belirteci, uygulamaların erişimi paylaşılan anahtardan daha güvenli bir şekilde denetlemesine izin vermek için kullanılabilir.

Herkese açık uygulamalar için önerimiz, Eşleme hesabı kaynağında izin verilen kaynakların belirli bir listesini yapılandırmayı işleme kötüye kullanımını sınırlamak ve SAS Belirtecini düzenli olarak yenilemektir.

Tür: apiKey
İçinde: header

Örnekler

Successfully retrieve a route between an origin and a destination

Örnek isteği

HTTP

GET https://atlas.microsoft.com/route/directions/json?api-version=1.0&query=52.50931,13.42936:52.50274,13.43872&report=effectiveSettings

Örnek yanıt

Durum kodu:

200

{
  "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
AlternativeRouteType	Başvuru yolu ile karşılaştırıldığında, hesaplanan alternatiflerin belirli planlama ölçütlerine göre en uygun olanını denetler.
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.
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.
DrivingSide	Manevra noktasında sola ve sağ tarafa doğru sürüşü gösterir.
EffectiveSetting	Bu Rota API'si çağrılırken kullanılan etkili parametre veya veriler.
ErrorAdditionalInfo	Kaynak yönetimi hatası ek bilgileri.
ErrorDetail	Hata ayrıntısı.
ErrorResponse	Hata yanıtı
GuidanceInstructionType	Yönergenin türü, örneğin yol formunun değiştirilmesi veya değiştirilmesi.
GuidanceManeuver	Manevrayı tanımlayan bir kod.
InclineLevel	Heyecan verici rota için tepelik derecesi. Bu parametre yalnızca routeType=heyecan verici ile birlikte kullanılabilir.
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.
LatLongPair	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.
ResponseFormat	Yanıtın istenen biçimi. Değer json veya xml olabilir.
ResponseSectionType	Bildirilen yol yanıtının bölüm türleri
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
Route
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.
RouteDirections	Bu nesne başarılı bir Yol Tarifleri çağrısından döndürülür
RouteGuidance	Rehberlikle ilgili öğeleri içerir. Bu alan yalnızca rehberlik istendiğinde ve kullanılabilir olduğunda bulunur.
RouteInstruction	Bir manevrayı açıklayan bir dizi öznitelik, örneğin 'Sağa dön', 'Sola dön', 'Feribota bin', 'Otoyola çık', 'Var'.
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.
RouteInstructionsType	Belirtilirse, kılavuz yönergeleri döndürülür. instructionsType parametresinin routeRepresentation=none ile birlikte kullanılamadığını unutmayın.
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.
RouteLegSummary	Yol bölümü için özet nesnesi.
RouteOptimizedWaypoint	İyileştirilmiş yol noktası nesnesi.
RouteReport	Geçerli çağrıda kullanılan geçerli ayarları raporlar.
RouteRepresentationForBestOrder	Yanıt olarak sağlanan yol kümesinin gösterimini belirtir.
RouteSection	Rota bölümleri, bir yolun parçaları hakkında ek bilgiler içerir. Her bölüm, startPointIndex, endPointIndexve sectionTypeöğelerini içerir.
RouteSectionTec	TPEG2-TEC standardındaki tanımları kullanarak trafik olayının ayrıntıları. effectCode içerebilir ve öğelere neden olabilir.
RouteSectionTecCause	Trafik olayının nedeni. mainCauseCode ve subCauseCode öğelerini içerebilir. Simgeografiyi ve açıklamaları tanımlamak için kullanılabilir.
RouteSummary	Özet nesnesi
RouteType	İstenen yol türü.
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
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.
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.
VehicleEngineType	Aracın motor tipi. Ayrıntılı bir Tüketim Modeli belirtildiğinde, vehicleEngineTypedeğeriyle tutarlı olmalıdır.
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.
WindingnessLevel	Heyecan verici rota için dönüş seviyesi. Bu parametre yalnızca routeType=heyecan verici ile birlikte kullanılabilir.

AlternativeRouteType

Listeleme

Başvuru yolu ile karşılaştırıldığında, hesaplanan alternatiflerin belirli planlama ölçütlerine göre en uygun olanını denetler.

Değer	Description
anyRoute	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	Alternatif bir yol döndürmek için verilen planlama ölçütlerine göre başvuru yolundan daha iyi olması gerekir.

ComputeTravelTime

Listeleme

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.

Değer	Description
none	Ek seyahat sürelerini hesaplamaz.
all	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.

DelayMagnitude

Listeleme

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.

Değer	Description
0	Bilinmeyen.
1	Küçük.
2	Ilımlı.
3	Binbaşı.
4	Tanımsız, yol kapatmalar ve diğer süresiz gecikmeler için kullanılır.

DrivingSide

Listeleme

Manevra noktasında sola ve sağ tarafa doğru sürüşü gösterir.

Değer	Description
LEFT	Sol taraf.
RIGHT	Sağ tarafa.

EffectiveSetting

Object

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

Object

Kaynak yönetimi hatası ek bilgileri.

Name	Tür	Description
info	object	Ek bilgiler.
type	string	Ek bilgi türü.

ErrorDetail

Object

Hata ayrıntısı.

Name	Tür	Description
additionalInfo	ErrorAdditionalInfo[]	Hata ek bilgileri.
code	string	Hata kodu.
details	ErrorDetail[]	Hata ayrıntıları.
message	string	Hata iletisi.
target	string	Hata hedefi.

ErrorResponse

Object

Hata yanıtı

Name	Tür	Description
error	ErrorDetail	Hata nesnesi.

GuidanceInstructionType

Listeleme

Yönergenin türü, örneğin yol formunun değiştirilmesi veya değiştirilmesi.

Değer	Description
TURN	Dönmek.
ROAD_CHANGE	Yol Değişikliği.
LOCATION_DEPARTURE	Kalkış konumu.
LOCATION_ARRIVAL	Varış konumu.
DIRECTION_INFO	Yön bilgileri.
LOCATION_WAYPOINT	Yol noktası konumu.

GuidanceManeuver

Listeleme

Manevrayı tanımlayan bir kod.

Değer	Description
ARRIVE	Geldiniz.
ARRIVE_LEFT	Geldiniz. Hedefiniz sol tarafta.
ARRIVE_RIGHT	Geldiniz. Hedefiniz sağ tarafta.
DEPART	Ayrılmak.
STRAIGHT	Dümdüz devam edin.
KEEP_RIGHT	Sağa doğru devam edin.
BEAR_RIGHT	Ayı sağ.
TURN_RIGHT	Sağa dön.
SHARP_RIGHT	Sağa doğru keskin dön.
KEEP_LEFT	Sola doğru devam edin.
BEAR_LEFT	Ayı gitti.
TURN_LEFT	Sola dönün.
SHARP_LEFT	Keskin sola dön.
MAKE_UTURN	U dönüşü yapın.
ENTER_MOTORWAY	Otoyola çık.
ENTER_FREEWAY	Otobana bin.
ENTER_HIGHWAY	Otobana bin.
TAKE_EXIT	Çıkışa geçin.
MOTORWAY_EXIT_LEFT	Sol çıkışa geçin.
MOTORWAY_EXIT_RIGHT	Doğru çıkışa çık.
TAKE_FERRY	Feribota bin.
ROUNDABOUT_CROSS	Kavşağa geç.
ROUNDABOUT_RIGHT	Kavşakta sağ taraftaki çıkışa doğru inin.
ROUNDABOUT_LEFT	Kavşakta soldan çıkışa geçin.
ROUNDABOUT_BACK	Kavşak etrafından dolaş.
TRY_MAKE_UTURN	U dönüşü yapmayı deneyin.
FOLLOW	Takip etmek.
SWITCH_PARALLEL_ROAD	Paralel yola geçin.
SWITCH_MAIN_ROAD	Ana yola geç.
ENTRANCE_RAMP	Rampadan çıkın.
WAYPOINT_LEFT	Yol noktasına ulaştınız. Sol tarafta.
WAYPOINT_RIGHT	Yol noktasına ulaştınız. Sağ tarafta.
WAYPOINT_REACHED	Yol noktasına ulaştınız.

InclineLevel

Listeleme

Heyecan verici rota için tepelik derecesi. Bu parametre yalnızca routeType=heyecan verici ile birlikte kullanılabilir.

Değer	Description
low	alçak
normal	normal
high	yüksek

JunctionType

Listeleme

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.

Değer	Description
REGULAR	düzenli
ROUNDABOUT	atlıkarınca
BIFURCATION	Çatallanma

LatLongPair

Object

Enlem ve boylam olarak temsil edilen konum.

Name	Tür	Description
latitude	number (double)	Latitude özelliği
longitude	number (double)	Longitude özelliği

Report

Listeleme

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.

Değer	Description
effectiveSettings	API çağrılırken kullanılan etkili parametreleri veya verileri raporlar.

ResponseFormat

Listeleme

Yanıtın istenen biçimi. Değer json veya xml olabilir.

Değer	Description
json	JavaScript Nesne Gösterimi Veri Değişim Biçimi
xml	Genişletilebilir biçimlendirme dili

ResponseSectionType

Listeleme

Bildirilen yol yanıtının bölüm türleri

Değer	Description
CAR_TRAIN	Rotanın arabalar veya trenler olan bölümleri.
COUNTRY	Rotanın hangi ülkelerde/bölgelerde olduğunu gösteren bölümler.
FERRY	Rotanın feribot olan bölümleri.
MOTORWAY	Yolun otoyollar olan bölümleri.
PEDESTRIAN	Rotanın yalnızca yayalar için uygun bölümleri.
TOLL_ROAD	Ücretin ödenmesini gerektiren rota bölümleri.
TOLL_VIGNETTE	Rotanın ücretli bir vinyet gerektiren bölümleri.
TRAFFIC	Yolun trafik bilgilerini içeren bölümleri.
TRAVEL_MODE	travelModeistek parametresiyle ilgili bölümler.
TUNNEL	Yolun tünel olan bölümleri.
CARPOOL	Yolun, araç havuzu (HOV/Yüksek Dolu Araç) şeritlerinin kullanılmasını gerektiren bölümleri.
URBAN	Kentsel alanların içinde yer alan rotanın bölümleri.

ResponseTravelMode

Listeleme

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

Değer	Description
car	Döndürülen rotalar arabalar için iyileştirilmiştir.
truck	Döndürülen rotalar, kamyonlar gibi ticari araçlar için optimize edilmiştir.
taxi	Döndürülen rotalar taksiler için iyileştirilmiştir. BETA işlevselliği.
bus	Döndürülen rotalar, yalnızca otobüs hatlarının kullanımı dahil olmak üzere otobüsler için iyileştirilmiştir. BETA işlevselliği.
van	Döndürülen yollar minibüsler için iyileştirilmiştir. BETA işlevselliği.
motorcycle	Döndürülen rotalar motosikletler için optimize edilmiştir. BETA işlevselliği.
bicycle	Döndürülen rotalar, bisiklet şeritlerinin kullanımı dahil olmak üzere bisikletler için optimize edilmiştir.
pedestrian	Geri dönen yollar, kaldırım kullanımı dahil olmak üzere yayalar için optimize edilmiştir.
other	Bu bölümde verilen taşıma modu mümkün değildir

Route

Object

Name	Tür	Description
guidance	RouteGuidance	Rehberlikle ilgili öğeleri içerir. Bu alan yalnızca rehberlik istendiğinde ve kullanılabilir olduğunda bulunur.
legs	RouteLeg[]	Bacaklar dizisi
sections	RouteSection[]	Sections dizisi
summary	RouteSummary	Özet nesnesi

RouteAvoidType

Listeleme

Rotayı belirlerken yol hesaplamasının kaçınmaya çalışması gereken bir şeyi belirtir. Bir istekte birden çok kez belirtilebilir, örneğin, '&avoid=otoyollar&avoid=tollRoads&avoid=ferries'. Yol Aralığı isteklerinde zatenUsedRoads değeri kullanılmamalıdır.

Değer	Description
tollRoads	Ücretli yollardan kaçınıyor.
motorways	Otoyollardan kaçınıyor
ferries	Feribotları önler
unpavedRoads	Kazınmamış yollardan kaçınıyor
carpools	Araç havuzu (HOV/Yüksek Dolu Araç) şeritlerinin kullanılmasını gerektiren rotalardan kaçınıyor.
alreadyUsedRoads	Aynı yolu birden çok kez kullanmaktan kaçınıyor. routeType=heyecan verici ile birlikte en kullanışlı.
borderCrossings	Rota hesaplamasında sınır geçişlerini önler.

RouteDirections

Object

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	RouteOptimizedWaypoint[]	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: <optimizedWaypoints> <waypoint providedIndex="0" optimizedIndex="1"/> <waypoint providedIndex="1" optimizedIndex="2"/> <waypoint providedIndex="2" optimizedIndex="0"/> </optimizedWaypoints> , ö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	RouteReport	Geçerli çağrıda kullanılan geçerli ayarları raporlar.
routes	Route[]	Rotalar dizisi

RouteGuidance

Object

Rehberlikle ilgili öğeleri içerir. Bu alan yalnızca rehberlik istendiğinde ve kullanılabilir olduğunda bulunur.

Name	Tür	Description
instructionGroups	RouteInstructionGroup[]	Birbiriyle ilişkili yönerge öğelerinin bir dizisini gruplandırır.
instructions	RouteInstruction[]	Manevraları açıklayan yönergelerin listesi.

RouteInstruction

Object

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. Örneğin: 10. Turn left onto Einsteinweg/A10/E22 towards Ring Amsterdam 11. Follow Einsteinweg/A10/E22 towards Ring Amsterdam 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: Turn left onto Einsteinweg/A10/E22 towards Ring Amsterdam then follow Einsteinweg/A10/E22 towards Ring Amsterdam.
countryCode	string	3 karakterli ISO 3166-1 alfa-3 ülke kodu. Örneğin ABD.
drivingSide	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	GuidanceInstructionType	Yönergenin türü, örneğin yol formunun değiştirilmesi veya değiştirilmesi.
junctionType	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	GuidanceManeuver	Manevrayı tanımlayan bir kod.
message	string	Manevra için okunabilir bir mesaj.
point	LatLongPair	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 (int64)	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: 180 = U dönüşü [-179, -1] = Sol dönüş 0 = Düz açık ('0 derece' dönüş) [1, 179] = Sağ dönüş junctionType bir çarpım yönergesi gösteriyorsa: <0 - sola tut >0 - sağa doğru tut

RouteInstructionGroup

Object

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

Listeleme

Belirtilirse, kılavuz yönergeleri döndürülür. instructionsType parametresinin routeRepresentation=none ile birlikte kullanılamadığını unutmayın.

Değer	Description
coded	İnsan tarafından okunabilen iletiler olmadan ham yönerge verilerini döndürür.
text	düz metin olarak insan tarafından okunabilen iletiler içeren ham yönergeler verilerini döndürür.
tagged	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: Turn left onto <roadNumber>A4</roadNumber>/<roadNumber>E19</roadNumber> towards <signpostText>Den Haag</signpostText>

RouteLeg

Object

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	LatLongPair[]	Nokta dizisi
summary	RouteLegSummary	Yol bölümü için özet nesnesi.

RouteLegSummary

Object

Yol bölümü için özet nesnesi.

Name	Tür	Description
arrivalTime	string (date-time)	Rota veya bacak için tahmini varış zamanı. Saat UTC olarak ayarlanır.
batteryConsumptionInkWh	number (double)	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 (date-time)	Rota veya bacak için tahmini kalkış saati. Saat UTC olarak ayarlanır.
fuelConsumptionInLiters	number (double)	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

Object

İ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

Object

Geçerli çağrıda kullanılan geçerli ayarları raporlar.

Name	Tür	Description
effectiveSettings	EffectiveSetting[]	Bu Rota API'si çağrılırken kullanılan etkili parametreler veya veriler.

RouteRepresentationForBestOrder

Listeleme

Yanıt olarak sağlanan yol kümesinin gösterimini belirtir.

Değer	Description
polyline	Yanıta rota geometrisi ekler.
summaryOnly	Çok çizgiye göre özet, ancak yanıttaki yollar için nokta geometrisi öğelerini hariç tutarak.
none	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.

RouteSection

Object

Rota bölümleri, bir yolun parçaları hakkında ek bilgiler içerir. Her bölüm, startPointIndex, endPointIndexve 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	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.
sectionType	ResponseSectionType	Bildirilen yol yanıtının bölüm türleri
simpleCategory	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	RouteSectionTec	TPEG2-TEC standardındaki tanımları kullanarak trafik olayının ayrıntıları. effectCode içerebilir ve öğelere neden olabilir.
travelMode	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

RouteSectionTec

Object

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	RouteSectionTecCause[]	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

Object

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

Object

Özet nesnesi

Name	Tür	Description
arrivalTime	string (date-time)	Rota veya bacak için tahmini varış zamanı. Saat UTC olarak ayarlanır.
departureTime	string (date-time)	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

Listeleme

İstenen yol türü.

Değer	Description
fastest	En hızlı yol.
shortest	Mesafeye göre en kısa rota.
eco	Ekonomi ve hız ile dengelenmiş bir rota.
thrilling	İlginç veya zorlu yollar içerir ve mümkün olduğunca az otoyol kullanır. Dahil edilen dönüş düzeyini ve ayrıca tepelik derecesini seçebilirsiniz. Bunun nasıl ayarlanacağına ilişkin engebelilik ve sargı parametrelerine bakın. routeType=heyecan verici ile planlanan rotalarda 900 km sınırı vardır

SectionType

Listeleme

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

Değer	Description
carTrain	Rotanın arabalar veya trenler olan bölümleri.
country	Rotanın hangi ülkelerde/bölgelerde olduğunu gösteren bölümler.
ferry	Rotanın feribot olan bölümleri.
motorway	Yolun otoyollar olan bölümleri.
pedestrian	Rotanın yalnızca yayalar için uygun bölümleri.
tollRoad	Ücretin ödenmesini gerektiren rota bölümleri.
tollVignette	Rotanın ücretli bir vinyet gerektiren bölümleri.
traffic	Yolun trafik bilgilerini içeren bölümleri.
travelMode	travelModeistek parametresiyle ilgili bölümler.
tunnel	Yolun tünel olan bölümleri.
carpool	Yolun, araç havuzu (HOV/Yüksek Dolu Araç) şeritlerinin kullanılmasını gerektiren bölümleri.
urban	Kentsel alanların içinde yer alan rotanın bölümleri.

SimpleCategory

Listeleme

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.

Değer	Description
JAM	Trafik sıkışıklığı.
ROAD_WORK	Yol çalışması.
ROAD_CLOSURE	Yol kapatma.
OTHER	Diğer.

TravelMode

Listeleme

İstenen rota için seyahat modu. Tanımlanmamışsa, varsayılan değer 'araba'dır. İstenen travelMode'un tüm rota için kullanılamayabileceğini unutmayın. İstenen travelMode belirli bir bölümde kullanılamadığı durumlarda, bu bölümün yanıtının travelMode öğesi "diğer" olur. Seyahat modlarının otobüs, motosiklet, taksi ve minibüs BETA işlevi olduğunu unutmayın. Tüm alanlarda tam kısıtlama verileri kullanılamaz.

Değer	Description
car	Döndürülen rotalar arabalar için iyileştirilmiştir.
truck	Döndürülen rotalar, kamyonlar gibi ticari araçlar için optimize edilmiştir.
taxi	Döndürülen rotalar taksiler için iyileştirilmiştir. BETA işlevselliği.
bus	Döndürülen rotalar, yalnızca otobüs hatlarının kullanımı dahil olmak üzere otobüsler için iyileştirilmiştir. BETA işlevselliği.
van	Döndürülen yollar minibüsler için iyileştirilmiştir. BETA işlevselliği.
motorcycle	Döndürülen rotalar motosikletler için optimize edilmiştir. BETA işlevselliği.
bicycle	Döndürülen rotalar, bisiklet şeritlerinin kullanımı dahil olmak üzere bisikletler için optimize edilmiştir.
pedestrian	Geri dönen yollar, kaldırım kullanımı dahil olmak üzere yayalar için optimize edilmiştir.

VehicleEngineType

Listeleme

Aracın motor tipi. Ayrıntılı bir Tüketim Modeli belirtildiğinde, vehicleEngineTypedeğeriyle tutarlı olmalıdır.

Değer	Description
combustion	İç yanmalı motor.
electric	Elektrik motoru.

VehicleLoadType

Listeleme

Tehlikeli madde olarak sınıflandırılabilecek ve bazı yollardan kısıtlanmış kargo türleri. Kullanılabilir araçLoadType değerleri, 1 ile 9 arasında ABD Hazmat sınıflarının yanı sıra diğer ülkelerde/bölgelerde kullanılmak üzere genel sınıflandırmalardır. USHazmat ile başlayan değerler ABD yönlendirme içindir, diğer Tüm ülkeler/bölgeler için diğerHazmat kullanılmalıdır. vehicleLoadType birden çok kez belirtilebilir. Bu parametre şu anda yalnızca travelMode=truck için kabul edilmektedir.

Değer	Description
USHazmatClass1	Patlayıcı
USHazmatClass2	Sıkıştırılmış gaz
USHazmatClass3	Yanıcı sıvılar
USHazmatClass4	Yanıcı katılar
USHazmatClass5	Oksidatörler
USHazmatClass6	Zehir
USHazmatClass7	Radyoaktif
USHazmatClass8	Aşındırıcılar
USHazmatClass9	Çeşitli
otherHazmatExplosive	Patlayıcı
otherHazmatGeneral	Çeşitli
otherHazmatHarmfulToWater	Suya zararlı

WindingnessLevel

Listeleme

Heyecan verici rota için dönüş seviyesi. Bu parametre yalnızca routeType=heyecan verici ile birlikte kullanılabilir.

Değer	Description
low	alçak
normal	normal
high	yüksek