Route - Post Route Matrix

Hizmet:: Maps

API Sürümü:: 2025-01-01

Route Matrix API'si, bir eşitleme isteği kullanarak kaynak ve hedef konumlar tarafından tanımlanan bir rota kümesi için yol özetleri matrisinin hesaplanmasını sağlayan bir HTTP POST isteğidir. Hizmet, belirli 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. Rota Matrisleri sürüş, yürüyüş ve kamyon rotaları için hesaplanabilir. Örneğin, bir gıda teslim şirketinin 20 sürücüsü vardır ve teslimatı restorandan almak için en yakın sürücüyü bulması gerekir. Bu kullanım örneğini çözmek için Rota Matrisi API'sini çağırabilir ve sürücüleri restorandan gerçek seyahat mesafelerine veya zamanlarına göre sıralamak için seyahat maliyetini kullanabilirler.

Rota Matrisleri, en yaygın olarak Seyahat Eden Satışçı Sorunu (TSP) ve Araç Yönlendirme Sorunu'nun (VRP) çözülmesi için çeşitli farklı türlerde kullanılır. Matristeki her çıkış noktası-hedef çifti için seyahat süresi ve uzaklık döndürülür. Yol Tarifleri API'sini kullanarak hangi ayrıntılı yolların hesapleneceğini belirlemek için hesaplanan maliyetleri kullanabilirsiniz.

