Route - Get Route Directions

Başvuru

Service:: Maps

API Version:: 1.0

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

Get Route Directions API, bir kaynak ile hedef arasında bir yol döndüren ve belirtilirse yol noktalarından geçen bir HTTP GET isteğidir. Rota, geçerli trafik ve istenen haftanın günü ve günün saati üzerindeki tipik yol hızları gibi faktörleri dikkate alır.

Döndürülen bilgiler mesafeyi, tahmini seyahat süresini ve rota geometrisinin bir gösterimini içerir. Seçilen seçeneklere bağlı olarak, iyileştirilmiş yol noktası sırası veya sırayla çevirme yönergeleri gibi ek yönlendirme bilgileri de sağlanır.

Yönlendirme hizmeti, araca özgü tüketim modelinin ayrıntılı açıklaması için bir dizi parametre sağlar. Daha fazla bilgi için bkz . Tüketim Modeli.

GET https://atlas.microsoft.com/route/directions/{format}?api-version=1.0&query={query}

With optional parameters:

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 gerekir. İlki çıkış noktası, sonuncusu ise yolun hedefidir. aralarındaki isteğe bağlı koordinatlar, rotada WayPoint olarak hareket eder. En fazla 150 WayPoint geçirebilirsiniz.
accelerationEfficiency	query		number double	Araç hızlandığında yakıtta depolanan kimyasal enerjiyi kinetik enerjiye dönüştürmenin verimliliğini belirtir (örn. KineticEnergyGained/ChemicalEnergyConsumed). ChemicalEnergyConsumed , tüketilen yakıtın fuelEnergyDensityInMJoulesPerLiter kullanılarak kimyasal enerjiye dönüştürülmesiyle elde edilir. DecelerationEfficiency ile eşlenmelidir. İzin verilen değer aralığı 0,0 - 1/decelerationEfficiency değerleridir. Mantıklı Değerler : Yanma Modeli için : 0.33, Elektrik Modeli için : 0.66
alternativeType	query		AlternativeRouteType	Başvuru yoluyla karşılaştırıldığında, hesaplanan alternatiflerin verilen planlama ölçütlerine göre en uygunluğu denetler.
arriveAt	query		string date-time	İsteğe bağlı saat dilimi uzaklığıyla RFC 3339, bölüm 5.6'da tanımlandığı gibi bir `dateTime` değer olarak biçimlendirilmiş hedef noktaya varış tarihi ve saati. Bir saat dilimi uzaklığı belirtilmediğinde, hedef noktaya ait olduğu varsayılır. Örnekler: 2023-12-19T16:39:57 2023-12-20T00:39:57+00:00 `arriveAt` parametresi , `minDeviationDistance` veya `minDeviationTime`ile `departAt`birlikte kullanılamaz.
auxiliaryPowerInkW	query		number double	Yardımcı sistemlerin sürdürülmesi için kullanılan güç miktarını kilowatt (kW) cinsinden belirtir. Ac sistemleri, radyo, ısıtma vb. cihazlar ve sistemler nedeniyle tüketimi belirtmek için kullanılabilir. Mantıklı Değerler : 1.7
auxiliaryPowerInLitersPerHour	query		number double	Aracın yardımcı sistemlerinin sürdürülmesi için tüketilen yakıt miktarını litre/saat cinsinden belirtir. Ac sistemleri, radyo, ısıtma vb. cihazlar ve sistemler nedeniyle tüketimi belirtmek için kullanılabilir. Mantıklı Değerler : 0.2
avoid	query		RouteAvoidType[]	Yol hesaplamasının yolu belirlerken kaçınmaya çalışması gereken bir şeyi belirtir. Bir istekte birden çok kez belirtilebilir, örneğin, '&avoid=otoyollar&avoid=tollRoads&avoid=ferries'. Yol Aralığı isteklerinde zatenUsedRoads değeri kullanılmamalıdır.
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ısa ile birlikte kullanıldığında en iyi sonuçları verir. Kaynak ve hedefin iyileştirilmiş yol noktası dizinlerinin dışında bırakıldıklarına dikkat edin. Yanıta kaynak ve hedef eklemek için lütfen kaynağı hesaba katmak için tüm dizinleri 1 artırın ve ardından hedefi son dizin olarak ekleyin. Olası değerler true veya false olabilir. True, mümkünse daha iyi bir sıra hesaplar, ancak 0'dan büyük maxAlternatives değeriyle birlikte veya daire yol noktalarıyla birlikte kullanılmasına izin verilmez. False belirtilen sırada konumları kullanır ve routeRepresentation none ile birlikte kullanılmasına izin verilmez.
computeTravelTimeFor	query		ComputeTravelTime	Farklı türdeki trafik bilgileri (yok, geçmiş, canlı) ve varsayılan en iyi tahmini seyahat süresi kullanılarak ek seyahat sürelerinin döndürülip döndürülmeyeceğini belirtir.
constantSpeedConsumptionInkWhPerHundredkm	query		string	Tüketimin hıza bağımlı bileşenini belirtir. Hız/tüketim hızı çiftlerinin sırasız bir listesi olarak sağlanır. Liste, tüketim eğrisi üzerindeki noktaları tanımlar. Listede bulunmayan hızlar için tüketim oranları aşağıdaki gibidir: verilen hız listedeki iki hız arasındaysa doğrusal ilişkilendirmeye göre aksi takdirde, listedeki en yakın iki nokta tarafından belirlenen bir sabit (ΔConsumption/ΔSpeed) varsayılarak doğrusal tahmine göre Liste 1 ile 25 nokta (dahil) arasında olmalı ve aynı hızda yinelenen noktalar içermeyebilir. Yalnızca tek bir nokta içeriyorsa, bu noktanın tüketim oranı daha fazla işlenmeden kullanılır. En büyük hız için belirtilen tüketim, en büyük penultimate hızının değerinden büyük veya buna eşit olmalıdır. Bu, tahminin negatif tüketim oranlarına yol açmamasını sağlar. Benzer şekilde, listedeki en küçük iki hız için belirtilen tüketim değerleri, daha küçük hızlar için negatif tüketim oranına yol açamaz. Tüketim değerleri için geçerli aralık (kWh/100km cinsinden ifade edilir) 0,01 ile 100000,0 arasındadır. Mantıklı Değerler: 50,8.2:130,21.3 Bu parametre Elektrik tüketim modeli için gereklidir.
constantSpeedConsumptionInLitersPerHundredkm	query		string	Tüketimin hıza bağımlı bileşenini belirtir. İki nokta üst üste ayrılmış hız & tüketim oranı çiftlerinin sıralanmamış bir listesi olarak sağlanır. Liste, tüketim eğrisi üzerindeki noktaları tanımlar. Listede bulunmayan hızlar için tüketim oranları aşağıdaki gibidir: verilen hız listedeki iki hız arasındaysa doğrusal ilişkilendirmeye göre aksi takdirde, listedeki en yakın iki nokta tarafından belirlenen bir sabit (ΔConsumption/ΔSpeed) varsayılarak doğrusal tahmine göre Liste 1 ile 25 nokta (dahil) arasında olmalı ve aynı hızda yinelenen noktalar içermeyebilir. Yalnızca tek bir nokta içeriyorsa, bu noktanın tüketim oranı daha fazla işlenmeden kullanılır. En büyük hız için belirtilen tüketim, en büyük penultimate hızının değerinden büyük veya buna eşit olmalıdır. Bu, tahminin negatif tüketim oranlarına yol açmamasını sağlar. Benzer şekilde, listedeki en küçük iki hız için belirtilen tüketim değerleri, daha küçük hızlar için negatif tüketim oranına yol açamaz. Tüketim değerleri için geçerli aralık (l/100km cinsinden ifade edilir) 0,01 ile 100000,0 arasındadır. Mantıklı Değerler: 50,6,3:130,11,5 Not : Bu parametre Yanma Tüketim Modeli için gereklidir.
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 maxChargeInkWh arasındadır. Mantıklı Değerler : 43
currentFuelInLiters	query		number double	Litre olarak yakıtın geçerli tedarikini belirtir. Mantıklı Değerler : 55
decelerationEfficiency	query		number double	Araç yavaşladığında kinetik enerjiyi tasarruflu (tüketilmemiş) yakıta dönüştürmenin verimliliğini belirtir (örneğin, ChemicalEnergySaved/KineticEnergyLost). ChemicalEnergySaved , tasarruf edilen (tüketilmeyen) yakıtın fuelEnergyDensityInMJoulesPerLiter kullanılarak enerjiye dönüştürülmesiyle elde edilir. AccelerationEfficiency ile eşlenmelidir. İzin verilen değer aralığı 0,0 ile 1/accelerationEfficiency arasındadır. Duyarlı Değerler : Yanma Modeli için : 0,83, Elektrik Modeli için : 0,91
departAt	query		string date-time	çıkış noktasından çıkış tarihi ve saati RFC 3339, bölüm 5.6'da tanımlandığı gibi bir değer olarak `dateTime` biçimlendirilmiş ve isteğe bağlı bir saat dilimi uzaklığı. Bir 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-20T00:39:57+00:00 `departAt` parametresi ile `arriveAt`birlikte kullanılamaz.
downhillEfficiency	query		number double	Araç yükselmeyi kaybettiğinde (örneğin ChemicalEnergySaved/PotentialEnergyLost) potansiyel enerjiyi tasarruf edilen (tüketilmeyen) yakıta dönüştürmenin verimliliğini belirtir. ChemicalEnergySaved , tasarruf edilen (tüketilmeyen) yakıtın fuelEnergyDensityInMJoulesPerLiter kullanılarak enerjiye dönüştürülmesiyle elde edilir. Yokuş yukarı verimlilik ile eşlenmelidir. İzin verilen değer aralığı 0,0 ile 1/uphillEfficiency arasındadır. Duyarlı Değerler : Yanma Modeli için : 0,51, Elektrik Modeli için : 0,73
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. Herhangi bir *Efficiency parametresi ayarlandıysa bu parametre gereklidir. Mantıklı Değerler : 34.2
hilliness	query		InclineLevel	Heyecan verici rota için tepelik derecesi. Bu parametre yalnızca =heyecan verici ile `routeType`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	language parametresi, kılavuz iletilerinin dilini belirler. Uygun adlar (sokakların, plazaların, vb. adları) belirtilen dilde döndürülür veya bu ad kullanılamıyorsa, buna yakın bir dilde döndürülür. İzin verilen değerler IETF dil etiketleridir (bir alt kümesi). Şu anda desteklenen diller Desteklenen diller bölümünde listelenmiştir. Varsayılan değer: en-GB
maxAlternatives	query		integer	Hesaplanacak istenen alternatif yolların sayısı. Varsayılan: 0, en az: 0 ve maksimum: 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 currentChargeInkWh değerinden büyük veya buna eşit olması gerekir. Mantıklı 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 başlangıç noktasından başvuru yolunu izler (bkz. POST İstekleri bölümüne bakın). Yalnızca bir yolu yeniden oluştururken kullanılabilir. minDeviationDistance parametresi, arriveAt ile birlikte kullanılamaz
minDeviationTime	query		integer	Döndürülen tüm alternatif yollar, calculateRoute isteğinin başlangıç noktasından başvuru yolunu (bkz. POST İstekleri bölümüne bakın) en az bu kadar saniye boyunca izler. Yalnızca bir yolu yeniden oluştururken kullanılabilir. minDeviationTime parametresi, arriveAt ile birlikte kullanılamaz. Varsayılan değer 0'dır. )minDeviationTime_ sıfırdan büyük bir değere ayarlanması aşağıdaki sonuçları doğurabilir: calculateRoute İsteğinin çıkış noktası giriş başvuru yolunda (veya çok yakınında) olmalıdır. Böyle bir durum söz konusu değilse 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ında 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ıç kısmı, çıkış noktası Yanıttan dışlanana kadar yukarı doğru ilerler. minDeviationDistance ve minDeviationTime değerleri, kaynak noktasından itibaren başvuru yolunu izlemek için ne kadar alternatif yolun garanti edileceğini belirler. Yol , departAt kullanmalıdır. vehicleHeading yok sayılır.
report	query		Report	Tanılama amacıyla hangi verilerin raporlanması gerektiğini belirtir. Tek olası değer effectiveSettings'tir. API çağrılırken kullanılan etkili parametreleri veya verileri raporlar. Varsayılan parametreler söz konusu olduğunda, parametrenin çağıran tarafından belirtilmediğinde varsayılan değer yansıtılır.
routeRepresentation	query		RouteRepresentationForBestOrder	Yanıt olarak sağlanan yol kümesinin gösterimini belirtir. Bu parametre değeri yalnızca computeBestOrder=true ile birlikte kullanılabilir.
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. Birden çok tür kullanılabilir. Varsayılan sectionType, travelMode girişine başvurur. Varsayılan olarak travelMode araç olarak ayarlanır
traffic	query		boolean	Olası değerler: true - Yönlendirme sırasında tüm kullanılabilir trafik bilgilerini göz önünde bulundurun 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 hala 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 öğesinin tüm rota için kullanılamayabileceğini unutmayın. İstenen travelMode belirli bir bölüm için kullanılamıyorsa, bu bölüm için yanıtın travelMode öğesi "diğer" olur. Seyahat modlarının veri yolu, motosiklet, taksi ve van BETA işlevi olduğunu unutmayın. Tüm alanlarda tam kısıtlama verileri kullanılamaz.
uphillEfficiency	query		number double	Araç yükselme kazandığında yakıtta depolanan kimyasal enerjiyi potansiyel enerjiye dönüştürme verimliliğini belirtir (örneğin, PotentialEnergyGained/ChemicalEnergyConsumed). ChemicalEnergyConsumed , tüketilen yakıtın fuelEnergyDensityInMJoulesPerLiter kullanılarak kimyasal enerjiye dönüştürülmesiyle elde edilir. DownhillEfficiency ile eşlenmelidir. İzin verilen değer aralığı 0,0 ile 1/downhillEfficiency arasındadır. Duyarlı Değerler : Yanma Modeli için : 0.27, Elektrik Modeli için : 0.74
vehicleAxleWeight	query		integer	Aracın aks başına ağırlığı kg. 0 değeri, aks başına ağırlık kısıtlamalarının dikkate alınmadığı anlamına gelir.
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 , vehicleEngineType değeriyle tutarlı olmalıdır.
vehicleHeading	query		integer	Aracın yön yönü, gerçek Kuzey'den başlayan ve saat yönünde devam eden dereceler halinde. Kuzey 0 derece, doğu 90 derece, güney 180 derece, batı 270 derece. Olası değerler 0-359
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 vehicleLoadType değerleri, 1 ile 9 arasında ABD Hazmat sınıflarının yanı sıra diğer ülkelerde/bölgelerde kullanılmak üzere genel sınıflandırmalardır. USHazmat ile başlayan değerler ABD yönlendirme içindir, diğer Tüm ülkeler/bölgeler için ise diğerHazmat kullanılmalıdır. vehicleLoadType birden çok kez belirtilebilir. Bu parametre şu anda yalnızca travelMode=truck için kabul edilmektedir.
vehicleMaxSpeed	query		integer	Aracın km/saat maksimum hızı. Araç profilindeki maksimum hız, otoyollarda bir araca izin verilip verilmediğini kontrol etmek için kullanılır. 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. Aracın maksimum hızı 50 km/saat olarak ayarlanırsa, rota motoru mevcut durum olduğu için 60 km/saat'i 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 kullanır.
vehicleWeight	query		integer	Aracın kilogram ağırlığı. 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 vehicleWeight 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 =thrilling ile `routeType`birlikte kullanılabilir.

