Route - Post Route Directions Batch Sync

Service:

Maps

API Version:

1.0

Tek bir zaman uyumlu istekte Yol Tarifleri Alma API'sine bir grup sorgu göndermek için kullanın.

Post Route Directions Batch Sync API, tek bir zaman uyumlu istek kullanarak Yol Tarifleri Alma API'sine toplu sorgular gönderen bir HTTP POST isteğidir. API'yi çağırarak Route Directions Batch zaman uyumsuz (zaman uyumsuz) veya zaman uyumlu (eşitleme) çalıştırabilirsiniz. Zaman uyumsuz API, çağıranın en fazla 700 sorguyu toplu olarak toplamasına ve API'yi 100 sorguya kadar eşitlemesine olanak tanır. API'yi Post Route Directions Batch zaman uyumsuz istekte çağırmak için bkz . Yol Tarifleri Sonrası Toplu İşlemi.

Zaman Uyumlu Toplu İş İsteği Gönder

Basit toplu istekler için Zaman Uyumlu API önerilir. Hizmet bir istek aldığında, toplu iş öğeleri hesaplanır hesaplanmaz yanıt verir ve sonuçları daha sonra alma imkanı olmaz. İstek 60 saniyeden uzun sürerse Zaman Uyumlu API bir zaman aşımı hatası (408 yanıtı) döndürür. Bu API için toplu iş öğelerinin sayısı 100 ile sınırlıdır.

POST https://atlas.microsoft.com/route/directions/batch/sync/json?api-version=1.0&subscription-key={subscription-key}

Toplu Yanıt Modeli

Döndürülen veri içeriği, zaman uyumsuz ve eşitleme istekleri için benzerdir. Zaman uyumsuz toplu iş isteğinin sonuçları indirilirken, toplu iş işleme tamamlandıysa yanıt gövdesi toplu iş yanıtını içerir. Bu toplu yanıt, özgün toplu iş isteğinin totalRequests parçası olan öğesini ve successfulRequestsörneğin başarıyla yürütülen sorguları gösteren bir summary bileşen içerir. Toplu yanıt, toplu iş isteğindeki her sorgu için bir yanıt içeren bir dizi de içerir batchItems . , batchItems sonuçları, özgün sorguların toplu iş isteğinde gönderildiği sırayla tam olarak aynı sırada içerir. içindeki batchItems her öğe ve response alanlarını içerirstatusCode. içindeki batchItems her response biri aşağıdaki türlerden biridir:

• RouteDirections - Sorgu başarıyla tamamlandıysa.

• Error - Sorgu başarısız olduysa. Yanıt, bu durumda bir code ve message içerir.

Aşağıda 1 başarılı ve 1 başarısız sonucu içeren örnek bir Batch Yanıtı verilmişti :

{
    "summary": {
        "successfulRequests": 1,
        "totalRequests": 2
    },
    "batchItems": [
        {
            "statusCode": 200,
            "response": {
                "routes": [
                    {
                        "summary": {
                            "lengthInMeters": 1758,
                            "travelTimeInSeconds": 387,
                            "trafficDelayInSeconds": 0,
                            "departureTime": "2018-07-17T00:49:56+00:00",
                            "arrivalTime": "2018-07-17T00:56:22+00:00"
                        },
                        "legs": [
                            {
                                "summary": {
                                    "lengthInMeters": 1758,
                                    "travelTimeInSeconds": 387,
                                    "trafficDelayInSeconds": 0,
                                    "departureTime": "2018-07-17T00:49:56+00:00",
                                    "arrivalTime": "2018-07-17T00:56:22+00:00"
                                },
                                "points": [
                                    {
                                        "latitude": 47.62094,
                                        "longitude": -122.34892
                                    },
                                    {
                                        "latitude": 47.62094,
                                        "longitude": -122.3485
                                    },
                                    {
                                        "latitude": 47.62095,
                                        "longitude": -122.3476
                                    }
                                ]
                            }
                        ],
                        "sections": [
                            {
                                "startPointIndex": 0,
                                "endPointIndex": 40,
                                "sectionType": "TRAVEL_MODE",
                                "travelMode": "bicycle"
                            }
                        ]
                    }
                ]
            }
        },
        {
            "statusCode": 400,
            "response":
            {
                "error":
                {
                    "code": "400 BadRequest",
                    "message": "Bad request: one or more parameters were incorrectly specified or are mutually exclusive."
                }
            }
        }
    ]
}

POST https://atlas.microsoft.com/route/directions/batch/sync/json?api-version=1.0

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

