Route

  • Başvuru
Service:
Maps
API Version:
1.0

Operations

Get Route Directions

Için geçerlidir: S0 ve S1 fiyatlandırma katmanları.

Bir çıkış noktası ile hedef arasında, belirtilmişse yol noktaları üzerinden geçen bir yol döndürür. Yol, geçerli trafik ve istenen haftanın günü ve günün saati gibi tipik yol hızları gibi faktörleri dikkate alır.

Döndürülen bilgiler uzaklık, tahmini seyahat süresi ve rota geometrisi gösterimini içerir. Seçilen seçeneklere bağlı olarak, en iyi duruma getirilmiş yol noktası sırası veya turn by turn yönergeleri gibi ek yönlendirme bilgileri de kullanılabilir.

Yönlendirme hizmeti, araca özgü Tüketim Modeli'nin ayrıntılı açıklaması için bir dizi parametre sağlar. Lütfen ilgili kavramların ve parametrelerin ayrıntılı açıklaması için Tüketim Modeli'ne göz geçirin.
Get Route Range

Rota Aralığı (Isochrone) API'si

Için geçerlidir: S1 fiyatlandırma katmanı.

Bu hizmet, belirtilen yakıt, enerji, zaman veya mesafe bütçesine göre çıkış noktasından ulaşıla bir konum kümesi hesaplar. Çokgen sınırı (veya Isochrone), saat yönünün yanı sıra çıkış noktasının sonucu olan kesin çokgen merkezinde döndürülür.

Döndürülen çokgen, sağlanan Isochrone içinde POI'leri aramak için Geometri İçinde Ara gibi daha fazla işleme için kullanılabilir.
Post Route Directions

Için geçerlidir: S0 ve S1 fiyatlandırma katmanları.

Bir çıkış noktası ile hedef arasında, belirtilmişse yol noktaları üzerinden geçen bir yol döndürür. Yol, geçerli trafik ve istenen haftanın günü ve günün saati gibi tipik yol hızları gibi faktörleri dikkate alır.

Döndürülen bilgiler uzaklık, tahmini seyahat süresi ve rota geometrisi gösterimini içerir. Seçilen seçeneklere bağlı olarak, en iyi duruma getirilmiş yol noktası sırası veya turn by turn yönergeleri gibi ek yönlendirme bilgileri de kullanılabilir.

Yönlendirme hizmeti, araca özgü Tüketim Modeli'nin ayrıntılı açıklaması için bir dizi parametre sağlar. Lütfen ilgili kavramların ve parametrelerin ayrıntılı açıklaması için Tüketim Modeli'ne göz geçirin.
Post Route Directions Batch

Yönlendirme Yönergeleri Batch API'si

Için geçerlidir: S1 fiyatlandırma katmanı.

Yol Tarifi Toplu İş API'si, tek bir API çağrısı kullanarak toplu sorguları Yönlendirme Yönergeleri API'sini gönderir. Zaman uyumsuz (zaman uyumsuz) veya zaman uyumlu (eşitleme) çalıştırmak için Yol Yönergeleri Batch API'sini çağırabilirsiniz. Zaman uyumsuz API, çağıranın en fazla 700 sorgu toplu işlemesini ve 100'e kadar sorgu eşitleme API'sini kullanmasını sağlar.

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

Basit toplu iş istekleri 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 olasılığı yoktur. İ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}

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

Zaman Uyumsuz API, görece karmaşık yol isteklerinin büyük hacimlerini işlemeye uygundur

  • Sonuçların ayrı bir çağrıyla alınmasına olanak sağlar (birden çok indirme mümkündür).
  • Zaman uyumsuz API güvenilirlik için iyileştirilmiştir ve bir zaman aşımına neden olması beklenmiyor.
  • Bu API için toplu iş öğelerinin sayısı 700 ile sınırlıdır.

Zaman uyumsuz istek kullanarak istekte bulundursanız, hizmet varsayılan olarak yanıt üst bilgisinin Konum alanında bir yeniden yönlendirme URL'si üzerinde bir 202 yanıt kodu döndürür. Yanıt verileri veya hata bilgileri kullanılabilir olana kadar bu URL düzenli aralıklarla denetlenir. Zaman uyumsuz yanıtlar 14 gün boyunca depolanır. Yeniden yönlendirme URL'si, süre sonu süresi sonra kullanılırsa 404 yanıtı döndürür.