İstek Başlığı

Name	Gerekli	Tür	Description
x-ms-client-id		string	Hangi hesabın Microsoft Entra ID güvenlik modeliyle birlikte kullanıma yönelik olduğunu belirtir. Azure Haritalar hesabı için benzersiz bir kimliği temsil eder ve Azure Haritalar yönetim düzlemi Hesap API'sinden alınabilir. Azure Haritalar Microsoft Entra ID güvenliğini kullanmak için kılavuz için aşağıdaki makalelere bakın.

Yanıtlar

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

Güvenlik

AADToken

Bunlar Microsoft Entra OAuth 2.0 Akışlarıdır. Azure rol tabanlı erişim denetimiyle eşleştirildiğinde, Azure Haritalar REST API'lerine erişimi denetlemek için kullanılabilir. Azure rol tabanlı erişim denetimleri, bir veya daha fazla Azure Haritalar kaynak hesabına veya alt kaynağına erişimi tanımlamak için kullanılır. Herhangi bir kullanıcı, grup veya hizmet sorumlusuna yerleşik bir rol veya REST API'lerini Azure Haritalar için bir veya daha fazla izinden oluşan özel bir rol aracılığıyla erişim verilebilir.

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

Notlar

Bu güvenlik tanımı, uygulamanın erişim isteğinde x-ms-client-id bulunduğu Azure Haritalar kaynağı belirtmek için üst bilginin kullanılmasını gerektirir. Bu, Haritalar yönetim API'sinden edinilebilir.

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

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

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

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

