RouteURL class
RouteURL, Azure Haritalar yol işlemlerinin URL'sini temsil eder.
- Extends
Oluşturucular
RouteURL(Pipeline, string) | RouteURL örneği oluşturur. |
Devralınan Özellikler
maps |
Temel URL dize değeri. |
Yöntemler
calculate |
Bir kaynak ile hedef arasında, belirtilmişse yol noktalarından geçen bir yol döndürür. Rota, geçerli trafik ve istenen haftanın günü ve günün saati üzerindeki tipik yol hızları gibi faktörleri dikkate alacaktı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 Modeli'nin 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'ne bakın. belirtilirse Aksi takdirde Yol Tariflerini Al API'sini kullanır: https://docs.microsoft.com/rest/api/maps/route/getroutedirections |
calculate |
Not: Bu API şu anda önizleme aşamasındadır ve hataya neden olan değişikliklere tabi olabilir. Kaynak ve hedef konumlar tarafından tanımlanan bir yol kümesi için yol özetlerinin matrisini hesaplar. Bu hizmet, verilen her kaynak için söz konusu 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. Her rota için seyahat süreleri ve mesafeler hesaplanır. Yönlendirme Yönergeleri API'sini kullanarak hangi yolların hesapleneceğini belirlemek için hesaplanan maliyetleri kullanabilirsiniz. İstekteki waitForResults parametresi false (varsayılan değer) olarak ayarlanırsa, bu API yanıt üst bilgisinin Konum alanında yeniden yönlendirme URL'si boyunca bir 202 yanıt kodu döndürür. Yanıt verileri veya hata bilgileri sağlanana kadar bu URL düzenli aralıklarla denetlenmelidir. Bu API için matrisin en büyük boyutu 700'dür (çı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). Rota matrisi hesaplamak uzun süre çalışan bir işlem olarak kabul edilir. Uzun süre çalışan işlemler, ilk istek kabul edildikten (HTTP 202) sonra nihai sonucun kullanılabilir olana kadar yoklanması anlamına gelir. Her yoklama isteği, belirtildiyse iptal edenin zaman aşımını yeniden başlatır. Rota Sonrası Matris API'sini kullanır: https://docs.microsoft.com/rest/api/maps/route/postroutematrixpreview |
calculate |
Belirtilen yakıt, enerji veya zaman bütçesine göre çıkış noktasından ulaşabileceğiniz konum kümesini hesaplayın. Çokgen bir sınır (veya Isochrone) saat yönünün tersine ve çıkış noktasının sonucu olan kesin çokgen merkezine döndürülür. Döndürülen çokgen, sağlanan Isochrone içindeki POI'leri aramak için İç Geometri Arama gibi daha fazla işlem için kullanılabilir. Yol Aralığını Al API'sini kullanır: https://docs.microsoft.com/rest/api/maps/route/getrouterange |
Devralınan Yöntemler
new |
Kimlik bilgileri sağlanmış yeni bir İşlem Hattı nesnesi oluşturmak için kullanılan statik bir yöntem. |
Oluşturucu Ayrıntıları
RouteURL(Pipeline, string)
RouteURL örneği oluşturur.
new RouteURL(pipeline: Pipeline, mapsUrl?: string)
Parametreler
- pipeline
- Pipeline
Varsayılan işlem hattı oluşturmak veya özelleştirilmiş bir işlem hattı sağlamak için MapsURL.newPipeline() çağrısı yapın.
- mapsUrl
-
string
varsayılan olarak Azure Haritalar hizmetine işaret eden bir URL dizesidir"https://atlas.microsoft.com"
.
Herhangi bir protokol belirtilmezse (örneğin "atlas.microsoft.com"
, ) https
varsayılır.
Devralınan Özellik Detayları
mapsUrl
Yöntem Ayrıntıları
calculateRouteDirections(Aborter, GeoJSON.Position[], CalculateRouteDirectionsOptions)
Bir kaynak ile hedef arasında, belirtilmişse yol noktalarından geçen bir yol döndürür. Rota, geçerli trafik ve istenen haftanın günü ve günün saati üzerindeki tipik yol hızları gibi faktörleri dikkate alacaktı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 Modeli'nin 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'ne bakın.
belirtilirse options.postBody
Yol Tarifleri Sonrası API'sini kullanır: https://docs.microsoft.com/rest/api/maps/route/postroutedirections
Aksi takdirde Yol Tariflerini Al API'sini kullanır: https://docs.microsoft.com/rest/api/maps/route/getroutedirections
function calculateRouteDirections(aborter: Aborter, coordinates: GeoJSON.Position[], options?: CalculateRouteDirectionsOptions): Promise<CalculateRouteDirectionsResponse>
Parametreler
- aborter
- Aborter
İstek iptali hakkında daha fazla örnek için Aborter.none veya Aborter.timeout() ile yeni bir Aborter örneği oluşturun.
- coordinates
-
GeoJSON.Position[]
Rotanın hesaplandığı koordinat dizisi.
Her koordinat bir dizisidir [longitude, latitude]
. En az iki koordinat gerekir.
İlki çıkış noktası, sonuncusu ise yolun hedefidir.
aralarındaki isteğe bağlı koordinatlar, rotada WayPoint olarak hareket eder. En fazla 150 WayPoint geçirebilirsiniz.
- options
- CalculateRouteDirectionsOptions
Döndürülenler
Promise<CalculateRouteDirectionsResponse>
calculateRouteMatrix(Aborter, CalculateRouteMatrixRequestBody, CalculateRouteMatrixOptions)
Not: Bu API şu anda önizleme aşamasındadır ve hataya neden olan değişikliklere tabi olabilir. Kaynak ve hedef konumlar tarafından tanımlanan bir yol kümesi için yol özetlerinin matrisini hesaplar. Bu hizmet, verilen her kaynak için söz konusu 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. Her rota için seyahat süreleri ve mesafeler hesaplanır. Yönlendirme Yönergeleri API'sini kullanarak hangi yolların hesapleneceğini belirlemek için hesaplanan maliyetleri kullanabilirsiniz. İstekteki waitForResults parametresi false (varsayılan değer) olarak ayarlanırsa, bu API yanıt üst bilgisinin Konum alanında yeniden yönlendirme URL'si boyunca bir 202 yanıt kodu döndürür. Yanıt verileri veya hata bilgileri sağlanana kadar bu URL düzenli aralıklarla denetlenmelidir. Bu API için matrisin en büyük boyutu 700'dür (çı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).
Rota matrisi hesaplamak uzun süre çalışan bir işlem olarak kabul edilir. Uzun süre çalışan işlemler, ilk istek kabul edildikten (HTTP 202) sonra nihai sonucun kullanılabilir olana kadar yoklanması anlamına gelir. Her yoklama isteği, belirtildiyse iptal edenin zaman aşımını yeniden başlatır.
Rota Sonrası Matris API'sini kullanır: https://docs.microsoft.com/rest/api/maps/route/postroutematrixpreview
function calculateRouteMatrix(aborter: Aborter, body: CalculateRouteMatrixRequestBody, options?: CalculateRouteMatrixOptions): Promise<CalculateRouteMatrixResponse>
Parametreler
- aborter
- Aborter
İstek iptali hakkında daha fazla örnek için Aborter.none veya Aborter.timeout() ile yeni bir Aborter örneği oluşturun.
Giriş parametrelerine göre matrisin her hücresi için rota uzaklığı, seyahat süresi ve diğer özeti hesaplamak için çıkış ve hedef koordinatlarının matrisi. Desteklenen en düşük ve en fazla hücre sayısı sırasıyla 1 ve 700'tür. Örneğin, 35 kaynak ve 20 hedef ya da 25 çıkış noktası ve 25 hedef olabilir.
- options
- CalculateRouteMatrixOptions
Döndürülenler
Promise<CalculateRouteMatrixResponse>
calculateRouteRange(Aborter, GeoJSON.Position, CalculateRouteRangeOptions)
Belirtilen yakıt, enerji veya zaman bütçesine göre çıkış noktasından ulaşabileceğiniz konum kümesini hesaplayın. Çokgen bir sınır (veya Isochrone) saat yönünün tersine ve çıkış noktasının sonucu olan kesin çokgen merkezine döndürülür. Döndürülen çokgen, sağlanan Isochrone içindeki POI'leri aramak için İç Geometri Arama gibi daha fazla işlem için kullanılabilir.
Yol Aralığını Al API'sini kullanır: https://docs.microsoft.com/rest/api/maps/route/getrouterange
function calculateRouteRange(aborter: Aborter, center: GeoJSON.Position, options?: CalculateRouteRangeOptions): Promise<CalculateRouteRangeResponse>
Parametreler
- aborter
- Aborter
İstek iptali hakkında daha fazla örnek için Aborter.none veya Aborter.timeout() ile yeni bir Aborter örneği oluşturun.
- center
- GeoJSON.Position
Aralık hesaplamasının başlaması gereken koordinat.
- options
- CalculateRouteRangeOptions
Döndürülenler
Promise<CalculateRouteRangeResponse>
Devralınan Yöntemin Ayrıntıları
newPipeline(Credential, INewPipelineOptions)
Kimlik bilgileri sağlanmış yeni bir İşlem Hattı nesnesi oluşturmak için kullanılan statik bir yöntem.
static function newPipeline(credential: Credential, pipelineOptions?: INewPipelineOptions): Pipeline
Parametreler
- credential
- Credential
SubscriptionKeyCredential, TokenCredential ve MapControlCredential gibi.
- pipelineOptions
- INewPipelineOptions
Döndürülenler
Yeni bir İşlem Hattı nesnesi.
MapsURL.newPipeline'denDevralındı