İç mekan haritaları yol bağlama hizmeti (önizleme)

  • Makale

Azure Haritalar Creator yol bağlama hizmeti, iç mekan haritanızın içinde bir yerden bir yere gitmenize olanak tanır. Hizmet, katlar arasında gezinmek için merdiven ve asansörlerden yararlanır ve fiziksel engeller arasında gezinmenize yardımcı olacak rehberlik sağlar. Bu makalede, örnek bir iç mekan haritasında başlangıç noktasından hedef noktaya nasıl yol oluşturulacağı açıklanmaktadır.

Önkoşullar

Önemli

  • Bu makalede coğrafi URL kullanılır us.atlas.microsoft.com . Oluşturucu hizmetiniz Birleşik Devletler oluşturulmadıysa farklı bir coğrafi URL kullanmanız gerekir. Daha fazla bilgi için bkz . Oluşturucu hizmetlerine erişim.
  • Bu makaledeki URL örneklerinde şunları yapmanız gerekir:
    • değerini Azure Haritalar abonelik anahtarınız ile değiştirin{Your-Azure-Maps-Subscription-key}.
    • } değerini kendi ile datasetIddeğiştirin{datasetId. Daha fazla bilgi için İç mekan haritaları oluşturmak için Oluşturucu kullanma öğreticisinin Veri kümesi oluşturma durumunu denetleme bölümüne bakın.

Yol kümesi oluşturma

Yol kümesi, yol bağlama hizmeti tarafından kullanılan iç mekan harita verilerinin bir koleksiyonudur.

Bir veri kümesinden bir yol kümesi oluşturulur. Rota kümesi veri kümesinden bağımsızdır; başka bir deyişle veri kümesi silinirse rota kümesi varolmaya devam eder.

Bir yol kümesi oluşturduktan sonra, başlangıç noktasından tesisin içindeki hedef noktaya bir yol almak için yol bağlama API'sini kullanabilirsiniz.

Yol kümesi oluşturmak için:

  1. Aşağıdaki HTTP POST isteğini yürütür:

    https://us.atlas.microsoft.com/routesets?api-version=2023-03-01-preview&datasetID={datasetId}&subscription-key={Your-Azure-Maps-Subscription-key}

  2. Yanıt üst bilgisinden Operation-Location anahtarının değerini kopyalayın.

İşlem-Konum anahtarı, sonraki bölümde gösterildiği gibi rota kümesi oluşturma durumunu denetlemek için kullanılan durum URL'sidir.

Routeset oluşturma durumunu denetleyin ve routesetId değerini alın

Routeset oluşturma işleminin durumunu denetlemek ve routesetId değerini almak için:

  1. Aşağıdaki HTTP GET isteğini yürütür:

    https://us.atlas.microsoft.com/routesets/operations/{operationId}?api-version=2023-03-01-preview&subscription-key={Your-Azure-Maps-Subscription-key}

    Dekont

    operationId Yeni bir yol kümesi oluştururken yanıt üst bilgisindeki Operation-Location anahtarından değerini alın.

  2. Yanıtlar üst bilgisinden Resource-Location anahtarının değerini kopyalayın. Kaynak konumu URL'sidir ve içerir routesetId:

    https://us.atlas.microsoft.com/routesets/**675ce646-f405-03be-302e-0d22bcfe17e8**?api-version=2023-03-01-preview

not routesetIdedin. Tüm isteklerde ve tesis kimliğini aldığınızda gereklidir.

Tesis kimliğini alma

facilityIdrouteset'in bir özelliği, yol bulma yolu aranırken gerekli bir parametredir. routeset'i facilityId sorgulayarak değerini alın.

  1. Aşağıdaki HTTP GET isteğini yürütür:

    https://us.atlas.microsoft.com/routesets/{routesetId}?api-version=2023-03-01-preview&subscription-key={Your-Azure-Maps-Subscription-key}

  2. facilityId, aşağıdaki örnekte yer alan routeset isteğinin yanıt gövdesinde bulabileceğiniz nesnesinin bir özelliğidir facilityDetailsFCL43:

{
    "routeSetId": "675ce646-f405-03be-302e-0d22bcfe17e8",
    "dataSetId": "eec3825c-620f-13e1-b469-85d2767c8a41",
    "created": "10/10/2022 6:58:32 PM +00:00",
    "facilityDetails": [
        {
            "facilityId": "FCL43",
            "levelOrdinals": [
                0,
                1
            ]
        }
    ],
    "creationMode": "Wall",
    "ontology": "facility-2.0"
}

Yol bağlama yolu alma

Önceki bölümde oluşturduğunuz yol kümesinden yol oluşturma API'sini kullanın. Yol bağlama API'sinin iç mekan haritasında başlangıç ve bitiş noktalarının yanı sıra kat düzeyi sıralı numaraları içeren bir sorgu gerekir. Creator wayfinding hakkında daha fazla bilgi için kavramlar makalesindeki yol bağlama bölümüne bakın.

Yol bağlama sorgusu oluşturmak için:

  1. Aşağıdaki HTTP GET isteğini yürütür ({routesetId} yerine Routeset oluşturma durumunu denetleyin bölümünde elde edilen routesetId değerini ve {facilityId} değerini Tesis Kimliğini Alma bölümünde elde edilen facilityId değeriyle değiştirin):

    https://us.atlas.microsoft.com/wayfinding/path?api-version=2023-03-01-preview&subscription-key={Your-Azure-Maps-Subscription-key}&routesetid={routeset-ID}&facilityid={facility-ID}&fromPoint={lat,lon}&fromLevel={from-level}&toPoint={lat,lon}&toLevel={to-level}&minWidth={minimun-width}

    Bahşiş

    parametresi, AvoidFeatures yol belirleme hizmeti için asansörler veya merdivenler gibi yolu belirlerken kaçınılması gereken bir şey belirtmek için kullanılabilir.

  2. Yolun ve bacakların ayrıntıları yanıtın Gövdesinde görüntülenir.

Özet, toplam yolculuk için tahmini seyahat süresini saniye cinsinden görüntüler. Buna ek olarak, yolculuğun her bölümü için tahmini süre her bacağın başında görüntülenir.

Yol bağlama hizmeti, belirli aralıklı noktalar aracılığıyla yolu hesaplar. Her nokta, enlem ve boylam ayrıntılarıyla birlikte görüntülenir.