subscription-key

Bu, Azure portal bir Azure Haritalar hesabı İçerik Oluşturucu veya PowerShell, CLI, Azure SDK'ları veya REST API kullanarak sağlanan paylaşılan bir anahtardır.

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

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

Type: apiKey
In: query

SAS Token

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

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

Herkese açık uygulamalar için önerimiz, uygunsuz işlemeyi sınırlamak ve SAS Belirtecini düzenli olarak yenilemek için Harita hesabı kaynağında izin verilen kaynakların belirli bir listesini yapılandırmanızdır.

Type: apiKey
In: header

Örnekler

Successfully retrieve a route between an origin and a destination

Sample Request

HTTP

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

Sample Response

Status code:: 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 yoluyla karşılaştırıldığında, hesaplanan alternatiflerin verilen planlama ölçütlerine göre en uygun olanını denetler.
ComputeTravelTime	Farklı türdeki trafik bilgileri (yok, geçmiş, canlı) ve varsayılan en iyi tahmin edilen seyahat süresi kullanılarak ek seyahat sürelerinin döndürülip döndürülmeyeceğini belirtir.
DelayMagnitude	Olayın neden olduğu gecikmenin büyüklüğü. Bu değerler , Trafik Olayı Ayrıntısı Alma API'sinin yanıt alanı ty değerlerine karşılık gelir.
DrivingSide	Manevra noktasında sol ve sağ taraftaki sürüşü gösterir.
EffectiveSetting	Bu Yol 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 =heyecan verici ile `routeType`birlikte kullanılabilir.
JunctionType	Manevranın gerçekleştiği kavşağın türü. Daha büyük kavşaklar için, kavşak girmek ve kavşaktan çıkmak için iki ayrı yönerge oluşturulur.
LatLongPair	Enlem ve boylam olarak temsil edilen konum.
Report	Tanılama amacıyla hangi verilerin raporlanması gerektiğini belirtir. Tek olası değer effectiveSettings'tir. API çağrılırken kullanılan etkili parametreleri veya verileri raporlar. Varsayılan parametreler söz konusu olduğunda, parametrenin çağıran tarafından belirtilmediğinde varsayılan değer yansıtılır.
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. İstenen aktarım modu bu bölümde mümkün değilse değer olarak ayarlanır `other`
Route
RouteAvoidType	Yol hesaplamasının yolu belirlerken kaçınmaya çalışması gereken bir şeyi belirtir. Bir istekte birden çok kez belirtilebilir, örneğin, '&avoid=otoyollar&avoid=tollRoads&avoid=ferries'. Yol Aralığı isteklerinde zatenUsedRoads değeri kullanılmamalıdır.
RouteDirections	Bu nesne başarılı bir Yol Tarifleri çağrısından döndürülür
RouteGuidance	Kılavuzla ilgili öğeleri içerir. Bu alan yalnızca rehberlik istendiğinde bulunur ve kullanılabilir durumdadır.
RouteInstruction	Bir manevrayı açıklayan bir öznitelik kümesi, örneğin 'Sağa dön', 'Sola tut', 'Feribota bin', 'Otoyola bin', 'Var'.
RouteInstructionGroup	Birbiriyle ilişkili yönerge öğelerinin bir dizisini Gruplar. Sıra aralığı firstInstructionIndex ve lastInstructionIndex ile kısıtlanır. İnsan tarafından okunabilen metin iletileri rehberlik için istendiğinde (instructionType=text veya etiketli), yönerge Grubu kullanılabilir olduğunda döndürülen bir özet iletiye sahiptir.
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 rotanın bir bölümünün açıklaması. İstekte sağlanan her ek yol noktası, döndürülen rotada ek bir bacakla sonuçlanır.
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ı bildirir.
RouteRepresentationForBestOrder	Yanıt olarak sağlanan yol kümesinin gösterimini belirtir. Bu parametre değeri yalnızca computeBestOrder=true ile birlikte kullanılabilir.
RouteSection	Yol bölümleri, bir yolun bölümleri hakkında ek bilgiler içerir. Her bölüm en az , `endPointIndex`ve `sectionType`öğelerini `startPointIndex`içerir.
RouteSectionTec	TPEG2-TEC standardında 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. Simge 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. Birden çok tür kullanılabilir. 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 öğesinin tüm rota için kullanılamayabileceğini unutmayın. İstenen travelMode belirli bir bölüm için kullanılamıyorsa, bu bölüm için yanıtın travelMode öğesi "diğer" olur. Seyahat modlarının veri yolu, motosiklet, taksi ve van BETA işlevi olduğunu unutmayın. Tüm alanlarda tam kısıtlama verileri kullanılamaz.
VehicleEngineType	Aracın motor tipi. Ayrıntılı bir Tüketim Modeli belirtildiğinde , vehicleEngineType değ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 vehicleLoadType değerleri, 1 ile 9 arasında ABD Hazmat sınıflarının yanı sıra diğer ülkelerde/bölgelerde kullanılmak üzere genel sınıflandırmalardır. USHazmat ile başlayan değerler ABD yönlendirme içindir, diğer Tüm ülkeler/bölgeler için ise diğerHazmat kullanılmalıdır. vehicleLoadType birden çok kez belirtilebilir. Bu parametre şu anda yalnızca travelMode=truck için kabul edilmektedir.
WindingnessLevel	Heyecan verici rota için dönüş seviyesi. Bu parametre yalnızca =heyecan verici ile `routeType`birlikte kullanılabilir.

