Route - Post Route Directions Batch Sync

Hizmet:
Maps
API Sürümü:
1.0

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

Uyarı

Azure Haritalar Route v1 hizmetinin kullanımdan kaldırılması

Azure Haritalar Route v1 hizmeti artık kullanım dışıdır ve 31.03.28 tarihinde kullanımdan kaldırılacaktır. Hizmet kesintilerini önlemek için Route v1 hizmetine yapılan tüm çağrıların 31.03.28'e kadar Route v2025-01-01 kullanacak şekilde güncelleştirilmesi gerekir. Daha fazla bilgi için bkz. Azure Haritalar Yol 1.0 API'lerini geçirme.

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

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

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 zaman aşımı hatası (408 yanıtı) döndürür. Toplu iş öğelerinin sayısı, bu API için 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}

Batch 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şin işlenmesi tamamlandıysa, yanıt gövdesi toplu iş yanıtını içerir. Bu toplu iş yanıtı, özgün toplu iş isteğinin parçası olan summary ve başarıyla yürütülen sorgular totalRequestsgösteren bir successfulRequests bileşeni içerir. Toplu yanıt, toplu iş isteğindeki her sorgu için bir yanıt içeren bir batchItems dizisi de içerir. batchItems, sonuçları özgün sorguların toplu iş isteğinde gönderildiği sırayla içerir. batchItems'deki her öğe statusCode ve response alanları içerir. response'daki her batchItems 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 bir message içerir.

Aşağıda 1 başarılı ve 1 başarısız sonucu içeren örnek bir Toplu 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çimi 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

Microsoft Entra ID güvenlik modeliyle kullanılması amaçlanan hesabı belirtir. Azure Haritalar hesabı için bu benzersiz kimlik, Azure Haritalar yönetim düzlemi Hesap API'sinden elde edilebilir. Azure Haritalar'da Microsoft Entra ID güvenliğini kullanma hakkında daha fazla bilgi için bkz.

İstek Gövdesi

Name Tür Description
batchItems

BatchRequestItem[]

İşlenmek üzere sorgu listesi.

Yanıtlar

Name Tür Description
200 OK

RouteDirectionsBatchResult

Tamam
Other Status Codes

ErrorResponse

Zaman aşımı: İsteğin bitme süresi, API'de tanımlanan maksimum 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ının . 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ş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çinkimlik 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

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üzlemi yapılandırılır. * Azure Haritalar Web SDK 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 Azure Haritalar hesabı oluşturma 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 Azure Haritalar REST API'lerine erişmek için gizli istemci uygulamaları yaklaşımını kullanmanızı ö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ğı 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ölgelere ayrıntılı denetim ile erişim yetkisine sahiptir. 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, Eşleme hesabı kaynağında izin verilen kaynakların belirli bir listesini yapılandırmayı işleme kötüye kullanımını sınırlamak ve SAS Belirtecini düzenli olarak yenilemektir.

Tür: apiKey
İçinde: header

Örnekler

Successfully retrieve the route direction batch result synchronously

Örnek isteği

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

Örnek yanıt

Durum kodu:
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
  }
}
Durum kodu:
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 isteği nesnesi
DelayMagnitude

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

Manevra noktasında sola ve sağ tarafa doğru sürüşü gösterir.
EffectiveSetting

Bu Rota 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çimi desteklenir.
JunctionType

Manevranın gerçekleştiği kavşağın türü. Daha büyük kavşaklar için, yuvarlak kavşak girmek ve çı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 halde ErrorResponse.
ResponseSectionType

Bildirilen yol yanıtının bölüm türleri
ResponseTravelMode

Hesaplanan rota için seyahat modu. bu bölümde istenen aktarım modu mümkün değilse değer other olarak ayarlanır
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

Rehberlikle ilgili öğeleri içerir. Bu alan yalnızca rehberlik istendiğinde ve kullanılabilir olduğunda bulunur.
RouteInstruction

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

Birbiriyle ilişkili yönerge öğelerinin bir dizisini gruplandırır. Sıra aralığı firstInstructionIndex ve lastInstructionIndex ile kısıtlanır. İnsan tarafından okunabilen metin iletileri yönergeler için istendiğinde (instructionType=text veya etiketli), varsa instructionGroup'ta bir özet iletisi döndürülür.
RouteLeg

Bir nokta listesinden oluşan bir rota parçası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ı raporlar.
RouteSection

