Aracılığıyla paylaş

Route - Get Route Range

  • Başvuru
Hizmet:
Maps
API Sürümü:
1.0

Belirli bir eşik içindeki belirli bir noktadan erişilebilen alanı zamana, mesafeye veya yakıt kapasitesine göre gösteren bir harita oluşturmak için kullanın.

Get Route Range (Isochrone) API,belirtilen yakıt, enerji, zaman veya mesafe bütçesine göre çıkış noktasından ulaşılacak konum kümesini hesaplayan bir HTTP GET isteğidir. Çokgen bir sınır (veya Isochrone) hem saat yönünün tersine hem de çıkış noktasının sonucu olan kesin çokgen merkezi olarak döndürülür.

Döndürülen çokgen, sağlanan isochrone içindeki POI'leri aramak için Geometri İçinde Ara gibi daha fazla işlem için kullanılabilir.

GET https://atlas.microsoft.com/route/range/{format}?api-version=1.0&query={query}
İsteğe bağlı parametrelerle: 
GET https://atlas.microsoft.com/route/range/{format}?api-version=1.0&query={query}&fuelBudgetInLiters={fuelBudgetInLiters}&energyBudgetInkWh={energyBudgetInkWh}&timeBudgetInSec={timeBudgetInSec}&distanceBudgetInMeters={distanceBudgetInMeters}&departAt={departAt}&routeType={routeType}&traffic={traffic}&avoid={avoid}&travelMode={travelMode}&hilliness={hilliness}&windingness={windingness}&vehicleAxleWeight={vehicleAxleWeight}&vehicleWidth={vehicleWidth}&vehicleHeight={vehicleHeight}&vehicleLength={vehicleLength}&vehicleMaxSpeed={vehicleMaxSpeed}&vehicleWeight={vehicleWeight}&vehicleCommercial={vehicleCommercial}&vehicleLoadType={vehicleLoadType}&vehicleEngineType={vehicleEngineType}&constantSpeedConsumptionInLitersPerHundredkm={constantSpeedConsumptionInLitersPerHundredkm}&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

number[]

Aralık hesaplamasının başlaması gereken Koordinat.
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
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.
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, isteğe bağlı saat dilimi uzaklığı ile RFC 3339, bölüm 5.6'da tanımlandığı gibi bir dateTime değer olarak biçimlendirilmiştir. Bir saat dilimi uzaklığı belirtilmediğinde, kaynak noktasının bu olduğu varsayılır.

  • Varsayılan değer: now
  • Diğer değer: dateTime

Örnekler:

  • 2023-12-19T16:39:57
  • 2023-12-20T00:39:57+00:00

departAt parametresi ile arriveAtbirlikte kullanılamaz.
distanceBudgetInMeters
 query

number

double

Sürüş mesafesi kullanılarak seyahat edilebilecek maksimum mesafeyi belirleyen metreler halinde mesafe bütçesi. Tüketim Modeli yalnızca routeType eko olduğunda aralığı etkiler.
Tam olarak bir bütçe (fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec veya distanceBudgetInMeters) kullanılmalıdır.
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
energyBudgetInkWh
 query

number

double

Belirtilen Elektrik Tüketimi Modeli kullanılarak seyahat edilebilecek maksimum aralığı belirleyen kilowatt saat (kWh) cinsinden elektrik enerjisi bütçesi.
energyBudgetInkWh kullanıldığında, ayrıntılı bir Elektrik Tüketim Modeli belirtmek zorunludur.
Tam olarak bir bütçe (fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec veya distanceBudgetInMeters) kullanılmalıdır.
fuelBudgetInLiters
 query

number

double

Belirtilen Yanma Tüketimi Modeli kullanılarak seyahat edilebilecek maksimum aralığı belirleyen litre cinsinden yakıt bütçesi.
fuelBudgetInLiters kullanıldığında ayrıntılı bir Yanma Tüketim Modeli belirtmek zorunludur.
Tam olarak bir bütçe (fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec veya distanceBudgetInMeters) kullanılmalıdır.
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 routeTypebirlikte kullanılabilir.
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
routeType
 query