AlternativeRouteType

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

Name	Tür	Description
anyRoute	string	En iyi durumdaki başvuru rotası ile karşılaştırması ne olursa olsun herhangi bir alternatif yolun döndürülebilmesine izin verin.
betterRoute	string	Alternatif bir yol döndürmek için verilen planlama ölçütlerine göre başvuru yolundan daha iyi olması gerekir.

ComputeTravelTime

Farklı türdeki trafik bilgileri (yok, geçmiş, canlı) ve varsayılan en iyi tahmin edilen seyahat süresi kullanılarak ek seyahat sürelerinin döndürülip döndürülmeyeceğini belirtir.

Name	Tür	Description
all	string	Tüm trafik bilgisi türleri için seyahat sürelerini hesaplar ve yol yanıtında özetlere dahil edilen noTrafficTravelTimeInSeconds, historicTrafficTravelTimeInSeconds ve liveTrafficIncidentsTravelTimeInSeconds alanlarındaki tüm sonuçları belirtir.
none	string	Ek seyahat sürelerini hesaplamaz.

DelayMagnitude

Olayın neden olduğu gecikmenin büyüklüğü. Bu değerler , Trafik Olayı Ayrıntısı Alma API'sinin yanıt alanı ty değerlerine karşılık gelir.

Name	Tür	Description
0	string	Bilinmiyor.
1	string	Küçük.
2	string	Orta.
3	string	Büyük.
4	string	Tanımsız, yol kapatma ve diğer belirsiz gecikmeler için kullanılır.