Zaman uyumsuz toplu iş isteğinin uzun süre çalışan bir istek olduğunu lütfen unutmayın. Tipik bir işlem dizisi şöyledir:

  1. İstemci, POST Azure Haritalar'a Yol Tarifi Toplu İş isteği Haritalar

  2. Sunucu, aşağıdakilerden biri ile yanıt verir:

    HTTP 202 Accepted - Batch isteği kabul edildi.

    HTTP Error - Batch isteğinizi işlerken bir hata oluştu. Bu bir veya başka 400 Bad Request bir durum Error kodu olabilir.

  3. Toplu iş isteği başarıyla kabul edildiyse, yanıtta üst bilgi toplu iş isteğinin sonuçlarını Location indirmek için URL'yi içerir. Bu durum URI'sı aşağıdaki gibi görünüyor:

GET https://atlas.microsoft.com/route/directions/batch/{batch-id}?api-version=1.0Not:- Çalıştırmadan önce durum URI'sinde AUTH bilgilerini (subscription-key/azure_auth - Bkz. Güvenlik)eklemeyi unutmayın.
4. İstemci, toplu GET iş sonuçlarını indirmek için 3. Adımda elde edilen indirme URL'sinde bir istek verir.

Batch İsteği için POST Gövdesi

Yol tarifi sorgularını göndermek için istek gövdesinin diziyi biçiminde ve üst bilgisi olarak ayarlanıyor olduğu POST bir istek batchItems json Content-Type application/json kullanırız. 3 yol tarifi sorgusu içeren örnek istek gövdesi şöyledir:

{
    "batchItems": [
        { "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" },
        { "query": "?query=48.923159,-122.557362:32.621279,-116.840362" }
    ]
}

Toplu işteki yol yönergeleri sorgusu protokol, temel URL, yol, api sürümü ve abonelik anahtarı olmadan yalnızca kısmi bir URL'dir. Desteklenen yol yönergeleri URI parametrelerinin herhangi birini kabul eder. Yol yönergeleri sorgusunda yer alan dize değerlerinin düzgün bir şekilde kaçarak (örneğin " karakteriyle kaçarak) olması ve aynı zamanda URL ile \ kodlanmış olması gerekir.

Zaman uyumsuz API, çağıranın en fazla 700 sorguyu toplu işlemesini ve en fazla 100 sorguyu eşitleme API'sini kullanmasını sağlar ve toplu iş en az 1 sorgu içerebilir.

Zaman Uyumsuz Toplu İş Sonuçlarını İndirme

Zaman uyumsuz toplu iş sonuçlarını indirmek için toplu iş indirme GET uç noktasına bir istek gönderilir. Bu indirme URL'si, başarılı bir toplu iş Location isteğinin üst POST bilgilerinden elde edilebilir ve aşağıdaki gibi görünür:

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

Toplu iş sonuçlarını indirmeye yönelik tipik işlem sırası şu şekildedir:

  1. İstemci, indirme GET URL'sini kullanarak bir istek gönderir.

  2. Sunucu, aşağıdakilerden biri ile yanıt verir:

    HTTP 202 Accepted - Batch isteği kabul edildi ama hala işleniyor. Lütfen bir süre sonra yeniden deneyin.

    HTTP 200 OK - Batch isteği başarıyla işlendi. Yanıt gövdesi tüm toplu iş sonuçlarını içerir.

Toplu Yanıt Modeli

Döndürülen veri içeriği, zaman uyumsuz ve eşitleme istekleri için benzerdir. Zaman uyumsuz bir toplu iş isteğinin sonuçlarını indirirken, toplu iş işlemeyi bitirmişse, 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 ve yani başarıyla yürütülen summary sorguları belirten bir bileşen totalRequests successfulRequests içerir. Toplu iş yanıtı, toplu batchItems iş isteğinde her bir sorgu için yanıt içeren bir dizi de içerir. batchItems, sonuçları toplu iş isteğinde gönderilen özgün sorguların tam olarak aynı sırayla içerir. içinde her öğe batchItems ve statusCode alanları response içerir. içinde response batchItems her biri aşağıdaki türlerden biridir:

  • RouteDirectionsResponse - Sorgu başarıyla tamamlandı ise.

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

1 başarılı ve 1 başarısız sonuç ile örnek bir Batch Yanıtı:

{
    "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 Route Matrix

Için geçerlidir: S1 fiyatlandırma katmanı.

Matris Yönlendirme hizmeti, zaman uyumsuz (zaman uyumsuz) veya zaman uyumlu (eşitleme) POST isteği kullanarak kaynak ve hedef konumlara göre tanımlanan bir yol kümesi için yol özetleri matrisinin hesaplanmasına olanak sağlar. Verilen her çıkış noktası için hizmet, bu çıkış alanından belirli bir hedefe yönlendirmenin maliyetini hesaplar. Kaynak kümesi ve hedef kümesi, bir tablonun sütun ve satır üst bilgileri olarak düşünebilirsiniz ve tablodaki her hücre o hücrenin kaynağından hedefe yönlendirme maliyetlerini içerir. Örneğin bir yemek teslimatı şirketinde 20 sürücü olduğunu ve restorandaki teslimatı almak için en yakın sürücüyü bulmaları gerekiyor. Bu kullanım sorununu çözmek için Matris Yönlendirme API'sini çağırabilirsiniz.

Her rota için seyahat süreleri ve mesafeler döndürülür. Rota Yönergeleri API'sini kullanarak hangi ayrıntılı yolların hesaplandır ayrıntılı olduğunu belirlemek için hesaplanan maliyetleri kullanabilirsiniz.

Zaman uyumsuz istek için matrisin maksimum boyutu 700'tir ve eşitleme isteği için bu değer 100'tir (kaynak sayısı hedef sayısıyla çarpılır).

Zaman Uyumlu Yol Matrisi İsteği Gönderme

Senaryon zaman uyumlu istekler gerektiriyorsa ve matrisin maksimum boyutu 100'den küçük veya buna eşitse, zaman uyumlu istekte bulundurabilirsiniz. Bu API için matrisin maksimum boyutu 100'tir (kaynak sayısı hedef sayısıyla çarpılır). Bu kısıtlamayı da kabul etmek gerekirse, olası matris boyutlarına örnekler: 10x10, 6x8, 9x8 (kare olması gerek değildir).

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

Zaman Uyumsuz Yol Matrisi İsteği Gönderme

Zaman Uyumsuz API, görece karmaşık yönlendirme isteklerinin büyük hacimlerini işlemeye uygundur. Zaman uyumsuz istek kullanarak istekte bulundursanız, hizmet varsayılan olarak yanıt üst bilgisinin Konum alanında bir yeniden yönlendirme URL'si üzerinde bir 202 yanıt kodu döndürür. Yanıt verileri veya hata bilgileri kullanılabilir olana kadar bu URL düzenli aralıklarla denetlenir. İstekte parametre true olarak ayarlanırsa, istek 120 saniyenin altında tamam olursa kullanıcı waitForResults 200 yanıtını alır.

Bu API için matrisin maksimum boyutu 700'tir (kaynak sayısı hedef sayısıyla çarpılır). Bu kısıtlamayı da kullanarak, olası matris boyutlarının örnekleri: 50x10, 10x10, 28x25. 10x70 (kare olması gerek değildir).

Zaman uyumsuz yanıtlar 14 gün boyunca depolanır. Yeniden yönlendirme URL'si, süre sonu sonrasında kullanılırsa 404 yanıtı döndürür.

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

Tipik bir zaman uyumsuz işlemler dizisi şöyledir:

  1. İstemci, Azure Haritalar'a Yol Matrisi POST isteği gönderir

  2. Sunucu, aşağıdakilerden biri ile yanıt verir:

    HTTP 202 Accepted - Yol Matrisi isteği kabul edildi.

    HTTP Error - Yol Matrisi isteğinizi işleme sırasında bir hata oluştu. Bu, 400 Hatalı İstek veya başka bir Hata durum kodu olabilir.

  3. Matris Rotası isteği başarıyla kabul edildiyse, yanıtta Konum üst bilgisi isteğin sonuçlarını indirmek için URL'yi içerir. Bu durum URI'si aşağıdaki gibi görünüyor:

  GET https://atlas.microsoft.com/route/matrix/{matrixId}?api-version=1.0?subscription-key={subscription-key}
  1. İstemci, sonuçları indirmek için 3. Adımda elde edilen indirme URL'sinde bir GET isteği verir

Eşitleme Sonuçlarını İndirme

Yol Matrisi Eşitleme API'si için bir POST isteğite bulundurarak hizmet, başarılı istek için 200 yanıt kodu ve bir yanıt dizisi döndürür. Yanıt gövdesi verileri içerir ve sonuçları daha sonra almak mümkün olmayacaktır.

Zaman Uyumsuz Sonuçları İndirme

bir istek yanıt verdiği 202 Accepted zaman uyumsuz işlem hattımız kullanılarak istek işlenir. Yanıtın konum üst bilgisinde zaman uyumsuz isteğinizin ilerlemesini denetlemeniz için bir URL verilir. Bu durum URI'si aşağıdaki gibi görünüyor:

  GET https://atlas.microsoft.com/route/matrix/{matrixId}?api-version=1.0?subscription-key={subscription-key}

Konum üst bilgisi tarafından sağlanan URL, bir istek olduğunda GET aşağıdaki yanıtları geri alır.

HTTP 202 Accepted - Matris isteği kabul edildi ama hala işleniyor. Lütfen bir süre sonra yeniden deneyin.

HTTP 200 OK - Matris isteği başarıyla işlendi. Yanıt gövdesi tüm sonuçları içerir.