Rota bölümleri, bir yolun parçaları hakkında ek bilgiler içerir. Her bölüm, startPointIndex, endPointIndexve sectionTypeöğelerini iç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. Simgeografiyi 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 iş isteğinin sonuçlarının özeti

BatchRequest

Object

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

Name Tür Description
batchItems

BatchRequestItem[]

İşlenmek üzere sorgu listesi.

BatchRequestItem

Object

Batch isteği 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

Listeleme

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

Değer Description
0

Bilinmeyen.
1

Küçük.
2

Ilımlı.
3

Binbaşı.
4

Tanımsız, yol kapatmalar ve diğer süresiz gecikmeler için kullanılır.

DrivingSide

Listeleme

Manevra noktasında sola ve sağ tarafa doğru sürüşü gösterir.

Değer Description
LEFT

Sol taraf.
RIGHT

Sağ tarafa.

EffectiveSetting

Object

Bu Rota 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

Object

Kaynak yönetimi hatası ek bilgileri.

Name Tür Description
info

object

Ek bilgiler.
type

string

Ek bilgi türü.

ErrorDetail

Object

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

Object

Hata yanıtı

Name Tür Description
error

ErrorDetail

Hata nesnesi.

GuidanceInstructionType

Listeleme

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

Değer Description
TURN

Dönmek.
ROAD_CHANGE

Yol Değişikliği.
LOCATION_DEPARTURE

Kalkış konumu.
LOCATION_ARRIVAL

Varış konumu.
DIRECTION_INFO

Yön bilgileri.
LOCATION_WAYPOINT

Yol noktası konumu.

GuidanceManeuver

Listeleme

Manevrayı tanımlayan bir kod.

Değer Description
ARRIVE

Geldiniz.
ARRIVE_LEFT

Geldiniz. Hedefiniz sol tarafta.
ARRIVE_RIGHT

Geldiniz. Hedefiniz sağ tarafta.
DEPART

Ayrılmak.
STRAIGHT

Dümdüz devam edin.
KEEP_RIGHT

Sağa doğru devam edin.
BEAR_RIGHT

Ayı sağ.
TURN_RIGHT

Sağa dön.
SHARP_RIGHT

Sağa doğru keskin dön.
KEEP_LEFT

Sola doğru devam edin.
BEAR_LEFT

Ayı gitti.
TURN_LEFT

Sola dönün.
SHARP_LEFT

Keskin sola dön.
MAKE_UTURN

U dönüşü yapın.
ENTER_MOTORWAY

Otoyola çık.
ENTER_FREEWAY

Otobana bin.
ENTER_HIGHWAY

Otobana bin.
TAKE_EXIT

Çıkışa geçin.
MOTORWAY_EXIT_LEFT

Sol çıkışa geçin.
MOTORWAY_EXIT_RIGHT

Doğru çıkışa çık.
TAKE_FERRY

Feribota bin.
ROUNDABOUT_CROSS

Kavşağa geç.
ROUNDABOUT_RIGHT

Kavşakta sağ taraftaki çıkışa doğru inin.
ROUNDABOUT_LEFT

Kavşakta soldan çıkışa geçin.
ROUNDABOUT_BACK

Kavşak etrafından dolaş.
TRY_MAKE_UTURN

U dönüşü yapmayı deneyin.
FOLLOW

Takip etmek.
SWITCH_PARALLEL_ROAD

Paralel yola geçin.
SWITCH_MAIN_ROAD

Ana yola geç.
ENTRANCE_RAMP

Rampadan çıkın.
WAYPOINT_LEFT

Yol noktasına ulaştınız. Sol tarafta.
WAYPOINT_RIGHT

Yol noktasına ulaştınız. Sağ tarafta.
WAYPOINT_REACHED

Yol noktasına ulaştınız.

JsonFormat

Listeleme

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

Değer Description
json

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

JunctionType

Listeleme

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

Değer Description
REGULAR

düzenli
ROUNDABOUT

atlıkarınca
BIFURCATION

Çatallanma

LatLongPair

Object

Enlem ve boylam olarak temsil edilen konum.

Name Tür Description
latitude

number (double)

Latitude özelliği
longitude

number (double)

Longitude özelliği

Response

Object

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

Name Tür Description
error

ErrorDetail

Hata nesnesi.
formatVersion

string

Biçim Sürümü özelliği
optimizedWaypoints

RouteOptimizedWaypoint[]

Yol noktalarının iyileştirilmiş sırası. Ö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ü, birinci" olur.
report

RouteReport

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

Route[]

Rotalar dizisi