DrivingSide

Manevra noktasında sol ve sağ taraftaki sürüşü gösterir.

Name	Tür	Description
LEFT	string	Sol tarafta.
RIGHT	string	Sağ tarafta.

EffectiveSetting

Bu Yol API'si çağrılırken kullanılan etkili parametre veya veriler.

Name	Tür	Description
key	string	Kullanılan parametrenin adı.
value	string	Kullanılan parametrenin değeri.

ErrorAdditionalInfo

Kaynak yönetimi hatası ek bilgileri.

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

ErrorDetail

Hata ayrıntısı.

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

ErrorResponse

Hata yanıtı

Name	Tür	Description
error	ErrorDetail	Hata nesnesi.

GuidanceInstructionType

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

Name	Tür	Description
DIRECTION_INFO	string	Yön bilgileri.
LOCATION_ARRIVAL	string	Varış konumu.
LOCATION_DEPARTURE	string	Kalkış yeri.
LOCATION_WAYPOINT	string	Yol noktası konumu.
ROAD_CHANGE	string	Yol Değişikliği.
TURN	string	Dön.

GuidanceManeuver

Manevrayı tanımlayan bir kod.

Name	Tür	Description
ARRIVE	string	Sen geldin.
ARRIVE_LEFT	string	Sen geldin. Hedefiniz sol tarafta.
ARRIVE_RIGHT	string	Sen geldin. Hedefiniz sağ tarafta.
BEAR_LEFT	string	Ayı sola.
BEAR_RIGHT	string	Ayı sağa.
DEPART	string	Bırak.
ENTER_FREEWAY	string	Otobana bin.
ENTER_HIGHWAY	string	Otobana bin.
ENTER_MOTORWAY	string	Otoyola bin.
ENTRANCE_RAMP	string	Rampayı al.
FOLLOW	string	Izleyin.
KEEP_LEFT	string	Sola doğru devam edin.
KEEP_RIGHT	string	Sağa doğru devam edin.
MAKE_UTURN	string	U dönüşü yap.
MOTORWAY_EXIT_LEFT	string	Sol çıkışa geçin.
MOTORWAY_EXIT_RIGHT	string	Doğru çıkışa geçin.
ROUNDABOUT_BACK	string	Kavşakta dolaş.
ROUNDABOUT_CROSS	string	Kavşakta çapraz.
ROUNDABOUT_LEFT	string	Kavşakta soldan çıkışa geçin.
ROUNDABOUT_RIGHT	string	Kavşakta sağdan çıkışa geçin.
SHARP_LEFT	string	Sola doğru keskin dön.
SHARP_RIGHT	string	Sağa doğru keskin dön.
STRAIGHT	string	Dümdüz devam edin.
SWITCH_MAIN_ROAD	string	Ana yola geç.
SWITCH_PARALLEL_ROAD	string	Paralel yola geçin.
TAKE_EXIT	string	Çıkışa geçin.
TAKE_FERRY	string	Feribota bin.
TRY_MAKE_UTURN	string	U dönüşü yapmayı deneyin.
TURN_LEFT	string	Sola dönün.
TURN_RIGHT	string	Sağa dönün.
WAYPOINT_LEFT	string	Yol noktasına ulaştınız. Sol tarafta.
WAYPOINT_REACHED	string	Yol noktasına ulaştınız.
WAYPOINT_RIGHT	string	Yol noktasına ulaştınız. Sağ tarafta.

InclineLevel

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

Name	Tür	Description
high	string	yüksek
low	string	Düşük
normal	string	Normal

JunctionType

Manevranın gerçekleştiği kavşağın türü. Daha büyük kavşaklar için, kavşak girmek ve kavşaktan çıkmak için iki ayrı yönerge oluşturulur.

Name	Tür	Description
BIFURCATION	string	Çatallanma
REGULAR	string	Normal
ROUNDABOUT	string	Roundabout

LatLongPair

Enlem ve boylam olarak temsil edilen konum.

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

Report

Tanılama amacıyla hangi verilerin raporlanması gerektiğini belirtir. Tek olası değer effectiveSettings'tir. API çağrılırken kullanılan etkili parametreleri veya verileri raporlar. Varsayılan parametreler söz konusu olduğunda, parametrenin çağıran tarafından belirtilmediğinde varsayılan değer yansıtılır.

Name	Tür	Description
effectiveSettings	string	API çağrılırken kullanılan etkili parametreleri veya verileri raporlar.

ResponseFormat

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

Name	Tür	Description
json	string	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 Doluluk Aracı) şeritlerinin kullanılmasını gerektiren bölümleri.
CAR_TRAIN	string	Rotanın arabalar veya trenler olan bölümleri.
COUNTRY	string	Rotanın hangi ülkelerde/bölgelerde olduğunu gösteren bölümler.
FERRY	string	Rotanın feribot olan bölümleri.
MOTORWAY	string	Yolun otoyollar olan bölümleri.
PEDESTRIAN	string	Rotanın yalnızca yayalar için uygun bölümleri.
TOLL_ROAD	string	Rotanın ücretli ödeme gerektiren bölümleri.
TOLL_VIGNETTE	string	Yolun ücretli bir vignette bulunmasını gerektiren bölümleri.
TRAFFIC	string	Yolun trafik bilgilerini içeren bölümleri.
TRAVEL_MODE	string	İstek parametresiyle `travelMode`ilgili bölümler.
TUNNEL	string	Yolun tünel olan bölümleri.
URBAN	string	Yolun kentsel alanlar içinde yer alan bölümleri.

