@azure-rest/maps-route package

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

Batch isteği nesnesi

Batch API'sinden döndürülen bir öğe. 'response' özelliğiyle genişletin.

Bu nesne başarılı bir Batch hizmet çağrısından döndürülür. 'batchItems' özelliğiyle genişletin.

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

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

Hata ayrıntısı.

Başarısız işlemlerin hata ayrıntılarını döndürmek için tüm Azure Resource Manager API'leri için genel hata yanıtı. (Bu, OData hata yanıt biçimini de izler.).

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

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

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

Geçerli bir GeoJSON geometri nesnesi. Tür yedi geçerli GeoJSON geometri türünden biri olmalıdır: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon ve GeometryCollection. Ayrıntılar için lütfen RFC 7946 bakın.

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

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

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

GeoJson MultiPointtarafından kapsanan veriler.

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

Geçerli bir GeoJSON nesnesi. Ayrıntılar için lütfen RFC 7946 bakın.

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

GeoJson Pointtarafından kapsanan veriler.

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

Enlem ve boylam olarak temsil edilen konum.

İstemci için isteğe bağlı parametreler

Yol tarifleri için gövde sonrası parametreleri.

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

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

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

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

Get Route Directions API'si, bir kaynak ile hedef arasında bir yol döndüren ve belirtilirse yol noktalarından geçen bir HTTP GET isteğidir. Rota, geçerli trafik ve istenen haftanın günü ve günün saati üzerindeki tipik yol hızları gibi faktörleri dikkate alır.

Döndürülen bilgiler mesafeyi, tahmini seyahat süresini ve rota geometrisinin bir gösterimini içerir. Seçilen seçeneklere bağlı olarak, iyileştirilmiş yol noktası sırası veya sırayla çevirme yönergeleri gibi ek yönlendirme bilgileri de sağlanır.

Yönlendirme hizmeti, araca özgü tüketim modelinin ayrıntılı açıklaması için bir dizi parametre sağlar. Daha fazla bilgi için bkz. Tüketim Modeli.

Get Route Directions Batch API'si, tek bir istek kullanarak GET API'sine toplu sorgular gönderen bir HTTP isteğidir. zaman uyumsuz (zaman uyumsuz) veya zaman uyumlu (eşitleme) çalıştırmak için Get 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 Toplu İş Sonuçlarını İndirme

Zaman uyumsuz toplu iş sonuçlarını indirmek için toplu indirme uç noktasına bir GET isteği gönderirsiniz. Bu indirme URL'si, başarılı bir Location toplu işleminin POST üst bilgisinden alınabilir 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 dizisi aşağıda verilmiştir:

1. İstemci,indirme URL'sini kullanarak bir isteği gönderir.

2. Sunucu aşağıdakilerden biriyle yanıt verir:

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

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

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

Get Route Directions Batch API'si, tek bir istek kullanarak GET API'sine toplu sorgular gönderen bir HTTP isteğidir. zaman uyumsuz (zaman uyumsuz) veya zaman uyumlu (eşitleme) çalıştırmak için Get 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 Toplu İş Sonuçlarını İndirme

Zaman uyumsuz toplu iş sonuçlarını indirmek için toplu indirme uç noktasına bir GET isteği gönderirsiniz. Bu indirme URL'si, başarılı bir Location toplu işleminin POST üst bilgisinden alınabilir 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 dizisi aşağıda verilmiştir:

1. İstemci,indirme URL'sini kullanarak bir isteği gönderir.

2. Sunucu aşağıdakilerden biriyle yanıt verir:

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

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

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

Get Route Directions API'si, bir kaynak ile hedef arasında bir yol döndüren ve belirtilirse yol noktalarından geçen bir HTTP GET isteğidir. Rota, geçerli trafik ve istenen haftanın günü ve günün saati üzerindeki tipik yol hızları gibi faktörleri dikkate alır.

Döndürülen bilgiler mesafeyi, tahmini seyahat süresini ve rota geometrisinin bir gösterimini içerir. Seçilen seçeneklere bağlı olarak, iyileştirilmiş yol noktası sırası veya sırayla çevirme yönergeleri gibi ek yönlendirme bilgileri de sağlanır.

Yönlendirme hizmeti, araca özgü tüketim modelinin ayrıntılı açıklaması için bir dizi parametre sağlar. Daha fazla bilgi için bkz. Tüketim Modeli.

Post Route Directions API,bir kaynak ile hedef arasında bir yol döndüren ve belirtilirse yol noktalarından geçen bir HTTP POST isteğidir. Rota, istenen haftanın günü ve günün saatinde geçerli trafik ve tipik yol hızları gibi faktörleri hesaba katacaktır.

Döndürülen bilgiler mesafeyi, tahmini seyahat süresini ve rota geometrisinin bir gösterimini içerir. Seçilen seçeneklere bağlı olarak, iyileştirilmiş yol noktası sırası veya sırayla çevirme yönergeleri gibi ek yönlendirme bilgileri de sağlanır.

Yönlendirme hizmeti, araca özgü Tüketim Modelinin ayrıntılı açıklaması için bir dizi parametre sağlar. İlgili kavramların ve parametrelerin ayrıntılı açıklaması için lütfen Tüketim Modeli denetleyin.

