Route - Post Route Matrix
Zaman uyumsuz istek kullanarak çıkış noktaları ve hedefler listesindeki tüm olası çiftlerin seyahat süresini ve uzaklıklarını gösteren bir yol matrisi almak için kullanın.
Post Route Matrix
API, zaman uyumsuz (zaman uyumsuz) bir istek kullanarak kaynak ve hedef konumlar tarafından tanımlanan bir yol kümesi için yol özetleri matrisinin hesaplanmasını sağlayan bir HTTP POST
isteğidir. Zaman uyumlu (eşitleme) isteğinde bulunmak için bkz . Post Route Matrix Sync. Hizmet, belirli her kaynak için, bu kaynaktan verilen her hedefe yönlendirmenin maliyetini hesaplar. Kaynak kümesi ve hedef kümesi, bir tablonun sütun ve satır üst bilgileri olarak düşünülebilir ve tablodaki her hücre, o hücre için kaynaktan hedefe yönlendirme maliyetlerini içerir. Örneğin, bir gıda teslimat şirketinin 20 sürücüsü olduğunu ve teslimatı restorandan almak için en yakın sürücüyü bulması gerektiğini varsayalım. Bu kullanım örneğini çözmek için Matrix Route API'sini çağırabilir.
Her rota için seyahat süreleri ve mesafeler döndürülür. Yol Tarifleri API'sini kullanarak hesaplanması gereken ayrıntılı yolları belirlemek için hesaplanan maliyetleri kullanabilirsiniz.
Zaman uyumsuz istek matrisinin boyut üst sınırı 700 , eşitleme isteği için ise 100'dür (kaynak sayısı hedef sayısıyla çarpılır).
Zaman Uyumlu Yönlendirme Matrisi İsteği Gönderme
Senaryonuz zaman uyumlu istekler gerektiriyorsa ve matrisin boyut üst sınırı 100'den küçük veya buna eşitse, zaman uyumlu istekte bulunmak isteyebilirsiniz. Bu API için matrisin en büyük boyutu 100'dür (kaynak sayısı hedef sayısıyla çarpılır). Bu kısıtlama göz önünde bulundurularak olası matris boyutlarına örnekler şunlardır: 10x10, 6x8, 9x8 (kare olması gerekmez).
POST https://atlas.microsoft.com/route/matrix/sync/json?api-version=1.0&subscription-key={subscription-key}
Zaman Uyumsuz Yol Matrisi İsteği Gönderme
Zaman Uyumsuz API, görece karmaşık yönlendirme isteklerinin büyük hacimlerini işlemek için uygundur. Zaman uyumsuz istek kullanarak istekte bulunduğunuzda, hizmet varsayılan olarak yanıt üst bilgisinin Konum alanındaki yeniden yönlendirme URL'si boyunca bir 202 yanıt kodu döndürür. Yanıt verileri veya hata bilgileri kullanılabilir olana kadar bu URL düzenli aralıklarla denetlenmelidir. İstekteki parametre true olarak ayarlanırsa waitForResults
, istek 120 saniyenin altında biterse kullanıcı 200 yanıt alır.
Bu API için matrisin en büyük boyutu 700'dür (kaynak sayısı hedef sayısıyla çarpılır). Bu kısıtlama göz önünde bulundurularak olası matris boyutlarına örnekler şunlardır: 50x10, 10x10, 28x25. 10x70 (kare olması gerekmez).
Zaman uyumsuz yanıtlar 14 gün boyunca depolanır. Yeniden yönlendirme URL'si, süre sonundan sonra kullanılırsa bir 404 yanıtı döndürür.
POST https://atlas.microsoft.com/route/matrix/json?api-version=1.0&subscription-key={subscription-key}
Zaman uyumsuz işlemlerin tipik bir dizisi aşağıda verilmiştir:
İstemci, Azure Haritalar'a Rota Matrisi POST isteği gönderir
Sunucu aşağıdakilerden biriyle yanıt verir:
HTTP
202 Accepted
- Yol Matrisi isteği kabul edildi.HTTP
Error
- Yol Matrisi isteğiniz işlenirken bir hata oluştu. Bu 400 Hatalı İstek veya başka bir Hata durum kodu olabilir.Matris Yolu isteği başarıyla kabul edildiyse, yanıttaki Konum üst bilgisi isteğin sonuçlarını indirmek için URL'yi içerir. Bu durum URI'sı aşağıdaki gibi görünür:
GET https://atlas.microsoft.com/route/matrix/{matrixId}?api-version=1.0?subscription-key={subscription-key}
- İstemci, sonuçları indirmek için 3. Adımda alınan indirme URL'sinde bir GET isteği gönderir
Eşitleme Sonuçlarını İndir
Route Matrix Sync API'sine post isteği gönderdiğinizde, hizmet başarılı istek için 200 yanıt kodu ve bir yanıt dizisi döndürür. Yanıt gövdesi verileri içerir ve sonuçları daha sonra alma imkanı olmayacaktır.
Zaman Uyumsuz Sonuçları İndir
bir istek yanıt 202 Accepted
verdiği zaman, istek zaman uyumsuz işlem hattımız kullanılarak işlenir. Yanıtın konum üst bilgisinde zaman uyumsuz isteğinizin ilerleme durumunu denetlemek için size bir URL verilir. Bu durum URI'sı aşağıdaki gibi görünür:
GET https://atlas.microsoft.com/route/matrix/{matrixId}?api-version=1.0?subscription-key={subscription-key}
Konum üst bilgisi tarafından sağlanan URL, bir GET
istek verildiğinde aşağıdaki yanıtları döndürür.
HTTP
202 Accepted
- Matris isteği kabul edildi ancak hala işleniyor. Lütfen bir süre sonra yeniden deneyin.
HTTP
200 OK
- Matris isteği başarıyla işlendi. Yanıt gövdesi tüm sonuçları içerir.
POST https://atlas.microsoft.com/route/matrix/json?api-version=1.0
POST https://atlas.microsoft.com/route/matrix/json?api-version=1.0&waitForResults={waitForResults}&computeTravelTimeFor={computeTravelTimeFor}§ionType={sectionType}&arriveAt={arriveAt}&departAt={departAt}&vehicleAxleWeight={vehicleAxleWeight}&vehicleLength={vehicleLength}&vehicleHeight={vehicleHeight}&vehicleWidth={vehicleWidth}&vehicleMaxSpeed={vehicleMaxSpeed}&vehicleWeight={vehicleWeight}&windingness={windingness}&hilliness={hilliness}&travelMode={travelMode}&avoid={avoid}&traffic={traffic}&routeType={routeType}&vehicleLoadType={vehicleLoadType}
URI Parametreleri
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
format
|
path | True |
Yanıtın istenen biçimi. Yalnızca |
|
api-version
|
query | True |
string |
Azure Haritalar API'sinin sürüm numarası. |
arrive
|
query |
string date-time |
İsteğe bağlı saat dilimi uzaklığı ile RFC 3339, bölüm 5.6'da tanımlandığı gibi bir Örnekler:
|
|
avoid
|
query |
Yol hesaplamasının yolu belirlerken kaçınmaya çalışması gereken bir şeyi belirtir. Bir istekte birden çok kez belirtilebilir, örneğin, '&avoid=otoyollar&avoid=tollRoads&avoid=ferries'. Yol Aralığı isteklerinde zatenUsedRoads değeri kullanılmamalıdır. |
||
compute
|
query |
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. |
||
depart
|
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
Örnekler:
|
|
hilliness
|
query |
Heyecan verici rota için tepelik derecesi. Bu parametre yalnızca =heyecan verici ile |
||
route
|
query |
İstenen yol türü. |
||
section
|
query |
Yol yanıtında hangi bölüm türlerinin bildirilmiş olduğunu belirtir. |
||
traffic
|
query |
boolean |
Olası değerler:
|
|
travel
|
query |
İstenen rota için seyahat modu. Tanımlanmamışsa, varsayılan değer 'araba'dır. İstenen travelMode öğesinin tüm rota için kullanılamayabileceğini unutmayın. İstenen travelMode belirli bir bölüm için kullanılamıyorsa, bu bölüm için yanıtın travelMode öğesi "diğer" olur. Seyahat modlarının veri yolu, motosiklet, taksi ve van BETA işlevi olduğunu unutmayın. Tüm alanlarda tam kısıtlama verileri kullanılamaz. |
||
vehicle
|
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. |
|
vehicle
|
query |
number double |
Aracın metre cinsinden yüksekliği. 0 değeri, yükseklik kısıtlamalarının dikkate alınmadığı anlamına gelir. |
|
vehicle
|
query |
number double |
Aracın metre cinsinden uzunluğu. 0 değeri, uzunluk kısıtlamalarının dikkate alınmadığı anlamına gelir. |
|
vehicle
|
query |
Tehlikeli madde olarak sınıflandırılabilecek ve bazı yollardan kısıtlanmış kargo türleri. Kullanılabilir vehicleLoadType değerleri, 1 ile 9 arasında ABD Hazmat sınıflarının yanı sıra diğer ülkelerde/bölgelerde kullanılmak üzere genel sınıflandırmalardır. USHazmat ile başlayan değerler ABD yönlendirme içindir, diğer Tüm ülkeler/bölgeler için ise diğerHazmat kullanılmalıdır. vehicleLoadType birden çok kez belirtilebilir. Bu parametre şu anda yalnızca travelMode=truck için kabul edilmektedir. |
||
vehicle
|
query |
integer |
Aracın km/saat maksimum hızı. Araç profilindeki maksimum hız, otoyollarda bir araca izin verilip verilmediğini kontrol etmek için kullanılır.
|
|
vehicle
|
query |
integer |
Aracın ağırlığı kilogram olarak. |
|
vehicle
|
query |
number double |
Aracın metre cinsinden genişliği. 0 değeri, genişlik kısıtlamalarının dikkate alınmadığı anlamına gelir. |
|
wait
|
query |
boolean |
İsteğin zaman uyumlu olarak yürütülip yürütülmeyeceğini belirten Boole değeri. true olarak ayarlanırsa, istek 120 saniyenin altında biterse kullanıcı 200 yanıt alır. Aksi takdirde, kullanıcı hemen bir 202 yanıtı alır. 202 yanıtıyla ilgili diğer ayrıntılar için lütfen API açıklamasına bakın. Yalnızca zaman uyumsuz istek için desteklenir. |
|
windingness
|
query |
Heyecan verici rota için dönüş seviyesi. Bu parametre yalnızca =heyecan verici ile |
İstek Başlığı
Name | Gerekli | Tür | Description |
---|---|---|---|
x-ms-client-id |
string |
Microsoft Entra ID güvenlik modeliyle birlikte hangi hesabın kullanıma yönelik olduğunu belirtir. Azure Haritalar hesabı için benzersiz bir kimliği temsil eder ve Azure Haritalar yönetim düzlemi Hesap API'sinden alınabilir. Azure Haritalar'da Microsoft Entra ID güvenliğini kullanmak için rehberlik için aşağıdaki makalelere bakın. |
İstek Gövdesi
Name | Tür | Description |
---|---|---|
destinations |
Geçerli |
|
origins |
Geçerli |
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK |
Matris isteği başarıyla işlendi. Yanıt gövdesi tüm sonuçları içerir. |
|
202 Accepted |
Yalnızca zaman uyumsuz istek için desteklenir. İstek Kabul Edildi: İstek işlenmek üzere kabul edildi. Sonuçları yeniden denemek veya sonuçlara erişmek için lütfen Konum Üst Bilgisindeki URL'yi kullanın. Üst Bilgiler Location: string |
|
Other Status Codes |
Beklenmeyen bir hata oluştu. |
Güvenlik
AADToken
Bunlar Microsoft Entra OAuth 2.0 Akışlarıdır. Azure rol tabanlı erişim 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-id
gerektirir. 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.
- 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 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 submit a route matrix request
Örnek isteği
POST https://atlas.microsoft.com/route/matrix/json?api-version=1.0&routeType=shortest
{
"origins": {
"type": "MultiPoint",
"coordinates": [
[
4.85106,
52.36006
],
[
4.85056,
52.36187
]
]
},
"destinations": {
"type": "MultiPoint",
"coordinates": [
[
4.85003,
52.36241
],
[
13.42937,
52.50931
]
]
}
}
Örnek yanıt
{
"formatVersion": "0.0.1",
"matrix": [
[
{
"statusCode": 200,
"response": {
"routeSummary": {
"lengthInMeters": 495,
"travelTimeInSeconds": 134,
"trafficDelayInSeconds": 0,
"departureTime": "2018-07-27T22:55:29+00:00",
"arrivalTime": "2018-07-27T22:57:43+00:00"
}
}
},
{
"statusCode": 200,
"response": {
"routeSummary": {
"lengthInMeters": 647651,
"travelTimeInSeconds": 26835,
"trafficDelayInSeconds": 489,
"departureTime": "2018-07-27T22:55:29+00:00",
"arrivalTime": "2018-07-28T06:22:44+00:00"
}
}
}
],
[
{
"statusCode": 200,
"response": {
"routeSummary": {
"lengthInMeters": 338,
"travelTimeInSeconds": 104,
"trafficDelayInSeconds": 0,
"departureTime": "2018-07-27T22:55:29+00:00",
"arrivalTime": "2018-07-27T22:57:13+00:00"
}
}
},
{
"statusCode": 200,
"response": {
"routeSummary": {
"lengthInMeters": 647494,
"travelTimeInSeconds": 26763,
"trafficDelayInSeconds": 469,
"departureTime": "2018-07-27T22:55:29+00:00",
"arrivalTime": "2018-07-28T06:21:32+00:00"
}
}
}
]
],
"summary": {
"successfulRoutes": 4,
"totalRoutes": 4
}
}
operation-Location: New URL to check the status of the long-running operation.
Tanımlar
Name | Description |
---|---|
Compute |
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. |
Error |
Kaynak yönetimi hatası ek bilgileri. |
Error |
Hata ayrıntısı. |
Error |
Hata yanıtı |
Geo |
Geçerli |
Incline |
Heyecan verici rota için tepelik derecesi. Bu parametre yalnızca =thrilling ile |
Json |
Yanıtın istenen biçimi. Yalnızca |
Route |
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. |
Route |
Yol bölümü için özet nesnesi. |
Route |
Matris sonuç nesnesi |
Route |
Koordinat matrisi olan bir nesne. |
Route |
Bu nesne başarılı bir Yol Matrisi çağrısından döndürülür. Örneğin, 2 çıkış noktası ve 3 hedef sağlanmışsa, her birinde 3 öğe bulunan 2 dizi vardır. Her öğenin içeriği sorguda sağlanan seçeneklere bağlıdır. |
Route |
Giriş matrisindeki geçerli hücrenin yanıt nesnesi. |
Route |
Özet nesnesi |
Route |
İstenen yol türü. |
Section |
Yol yanıtında hangi bölüm türlerinin bildirilmiş olduğunu belirtir. |
Travel |
İstenen rota için seyahat modu. Tanımlanmamışsa, varsayılan değer 'araba'dır. İstenen travelMode öğesinin tüm rota için kullanılamayabileceğini unutmayın. İstenen travelMode belirli bir bölü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. |
Vehicle |
Tehlikeli madde olarak sınıflandırılabilecek ve bazı yollardan kısıtlanmış kargo türleri. Kullanılabilir vehicleLoadType değerleri, 1 ile 9 arasında ABD Hazmat sınıflarının yanı sıra diğer ülkelerde/bölgelerde kullanılmak üzere genel sınıflandırmalardır. USHazmat ile başlayan değerler ABD yönlendirme içindir, diğer Tüm ülkeler/bölgeler için diğerHazmat kullanılmalıdır. vehicleLoadType birden çok kez belirtilebilir. Bu parametre şu anda yalnızca travelMode=truck için kabul edilmektedir. |
Windingness |
Heyecan verici rota için dönüş seviyesi. Bu parametre yalnızca =thrilling ile |
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.
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. |
ErrorAdditionalInfo
Kaynak yönetimi hatası ek bilgileri.
Name | Tür | Description |
---|---|---|
info |
object |
Ek bilgiler. |
type |
string |
Ek bilgi türü. |
ErrorDetail
Hata ayrıntısı.
Name | Tür | Description |
---|---|---|
additionalInfo |
Hata ek bilgileri. |
|
code |
string |
Hata kodu. |
details |
Hata ayrıntıları. |
|
message |
string |
Hata iletisi. |
target |
string |
Hata hedefi. |
ErrorResponse
Hata yanıtı
Name | Tür | Description |
---|---|---|
error |
Hata nesnesi. |
GeoJsonMultiPoint
Geçerli GeoJSON MultiPoint
bir geometri türü. Ayrıntılar için lütfen RFC 7946'ya bakın.
Name | Tür | Description |
---|---|---|
coordinates |
number[] |
Geometrinin |
type |
string:
Multi |
|
InclineLevel
Heyecan verici rota için tepelik derecesi. Bu parametre yalnızca =thrilling ile routeType
birlikte kullanılabilir.
Name | Tür | Description |
---|---|---|
high |
string |
yüksek |
low |
string |
alçak |
normal |
string |
normal |
JsonFormat
Yanıtın istenen biçimi. Yalnızca json
biçim desteklenir.
Name | Tür | Description |
---|---|---|
json |
string |
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 |
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 |
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 |
Elektrikli Tüketim 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, geri kazanılmış elektrik enerjisini içerir ve bu nedenle negatif olabilir (bu da enerji kazanıldığına işaret eder). Hem maxChargeInkWh hem de currentChargeInkWh belirtilirse, pil şarj düzeyinin maxChargeInkWh değerini asla aşmadığından emin olmak için yeniden iyileşme sınırlanır. MaxChargeInkWh veya currentChargeInkWh belirtilmezse, tüketim hesaplamasında kısıtlanmamış geri alma varsayılır. |
departureTime |
string |
Rota veya bacak için tahmini kalkış saati. Saat UTC 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 |
Trafik koşullarından (ör. tıkanıklık) dolayı rotada gecikme yaşanmaz gibi hesaplanan tahmini seyahat süresi. 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ı türlerdeki trafik bilgilerini 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. |
RouteMatrix
Matris sonuç nesnesi
Name | Tür | Description |
---|---|---|
response |
Giriş matrisindeki geçerli hücrenin yanıt nesnesi. |
|
statusCode |
integer |
Giriş matrisindeki geçerli hücre için StatusCode özelliği. |
RouteMatrixQuery
Koordinat matrisi olan bir nesne.
Name | Tür | Description |
---|---|---|
destinations |
Geçerli |
|
origins |
Geçerli |
RouteMatrixResult
Bu nesne başarılı bir Yol Matrisi çağrısından döndürülür. Örneğin, 2 çıkış noktası ve 3 hedef sağlanmışsa, her birinde 3 öğe bulunan 2 dizi vardır. Her öğenin içeriği sorguda sağlanan seçeneklere bağlıdır.
Name | Tür | Description |
---|---|---|
formatVersion |
string |
Format Version özelliği |
matrix |
2 boyutlu yol özetleri dizisi olarak sonuç verir. |
|
summary |
Özet nesnesi |
RouteMatrixResultResponse
Giriş matrisindeki geçerli hücrenin yanıt nesnesi.
Name | Tür | Description |
---|---|---|
routeSummary |
Yol bölümü için özet nesnesi. |
RouteMatrixSummary
Özet nesnesi
Name | Tür | Description |
---|---|---|
successfulRoutes |
integer |
Yanıttaki başarılı yolların sayısı. |
totalRoutes |
integer |
İstenen toplam yol sayısı. Giriş matrisindeki hücre sayısı. |
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 |
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
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 |
Yolun ücretli bir vignette bulunmasını gerektiren bölümleri. |
traffic |
string |
Yolun trafik bilgilerini içeren bölümleri. |
travelMode |
string |
İstek parametresiyle |
tunnel |
string |
Yolun tünel olan bölümleri. |
urban |
string |
Yolun kentsel alanlar içinde yer alan bölümleri. |
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 |
---|---|---|
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. |
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. |
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 routeType
birlikte kullanılabilir.
Name | Tür | Description |
---|---|---|
high |
string |
yüksek |
low |
string |
alçak |
normal |
string |
normal |