Route - Post Route Matrix Sync

Başvuru

Service:: Maps

API Version:: 1.0

Zaman uyumlu bir istek kullanarak çıkış noktaları ve hedefler listesindeki tüm olası çiftlerin seyahat süresini ve uzaklıklarını gösteren bir rota matrisi almak için kullanın.

Post Route Matrix Sync API, tek bir zaman uyumlu (eşitleme) isteği 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 uyumsuz (zaman uyumsuz) istekte bulunmak için bkz. Yol Sonrası Matris. Hizmet, verilen her kaynak için bu kaynaktan verilen her hedefe yönlendirme 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ücrenin kaynağından 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 Matris Yönlendirme API'sini çağırabilir.

Her rota için seyahat süreleri ve mesafeler döndürülür. Yol Tarifleri API'sini kullanarak hangi ayrıntılı yolların hesapleneceğini belirlemek için hesaplanan maliyetleri kullanabilirsiniz.

Zaman uyumsuz istek için matrisin 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 Yol 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 istek yapmak isteyebilirsiniz. Bu API için matrisin en büyük boyutu 100'dür (çıkış noktası 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 istek yaptığınızda, hizmet varsayılan olarak yanıt üst bilgisinin Konum alanında 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 bir Yönlendirme 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/sync/json?api-version=1.0

With optional parameters:

POST https://atlas.microsoft.com/route/matrix/sync/json?api-version=1.0&waitForResults={waitForResults}&computeTravelTimeFor={computeTravelTimeFor}&sectionType={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	JsonFormat	Yanıtın istenen biçimi. Yalnızca `json` biçim desteklenir.
api-version	query	True	string	Azure Haritalar API'sinin sürüm numarası.
arriveAt	query		string date-time	İsteğ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ş hedef noktaya varış tarihi ve saati. Bir saat dilimi uzaklığı belirtilmediğinde, hedef noktanınki gibi 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.
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.
computeTravelTimeFor	query		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.
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 `arriveAt`birlikte kullanılamaz.
hilliness	query		InclineLevel	Heyecan verici rota için tepelik derecesi. Bu parametre yalnızca =heyecan verici ile `routeType`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, araba 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.
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.
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.
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.
waitForResults	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		WindingnessLevel	Heyecan verici rota için dönüş seviyesi. Bu parametre yalnızca =heyecan verici 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.

İstek Gövdesi

Name	Tür	Description
destinations	GeoJsonMultiPoint	Geçerli `GeoJSON MultiPoint` bir geometri türü. Ayrıntılar için lütfen RFC 7946'ya bakın.
origins	GeoJsonMultiPoint	Geçerli `GeoJSON MultiPoint` bir geometri türü. Ayrıntılar için lütfen RFC 7946'ya bakın.

Yanıtlar

Name	Tür	Description
200 OK	RouteMatrixResult	Matris isteği başarıyla işlendi. Yanıt gövdesi tüm sonuçları içerir.
Other Status Codes	ErrorResponse	Zaman aşımı: İsteğin bitmek için api'de tanımlanan en uzun süre miktarından daha uzun sürdü.
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 matrix request result synchronously

Sample Request

HTTP

POST https://atlas.microsoft.com/route/matrix/sync/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
      ]
    ]
  }
}

Sample Response

Status code:: 200

{
  "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
  }
}

Status code:: 408

{
  "error": {
    "code": "408 Timeout",
    "message": "Timeout: The request took longer to finish than the maximum amount of time defined in the api."
  }
}

Tanımlar

Name	Description
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.
ErrorAdditionalInfo	Kaynak yönetimi hatası ek bilgileri.
ErrorDetail	Hata ayrıntısı.
ErrorResponse	Hata yanıtı
GeoJsonMultiPoint	Geçerli `GeoJSON MultiPoint` bir geometri türü. Ayrıntılar için lütfen RFC 7946'ya bakın.
InclineLevel	Heyecan verici rota için tepelik derecesi. Bu parametre yalnızca =thrilling ile `routeType`birlikte kullanılabilir.
JsonFormat	Yanıtın istenen biçimi. Yalnızca `json` biçim desteklenir.
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.
RouteLegSummary	Yol bölümü için özet nesnesi.
RouteMatrix	Matris sonuç nesnesi
RouteMatrixQuery	Koordinat matrisi olan bir nesne.
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.
RouteMatrixResultResponse	Giriş matrisindeki geçerli hücrenin yanıt nesnesi.
RouteMatrixSummary	Ö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 araç olarak ayarlanı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.
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 `routeType`birlikte kullanılabilir.

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	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.

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 `GeoJson MultiPoint` koordinatları.
type	string: MultiPoint	`GeoJSON` Türünü belirtir. Dokuz geçerli GeoJSON nesne türünden biri olmalıdır: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature ve FeatureCollection.

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	Düşük
normal	string	Normal

JsonFormat

Yanıtın istenen biçimi. Yalnızca json biçim desteklenir.

Name	Tür	Description
json	string	JavaScript Nesne Gösterimi Veri Değişim Biçimi

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 `routeType`birlikte 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

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.

RouteMatrix

Matris sonuç nesnesi

Name	Tür	Description
response	RouteMatrixResultResponse	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	GeoJsonMultiPoint	Geçerli `GeoJSON MultiPoint` bir geometri türü. Ayrıntılar için lütfen RFC 7946'ya bakın.
origins	GeoJsonMultiPoint	Geçerli `GeoJSON MultiPoint` bir geometri türü. Ayrıntılar için lütfen RFC 7946'ya bakın.

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	RouteMatrix[]	2 boyutlu yol özetleri dizisi olarak sonuç verir.
summary	RouteMatrixSummary	Özet nesnesi

RouteMatrixResultResponse

Giriş matrisindeki geçerli hücrenin yanıt nesnesi.

Name	Tür	Description
routeSummary	RouteLegSummary	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 `routeType`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 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 `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.

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 routeTypebirlikte kullanılabilir.

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