İ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
batchItems	BatchRequestItem[]	İşlenmek üzere sorguların listesi.

Yanıtlar

Name	Tür	Description
200 OK	RouteDirectionsBatchResult	Tamam
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 the route direction batch result synchronously

Sample Request

HTTP

POST https://atlas.microsoft.com/route/directions/batch/sync/json?api-version=1.0

{
  "batchItems": [
    {
      "query": "?query=47.639987,-122.128384:47.621252,-122.184408:47.596437,-122.332000&routeType=fastest&travelMode=car&maxAlternatives=99"
    },
    {
      "query": "?query=47.620659,-122.348934:47.610101,-122.342015&travelMode=bicycle&routeType=eco&traffic=false"
    },
    {
      "query": "?query=40.759856,-73.985108:40.771136,-73.973506&travelMode=pedestrian&routeType=shortest"
    }
  ]
}

Sample Response

Status code:

200

{
  "batchItems": [
    {
      "statusCode": 400,
      "response": {
        "error": {
          "code": "400 BadRequest",
          "message": "maxAlternatives parameter value should be between 0 and 5 inclusive"
        }
      }
    },
    {
      "statusCode": 200,
      "response": {
        "formatVersion": "0.0.12",
        "routes": [
          {
            "summary": {
              "lengthInMeters": 1754,
              "travelTimeInSeconds": 386,
              "trafficDelayInSeconds": 0,
              "departureTime": "2019-06-21T22:56:23+00:00",
              "arrivalTime": "2019-06-21T23:02:49+00:00"
            },
            "legs": [
              {
                "summary": {
                  "lengthInMeters": 1754,
                  "travelTimeInSeconds": 386,
                  "trafficDelayInSeconds": 0,
                  "departureTime": "2019-06-21T22:56:23+00:00",
                  "arrivalTime": "2019-06-21T23:02:49+00:00"
                },
                "points": [
                  {
                    "latitude": 47.62094,
                    "longitude": -122.34892
                  },
                  {
                    "latitude": 47.62094,
                    "longitude": -122.3485
                  },
                  {
                    "latitude": 47.62095,
                    "longitude": -122.3476
                  },
                  {
                    "latitude": 47.60995,
                    "longitude": -122.34174
                  },
                  {
                    "latitude": 47.61011,
                    "longitude": -122.342
                  }
                ]
              }
            ],
            "sections": [
              {
                "startPointIndex": 0,
                "endPointIndex": 44,
                "sectionType": "TRAVEL_MODE",
                "travelMode": "bicycle"
              }
            ]
          }
        ]
      }
    },
    {
      "statusCode": 200,
      "response": {
        "formatVersion": "0.0.12",
        "routes": [
          {
            "summary": {
              "lengthInMeters": 1772,
              "travelTimeInSeconds": 1276,
              "trafficDelayInSeconds": 0,
              "departureTime": "2019-06-21T22:56:23+00:00",
              "arrivalTime": "2019-06-21T23:17:38+00:00"
            },
            "legs": [
              {
                "summary": {
                  "lengthInMeters": 1772,
                  "travelTimeInSeconds": 1276,
                  "trafficDelayInSeconds": 0,
                  "departureTime": "2019-06-21T22:56:23+00:00",
                  "arrivalTime": "2019-06-21T23:17:38+00:00"
                },
                "points": [
                  {
                    "latitude": 40.75982,
                    "longitude": -73.98493
                  },
                  {
                    "latitude": 40.7601,
                    "longitude": -73.98483
                  },
                  {
                    "latitude": 40.75984,
                    "longitude": -73.98417
                  },
                  {
                    "latitude": 40.76047,
                    "longitude": -73.9837
                  },
                  {
                    "latitude": 40.77095,
                    "longitude": -73.9736
                  },
                  {
                    "latitude": 40.77114,
                    "longitude": -73.97356
                  }
                ]
              }
            ],
            "sections": [
              {
                "startPointIndex": 0,
                "endPointIndex": 47,
                "sectionType": "TRAVEL_MODE",
                "travelMode": "pedestrian"
              }
            ]
          }
        ]
      }
    }
  ],
  "summary": {
    "successfulRequests": 2,
    "totalRequests": 3
  }
}

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
BatchRequest	Bu tür, Batch hizmeti için istek gövdesini temsil eder.
BatchRequestItem	Batch istek nesnesi
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.
JsonFormat	Yanıtın istenen biçimi. Yalnızca json biçim desteklenir.
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.
Response	Sorgunun sonucu. Sorgu başarıyla tamamlandıysa RouteDirections, aksi takdirde ErrorResponse.
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ğeri olarak ayarlanır other
Route
RouteDirectionsBatchItem	Yol Tarifleri Batch hizmet çağrısından döndürülen bir öğe.
RouteDirectionsBatchResult	Bu nesne başarılı bir Yol Tarifleri Batch hizmet ç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	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.
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.
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.
RouteSectionTec	TPEG2-TEC standardındaki tanımları kullanarak trafik olayının ayrıntıları. effectCode içerebilir ve öğelere neden olabilir.
RouteSectionTecCause	Trafik olayının nedeni. mainCauseCode ve subCauseCode öğelerini içerebilir. Simge ve açıklamaları tanımlamak için kullanılabilir.
RouteSummary	Özet nesnesi
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.
Summary	Toplu istek sonuçlarının özeti