ResponseSectionType

Listeleme

Bildirilen yol yanıtının bölüm türleri

Değer Description
CAR_TRAIN

Rotanın arabalar veya trenler olan bölümleri.
COUNTRY

Rotanın hangi ülkelerde/bölgelerde olduğunu gösteren bölümler.
FERRY

Rotanın feribot olan bölümleri.
MOTORWAY

Yolun otoyollar olan bölümleri.
PEDESTRIAN

Rotanın yalnızca yayalar için uygun bölümleri.
TOLL_ROAD

Ücretin ödenmesini gerektiren rota bölümleri.
TOLL_VIGNETTE

Rotanın ücretli bir vinyet gerektiren bölümleri.
TRAFFIC

Yolun trafik bilgilerini içeren bölümleri.
TRAVEL_MODE

travelModeistek parametresiyle ilgili bölümler.
TUNNEL

Yolun tünel olan bölümleri.
CARPOOL

Yolun, araç havuzu (HOV/Yüksek Dolu Araç) şeritlerinin kullanılmasını gerektiren bölümleri.
URBAN

Kentsel alanların içinde yer alan rotanın bölümleri.

ResponseTravelMode

Listeleme

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

Değer Description
car

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

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

Döndürülen rotalar taksiler için iyileştirilmiştir. BETA işlevselliği.
bus

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şlevselliği.
van

Döndürülen yollar minibüsler için iyileştirilmiştir. BETA işlevselliği.
motorcycle

Döndürülen rotalar motosikletler için optimize edilmiştir. BETA işlevselliği.
bicycle

Döndürülen rotalar, bisiklet şeritlerinin kullanımı dahil olmak üzere bisikletler için optimize edilmiştir.
pedestrian

Geri dönen yollar, kaldırım kullanımı dahil olmak üzere yayalar için optimize edilmiştir.
other

Bu bölümde verilen taşıma modu mümkün değildir

Route

Object
Name Tür Description
guidance

RouteGuidance

Rehberlikle ilgili öğeleri içerir. Bu alan yalnızca rehberlik istendiğinde ve kullanılabilir olduğunda bulunur.
legs

RouteLeg[]

Bacaklar dizisi
sections

RouteSection[]

Sections dizisi
summary

RouteSummary

Özet nesnesi

RouteDirectionsBatchItem

Object

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 halde ErrorResponse.
statusCode

integer

HTTP isteği durum kodu.

RouteDirectionsBatchResult

Object

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 iş isteğinin sonuçlarının özeti

RouteGuidance

Object

Rehberlikle ilgili öğeleri içerir. Bu alan yalnızca rehberlik istendiğinde ve kullanılabilir olduğunda bulunur.

Name Tür Description
instructionGroups

RouteInstructionGroup[]

Birbiriyle ilişkili yönerge öğelerinin bir dizisini gruplandırır.
instructions

RouteInstruction[]

Manevraları açıklayan yönergelerin listesi.

RouteInstruction

Object

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

Name Tür Description
combinedMessage

string

Manevra için insan tarafından okunabilen bir ileti, sonraki yönergedeki mesajla birleştirildi. Bazen birbirini izleyen iki yönergeyi tek bir yönergede birleştirmek mümkündür ve bu da izlemeyi kolaylaştırır. Bu durumda, olasıCombineWithNext bayrağı true olur. Örneğin:

10. Turn left onto Einsteinweg/A10/E22 towards Ring Amsterdam
11. Follow Einsteinweg/A10/E22 towards Ring Amsterdam

Yönerge 10'da possibleCombineWithNext bayrağı true. Bu, kodlanmış kılavuzun istemcilerine yönerge 11 ile birleştirilebileceğini gösterir. yönergeler, insan 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 sola ve sağ tarafa doğru sürüşü gösterir.
exitNumber

string

Geçerli manevra tarafından alınan bir otoyol çıkışının sayıları. Bir çıkışta 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, yuvarlak 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 okunabilir 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 numarası(lar). Örnek: ["E34", "N205"]
roundaboutExitNumber

integer (int64)

Bu, bir 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

Bir işaret direğindeki, manevrayla veya takip edilmesi gereken yönde en ilgili olan metin.
stateCode

string

Bir ISO 3166-2 kodunun ikinci bölümüyle temsil edilen ülkenin alt bölümü (örneğin, eyalet). Bu yalnızca ABD, Kanada ve Meksika gibi bazı ülkelerde/bölgelerde kullanılabilir.
street