Post Route Directions API,bir kaynak ile hedef arasında bir yol döndüren ve belirtilirse yol noktalarından geçen bir HTTP POST isteğidir. Rota, istenen haftanın günü ve günün saatinde geçerli trafik ve tipik yol hızları gibi faktörleri hesaba katacaktır.

Döndürülen bilgiler mesafeyi, tahmini seyahat süresini ve rota geometrisinin bir gösterimini içerir. Seçilen seçeneklere bağlı olarak, iyileştirilmiş yol noktası sırası veya sırayla çevirme yönergeleri gibi ek yönlendirme bilgileri de sağlanır.

Yönlendirme hizmeti, araca özgü Tüketim Modelinin ayrıntılı açıklaması için bir dizi parametre sağlar. İlgili kavramların ve parametrelerin ayrıntılı açıklaması için lütfen Tüketim Modeli denetleyin.

Get Route Matrix API'si, çıkış noktaları ve hedefler listesindeki tüm olası çiftler için seyahat süresini ve mesafeyi hesaplayan bir HTTP GET isteğidir. Ayrıntılı yol yönergeleri sağlayan Yol Tarifleri Alma API'sinden farklı olarak, bu API size her çıkış noktasından her hedefe yönlendirmenin maliyetini (seyahat süresi ve uzaklığı) vererek verimliliğe odaklanır. Daha fazla bilgi için bkz. Azure Haritalar Rota hizmetiiçin en iyi yöntemler.

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. Örneğin, bir gıda teslimat şirketinin 20 sürücüsü olduğunu ve teslimatı restorandan almak için en yakın sürücüyü bulması gerektiğini varsayalım. Bu kullanım örneğini çözmek için Matris Rota API'sini çağırabilir.

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

Zaman uyumsuz istek için matrisin en büyük boyutu 700 ve eşitleme isteği için 100 (hedef sayısıyla çarpılan çıkış noktası sayısı).

Zaman Uyumlu Yol Matrisi İsteği Gönderme

Senaryonuz zaman uyumlu istekler gerektiriyorsa ve matrisin en büyük boyutu 100'den küçük veya buna eşitse, zaman uyumlu istekte bulunmak isteyebilirsiniz. Bu API için matrisin en büyük boyutu 100'dir (çıkış noktası sayısı, hedef sayısıyla çarpılır). Bu kısıtlama göz önünde bulundurularak olası matris boyutlarına örnekler şunlardır: 10x10, 6x8, 9x8 (kare olması gerekmez).

GET 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, büyük hacimli nispeten karmaşık yönlendirme isteklerini işlemek için uygundur. Zaman uyumsuz istek kullanarak istekte bulunduğunuzda, hizmet varsayılan olarak yanıt üst bilgisinin Konum alanında bir yeniden yönlendirme URL'si boyunca bir 202 yanıt kodu döndürür. Yanıt verileri veya hata bilgileri kullanılabilir olana kadar bu URL düzenli aralıklarla denetlenmelidir. İstekteki waitForResults parametresi true olarak ayarlanırsa, istek 120 saniyenin altında biterse kullanıcı 200 yanıt alır.

Bu API için matrisin en büyük boyutu 700'dir (çıkış noktası sayısı, hedef sayısıyla çarpılır). Bu kısıtlama göz önünde bulundurularak olası matris boyutlarına örnekler şunlardır: 50x10, 10x10, 28x25. 10x70 (kare olması gerekmez).

Zaman uyumsuz yanıtlar 24 saat boyunca depolanır. Yeniden yönlendirme URL'si, süre sonundan sonra kullanılırsa bir 404 yanıtı döndürür.

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

Zaman uyumsuz işlemlerin tipik bir dizisi aşağıda verilmiştir:

1. İstemci, Azure Haritalar'a Bir Rota Matrisi GET isteği gönderir

2. Sunucu aşağıdakilerden biriyle yanıt verir:

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

   HTTP Error - Rota Matrisi isteğiniz işlenirken bir hata oluştu. Bu bir 400 Hatalı İstek veya başka bir Hata durum kodu olabilir.

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

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

4. İstemci, sonuçları indirmek için 3. Adımda alınan indirme URL'sinde bir GET isteği gönderir

Eşitleme Sonuçlarını İndir

Rota Matrisi Eşitleme API'sine get isteği gönderdiğinizde, hizmet başarılı istek için 200 yanıt kodu ve bir yanıt dizisi döndürür. Yanıt gövdesi verileri içerir ve sonuçları daha sonra alma imkanı olmayacaktır.

Zaman Uyumsuz Sonuçları İndir

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

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

Konum üst bilgisi tarafından sağlanan URL, bir GET isteği verildiğinde aşağıdaki yanıtları döndürür.

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

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

Get Route Matrix API'si, çıkış noktaları ve hedefler listesindeki tüm olası çiftler için seyahat süresini ve mesafeyi hesaplayan bir HTTP GET isteğidir. Ayrıntılı yol yönergeleri sağlayan Yol Tarifleri Alma API'sinden farklı olarak, bu API size her çıkış noktasından her hedefe yönlendirmenin maliyetini (seyahat süresi ve uzaklığı) vererek verimliliğe odaklanır. Daha fazla bilgi için bkz. Azure Haritalar Rota hizmetiiçin en iyi yöntemler.

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. Örneğin, bir gıda teslimat şirketinin 20 sürücüsü olduğunu ve teslimatı restorandan almak için en yakın sürücüyü bulması gerektiğini varsayalım. Bu kullanım örneğini çözmek için Matris Rota API'sini çağırabilir.

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