ResponseTravelMode

Hesaplanan rota için seyahat modu. İstenen aktarım modu bu bölümde mümkün değilse değer olarak ayarlanır other

Name	Tür	Description
bicycle	string	Döndürülen rotalar, bisiklet kulvarlarının kullanımı da dahil olmak üzere bisikletler için iyileştirilmiştir.
bus	string	Döndürülen rotalar, yalnızca otobüs hatlarının kullanımı dahil olmak üzere otobüsler için iyileştirilmiştir. BETA işlevi.
car	string	Döndürülen rotalar arabalar için iyileştirilmiştir.
motorcycle	string	Döndürülen rotalar motosikletler için iyileştirilmiştir. BETA işlevi.
other	string	Verilen aktarım modu bu bölümde mümkün değildir
pedestrian	string	Geri dönen yollar, kaldırım kullanımı dahil olmak üzere yayalar için iyileştirilmiştir.
taxi	string	Döndürülen rotalar taksiler için iyileştirilmiştir. BETA işlevi.
truck	string	Döndürülen rotalar, kamyonlar gibi ticari araçlar için optimize edilmiştir.
van	string	Döndürülen yollar, minibüsler için iyileştirilmiştir. BETA işlevi.

Route

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

RouteAvoidType

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

Name	Tür	Description
alreadyUsedRoads	string	Aynı yolu birden çok kez kullanmaktan kaçınıyor. =heyecan verici ile `routeType`birlikte en kullanışlı.
borderCrossings	string	Rota hesaplamasında sınır geçişlerini önler.
carpools	string	Araç havuzu (HOV/Yüksek Doluluk Aracı) şeritlerinin kullanılmasını gerektiren rotalardan kaçınır.
ferries	string	Feribotları önler
motorways	string	Otoyolları önler
tollRoads	string	Ücretli yollardan kaçınıyor.
unpavedRoads	string	Unpaved yolları önler

RouteDirections

Bu nesne başarılı bir Yol Tarifleri çağrısından döndürülür

Name	Tür	Description
formatVersion	string	Format Version özelliği
optimizedWaypoints	RouteOptimizedWaypoint[]	İyileştirilmiş yol noktası dizisi. Özgün ve iyileştirilmiş liste için kullanıcı tarafından sağlanan yol noktası dizisinin dizinini gösterir. Örneğin, bir yanıt: `<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ü, ilk" şeklindedir.
report	RouteReport	Geçerli çağrıda kullanılan geçerli ayarları bildirir.
routes	Route[]	Rotalar dizisi

RouteGuidance

Kılavuzla ilgili öğeleri içerir. Bu alan yalnızca rehberlik istendiğinde bulunur ve kullanılabilir durumdadır.

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

RouteInstruction

Bir manevrayı açıklayan bir öznitelik kümesi, örneğin 'Sağa dön', 'Sola tut', 'Feribota bin', 'Otoyola bin', 'Var'.

Name	Tür	Description
combinedMessage	string	Manevra için insan tarafından okunabilen bir ileti, bir sonraki yönergedeki mesajla birleştirildi. Bazen iki ardışık yönergeyi tek bir yönergede birleştirmek mümkündür ve bu da izlemeyi kolaylaştırır. Bu durumda possibleCombineWithNext bayrağı true olur. Örnek: `10. Turn left onto Einsteinweg/A10/E22 towards Ring Amsterdam 11. Follow Einsteinweg/A10/E22 towards Ring Amsterdam` 10. yönergedeki possibleCombineWithNext bayrağı true. Bu, kodlanmış kılavuzun istemcilerine yönerge 11 ile birleştirilebileceğini gösterir. Yönergeler, insanlar tarafından okunabilir rehberlik isteyen istemciler için otomatik olarak birleştirilir. combinedMessage alanı birleştirilmiş iletiyi içerir: `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 sol ve sağ taraftaki sürüşü gösterir.
exitNumber	string	Geçerli manevra tarafından alınan bir otoyol çıkışının sayısı... Bir çıkışın birden çok çıkış numarası varsa, bunlar "" ile ayrılır ve büyük olasılıkla "-" ile toplanır; örneğin, "10, 13-15".
instructionType	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, kavşak girmek ve kavşaktan çıkmak için iki ayrı yönerge oluşturulur.
maneuver	GuidanceManeuver	Manevrayı tanımlayan bir kod.
message	string	Manevra için insan tarafından okunabilen 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 sayıları... Örnek: ["E34", "N205"]
roundaboutExitNumber	string	Bu, dönel kavşakta hangi çıkışın alınacak olduğunu gösterir.
routeOffsetInMeters	integer	Yolun başlangıcından yönergenin noktasına uzaklık.
signpostText	string	Manevrayla veya takip edilmesi gereken yöne en uygun işaret direğindeki metin.
stateCode	string	ISO 3166-2 kodunun ikinci bölümüyle temsil edilen ülkenin alt bölümü (örneğin, eyalet). Bu yalnızca ABD, Kanada ve Meksika gibi bazı ülkelerde/bölgelerde kullanılabilir.
street	string	Manevradan sonraki sonraki önemli yol segmentinin veya izlenmesi gereken caddenin sokak adı.
travelTimeInSeconds	integer	RouteOffsetInMeters'e karşılık gelen noktaya kadar tahmini seyahat süresi.
turnAngleInDecimalDegrees	integer	Yönergenin yönünü gösterir. junctionType bir dönüş yönergesi gösteriyorsa: 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 tut

RouteInstructionGroup

Birbiriyle ilişkili yönerge öğelerinin bir dizisini Gruplar. Sıra aralığı firstInstructionIndex ve lastInstructionIndex ile kısıtlanır. İnsan tarafından okunabilen metin iletileri rehberlik için istendiğinde (instructionType=text veya etiketli), yönerge Grubu kullanılabilir olduğunda döndürülen bir özet iletiye sahiptir.

