RequestRouteMatrix interface

Paket:
@azure-rest/maps-route

Yöntemler

get(RequestParameters)

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}
  1. İ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.
post(RouteRequestRouteMatrixParameters)

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

Not

Tüm çıkış noktaları ve hedefler eksene hizalanmış 400 km x 400 km sınırlayıcı kutuda bulunmalıdır. Aksi takdirde bazı matris hücreleri OUT_OF_REGION olarak çözümlenir.

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}
  1. İ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.

Yöntem Ayrıntıları

get(RequestParameters)

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}
  1. İ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.

function get(options?: RequestParameters): StreamableMethod<RouteGetRouteMatrix200Response | RouteGetRouteMatrix202Response>

Parametreler

options
RequestParameters

Döndürülenler

StreamableMethod<RouteGetRouteMatrix200Response | RouteGetRouteMatrix202Response>

post(RouteRequestRouteMatrixParameters)

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

Not

Tüm çıkış noktaları ve hedefler eksene hizalanmış 400 km x 400 km sınırlayıcı kutuda bulunmalıdır. Aksi takdirde bazı matris hücreleri OUT_OF_REGION olarak çözümlenir.

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}
  1. İ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.

function post(options: RouteRequestRouteMatrixParameters): StreamableMethod<RouteRequestRouteMatrix200Response | RouteRequestRouteMatrix202Response>

Parametreler

options
RouteRequestRouteMatrixParameters

Döndürülenler

StreamableMethod<RouteRequestRouteMatrix200Response | RouteRequestRouteMatrix202Response>