string

Manevradan sonraki bir sonraki önemli yol segmentinin veya izlenmesi gereken caddenin sokak adı.
travelTimeInSeconds

integer

RouteOffsetInMeters'e karşılık gelen noktaya kadar olan tahmini seyahat süresi.
turnAngleInDecimalDegrees

integer

Yönergenin yönünü gösterir. junctionType bir dönüş yönergesi gösteriyorsa:

  • 180 = U dönüşü
  • [-179, -1] = Sol dönüş
  • 0 = Düz açık ('0 derece' dönüş)
  • [1, 179] = Sağ dönüş

junctionType bir çarpım yönergesi gösteriyorsa:

  • <0 - sola tut
  • >0 - sağa doğru tut

RouteInstructionGroup

Object

Birbiriyle ilişkili yönerge öğelerinin bir dizisini gruplandırır. Sıra aralığı firstInstructionIndex ve lastInstructionIndex ile kısıtlanır. İnsan tarafından okunabilen metin iletileri yönergeler için istendiğinde (instructionType=text veya etiketli), varsa instructionGroup'ta bir özet iletisi döndürülür.

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 yönergeler için istendiğinde (instructionType=text veya etiketli) özet ileti.
lastInstructionIndex

integer

Yönergelerdeki ve bu gruba ait olan son yönergenin dizini.

RouteLeg

Object

Bir nokta listesinden oluşan bir rota parçası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

Object

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

Name Tür Description
arrivalTime

string (date-time)

Rota veya bacak için tahmini varış zamanı. Saat UTC olarak ayarlanır.
batteryConsumptionInkWh

number (double)

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. PilConsumptionInkWh değeri geri kazanılmış 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 yeniden iyileşme eşlenir. MaxChargeInkWh veya currentChargeInkWh belirtilmezse, tüketim hesaplamasında kısıtlanmamış geri alma varsayılır.
departureTime

string (date-time)

Rota veya bacak için tahmini kalkış saati. Saat UTC olarak ayarlanır.
fuelConsumptionInLiters

number (double)

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

integer

Tahmini seyahat süresi, trafik koşullarından (örn. tıkanıklık) dolayı rotada gecikme yaşanmaz gibi hesaplanır. Yalnızca computeTravelTimeFor = tümü sorguda kullanılıyorsa eklenir.
trafficDelayInSeconds

integer

Trafik bilgilerine göre gerçek zamanlı olayların neden olduğu saniye cinsinden tahmini gecikme. Gelecekte kalkış saati ile 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ğinde bile unutmayın. DepartAt gelecekteyse, seyahat süresi zamana bağlı geçmiş trafik verileri kullanılarak hesaplanır.

RouteOptimizedWaypoint

Object

İ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

Object

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

Name Tür Description
effectiveSettings

EffectiveSetting[]

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

RouteSection

Object

Rota bölümleri, bir yolun parçaları hakkında ek bilgiler içerir. Her bölüm, startPointIndex, endPointIndexve sectionTypeöğelerini içerir.

Name Tür Description
delayInSeconds

integer

Olayın neden olduğu saniyeler içinde gecikme.
effectiveSpeedInKmh

integer

Olayın km/s cinsinden etkin hızı, uzunluğunun tamamı boyunca ortalamadı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ı API'sini almayanı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ındaki 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. bu bölümde istenen aktarım modu mümkün değilse değer other olarak ayarlanır

RouteSectionTec

Object

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

Object

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

Name Tür Description
mainCauseCode

integer

Trafik olayının temel 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

Object

Özet nesnesi

Name Tür Description
arrivalTime

string (date-time)

Rota veya bacak için tahmini varış zamanı. Saat UTC olarak ayarlanır.
departureTime

string (date-time)

Rota veya bacak için tahmini kalkış saati. Saat UTC olarak ayarlanı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ış saati ile 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ğinde bile unutmayın. DepartAt gelecekteyse, seyahat süresi zamana bağlı geçmiş trafik verileri kullanılarak hesaplanır.

SimpleCategory

Listeleme

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.

Değer Description
JAM

Trafik sıkışıklığı.
ROAD_WORK

Yol çalışması.
ROAD_CLOSURE

Yol kapatma.
OTHER

Diğer.

Summary

Object

Toplu iş isteğinin sonuçlarının özeti

Name Tür Description
successfulRequests

integer

Toplu işlemdeki başarılı isteklerin sayısı
totalRequests

integer

Toplu işlemdeki toplam istek sayısı