Name	Tür	Description
firstInstructionIndex	integer	Yönergelerdeki ilk yönergenin dizini ve bu gruba ait.
groupLengthInMeters	integer	Grubun uzunluğu.
groupMessage	string	İnsan tarafından okunabilen metin iletileri için rehberlik istendiğinde (instructionType=text veya etiketli) özet ileti.
lastInstructionIndex	integer	Yönergelerdeki ve bu gruba ait olan son yönergenin dizini.

RouteInstructionsType

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

Name Tür Description

coded

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

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:

Turn left onto <roadNumber>A4</roadNumber>/<roadNumber>E19</roadNumber>
towards <signpostText>Den Haag</signpostText>

text

string

İnsan tarafından okunabilen iletiler içeren ham yönergeler verilerini düz metin olarak döndürür.

RouteLeg

Bir nokta listesinden oluşan rotanın bir bölümünün açıklaması. İstekte sağlanan her ek yol noktası, döndürülen rotada ek bir bacakla sonuçlanır.

Name	Tür	Description
points	LatLongPair[]	Nokta dizisi
summary	RouteLegSummary	Yol bölümü için özet nesnesi.

RouteLegSummary

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

Name	Tür	Description
arrivalTime	string	Rota veya bacak için tahmini varış zamanı. Saat UTC olarakdır.
batteryConsumptionInkWh	number	Elektrik Tüketimi Modeli kullanılarak kilowatt saat (kWh) cinsinden tahmini elektrik enerjisi tüketimi. vehicleEngineType elektrikli olarak ayarlanırsa ve constantSpeedConsumptionInkWhPerHundredkm belirtilirse dahil edilir. BatteryConsumptionInkWh değeri, iyileştirilmiş elektrik enerjisini içerir ve bu nedenle negatif olabilir (bu da enerji kazandığını gösterir). Hem maxChargeInkWh hem de currentChargeInkWh belirtilirse, pil şarj düzeyinin maxChargeInkWh değerini asla aşmadığından emin olmak için yenileme sınırlanır. Ne maxChargeInkWh ne de currentChargeInkWh belirtilmezse, tüketim hesaplamasında kısıtlanmamış geri alma varsayılır.
departureTime	string	Rota veya bacak için tahmini kalkış saati. Saat UTC olarakdır.
fuelConsumptionInLiters	number	Yanma Tüketimi Modeli kullanılarak litre cinsinden tahmini yakıt tüketimi. VehicleEngineType yanma olarak ayarlanırsa ve constantSpeedConsumptionInLitersPerHundredkm belirtilirse dahil edilir. Değer negatif olmayacaktır.
historicTrafficTravelTimeInSeconds	integer	Zamana bağlı geçmiş trafik verileri kullanılarak hesaplanan tahmini seyahat süresi. Yalnızca computeTravelTimeFor = tümü sorguda kullanılıyorsa dahil edilir.
lengthInMeters	integer	Metre cinsinden Uzunluk özelliği
liveTrafficIncidentsTravelTimeInSeconds	integer	Gerçek zamanlı hız verileri kullanılarak hesaplanan tahmini seyahat süresi. Yalnızca computeTravelTimeFor = tümü sorguda kullanılıyorsa dahil edilir.
noTrafficTravelTimeInSeconds	integer	Tahmini seyahat süresi, trafik koşullarından (ör. tıkanıklık) dolayı rotada gecikme yaşanmaz gibi hesaplanır. Yalnızca computeTravelTimeFor = tümü sorguda kullanılıyorsa dahil edilir.
trafficDelayInSeconds	integer	Trafik bilgilerine göre gerçek zamanlı olayların neden olduğu saniye cinsinden tahmini gecikme. Gelecekte kalkış saatiyle planlanan rotalar için gecikmeler her zaman 0'dır. Farklı trafik bilgisi türlerini kullanarak ek seyahat süreleri döndürmek için computeTravelTimeFor=all parametresinin eklenmesi gerekir.
travelTimeInSeconds	integer	Gerçek zamanlı trafik nedeniyle gecikmeyi içeren saniye cinsinden tahmini seyahat süresi özelliği. Traffic=false travelTimeInSeconds yine de trafik nedeniyle gecikmeyi içerdiğini unutmayın. DepartAt gelecekteyse seyahat süresi zamana bağlı geçmiş trafik verileri kullanılarak hesaplanır.

RouteOptimizedWaypoint

İyileştirilmiş yol noktası nesnesi.

Name	Tür	Description
optimizedIndex	integer	Sistemden iyileştirilmiş yol noktası dizini.
providedIndex	integer	Kullanıcı tarafından sağlanan yol noktası dizini.

RouteReport

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

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

RouteRepresentationForBestOrder

Yanıt olarak sağlanan yol kümesinin gösterimini belirtir. Bu parametre değeri yalnızca computeBestOrder=true ile birlikte kullanılabilir.

Name	Tür	Description
none	string	Yalnızca iyileştirilmiş yol noktası dizinlerini içerir, ancak yanıta rota geometrisini içermez.
polyline	string	Yanıta rota geometrisi ekler.
summaryOnly	string	Çok hatlı olarak özet, ancak yanıttaki rotalar için nokta geometrisi öğelerini hariç tutarak.

RouteSection

Yol bölümleri, bir yolun bölümleri hakkında ek bilgiler içerir. Her bölüm en az , endPointIndexve sectionTypeöğelerini startPointIndexiçerir.

Name	Tür	Description
delayInSeconds	integer	Olayın neden olduğu saniyelerdeki gecikme.
effectiveSpeedInKmh	integer	Olayın km/s cinsinden etkin hızı, tüm uzunluğunun ortalamasını alır.
endPointIndex	integer	Bu bölümün uygulandığı yoldaki son noktanın (uzaklık 0) dizini.
magnitudeOfDelay	DelayMagnitude	Olayın neden olduğu gecikmenin büyüklüğü. Bu değerler , Trafik Olayı Ayrıntısı Alma API'sinin yanıt alanı ty değerlerine karşılık gelir.
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ında 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. İstenen aktarım modu bu bölümde mümkün değilse değer olarak ayarlanır `other`