Eşitleme isteği matrisinin en büyük boyutu 2500 (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 en büyük boyutu 2500'den küçük veya buna eşitse, zaman uyumlu istekte bulunmak isteyebilirsiniz. Bu API için matrisin en büyük boyutu 2500 'dir (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: 50x50, 60x40, 90x20 (kare olması gerekmez).

API Sınırlamaları

Matrisin zaman uyumlu işlenmesi, yol hesaplamasının hızlı, küçük matrisleri için en uygun olanıdır. Daha büyük matrisleri ve ağır yol hesaplamasını hesaplamak için zaman uyumsuz uç noktayı kullanın. Aşağıdaki sınırlama, zaman uyumlu istekler için geçerlidir. Aşağıdaki tablodaki satırların hiçbiri isteğin parametreleriyle eşleşmiyorsa, istek gereksinimleri karşılamaz ve işlenmez.

En büyük matris boyutu	En fazla çıkış noktası sayısı	En fazla hedef sayısı	Ek sınırlar
100	100	100	N/A
200	200	200	Tüm çıkış noktaları ve hedefler eksene hizalanmış 400 km x 400 km sınırlayıcı kutuda bulunmalıdır. Aksi takdirde, bazı matris hücreleri OUT_OF_REGION olarak çözümlenir.
2500	1000	1000	- `departAt` veya `arriveAt` herhangi biri olmalıdır. - `traffic` tarihi olmalıdır. - `travelMode` araç kullanıyor veya kamyon kullanıyor olmalıdır - Başka hiçbir parametre açıkça kullanılamaz.

Examples:

traffic=liveiçeren 10x20 matris isteği: Sınırlayıcı kutu kısıtlamaları içeren 200'e kadar olan bir sınırla eşleştiğinden, bu istek sınırlayıcı kutu sınırıyla işlenir.
Varsayılan parametrelerle 10x20 matris isteği (traffic=historical): Bu istek sınırlayıcı kutu sınırlamaları uygulamayan 2500'e kadar olan bir sınırla eşleştiğinden sınırlayıcı kutu sınırı olmadan işlenir.

POST {endpoint}/route/matrix?api-version=2025-01-01

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
endpoint	path	True	string (uri)	Azure Haritalar service hostname. Azure açık bulut için `https://atlas.microsoft.com` kullanın. Belirli bir Azure Haritalar coğrafyası veya egemen bir bulutu hedeflemek için Azure Haritalar coğrafi kapsam bkz.
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.

İstek Başlığı

Media Types: "application/geo+json"

Name	Gerekli	Tür	Description
x-ms-client-id		string	Microsoft Entra ID güvenlik modeliyle kullanılmak üzere tasarlanmış hesabı gösterir. Azure Haritalar hesabı için bu benzersiz ID, Azure Haritalar yönetim düzlemi Hesap API'dan alınabilir. Azure Haritalar'de Microsoft Entra ID güvenliği kullanımı hakkında daha fazla bilgi için bkz. Doğrulamayı Azure Haritalar içinde yönetin.

İstek Gövdesi

Media Types: "application/geo+json"

Name	Gerekli	Tür	Description
features	True	InputRouteMatrixFeaturesItem[]	Giriş matrisi için GeoJSON MultiPoint özellikleri olarak geçirilen bir kaynak ve hedef nokta kümesi. GeoJSON biçimiyle ilgili ayrıntılar için RFC 7946'ya bakın.
type	True	FeatureTypeEnum	`GeoJSON` türünü belirtir. Desteklenen tek nesne türü `FeatureCollection`. Daha fazla bilgi için bkz. rfc 7946.
arriveAt		string (date-time)	`dateTime`tarafından tanımlanan değeri olarak biçimlendirilmiş hedef noktaya varış tarihi ve saati. Saat dilimi uzaklığı belirtilmediğinde UTC varsayılır. `arriveAt` parametresi `departAt`ile birlikte kullanılamaz. `arriveAt`, zaman bağlamı ile ilgisiz olduğu kullanım örneğine göre uyarlanmış `any` değeri de destekler. `traffic=live` parametre değeri `any`ile birlikte kullanılamaz. Varsayılan değer: `any` belirtilmezse `arriveAt`. Örnek: "arriveAt": "2024-12-01T09:30:00.000-07:00"
avoid		RouteMatrixAvoidEnum[]	Yolu belirlerken yol hesaplamasının yerine getirilmesi gereken kısıtlamaları belirtir. Kaçınma, bir istekteki birden çok değeri destekler ve yalnızca sürüş ve kamyon seyahatiMode için desteklenir.
departAt		string (date-time)	`dateTime`tarafından tanımlanan değeri olarak biçimlendirilmiş çıkış noktasından ayrılma tarihi ve saati. Saat dilimi uzaklığı belirtilmediğinde UTC varsayılır. `departAt` parametresi `arriveAt`ile birlikte kullanılamaz. `departAt` şunları da destekler: `any` zaman bağlamı ilgisiz olduğu kullanım örneğine göre uyarlanmış değerdir. `traffic=live` parametre değeri `any`ile birlikte kullanılamaz. Kalkış saatini her bir hücrenin işlem zamanına ayarlamak için `now` değer. İşlem süresi, gönderim ile tamamlanması arasında herhangi bir zaman olabilir. Bu mod en iyi şekilde traffic=live ile birlikte kullanılır. Varsayılan değer: `any` belirtilmezse `departAt`. Örnek: "departAt": "2024-12-01T09:30:00.000-07:00"
optimizeRoute		RouteMatrixOptimizeRouteEnum	Yolu iyileştirmek için kullanılacak parametreyi belirtir. Tanımlanmamışsa, varsayılan değer "en hızlı" olur ve bu da seyahat süresini en aza indirmek için yolu döndürür. Örnek: "optimizeRoute":"en hızlı "
traffic		RouteMatrixTrafficEnum	Bilgi işlem yolları için trafiğin nasıl dikkate alınıyor olduğunu belirtir. Varsayılan değer: `historical`
travelMode		RouteMatrixTravelModeEnum	Matris hesaplanırken dikkate alınacak seyahat profilini belirtir. Belirtilmezse, varsayılan değer "driving" olur. Örnek: "travelMode":"driving"
vehicleSpec		RouteMatrixVehicleSpec	Rota matrisini hesaplarken dikkate alınacak araç yüksekliği, ağırlık, maksimum hız, yük türü gibi araç özniteliklerini belirtir. Bu, araç özelliklerine göre optimize edilmiş rota sağlamak için düşük köprü açıklıklarını, yol kısıtlamalarını, zor sağ dönüşleri önlemeye yardımcı olur. Araç öznitelikleri vehicleSpec özelliği içinde belirtilir.

Yanıtlar

Name	Tür	Description
200 OK	RouteMatrixResponse	İstek başarılı oldu. Media Types: "application/geo+json", "application/json"
Other Status Codes	MapsErrorResponse	Beklenmeyen bir hata yanıtı. Media Types: "application/geo+json", "application/json"

Name

Tür

Description

200 OK

RouteMatrixResponse

İstek başarılı oldu.

Media Types: "application/geo+json", "application/json"

Other Status Codes

MapsErrorResponse

Beklenmeyen bir hata yanıtı.

Media Types: "application/geo+json", "application/json"

Güvenlik

AadToken

Bunlar Microsoft Entra OAuth 2.0 Akışlarıdır. Azure rol tabanlı erişim kontrolüyle eşleştirildiğinde, Azure Haritalar REST API'lerine erişimi kontrol etmek için kullanılabilir. Azure rol tabanlı erişim kontrolleri, bir veya daha fazla Azure Haritalar kaynak hesabına veya alt kaynağa erişim belirlemek 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.

Note

Bu güvenlik tanımı kullanılmasını gerektirir. Bu, Haritalar yönetim API'sindenedinilebilir.
Authorization URL, Azure genel bulut örneğine özgüdür. Egemen bulutlar benzersiz Yetkilendirme URL'lerine ve Microsoft Entra ID yapılandırmalarına sahiptir.
Azure rol tabanlı erişim denetimi Azure portalı, PowerShell, CLI, Azure SDK'ları veya REST API'leri aracılığıyla Azure yönetim düzleminden yapılandırılır.
Azure Haritalar Web SDK'sının kullanımı, bir uygulamanın birden çok kullanım örneği için yapılandırma tabanlı kurulumuna olanak tanır.
Microsoft kimlik platformu hakkında daha fazla bilgi için bkz. Microsoft kimlik platformuna genel bakış.

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

Kapsamlar

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

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: header

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 a route matrix with additional parameters in the body

Örnek isteği

HTTP

POST https://atlas.microsoft.com/route/matrix?api-version=2025-01-01

{
  "type": "FeatureCollection",
  "avoid": [
    "unpavedRoads"
  ],
  "departAt": "2022-12-19T16:39:57+01:00",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "MultiPoint",
        "coordinates": [
          [
            9.15049,
            45.458545
          ],
          [
            11.050541,
            45.403337
          ]
        ]
      },
      "properties": {
        "pointType": "origins"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "MultiPoint",
        "coordinates": [
          [
            11.499931,
            48.149853
          ],
          [
            14.538226,
            50.033688
          ]
        ]
      },
      "properties": {
        "pointType": "destinations"
      }
    }
  ],
  "optimizeRoute": "fastest",
  "traffic": "historical",
  "travelMode": "truck"
}