Zaman uyumsuz istek için matrisin en büyük boyutu 700 ve eşitleme isteği için 100 (hedef sayısıyla çarpılan çıkış noktası sayısı).

Zaman Uyumlu Yol Matrisi İsteği Gönderme

Senaryonuz zaman uyumlu istekler gerektiriyorsa ve matrisin en büyük boyutu 100'den küçük veya buna eşitse, zaman uyumlu istekte bulunmak isteyebilirsiniz. Bu API için matrisin en büyük boyutu 100'dir (çıkış noktası sayısı, hedef sayısıyla çarpılır). Bu kısıtlama göz önünde bulundurularak olası matris boyutlarına örnekler şunlardır: 10x10, 6x8, 9x8 (kare olması gerekmez).

GET 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, büyük hacimli nispeten karmaşık yönlendirme isteklerini işlemek için uygundur. Zaman uyumsuz istek kullanarak istekte bulunduğunuzda, hizmet varsayılan olarak yanıt üst bilgisinin Konum alanında bir yeniden yönlendirme URL'si boyunca bir 202 yanıt kodu döndürür. Yanıt verileri veya hata bilgileri kullanılabilir olana kadar bu URL düzenli aralıklarla denetlenmelidir. İstekteki waitForResults parametresi true olarak ayarlanırsa, istek 120 saniyenin altında biterse kullanıcı 200 yanıt alır.

Bu API için matrisin en büyük boyutu 700'dir (çıkış noktası sayısı, hedef sayısıyla çarpılır). Bu kısıtlama göz önünde bulundurularak olası matris boyutlarına örnekler şunlardır: 50x10, 10x10, 28x25. 10x70 (kare olması gerekmez).

Zaman uyumsuz yanıtlar 24 saat boyunca depolanır. Yeniden yönlendirme URL'si, süre sonundan sonra kullanılırsa bir 404 yanıtı döndürür.

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

Zaman uyumsuz işlemlerin tipik bir dizisi aşağıda verilmiştir:

1. İstemci, Azure Haritalar'a Bir Rota Matrisi GET isteği gönderir

2. Sunucu aşağıdakilerden biriyle yanıt verir:

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

   HTTP Error - Rota Matrisi isteğiniz işlenirken bir hata oluştu. Bu bir 400 Hatalı İstek veya başka bir Hata durum kodu olabilir.

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

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

4. İstemci, sonuçları indirmek için 3. Adımda alınan indirme URL'sinde bir GET isteği gönderir

Eşitleme Sonuçlarını İndir

Rota Matrisi Eşitleme API'sine get isteği gönderdiğinizde, hizmet başarılı istek için 200 yanıt kodu ve bir yanıt dizisi döndürür. Yanıt gövdesi verileri içerir ve sonuçları daha sonra alma imkanı olmayacaktır.

Zaman Uyumsuz Sonuçları İndir

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

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

Konum üst bilgisi tarafından sağlanan URL, bir GET isteği verildiğinde aşağıdaki yanıtları döndürür.

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

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

Get Route Range (Isochrone) API'si, belirtilen yakıt, enerji, zaman veya mesafe bütçesine göre çıkış noktasından ulaşabileceğiniz konum kümesini hesaplayan bir HTTP GET isteğidir. Çokgen sınır (veya Isochrone) saat yönünün tersine ve çıkış noktasının sonucu olan kesin poligon merkezinde döndürülür.

Döndürülen çokgen, sağlanan isochrone içindeki POI'leri aramak için geometri gibi daha fazla işlem için kullanılabilir.

Get Route Range (Isochrone) API'si, belirtilen yakıt, enerji, zaman veya mesafe bütçesine göre çıkış noktasından ulaşabileceğiniz konum kümesini hesaplayan bir HTTP GET isteğidir. Çokgen sınır (veya Isochrone) saat yönünün tersine ve çıkış noktasının sonucu olan kesin poligon merkezinde döndürülür.

Döndürülen çokgen, sağlanan isochrone içindeki POI'leri aramak için geometri gibi daha fazla işlem için kullanılabilir.

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

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.

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

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.

Matris sonuç nesnesi

Koordinat matrisi olan bir nesne.

Bu nesne başarılı bir Yol Matrisi çağrısından döndürülür. Örneğin, 2 çıkış noktası ve 3 hedef sağlanmışsa, her birinde 3 öğe bulunan 2 dizi vardır. Her öğenin içeriği sorguda sağlanan seçeneklere bağlıdır.

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

Özet nesnesi

İyileştirilmiş yol noktası nesnesi.

Ulaşılabilir Aralık

Bu nesne başarılı bir Route Reachable Range çağrısından döndürülür

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

Post Route Directions Batch API,tek bir zaman uyumsuz 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 uyumlu bir istekte Post Route Directions Batch API'sini çağırmak için bkz. Yol Tarifleri Sonrası Batch Eşitleme.

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

Zaman Uyumsuz API, büyük hacimli nispeten karmaşık rota isteklerini işlemek için uygundur

• Sonuçların ayrı bir çağrıda alınmasına izin verir (birden çok indirme mümkündür).
• Zaman uyumsuz API güvenilirlik için iyileştirilmiştir ve zaman aşımıyla karşılaşılmaması beklenmemektedir.
• Toplu iş öğelerinin sayısı, bu API için 700 ile sınırlıdır.