RouteType

İstenen yol türü.
timeBudgetInSec
 query

number

double

Sürüş süresi kullanılarak seyahat edilebilecek maksimum aralığı belirleyen saniye olarak zaman bütçesi. Tüketim Modeli yalnızca routeType eko olduğunda aralığı etkiler.
Tam olarak bir bütçe (fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec veya distanceBudgetInMeters) kullanılmalıdı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 cinsindendir. 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.
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, araç için uygun bir değerin rota planlaması sırasında 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 mevcut 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 yine 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 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.

Mantıklı 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 =heyecan verici ile routeTypebirlikte kullanılabilir.

İstek Başlığı

Name Gerekli Tür Description
x-ms-client-id

string

Microsoft Entra ID güvenlik modeliyle birlikte hangi hesabın kullanıma yönelik olduğunu belirtir. Azure Haritalar hesabı için benzersiz bir kimliği temsil eder ve Azure Haritalar yönetim düzlemi Hesap API'sinden alınabilir. Azure Haritalar'da Microsoft Entra ID güvenliğini kullanmak için kılavuz için aşağıdaki makalelere bakın.

Yanıtlar

Name Tür Description
200 OK

RouteRangeResult

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 denetimi ile eşleştirildiğinde, Azure Haritalar REST API'lerine erişimi denetlemek için kullanılabilir. Azure rol tabanlı erişim denetimleri, bir veya daha fazla Azure Haritalar kaynak hesabına veya alt kaynağına erişim belirtmek için kullanılır. Tüm kullanıcılara, gruplara veya hizmet sorumlularına yerleşik bir rol veya Azure Haritalar REST API'leri için bir veya daha fazla izinden oluşan özel bir rol aracılığıyla erişim verilebilir.

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

Notlar

  • Bu güvenlik tanımı, uygulamanın erişim istediği Azure Haritalar kaynağını belirtmek için üst bilgi kullanımını x-ms-client-idgerektirir. Bu, Haritalar yönetim API'sinden alınabilir.

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

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

Kapsamlar

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

subscription-key

Bu, Azure portalında Bir Azure Haritalar hesabı oluşturduğunuzda veya PowerShell, CLI, Azure SDK'ları veya REST API'leri kullandığınızda sağlanan paylaşılan bir anahtardır.

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

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

Tür: apiKey
İçinde: query

SAS Token

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

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

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

Tür: apiKey
İçinde: header

Örnekler

Successfully retrieve a set of locations that can be reached from the origin point based on various conditions

Örnek isteği

GET https://atlas.microsoft.com/route/range/json?api-version=1.0&query=50.97452,5.86605&timeBudgetInSec=6000

Örnek yanıt