BatchRequest

Bu tür, Batch hizmeti için istek gövdesini temsil eder.

Name	Tür	Description
batchItems	BatchRequestItem[]	İşlenmek üzere sorguların listesi.

BatchRequestItem

Batch istek nesnesi

Name	Tür	Description
query	string	Bu parametre, yapılandırılmamış bir coğrafi kodlama işlemi gerçekleştirmek için kullanılan bir sorgu dizesi içerir. Sorgu dizesi, işlenmek üzere arama API'sine ayrıntılı olarak geçirilir.

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 kapatmalar ve diğer süresiz 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.

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

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	Boylam özelliği

Response

Sorgunun sonucu. Sorgu başarıyla tamamlandıysa RouteDirections, aksi takdirde ErrorResponse.

Name	Tür	Description
error	ErrorDetail	Hata nesnesi.
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

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	Rotanın ücretli bir vignette bulunmasını gerektiren bölümleri.
TRAFFIC	string	Yolun trafik bilgilerini içeren bölümleri.
TRAVEL_MODE	string	İstek parametresiyle travelModeilgili bölümler.
TUNNEL	string	Yolun tünel olan bölümleri.
URBAN	string	Yolun kentsel alanlarda bulunan bölümleri.

ResponseTravelMode

Hesaplanan rota için seyahat modu. İstenen aktarım modu bu bölümde mümkün değilse değeri 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 ş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.
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ş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.

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

RouteDirectionsBatchItem

Yol Tarifleri Batch hizmet çağrısından döndürülen bir öğe.

Name	Tür	Description
response	Response	Sorgunun sonucu. Sorgu başarıyla tamamlandıysa RouteDirections, aksi takdirde ErrorResponse.
statusCode	integer	HTTP isteği durum kodu.

RouteDirectionsBatchResult

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

Name	Tür	Description
batchItems	RouteDirectionsBatchItem[]	Toplu iş sonuçlarını içeren dizi.
summary	Summary	Toplu istek sonuçlarının özeti

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

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 taraftakiyle sağ taraftakinin sürüşünün karşılaştırmasını 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 çı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 numaraları... Örnek: ["E34", "N205"]
roundaboutExitNumber	string	Bu, döner kavşakta hangi çıkışın alınacak olduğunu gösterir.
routeOffsetInMeters	integer	Yolun başlangıcından yönerge noktasına olan uzaklık.
signpostText	string	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 bir alt bölümü (ör. eyalet). Bu yalnızca ABD, Kanada ve Meksika gibi bazı ülkelerde/bölgelerde kullanılabilir.
street	string	Manevradan sonraki bir sonraki önemli yol kesiminin veya izlenmesi gereken caddenin sokak adı.
travelTimeInSeconds	integer	routeOffsetInMeters'a 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ğa dönüş junctionType bir kaynak doğrulama yönergesi gösteriyorsa: <0 - sola tutun >0 - sağa doğru 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.

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

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ındaki tanımları kullanarak trafik olayının ayrıntıları. effectCode içerebilir ve öğelere neden olabilir.

Name	Tür	Description
causes	RouteSectionTecCause[]	Diziye neden olur
effectCode	integer	Trafik akışı üzerindeki etkisi. TPEG2-TEC standardında tanımlandığı gibi tec001:EffectCode tablosunda bir değer içerir. Trafik olaylarını önem derecesine göre renklendirmek için kullanılabilir.

RouteSectionTecCause

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.

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	Yolun kapanması.
ROAD_WORK	string	Yol çalışması.

Summary

Toplu istek sonuçlarının özeti

Name	Tür	Description
successfulRequests	integer	Toplu işlemdeki başarılı istek sayısı
totalRequests	integer	Toplu işlemdeki toplam istek sayısı