Örnek yanıt

Durum kodu:: 200

{
  "type": "Feature",
  "geometry": null,
  "properties": {
    "matrix": [
      {
        "arrivalAt": "2022-12-19T22:30:03+01:00",
        "departureAt": "2022-12-19T16:39:57+01:00",
        "destinationIndex": 0,
        "distanceInMeters": 492466,
        "durationInSeconds": 21007,
        "durationTrafficInSeconds": 21007,
        "originIndex": 0,
        "statusCode": 200
      },
      {
        "arrivalAt": "2022-12-20T02:00:19+01:00",
        "departureAt": "2022-12-19T16:39:57+01:00",
        "destinationIndex": 1,
        "distanceInMeters": 877028,
        "durationInSeconds": 33623,
        "durationTrafficInSeconds": 33623,
        "originIndex": 0,
        "statusCode": 200
      },
      {
        "arrivalAt": "2022-12-19T22:05:16+01:00",
        "departureAt": "2022-12-19T16:39:57+01:00",
        "destinationIndex": 0,
        "distanceInMeters": 427769,
        "durationInSeconds": 19520,
        "durationTrafficInSeconds": 19520,
        "originIndex": 1,
        "statusCode": 200
      },
      {
        "arrivalAt": "2022-12-20T01:34:27+01:00",
        "departureAt": "2022-12-19T16:39:57+01:00",
        "destinationIndex": 1,
        "distanceInMeters": 836080,
        "durationInSeconds": 32070,
        "durationTrafficInSeconds": 32070,
        "originIndex": 1,
        "statusCode": 200
      }
    ],
    "summary": {
      "successfulCount": 4,
      "totalCount": 4
    }
  }
}

Tanımlar