RouteSectionTec

TPEG2-TEC standardında tanımları kullanarak trafik olayının ayrıntıları. effectCode içerebilir ve öğelere neden olabilir.

Name	Tür	Description
causes	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

Trafik olayının nedeni. mainCauseCode ve subCauseCode öğelerini içerebilir. Simge ve açıklamaları tanımlamak için kullanılabilir.

Name	Tür	Description
mainCauseCode	integer	Trafik olayının ana nedeni. TPEG2-TEC standardında tanımlandığı gibi tec002:CauseCode tablosunda bir değer içerir.
subCauseCode	integer	Trafik olayının alt parçası. TPEG2-TEC standardında tanımlandığı gibi mainCauseCode tarafından tanımlanan alt neden tablosunda bir değer içerir.

RouteSummary

Özet nesnesi

Name	Tür	Description
arrivalTime	string	Rota veya bacak için tahmini varış zamanı. Saat UTC olarakdır.
departureTime	string	Rota veya bacak için tahmini kalkış saati. Saat UTC olarakdır.
lengthInMeters	integer	Metre cinsinden Uzunluk özelliği
trafficDelayInSeconds	integer	Trafik bilgilerine göre gerçek zamanlı olayların neden olduğu saniye cinsinden tahmini gecikme. Gelecekte kalkış saatiyle planlanan rotalar için gecikmeler her zaman 0'dır. Farklı trafik bilgisi türlerini kullanarak ek seyahat süreleri döndürmek için computeTravelTimeFor=all parametresinin eklenmesi gerekir.
travelTimeInSeconds	integer	Gerçek zamanlı trafik nedeniyle gecikmeyi içeren saniye cinsinden tahmini seyahat süresi özelliği. Traffic=false travelTimeInSeconds yine de trafik nedeniyle gecikmeyi içerdiğini unutmayın. DepartAt gelecekteyse seyahat süresi zamana bağlı geçmiş trafik verileri kullanılarak hesaplanır.

RouteType

İstenen yol türü.

Name	Tür	Description
eco	string	Ekonomi ve hız ile dengelenmiş bir rota.
fastest	string	En hızlı yol.
shortest	string	Mesafeye göre en kısa rota.
thrilling	string	İlgi çekici veya zorlu yollar içerir ve mümkün olduğunca az otoyol kullanır. Dahil edilen dönüş düzeyini ve ayrıca tepelik derecesini seçebilirsiniz. Bunun nasıl ayarlanacağına ilişkin engebelilik ve sargı parametrelerine bakın. =heyecan verici ile `routeType`planlanan rotalarda 900 km sınırı vardı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. Birden çok tür kullanılabilir. Varsayılan sectionType, travelMode girişine başvurur. Varsayılan olarak travelMode, araba olarak ayarlanır

Name	Tür	Description
carTrain	string	Rotanın arabalar veya trenler olan bölümleri.
carpool	string	Yolun, araç havuzu (HOV/Yüksek Doluluk Aracı) şeritlerinin kullanılmasını gerektiren bölümleri.
country	string	Rotanın hangi ülkelerde/bölgelerde olduğunu gösteren bölümler.
ferry	string	Rotanın feribot olan bölümleri.
motorway	string	Yolun otoyollar olan bölümleri.
pedestrian	string	Rotanın yalnızca yayalar için uygun bölümleri.
tollRoad	string	Rotanın ücretli ödeme gerektiren bölümleri.
tollVignette	string	Rotanın ücretli bir vignette bulunmasını gerektiren bölümleri.
traffic	string	Yolun trafik bilgilerini içeren bölümleri.
travelMode	string	İstek parametresiyle `travelMode`ilgili bölümler.
tunnel	string	Yolun tünel olan bölümleri.
urban	string	Yolun kentsel alanlarda bulunan bölümleri.

SimpleCategory

Olayın türü. Şu anda JAM, ROAD_WORK, ROAD_CLOSURE veya OTHER olabilir. Ayrıntılı bilgi için "tec" bölümüne bakın.

Name	Tür	Description
JAM	string	Trafik sıkışıklığı.
OTHER	string	Diğer.
ROAD_CLOSURE	string	Yol kapatma.
ROAD_WORK	string	Yol çalışması.

TravelMode

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

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

VehicleEngineType

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

Name	Tür	Description
combustion	string	İç yanmalı motor.
electric	string	Elektrik motoru.

VehicleLoadType

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

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

WindingnessLevel

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

Name	Tür	Description
high	string	yüksek
low	string	Düşük
normal	string	Normal

Route - Get Route Directions

URI Parametreleri

İstek Başlığı

Yanıtlar

Güvenlik

AADToken

Notlar

Scopes

subscription-key

SAS Token

Örnekler

Successfully retrieve a route between an origin and a destination

Sample Request

Sample Response

Tanımlar

AlternativeRouteType

ComputeTravelTime

DelayMagnitude

DrivingSide

EffectiveSetting

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

GuidanceInstructionType

GuidanceManeuver

InclineLevel

JunctionType

LatLongPair

Report

ResponseFormat

ResponseSectionType

ResponseTravelMode

Route

RouteAvoidType

RouteDirections

RouteGuidance

RouteInstruction

RouteInstructionGroup

RouteInstructionsType

RouteLeg

RouteLegSummary

RouteOptimizedWaypoint

RouteReport

RouteRepresentationForBestOrder

RouteSection

RouteSectionTec

RouteSectionTecCause

RouteSummary

RouteType

SectionType

SimpleCategory

TravelMode

VehicleEngineType

VehicleLoadType

WindingnessLevel

Ek kaynaklar