Zaman uyumsuz istek kullanarak istekte bulunduğunuzda, hizmet varsayılan olarak yanıt üst bilgisinin Konum alanında bir yeniden yönlendirme URL'si boyunca bir 202 yanıt kodu döndürür. Yanıt verileri veya hata bilgileri kullanılabilir olana kadar bu URL düzenli aralıklarla denetlenmelidir. Zaman uyumsuz yanıtlar 24 saat boyunca depolanır. Yeniden yönlendirme URL'si, süre sonundan sonra kullanılırsa bir 404 yanıtı döndürür.

Zaman uyumsuz toplu iş isteğinin uzun süre çalışan bir işlem olduğunu lütfen unutmayın. Aşağıda tipik bir işlem dizisi verilmiştir:

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

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

2. Sunucu aşağıdakilerden biriyle yanıt verir:

   HTTP 202 Accepted - Toplu iş isteği kabul edildi.

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

3. Toplu iş isteği başarıyla kabul edildiyse, yanıttaki Location üst bilgisi toplu iş isteğinin sonuçlarını indirme URL'sini içerir. Bu durum URI'si aşağıdaki gibi görünür:

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

4. İstemci, toplu iş sonuçlarını indirmek için 3. Adımda elde edilen GET bir isteği gönderir.

Toplu İstek için POST Gövdesi

yol tariflerini sorgular göndermek için, istek gövdesinin POST dizisini batchItems biçimde içereceği ve json üst bilgisinin Content-Typeolarak ayarlanacağı bir application/json isteği kullanırsınız. Sorgular 3 yol tarifi içeren örnek bir istek gövdesi aşağıda verilmiştir:

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