Durum kodu:
200 
{
  "formatVersion": "0.0.1",
  "reachableRange": {
    "center": {
      "latitude": 50.9745,
      "longitude": 5.86605
    },
    "boundary": [
      {
        "latitude": 52.03704,
        "longitude": 5.73602
      },
      {
        "latitude": 52.09456,
        "longitude": 5.59435
      },
      {
        "latitude": 52.16815,
        "longitude": 5.42279
      },
      {
        "latitude": 52.25047,
        "longitude": 5.21276
      },
      {
        "latitude": 52.21374,
        "longitude": 5.15355
      },
      {
        "latitude": 52.25674,
        "longitude": 4.96687
      },
      {
        "latitude": 52.07834,
        "longitude": 4.739
      },
      {
        "latitude": 52.05647,
        "longitude": 4.72513
      },
      {
        "latitude": 51.94553,
        "longitude": 4.53237
      },
      {
        "latitude": 51.70119,
        "longitude": 4.31165
      },
      {
        "latitude": 51.5837,
        "longitude": 4.28917
      },
      {
        "latitude": 51.48463,
        "longitude": 3.82685
      },
      {
        "latitude": 51.21096,
        "longitude": 3.62838
      },
      {
        "latitude": 50.6814,
        "longitude": 3.89244
      },
      {
        "latitude": 50.66791,
        "longitude": 3.93493
      },
      {
        "latitude": 50.49042,
        "longitude": 3.98156
      },
      {
        "latitude": 50.30944,
        "longitude": 4.47995
      },
      {
        "latitude": 50.24448,
        "longitude": 4.60502
      },
      {
        "latitude": 50.24467,
        "longitude": 4.89999
      },
      {
        "latitude": 50.08735,
        "longitude": 5.04206
      },
      {
        "latitude": 49.99214,
        "longitude": 5.23042
      },
      {
        "latitude": 49.88478,
        "longitude": 5.40994
      },
      {
        "latitude": 49.85797,
        "longitude": 5.46178
      },
      {
        "latitude": 49.86279,
        "longitude": 5.7196
      },
      {
        "latitude": 49.83259,
        "longitude": 5.74151
      },
      {
        "latitude": 50.22239,
        "longitude": 5.9387
      },
      {
        "latitude": 50.0011,
        "longitude": 6.08535
      },
      {
        "latitude": 50.04616,
        "longitude": 6.12089
      },
      {
        "latitude": 50.09472,
        "longitude": 6.28373
      },
      {
        "latitude": 49.95863,
        "longitude": 6.51654
      },
      {
        "latitude": 50.00485,
        "longitude": 6.61034
      },
      {
        "latitude": 50.00587,
        "longitude": 6.70295
      },
      {
        "latitude": 50.2947,
        "longitude": 6.65865
      },
      {
        "latitude": 50.36903,
        "longitude": 6.79276
      },
      {
        "latitude": 50.31614,
        "longitude": 7.32163
      },
      {
        "latitude": 50.36737,
        "longitude": 7.58782
      },
      {
        "latitude": 50.46919,
        "longitude": 7.7626
      },
      {
        "latitude": 50.96246,
        "longitude": 7.9826
      },
      {
        "latitude": 51.07086,
        "longitude": 7.55924
      },
      {
        "latitude": 51.36614,
        "longitude": 7.58138
      },
      {
        "latitude": 51.52015,
        "longitude": 7.67861
      },
      {
        "latitude": 51.65781,
        "longitude": 7.35175
      },
      {
        "latitude": 51.81916,
        "longitude": 7.21664
      },
      {
        "latitude": 51.9587,
        "longitude": 7.0467
      },
      {
        "latitude": 51.82713,
        "longitude": 6.67267
      },
      {
        "latitude": 51.81133,
        "longitude": 6.48424
      },
      {
        "latitude": 51.9368,
        "longitude": 6.27316
      },
      {
        "latitude": 52.01701,
        "longitude": 6.14452
      },
      {
        "latitude": 52.20847,
        "longitude": 6.09312
      },
      {
        "latitude": 52.23705,
        "longitude": 6.01297
      }
    ]
  }
}

Tanımlar

Name Description
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ı
InclineLevel

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

Enlem ve boylam olarak temsil edilen konum.
ResponseFormat

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

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

Ulaşılabilir Aralık
RouteRangeResult

Bu nesne başarılı bir Yol Ulaşılabilir Aralığı çağrısından döndürülür
RouteReport

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

İstenen yol türü.
TravelMode

İstenen rota için seyahat modu. Tanımlanmamışsa, varsayılan değer 'araba'dır. İstenen travelMode öğesinin tüm rota için kullanılamayabileceğini unutmayın. İstenen travelMode belirli bir bölümde kullanılamadığı durumlarda, bu bölüm için yanıtın travelMode öğesi "diğer" olacaktır. Seyahat modları otobüs, motosiklet, taksi ve minibüs BETA işlevselliği olduğunu unutmayın. Tüm alanlarda tam kısıtlama verileri kullanılamaz.
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 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 =thrilling ile routeTypebirlikte kullanılabilir.

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.

InclineLevel

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

Name Tür Description
high

string

yüksek
low