Name	Description
AdrTunnelRestrictionCodeEnum	ADR tünel kısıtlama kodu. ADR, tehlikeli malların karayoluyla uluslararası taşınmasıyla ilgili bir Avrupa anlaşmasıdır. ADR tünel kısıtlama kodu, tehlikeli malların taşınmasıyla ilgili kısıtlamalarla bir aracın tünelden geçmesine izin verilip verilmediğini belirlemek için kullanılır.
CommonErrorDetail	Hata ayrıntısı.
ErrorAdditionalInfo	Kaynak yönetimi hatası ek bilgileri.
FeaturesItemTypeEnum	`GeoJSON` türünü belirtir. Desteklenen tek nesne türü Özellik'tir. Daha fazla bilgi için bkz. rfc 7946.
FeatureTypeEnum	`GeoJSON` türünü belirtir. Desteklenen tek nesne türü `FeatureCollection`. Daha fazla bilgi için bkz. rfc 7946.
GeoJsonMultiPoint	Geçerli bir `GeoJSON MultiPoint` geometri türü. Ayrıntılar için lütfen RFC 7946 bakın.
GeoJsonObjectType	`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.
InputRouteMatrixFeaturesItem	`GeoJSON` MultiPoint özellik nesnesi için giriş çıkış noktasını ve hedef noktaları ve ek özellikleri belirtir. Ayrıntılar için rfc 7946 bakın.
InputRouteMatrixProperties	Giriş matrisinin properties nesnesini belirtir.
MapsErrorDetail	Hata ayrıntısı.
MapsErrorResponse	Azure Haritalar API'lerinde başarısız işlemler için hata detaylarını döndürmek için yaygın hata yanıtı.
MapsInnerError	Hatayla ilgili geçerli nesneden daha belirli bilgiler içeren bir nesne.
RouteMatrixAvoidEnum	Yolu belirlerken yol hesaplamasının yerine getirilmesi gereken kısıtlamaları belirtir. Kaçınma, bir istekteki birden çok değeri destekler ve yalnızca sürüş ve kamyon seyahatiMode için desteklenir.
RouteMatrixFeatureProperties	Yol Matrisi özellikleri.
RouteMatrixItemResult	Rota Matrisi öğe sonucu
RouteMatrixOptimizeRouteEnum	Yolu iyileştirmek için kullanılacak parametreyi belirtir. Tanımlanmamışsa, varsayılan değer "en hızlı" olur ve bu da seyahat süresini en aza indirmek için yolu döndürür. Örnek: "optimizeRoute":"en hızlı "
RouteMatrixRequest	Çıkış noktaları ve hedef listesindeki tüm olası çiftlerin seyahat süresini ve mesafesini gösteren bir rota matrisi almak için kullanın. Özellik nesnesini ve ek özellikleri `GeoJSON`. Ayrıntılar için rfc 7946 bakın.
RouteMatrixResponse	Bu nesne başarılı bir çağrıdan döndürülür.
RouteMatrixSummary	Rota matrisi isteğinin özeti
RouteMatrixTrafficEnum	Bilgi işlem yolları için trafiğin nasıl dikkate alınıyor olduğunu belirtir. Varsayılan değer: `historical`
RouteMatrixTravelModeEnum	Matris hesaplanırken dikkate alınacak seyahat profilini belirtir. Belirtilmezse, varsayılan değer "driving" olur. Örnek: "travelMode":"driving"
RouteMatrixTypeEnum	Giriş matrisi için kaynak MultiPoint türünü ve hedef MultiPoint türünü belirtir.
RouteMatrixVehicleSpec	Rota matrisini hesaplarken dikkate alınacak araç yüksekliği, ağırlık, maksimum hız, yük türü gibi araç özniteliklerini belirtir. Bu, araç özelliklerine göre optimize edilmiş rota sağlamak için düşük köprü açıklıklarını, yol kısıtlamalarını, zor sağ dönüşleri önlemeye yardımcı olur. Araç öznitelikleri vehicleSpec özelliği içinde belirtilir.
VehicleLoadTypeEnum	Tehlikeli madde olarak sınıflandırılabilecek ve bazı yollardan kısıtlanmış kargo türleri.

AdrTunnelRestrictionCodeEnum

Numaralandırma

ADR tünel kısıtlama kodu. ADR, tehlikeli malların karayoluyla uluslararası taşınmasıyla ilgili bir Avrupa anlaşmasıdır. ADR tünel kısıtlama kodu, tehlikeli malların taşınmasıyla ilgili kısıtlamalarla bir aracın tünelden geçmesine izin verilip verilmediğini belirlemek için kullanılır.

Değer	Description
B	B koduna sahip araçların ADR tünel kategorileri B, C, D ve E olan yollara yasaktır.
C	C koduna sahip araçlar, ADR tünel kategorileri C, D ve E olan yollardan kısıtlanır
D	D koduna sahip araçlar, ADR tünel kategorileri D ve E olan yollardan kısıtlanır.
E	E koduna sahip araçlar, ADR tünel kategorisi E olan yollardan kısıtlanır.

CommonErrorDetail

Nesne

Hata ayrıntısı.

Name	Tür	Description
additionalInfo	ErrorAdditionalInfo[]	Hata ek bilgileri.
code	string	Hata kodu.
details	CommonErrorDetail[]	Hata ayrıntıları.
message	string	Hata iletisi.
target	string	Hata hedefi.

ErrorAdditionalInfo

Nesne

Kaynak yönetimi hatası ek bilgileri.

Name	Tür	Description
info	object	Ek bilgiler.
type	string	Ek bilgi türü.

FeaturesItemTypeEnum

Numaralandırma

GeoJSON türünü belirtir. Desteklenen tek nesne türü Özellik'tir. Daha fazla bilgi için bkz. rfc 7946.

Değer	Description
Feature	`GeoJSON` Özelliği nesne türünü belirtir.

FeatureTypeEnum

Numaralandırma

GeoJSON türünü belirtir. Desteklenen tek nesne türü FeatureCollection. Daha fazla bilgi için bkz. rfc 7946.

Değer	Description
FeatureCollection	`GeoJSON` `FeatureCollection` nesne türünü belirtir.

GeoJsonMultiPoint

Nesne

Geçerli bir GeoJSON MultiPoint geometri türü. Ayrıntılar için lütfen RFC 7946 bakın.

Name	Tür	Description
coordinates	number[] (double)	`GeoJson MultiPoint` geometrisinin 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.

GeoJsonObjectType

Numaralandırma

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.

Değer	Description
Point	geometriyi `GeoJSON Point`.
MultiPoint	geometriyi `GeoJSON MultiPoint`.
LineString	geometriyi `GeoJSON LineString`.
MultiLineString	geometriyi `GeoJSON MultiLineString`.
Polygon	geometriyi `GeoJSON Polygon`.
MultiPolygon	geometriyi `GeoJSON MultiPolygon`.
GeometryCollection	geometriyi `GeoJSON GeometryCollection`.
Feature	`GeoJSON Feature` nesne.
FeatureCollection	`GeoJSON FeatureCollection` nesne.

InputRouteMatrixFeaturesItem

Nesne

GeoJSON MultiPoint özellik nesnesi için giriş çıkış noktasını ve hedef noktaları ve ek özellikleri belirtir. Ayrıntılar için rfc 7946 bakın.

Name	Tür	Description
geometry	GeoJsonMultiPoint	Geçerli bir `GeoJSON MultiPoint` geometri türü. Ayrıntılar için lütfen RFC 7946 bakın.
properties	InputRouteMatrixProperties	Giriş matrisi için kaynak özellikleri ve hedef özellikleri belirten MultiPoint özellik özellikleri nesnesi.
type	FeaturesItemTypeEnum	`GeoJSON` türünü belirtir. Desteklenen tek nesne türü Özellik'tir. Daha fazla bilgi için bkz. rfc 7946.

InputRouteMatrixProperties

Nesne

Giriş matrisinin properties nesnesini belirtir.

Name	Tür	Description
pointType	RouteMatrixTypeEnum	Giriş matrisi için kaynak MultiPoint türünü ve hedef MultiPoint türünü belirtir.

MapsErrorDetail

Nesne

Hata ayrıntısı.

Name	Tür	Description
code	string	Sunucu tanımlı hata kodları kümesinden biri.
details	MapsErrorDetail[]	Bu bildirilen hataya yol açan belirli hatalar hakkında bir dizi ayrıntı.
innererror	MapsInnerError	Hatayla ilgili geçerli nesneden daha belirli bilgiler içeren bir nesne.
message	string	Hatanın insan tarafından okunabilir bir gösterimi.
target	string	Hatanın hedefi.

MapsErrorResponse

Nesne

Azure Haritalar API'lerinde başarısız işlemler için hata detaylarını döndürmek için yaygın hata yanıtı.

Name	Tür	Description
error	MapsErrorDetail	Hata ayrıntısı.

MapsInnerError

Nesne

Hatayla ilgili geçerli nesneden daha belirli bilgiler içeren bir nesne.

Name	Tür	Description
code	string	Hata kodu.
innererror	MapsInnerError	Hatayla ilgili geçerli nesneden daha belirli bilgiler içeren bir nesne.

RouteMatrixAvoidEnum

Numaralandırma

Yolu belirlerken yol hesaplamasının yerine getirilmesi gereken kısıtlamaları belirtir. Kaçınma, bir istekteki birden çok değeri destekler ve yalnızca sürüş ve kamyon seyahatiMode için desteklenir.

Değer	Description
tollRoads	Rotada ücretli yolların kullanılmasını önler.
unpavedRoads	Rotada kazınmamış yollardan kaçınıyor.

RouteMatrixFeatureProperties

Nesne

Yol Matrisi özellikleri.

Name	Tür	Description
matrix	RouteMatrixItemResult[]	Yol sonuçları matrisi.
summary	RouteMatrixSummary	Rota matrisi isteğinin özeti

RouteMatrixItemResult

Nesne

Rota Matrisi öğe sonucu

Name	Tür	Description
arrivalAt	string (date-time)	Trafik koşullarını dikkate alan tahmini varış zamanı, `dateTime`tarafından tanımlanan bir değeri olarak biçimlendirilir. saat dilimi uzaklığını `departAt` veya `arrivalAt`ile başvurur. Aksi takdirde UTC saati kullanılır. Eğer departAt veya arriveAt varsa, o zaman departureAt yoktur.
departureAt	string (date-time)	Trafik koşullarını dikkate alan tahmini kalkış saati, `dateTime`tarafından tanımlanan bir değeri olarak biçimlendirilir. saat dilimi uzaklığını `departAt` veya `arrivalAt`ile başvurur. Aksi takdirde UTC saati kullanılır. departAt veya arriveAt ise `any`, departureAt yoktur.
destinationIndex	integer (int32)	Hedef noktanın dizini
distanceInMeters	number (double)	Metre cinsinden Uzunluk özelliği
durationInSeconds	integer (int64)	Trafik koşulları nedeniyle rotada gecikmeler içermeyen saniye cinsinden tahmini seyahat süresi.
durationTrafficInSeconds	integer (int64)	Geçerli trafik koşullarıyla ilgili bir `TravelDistance` seyahat etmek için geçen süre (saniye olarak). Bu değer, mevcut trafik koşullarını hesaba katmak için aktarılırsa `traffic=live` sağlanır.
error	CommonErrorDetail	Hata ayrıntısı.
originIndex	integer (int32)	Çıkış noktasının dizini
statusCode	integer (int32)	Geçerli hücrenin HTTP durum kodu.

RouteMatrixOptimizeRouteEnum

Numaralandırma

Yolu iyileştirmek için kullanılacak parametreyi belirtir. Tanımlanmamışsa, varsayılan değer "en hızlı" olur ve bu da seyahat süresini en aza indirmek için yolu döndürür.

Örnek: "optimizeRoute":"en hızlı "

Değer Description

fastest

Değer	Description
fastest	Seyahat süresine göre rotayı iyileştirmek için en hızlı yolu bulur. Rota Matrisi eşitleme API'sinde yalnızca `fastest` desteklenir. Diğer türleri kullanmak için Yol Matrisi zaman uyumsuz API'sini denetleyin.

Seyahat süresine göre rotayı iyileştirmek için en hızlı yolu bulur.

Rota Matrisi eşitleme API'sinde yalnızca fastest desteklenir. Diğer türleri kullanmak için Yol Matrisi zaman uyumsuz API'sini denetleyin.

RouteMatrixRequest

Nesne

Çıkış noktaları ve hedef listesindeki tüm olası çiftlerin seyahat süresini ve mesafesini gösteren bir rota matrisi almak için kullanın. Özellik nesnesini ve ek özellikleri GeoJSON. Ayrıntılar için rfc 7946 bakın.

Name	Tür	Default value	Description
arriveAt	string (date-time)		`dateTime`tarafından tanımlanan değeri olarak biçimlendirilmiş hedef noktaya varış tarihi ve saati. Saat dilimi uzaklığı belirtilmediğinde UTC varsayılır. `arriveAt` parametresi `departAt`ile birlikte kullanılamaz. `arriveAt`, zaman bağlamı ile ilgisiz olduğu kullanım örneğine göre uyarlanmış `any` değeri de destekler. `traffic=live` parametre değeri `any`ile birlikte kullanılamaz. Varsayılan değer: `any` belirtilmezse `arriveAt`. Örnek: "arriveAt": "2024-12-01T09:30:00.000-07:00"
avoid	RouteMatrixAvoidEnum[]		Yolu belirlerken yol hesaplamasının yerine getirilmesi gereken kısıtlamaları belirtir. Kaçınma, bir istekteki birden çok değeri destekler ve yalnızca sürüş ve kamyon seyahatiMode için desteklenir.
departAt	string (date-time)		`dateTime`tarafından tanımlanan değeri olarak biçimlendirilmiş çıkış noktasından ayrılma tarihi ve saati. Saat dilimi uzaklığı belirtilmediğinde UTC varsayılır. `departAt` parametresi `arriveAt`ile birlikte kullanılamaz. `departAt` şunları da destekler: `any` zaman bağlamı ilgisiz olduğu kullanım örneğine göre uyarlanmış değerdir. `traffic=live` parametre değeri `any`ile birlikte kullanılamaz. Kalkış saatini her bir hücrenin işlem zamanına ayarlamak için `now` değer. İşlem süresi, gönderim ile tamamlanması arasında herhangi bir zaman olabilir. Bu mod en iyi şekilde traffic=live ile birlikte kullanılır. Varsayılan değer: `any` belirtilmezse `departAt`. Örnek: "departAt": "2024-12-01T09:30:00.000-07:00"
features	InputRouteMatrixFeaturesItem[]		Giriş matrisi için GeoJSON MultiPoint özellikleri olarak geçirilen bir kaynak ve hedef nokta kümesi. GeoJSON biçimiyle ilgili ayrıntılar için RFC 7946'ya bakın.
optimizeRoute	RouteMatrixOptimizeRouteEnum	fastest	Yolu iyileştirmek için kullanılacak parametreyi belirtir. Tanımlanmamışsa, varsayılan değer "en hızlı" olur ve bu da seyahat süresini en aza indirmek için yolu döndürür. Örnek: "optimizeRoute":"en hızlı "
traffic	RouteMatrixTrafficEnum	historical	Bilgi işlem yolları için trafiğin nasıl dikkate alınıyor olduğunu belirtir. Varsayılan değer: `historical`
travelMode	RouteMatrixTravelModeEnum	driving	Matris hesaplanırken dikkate alınacak seyahat profilini belirtir. Belirtilmezse, varsayılan değer "driving" olur. Örnek: "travelMode":"driving"
type	FeatureTypeEnum		`GeoJSON` türünü belirtir. Desteklenen tek nesne türü `FeatureCollection`. Daha fazla bilgi için bkz. rfc 7946.
vehicleSpec	RouteMatrixVehicleSpec		Rota matrisini hesaplarken dikkate alınacak araç yüksekliği, ağırlık, maksimum hız, yük türü gibi araç özniteliklerini belirtir. Bu, araç özelliklerine göre optimize edilmiş rota sağlamak için düşük köprü açıklıklarını, yol kısıtlamalarını, zor sağ dönüşleri önlemeye yardımcı olur. Araç öznitelikleri vehicleSpec özelliği içinde belirtilir.

RouteMatrixResponse

Nesne

Bu nesne başarılı bir çağrıdan döndürülür.

Name	Tür	Description
geometry		Geometri nesnesi null
properties	RouteMatrixFeatureProperties	Yol Matrisi özellikleri.
type	FeaturesItemTypeEnum	`GeoJSON` türünü belirtir. Desteklenen tek nesne türü Özellik'tir. Daha fazla bilgi için bkz. rfc 7946.

RouteMatrixSummary

Nesne

Rota matrisi isteğinin özeti

Name	Tür	Description
successfulCount	integer (int32)	Bu matris içindeki başarılı yolların sayısı.
totalCount	integer (int32)	Bu matris içindeki yolların toplam sayısı.

RouteMatrixTrafficEnum

Numaralandırma

Bilgi işlem yolları için trafiğin nasıl dikkate alınıyor olduğunu belirtir.

Varsayılan değer: historical

Değer Description

historical

Değer	Description
historical	Rota hesaplaması, geçmiş seyahat sürelerini ve uzun vadeli kapanışları dikkate alır. Seyahat süresi penceresinde trafik sıkışıklıkları ve kısa süreli kapanışlar, rotayı veya seyahat süresini etkilemez.
live	Geçmiş seyahat sürelerine ek olarak, rota hesaplaması seyahat süresi penceresinde trafik sıkışıklıklarını ve kısa ve uzun süreli kapanışları dikkate alır. `Note`: `traffic=livearriveAt=any` ve `departAt=any` ile birlikte kullanılamaz

Rota hesaplaması, geçmiş seyahat sürelerini ve uzun vadeli kapanışları dikkate alır. Seyahat süresi penceresinde trafik sıkışıklıkları ve kısa süreli kapanışlar, rotayı veya seyahat süresini etkilemez.

live

Geçmiş seyahat sürelerine ek olarak, rota hesaplaması seyahat süresi penceresinde trafik sıkışıklıklarını ve kısa ve uzun süreli kapanışları dikkate alır.

Note: traffic=livearriveAt=any ve departAt=any ile birlikte kullanılamaz

RouteMatrixTravelModeEnum

Numaralandırma

Matris hesaplanırken dikkate alınacak seyahat profilini belirtir. Belirtilmezse, varsayılan değer "driving" olur.

Örnek: "travelMode":"driving"

Değer	Description
driving	Rota matrisi hesaplaması için otomobillere uygun yönlendirme profili kullanılır.
truck	Rota matrisi hesaplaması için kamyon gibi ticari araçlara uygun yönlendirme profili kullanılır.
walking	Geri dönen yollar, kaldırım kullanımı dahil olmak üzere yayalar için optimize edilmiştir.

RouteMatrixTypeEnum

Numaralandırma

Giriş matrisi için kaynak MultiPoint türünü ve hedef MultiPoint türünü belirtir.

Değer	Description
origins	Giriş matrisindeki kaynak konumları tanımlayan MultiPoint özellikleri.
destinations	Giriş matrisinde hedef konumları tanımlayan MultiPoint özellikleri.

RouteMatrixVehicleSpec

Nesne

Rota matrisini hesaplarken dikkate alınacak araç yüksekliği, ağırlık, maksimum hız, yük türü gibi araç özniteliklerini belirtir. Bu, araç özelliklerine göre optimize edilmiş rota sağlamak için düşük köprü açıklıklarını, yol kısıtlamalarını, zor sağ dönüşleri önlemeye yardımcı olur. Araç öznitelikleri vehicleSpec özelliği içinde belirtilir.

Name	Tür	Default value	Description
adrTunnelRestrictionCode	AdrTunnelRestrictionCodeEnum		ADR tünel kısıtlama kodu. ADR, tehlikeli malların karayoluyla uluslararası taşınmasıyla ilgili bir Avrupa anlaşmasıdır. ADR tünel kısıtlama kodu, tehlikeli malların taşınmasıyla ilgili kısıtlamalarla bir aracın tünelden geçmesine izin verilip verilmediğini belirlemek için kullanılır.
axleWeight	integer (int64) minimum: 0 maximum: 1000000	0	Kg cinsinden aracın aks başına ağırlığı. 0 değeri, aks başına ağırlık kısıtlamalarının dikkate alınmadığı anlamına gelir.
height	number (double) minimum: 0 maximum: 1000000	0	Aracın metre cinsinden yüksekliği. 0 değeri, yükseklik kısıtlamalarının dikkate alınmadığı anlamına gelir.
isVehicleCommercial	boolean	False	Aracın ticari amaçlarla kullanılıp kullanılmadığı. Ticari araçların bazı yollarda sürmesine izin verilmiyor olabilir.
length	number (double) minimum: 0 maximum: 1000000	0	Aracın metre cinsinden uzunluğu. 0 değeri, uzunluk kısıtlamalarının dikkate alınmadığı anlamına gelir.
loadType	VehicleLoadTypeEnum[]		Tehlikeli madde olarak sınıflandırılabilecek ve bazı yollardan kısıtlanmış kargo türleri. Kullanılabilir araçLoadType değerleri, 1 ile 9 arasında ABD Hazmat sınıflarının yanı sıra diğer ülkelerde kullanılmak üzere genel sınıflandırmalardır. USHazmat ile başlayan değerler ABD yönlendirme içindir, diğer tüm ülkelerde ise diğerHazmat kullanılmalıdır. vehicleLoadType bir istekteki birden çok değeri destekler.
maxSpeed	integer (int64) minimum: 0 maximum: 250	0	Aracın km/saat cinsinden 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, rota planlaması sırasında araç için uygun bir değerin 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 geçerli 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 tekrar 60 km/saat kullanacaktır.
weight	integer (int64) minimum: 0 maximum: 1000000	0	Aracın ağırlığı kilogram olarak. 0 değeri, ağırlık kısıtlamalarının dikkate alınmadığı anlamına gelir.
width	number (double) minimum: 0 maximum: 1000000	0	Aracın metre cinsinden genişliği. 0 değeri, genişlik kısıtlamalarının dikkate alınmadığı anlamına gelir.

VehicleLoadTypeEnum

Numaralandırma

Tehlikeli madde olarak sınıflandırılabilecek ve bazı yollardan kısıtlanmış kargo türleri.

Değer	Description
USHazmatClass1	Patlayıcı
USHazmatClass2	Sıkıştırılmış gaz
USHazmatClass3	Yanıcı sıvılar
USHazmatClass4	Yanıcı katılar
USHazmatClass5	Oksidatörler
USHazmatClass6	Zehir
USHazmatClass7	Radyoaktif
USHazmatClass8	Aşındırıcılar
USHazmatClass9	Miscellaneous
otherHazmatExplosive	Patlayıcı
otherHazmatGeneral	Miscellaneous
otherHazmatHarmfulToWater	Suya zararlı