Bir toplu işte sorgu yol tarifleri, protokol, temel URL, yol, api sürümü ve abonelik anahtarı olmadan yalnızca kısmi bir URL . URI parametreleridesteklenen yol yönlerinden herhangi birini kabul edebilir. yol tarifleri sorgudaki dize değerleri düzgün bir şekilde kaçılmalıdır (örneğin , " karakteri \ ile kaçış karakteri) ve ayrıca düzgün URL ile kodlanmış olmalıdır.

Zaman uyumsuz API, çağıranın en fazla 700 sorguyu toplu işlemesine ve API'yi en fazla 100 sorgu eşitlemesine olanak tanır ve toplu işlem en az 1 sorgu içermelidir.

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

Zaman uyumsuz toplu iş sonuçlarını indirmek için toplu indirme uç noktasına bir GET isteği gönderirsiniz. Bu indirme URL'si, başarılı bir Location toplu işleminin POST üst bilgisinden alınabilir 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 dizisi aşağıda verilmiştir:

1. İstemci,indirme URL'sini kullanarak bir isteği gönderir.

2. Sunucu aşağıdakilerden biriyle yanıt verir:

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

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

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 Route Directions Batch API,tek bir zaman uyumsuz 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 uyumlu bir istekte Post Route Directions Batch API'sini çağırmak için bkz. Yol Tarifleri Sonrası Batch Eşitleme.

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

Zaman Uyumsuz API, büyük hacimli nispeten karmaşık rota isteklerini işlemek için uygundur

• Sonuçların ayrı bir çağrıda alınmasına izin verir (birden çok indirme mümkündür).
• Zaman uyumsuz API güvenilirlik için iyileştirilmiştir ve zaman aşımıyla karşılaşılmaması beklenmemektedir.
• Toplu iş öğelerinin sayısı, bu API için 700 ile sınırlıdır.

Zaman uyumsuz istek kullanarak istekte bulunduğunuzda, hizmet varsayılan olarak yanıt üst bilgisinin Konum alanında bir yeniden yönlendirme URL'si boyunca bir 202 yanıt kodu döndürür. Yanıt verileri veya hata bilgileri kullanılabilir olana kadar bu URL düzenli aralıklarla denetlenmelidir. Zaman uyumsuz yanıtlar 24 saat boyunca depolanır. Yeniden yönlendirme URL'si, süre sonundan sonra kullanılırsa bir 404 yanıtı döndürür.

Zaman uyumsuz toplu iş isteğinin uzun süre çalışan bir işlem olduğunu lütfen unutmayın. Aşağıda tipik bir işlem dizisi verilmiştir:

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

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

2. Sunucu aşağıdakilerden biriyle yanıt verir:

   HTTP 202 Accepted - Toplu iş isteği kabul edildi.

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

3. Toplu iş isteği başarıyla kabul edildiyse, yanıttaki Location üst bilgisi toplu iş isteğinin sonuçlarını indirme URL'sini içerir. Bu durum URI'si aşağıdaki gibi görünür:

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

4. İstemci, toplu iş sonuçlarını indirmek için 3. Adımda elde edilen GET bir isteği gönderir.

Toplu İstek için POST Gövdesi

yol tariflerini sorgular göndermek için, istek gövdesinin POST dizisini batchItems biçimde içereceği ve json üst bilgisinin Content-Typeolarak ayarlanacağı bir application/json isteği kullanırsınız. Sorgular 3 yol tarifi içeren örnek bir istek gövdesi aşağıda verilmiştir:

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

Bir toplu işte sorgu yol tarifleri, protokol, temel URL, yol, api sürümü ve abonelik anahtarı olmadan yalnızca kısmi bir URL . URI parametreleridesteklenen yol yönlerinden herhangi birini kabul edebilir. yol tarifleri sorgudaki dize değerleri düzgün bir şekilde kaçılmalıdır (örneğin , " karakteri \ ile kaçış karakteri) ve ayrıca düzgün URL ile kodlanmış olmalıdır.

Zaman uyumsuz API, çağıranın en fazla 700 sorguyu toplu işlemesine ve API'yi en fazla 100 sorgu eşitlemesine olanak tanır ve toplu işlem en az 1 sorgu içermelidir.

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

Zaman uyumsuz toplu iş sonuçlarını indirmek için toplu indirme uç noktasına bir GET isteği gönderirsiniz. Bu indirme URL'si, başarılı bir Location toplu işleminin POST üst bilgisinden alınabilir 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 dizisi aşağıda verilmiştir:

1. İstemci,indirme URL'sini kullanarak bir isteği gönderir.

2. Sunucu aşağıdakilerden biriyle yanıt verir:

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

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

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 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 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 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 Route Matrix API,zaman uyumsuz (zaman uyumsuz) bir istek kullanarak kaynak ve hedef konumlar tarafından tanımlanan bir yol kümesi için yol özetleri matrisinin hesaplanmasını sağlayan bir HTTP POST isteğidir. Zaman uyumlu (eşitleme) isteğinde bulunmak için bkz. Yönlendirme Sonrası Matris Eşitleme. 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. Örneğin, bir gıda teslimat şirketinin 20 sürücüsü olduğunu ve teslimatı restorandan almak için en yakın sürücüyü bulması gerektiğini varsayalım. Bu kullanım örneğini çözmek için Matris Rota API'sini çağırabilir.

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

Zaman uyumsuz istek için matrisin en büyük boyutu 700 ve eşitleme isteği için 100 (hedef sayısıyla çarpılan çıkış noktası sayısı).

Zaman Uyumlu Yol Matrisi İsteği Gönderme

Senaryonuz zaman uyumlu istekler gerektiriyorsa ve matrisin en büyük boyutu 100'den küçük veya buna eşitse, zaman uyumlu istekte bulunmak isteyebilirsiniz. Bu API için matrisin en büyük boyutu 100'dir (çıkış noktası sayısı, hedef sayısıyla çarpılır). Bu kısıtlama göz önünde bulundurularak olası matris boyutlarına örnekler şunlardır: 10x10, 6x8, 9x8 (kare olması gerekmez).

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

Zaman Uyumsuz Yol Matrisi İsteği Gönderme

Zaman Uyumsuz API, büyük hacimli nispeten karmaşık yönlendirme isteklerini işlemek için uygundur. Zaman uyumsuz istek kullanarak istekte bulunduğunuzda, hizmet varsayılan olarak yanıt üst bilgisinin Konum alanında bir yeniden yönlendirme URL'si boyunca bir 202 yanıt kodu döndürür. Yanıt verileri veya hata bilgileri kullanılabilir olana kadar bu URL düzenli aralıklarla denetlenmelidir. İstekteki waitForResults parametresi true olarak ayarlanırsa, istek 120 saniyenin altında biterse kullanıcı 200 yanıt alır.

Bu API için matrisin en büyük boyutu 700'dir (çıkış noktası sayısı, hedef sayısıyla çarpılır). Bu kısıtlama göz önünde bulundurularak olası matris boyutlarına örnekler şunlardır: 50x10, 10x10, 28x25. 10x70 (kare olması gerekmez).

Zaman uyumsuz yanıtlar 24 saat boyunca depolanır. Yeniden yönlendirme URL'si, süre sonundan sonra kullanılırsa bir 404 yanıtı döndürür.

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

Zaman uyumsuz işlemlerin tipik bir dizisi aşağıda verilmiştir:

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

2. Sunucu aşağıdakilerden biriyle yanıt verir:

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

   HTTP Error - Rota Matrisi isteğiniz işlenirken bir hata oluştu. Bu bir 400 Hatalı İstek veya başka bir Hata durum kodu olabilir.

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

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

4. İstemci, sonuçları indirmek için 3. Adımda alınan indirme URL'sinde bir GET isteği gönderir

Eşitleme Sonuçlarını İndir

Rota Matrisi Eşitleme API'si için post isteği yaptığınızda, hizmet başarılı istek için 200 yanıt kodu ve bir yanıt dizisi döndürür. Yanıt gövdesi verileri içerir ve sonuçları daha sonra alma imkanı olmayacaktır.

Zaman Uyumsuz Sonuçları İndir

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

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

Konum üst bilgisi tarafından sağlanan URL, bir GET isteği verildiğinde aşağıdaki yanıtları döndürür.

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

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

Post Route Matrix API,zaman uyumsuz (zaman uyumsuz) bir istek kullanarak kaynak ve hedef konumlar tarafından tanımlanan bir yol kümesi için yol özetleri matrisinin hesaplanmasını sağlayan bir HTTP POST isteğidir. Zaman uyumlu (eşitleme) isteğinde bulunmak için bkz. Yönlendirme Sonrası Matris Eşitleme. 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. Örneğin, bir gıda teslimat şirketinin 20 sürücüsü olduğunu ve teslimatı restorandan almak için en yakın sürücüyü bulması gerektiğini varsayalım. Bu kullanım örneğini çözmek için Matris Rota API'sini çağırabilir.

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

Zaman uyumsuz istek için matrisin en büyük boyutu 700 ve eşitleme isteği için 100 (hedef sayısıyla çarpılan çıkış noktası sayısı).

Zaman Uyumlu Yol Matrisi İsteği Gönderme

Senaryonuz zaman uyumlu istekler gerektiriyorsa ve matrisin en büyük boyutu 100'den küçük veya buna eşitse, zaman uyumlu istekte bulunmak isteyebilirsiniz. Bu API için matrisin en büyük boyutu 100'dir (çıkış noktası sayısı, hedef sayısıyla çarpılır). Bu kısıtlama göz önünde bulundurularak olası matris boyutlarına örnekler şunlardır: 10x10, 6x8, 9x8 (kare olması gerekmez).

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

Zaman Uyumsuz Yol Matrisi İsteği Gönderme

Zaman Uyumsuz API, büyük hacimli nispeten karmaşık yönlendirme isteklerini işlemek için uygundur. Zaman uyumsuz istek kullanarak istekte bulunduğunuzda, hizmet varsayılan olarak yanıt üst bilgisinin Konum alanında bir yeniden yönlendirme URL'si boyunca bir 202 yanıt kodu döndürür. Yanıt verileri veya hata bilgileri kullanılabilir olana kadar bu URL düzenli aralıklarla denetlenmelidir. İstekteki waitForResults parametresi true olarak ayarlanırsa, istek 120 saniyenin altında biterse kullanıcı 200 yanıt alır.

Bu API için matrisin en büyük boyutu 700'dir (çıkış noktası sayısı, hedef sayısıyla çarpılır). Bu kısıtlama göz önünde bulundurularak olası matris boyutlarına örnekler şunlardır: 50x10, 10x10, 28x25. 10x70 (kare olması gerekmez).

Zaman uyumsuz yanıtlar 24 saat boyunca depolanır. Yeniden yönlendirme URL'si, süre sonundan sonra kullanılırsa bir 404 yanıtı döndürür.

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

Zaman uyumsuz işlemlerin tipik bir dizisi aşağıda verilmiştir:

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

2. Sunucu aşağıdakilerden biriyle yanıt verir:

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

   HTTP Error - Rota Matrisi isteğiniz işlenirken bir hata oluştu. Bu bir 400 Hatalı İstek veya başka bir Hata durum kodu olabilir.

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

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

4. İstemci, sonuçları indirmek için 3. Adımda alınan indirme URL'sinde bir GET isteği gönderir

Eşitleme Sonuçlarını İndir

Rota Matrisi Eşitleme API'si için post isteği yaptığınızda, hizmet başarılı istek için 200 yanıt kodu ve bir yanıt dizisi döndürür. Yanıt gövdesi verileri içerir ve sonuçları daha sonra alma imkanı olmayacaktır.

Zaman Uyumsuz Sonuçları İndir

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

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

Konum üst bilgisi tarafından sağlanan URL, bir GET isteği verildiğinde aşağıdaki yanıtları döndürür.

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

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

Post Route Matrix Sync API,tek bir zaman uyumlu (eşitleme) isteği kullanarak kaynak ve hedef konumlar tarafından tanımlanan bir yol kümesi için yol özetleri matrisinin hesaplanmasını sağlayan bir HTTP POST isteğidir. Zaman uyumsuz (zaman uyumsuz) istekte bulunmak için bkz. Yol Sonrası Matris. Hizmet, 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. Örneğin, bir gıda teslimat şirketinin 20 sürücüsü olduğunu ve teslimatı restorandan almak için en yakın sürücüyü bulması gerektiğini varsayalım. Bu kullanım örneğini çözmek için Matris Rota API'sini çağırabilir.

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

Zaman uyumsuz istek için matrisin en büyük boyutu 700 ve eşitleme isteği için 100 (hedef sayısıyla çarpılan çıkış noktası sayısı).

Zaman Uyumlu Yol Matrisi İsteği Gönderme

Senaryonuz zaman uyumlu istekler gerektiriyorsa ve matrisin en büyük boyutu 100'den küçük veya buna eşitse, zaman uyumlu istekte bulunmak isteyebilirsiniz. Bu API için matrisin en büyük boyutu 100'dir (çıkış noktası sayısı, hedef sayısıyla çarpılır). Bu kısıtlama göz önünde bulundurularak olası matris boyutlarına örnekler şunlardır: 10x10, 6x8, 9x8 (kare olması gerekmez).

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

Zaman Uyumsuz Yol Matrisi İsteği Gönderme

Zaman Uyumsuz API, büyük hacimli nispeten karmaşık yönlendirme isteklerini işlemek için uygundur. Zaman uyumsuz istek kullanarak istekte bulunduğunuzda, hizmet varsayılan olarak yanıt üst bilgisinin Konum alanında bir yeniden yönlendirme URL'si boyunca bir 202 yanıt kodu döndürür. Yanıt verileri veya hata bilgileri kullanılabilir olana kadar bu URL düzenli aralıklarla denetlenmelidir. İstekteki waitForResults parametresi true olarak ayarlanırsa, istek 120 saniyenin altında biterse kullanıcı 200 yanıt alır.

Bu API için matrisin en büyük boyutu 700'dir (çıkış noktası sayısı, hedef sayısıyla çarpılır). Bu kısıtlama göz önünde bulundurularak olası matris boyutlarına örnekler şunlardır: 50x10, 10x10, 28x25. 10x70 (kare olması gerekmez).

Zaman uyumsuz yanıtlar 24 saat boyunca depolanır. Yeniden yönlendirme URL'si, süre sonundan sonra kullanılırsa bir 404 yanıtı döndürür.

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

Zaman uyumsuz işlemlerin tipik bir dizisi aşağıda verilmiştir:

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

2. Sunucu aşağıdakilerden biriyle yanıt verir:

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

   HTTP Error - Rota Matrisi isteğiniz işlenirken bir hata oluştu. Bu bir 400 Hatalı İstek veya başka bir Hata durum kodu olabilir.

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

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

4. İstemci, sonuçları indirmek için 3. Adımda alınan indirme URL'sinde bir GET isteği gönderir

Eşitleme Sonuçlarını İndir

Rota Matrisi Eşitleme API'si için post isteği yaptığınızda, hizmet başarılı istek için 200 yanıt kodu ve bir yanıt dizisi döndürür. Yanıt gövdesi verileri içerir ve sonuçları daha sonra alma imkanı olmayacaktır.

Zaman Uyumsuz Sonuçları İndir

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

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

Konum üst bilgisi tarafından sağlanan URL, bir GET isteği verildiğinde aşağıdaki yanıtları döndürür.

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

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

Post Route Matrix Sync API,tek bir zaman uyumlu (eşitleme) isteği kullanarak kaynak ve hedef konumlar tarafından tanımlanan bir yol kümesi için yol özetleri matrisinin hesaplanmasını sağlayan bir HTTP POST isteğidir. Zaman uyumsuz (zaman uyumsuz) istekte bulunmak için bkz. Yol Sonrası Matris. Hizmet, 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. Örneğin, bir gıda teslimat şirketinin 20 sürücüsü olduğunu ve teslimatı restorandan almak için en yakın sürücüyü bulması gerektiğini varsayalım. Bu kullanım örneğini çözmek için Matris Rota API'sini çağırabilir.

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

Zaman uyumsuz istek için matrisin en büyük boyutu 700 ve eşitleme isteği için 100 (hedef sayısıyla çarpılan çıkış noktası sayısı).

Zaman Uyumlu Yol Matrisi İsteği Gönderme

Senaryonuz zaman uyumlu istekler gerektiriyorsa ve matrisin en büyük boyutu 100'den küçük veya buna eşitse, zaman uyumlu istekte bulunmak isteyebilirsiniz. Bu API için matrisin en büyük boyutu 100'dir (çıkış noktası sayısı, hedef sayısıyla çarpılır). Bu kısıtlama göz önünde bulundurularak olası matris boyutlarına örnekler şunlardır: 10x10, 6x8, 9x8 (kare olması gerekmez).

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

Zaman Uyumsuz Yol Matrisi İsteği Gönderme

Zaman Uyumsuz API, büyük hacimli nispeten karmaşık yönlendirme isteklerini işlemek için uygundur. Zaman uyumsuz istek kullanarak istekte bulunduğunuzda, hizmet varsayılan olarak yanıt üst bilgisinin Konum alanında bir yeniden yönlendirme URL'si boyunca bir 202 yanıt kodu döndürür. Yanıt verileri veya hata bilgileri kullanılabilir olana kadar bu URL düzenli aralıklarla denetlenmelidir. İstekteki waitForResults parametresi true olarak ayarlanırsa, istek 120 saniyenin altında biterse kullanıcı 200 yanıt alır.

Bu API için matrisin en büyük boyutu 700'dir (çıkış noktası sayısı, hedef sayısıyla çarpılır). Bu kısıtlama göz önünde bulundurularak olası matris boyutlarına örnekler şunlardır: 50x10, 10x10, 28x25. 10x70 (kare olması gerekmez).

Zaman uyumsuz yanıtlar 24 saat boyunca depolanır. Yeniden yönlendirme URL'si, süre sonundan sonra kullanılırsa bir 404 yanıtı döndürür.

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

Zaman uyumsuz işlemlerin tipik bir dizisi aşağıda verilmiştir:

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

2. Sunucu aşağıdakilerden biriyle yanıt verir:

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

   HTTP Error - Rota Matrisi isteğiniz işlenirken bir hata oluştu. Bu bir 400 Hatalı İstek veya başka bir Hata durum kodu olabilir.

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

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

4. İstemci, sonuçları indirmek için 3. Adımda alınan indirme URL'sinde bir GET isteği gönderir

Eşitleme Sonuçlarını İndir

Rota Matrisi Eşitleme API'si için post isteği yaptığınızda, hizmet başarılı istek için 200 yanıt kodu ve bir yanıt dizisi döndürür. Yanıt gövdesi verileri içerir ve sonuçları daha sonra alma imkanı olmayacaktır.

Zaman Uyumsuz Sonuçları İndir

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

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

Konum üst bilgisi tarafından sağlanan URL, bir GET isteği verildiğinde aşağıdaki yanıtları döndürür.

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

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

Post Route Matrix Sync API,tek bir zaman uyumlu (eşitleme) isteği kullanarak kaynak ve hedef konumlar tarafından tanımlanan bir yol kümesi için yol özetleri matrisinin hesaplanmasını sağlayan bir HTTP POST isteğidir. Zaman uyumsuz (zaman uyumsuz) istekte bulunmak için bkz. Yol Sonrası Matris. Hizmet, 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. Örneğin, bir gıda teslimat şirketinin 20 sürücüsü olduğunu ve teslimatı restorandan almak için en yakın sürücüyü bulması gerektiğini varsayalım. Bu kullanım örneğini çözmek için Matris Rota API'sini çağırabilir.

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

Zaman uyumsuz istek için matrisin en büyük boyutu 700 ve eşitleme isteği için 100 (hedef sayısıyla çarpılan çıkış noktası sayısı).

Zaman Uyumlu Yol Matrisi İsteği Gönderme

Senaryonuz zaman uyumlu istekler gerektiriyorsa ve matrisin en büyük boyutu 100'den küçük veya buna eşitse, zaman uyumlu istekte bulunmak isteyebilirsiniz. Bu API için matrisin en büyük boyutu 100'dir (çıkış noktası sayısı, hedef sayısıyla çarpılır). Bu kısıtlama göz önünde bulundurularak olası matris boyutlarına örnekler şunlardır: 10x10, 6x8, 9x8 (kare olması gerekmez).

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

Zaman Uyumsuz Yol Matrisi İsteği Gönderme

Zaman Uyumsuz API, büyük hacimli nispeten karmaşık yönlendirme isteklerini işlemek için uygundur. Zaman uyumsuz istek kullanarak istekte bulunduğunuzda, hizmet varsayılan olarak yanıt üst bilgisinin Konum alanında bir yeniden yönlendirme URL'si boyunca bir 202 yanıt kodu döndürür. Yanıt verileri veya hata bilgileri kullanılabilir olana kadar bu URL düzenli aralıklarla denetlenmelidir. İstekteki waitForResults parametresi true olarak ayarlanırsa, istek 120 saniyenin altında biterse kullanıcı 200 yanıt alır.

Bu API için matrisin en büyük boyutu 700'dir (çıkış noktası sayısı, hedef sayısıyla çarpılır). Bu kısıtlama göz önünde bulundurularak olası matris boyutlarına örnekler şunlardır: 50x10, 10x10, 28x25. 10x70 (kare olması gerekmez).

Zaman uyumsuz yanıtlar 24 saat boyunca depolanır. Yeniden yönlendirme URL'si, süre sonundan sonra kullanılırsa bir 404 yanıtı döndürür.

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

Zaman uyumsuz işlemlerin tipik bir dizisi aşağıda verilmiştir:

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

2. Sunucu aşağıdakilerden biriyle yanıt verir:

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

   HTTP Error - Rota Matrisi isteğiniz işlenirken bir hata oluştu. Bu bir 400 Hatalı İstek veya başka bir Hata durum kodu olabilir.

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

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

4. İstemci, sonuçları indirmek için 3. Adımda alınan indirme URL'sinde bir GET isteği gönderir

Eşitleme Sonuçlarını İndir

Rota Matrisi Eşitleme API'si için post isteği yaptığınızda, hizmet başarılı istek için 200 yanıt kodu ve bir yanıt dizisi döndürür. Yanıt gövdesi verileri içerir ve sonuçları daha sonra alma imkanı olmayacaktır.

Zaman Uyumsuz Sonuçları İndir

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

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

Konum üst bilgisi tarafından sağlanan URL, bir GET isteği verildiğinde aşağıdaki yanıtları döndürür.

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

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

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

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

TPEG2-TEC standardındaki tanımları kullanarak trafik olayının ayrıntıları. effectCode içerebilir ve öğelere neden olabilir.

Özet nesnesi

Uzun süre çalışan bir işlemi yoklamada kullanılabilecek basit bir poller.

Geçerli bir GeoJSON geometri nesnesi. Tür yedi geçerli GeoJSON geometri türünden biri olmalıdır: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon ve GeometryCollection. Ayrıntılar için lütfen RFC 7946 bakın.

Geçerli bir GeoJSON nesnesi. Ayrıntılar için lütfen RFC 7946 bakın.

Bir grup yol yönü isteğinin toplu istek gövdesini oluşturun.

Bir abonelik anahtarından HaritalarRouteClient örneği oluşturur.

Örnek

import { AzureKeyCredential } from "@azure/core-auth";
import MapsRoute from "@azure-rest/maps-route";

const credential = new AzureKeyCredential("<subscription-key>");
const client = MapsRoute(credential);

Bir Azure Identity TokenCredential'nden MapsRoute örneği oluşturur.

Örnek

import { DefaultAzureCredential } from "@azure/identity";
import MapsRoute from "@azure-rest/maps-route";

const credential = new DefaultAzureCredential();
const client = MapsRoute(credential, "<maps-account-client-id>");

Bir Azure Identity AzureSASCredential'nden MapsRoute örneği oluşturur.

Örnek

import { AzureSASCredential } from "@azure/core-auth";
import MapsRoute from "@azure-rest/maps-route";

const credential = new AzureSASCredential("<SAS Token>");
const client = MapsRoute(credential);

Uzun süre çalışan bir işlemin yoklamasına yardımcı olmak için bir Poller nesnesi oluşturan yardımcı işlev.

[Latitude, Longtitute] dizisini şu biçimde bir dizeye dönüştürün: "Latitude_1,Longtitute_1:Latitude_2,Longtitute_2:..."