string

alçak
normal

string

normal

LatLongPair

Enlem ve boylam olarak temsil edilen konum.

Name Tür Description
latitude

number

Latitude özelliği
longitude

number

Longitude özelliği

ResponseFormat

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

Name Tür Description
json

string

JavaScript Nesne Gösterimi Veri Değişim Biçimi
xml

string

Genişletilebilir biçimlendirme dili

RouteAvoidType

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

Name Tür Description
alreadyUsedRoads

string

Aynı yolu birden çok kez kullanmaktan kaçınıyor. =heyecan verici ile routeTypebirlikte en kullanışlı olan.
borderCrossings

string

Rota hesaplamasında sınır geçişlerini önler.
carpools

string

Araç havuzu (HOV/Yüksek Doluluk Aracı) kulvarlarının kullanılmasını gerektiren rotalardan kaçınıyor.
ferries

string

Feribotlardan kaçınıyor
motorways

string

Otoyollardan kaçınıyor
tollRoads

string

Ücretli yollardan kaçınıyor.
unpavedRoads

string

Unpaved yolları önler

RouteRange

Ulaşılabilir Aralık

Name Tür Description
boundary

LatLongPair[]

Nokta listesi olarak gösterilen ulaşılabilir aralığın çokgen sınırı.
center

LatLongPair

Ulaşılabilir aralığın orta noktası

RouteRangeResult

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

Name Tür Description
formatVersion

string

Format Version özelliği
reachableRange

RouteRange

Ulaşılabilir Aralık
report

RouteReport

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

RouteReport

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

Name Tür Description
effectiveSettings

EffectiveSetting[]

Bu Yol API'si çağrılırken kullanılan geçerli parametreler veya veriler.

RouteType

İstenen yol türü.

Name Tür Description
eco

string

Ekonomi ve hız ile dengelenmiş bir rota.
fastest

string

En hızlı yol.
shortest

string

Mesafeye göre en kısa rota.
thrilling

string

İlginç veya zorlu yollar içerir ve mümkün olduğunca az otoyol kullanır. Dahil edilen dönüş düzeyini ve ayrıca tepelik derecesini seçebilirsiniz. Bunun nasıl ayarlanacağına ilişkin engebelilik ve sargı parametrelerine bakın. =heyecan verici ile planlanan routeTyperotalarda 900 km sınırı vardır

TravelMode

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

Name Tür Description
bus

string

Döndürülen rotalar, yalnızca otobüs hatlarının kullanımı dahil olmak üzere otobüsler için iyileştirilmiştir. BETA işlevi.
car

string

Döndürülen rotalar arabalar için iyileştirilmiştir.
motorcycle

string

Döndürülen rotalar motosikletler için iyileştirilmiştir. BETA işlevi.
taxi

string

Döndürülen rotalar taksiler için iyileştirilmiştir. BETA işlevi.
truck

string

Döndürülen rotalar, kamyonlar gibi ticari araçlar için optimize edilmiştir.
van

string

Döndürülen yollar, minibüsler için iyileştirilmiştir. BETA işlevi.

VehicleEngineType

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

Name Tür Description
combustion

string

İç yanmalı motor.
electric

string

Elektrik motoru.

VehicleLoadType

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

Name Tür Description
USHazmatClass1

string

Patlayıcılar
USHazmatClass2

string

Sıkıştırılmış gaz
USHazmatClass3

string

Yanıcı sıvılar
USHazmatClass4

string

Yanıcı katılar
USHazmatClass5

string

Oksidatörler
USHazmatClass6

string

Zehir
USHazmatClass7

string

Radyoaktif maddeler
USHazmatClass8

string

Aşındırıcılar
USHazmatClass9

string

Çeşitli
otherHazmatExplosive

string

Patlayıcılar
otherHazmatGeneral

string

Çeşitli
otherHazmatHarmfulToWater

string

Suya zararlı

WindingnessLevel

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

Name Tür Description
high

string

yüksek
low

string

alçak
normal

string

normal