Usługa tworzenia planów wnętrz (wersja zapoznawcza)

  • Artykuł

Usługa azure Mapy Creator wayfinding umożliwia przechodzenie z miejsca do miejsca w dowolnym miejscu na mapie wnętrz. Usługa wykorzystuje schody i windy do poruszania się między piętrami i zapewnia wskazówki ułatwiające poruszanie się po fizycznych przeszkodach. W tym artykule opisano sposób generowania ścieżki z punktu początkowego do punktu docelowego w przykładowej mapie wewnętrznej.

Wymagania wstępne

Ważne

  • W tym artykule jest używany us.atlas.microsoft.com adres URL geograficzny. Jeśli usługa Creator nie została utworzona w Stany Zjednoczone, musisz użyć innego adresu URL geograficznego. Aby uzyskać więcej informacji, zobacz Access to Creator services (Dostęp do usług dla twórców).
  • W przykładach adresów URL w tym artykule należy wykonać następujące działania:
    • Zastąp {Your-Azure-Maps-Subscription-key} ciąg kluczem subskrypcji usługi Azure Mapy.
    • Zastąp element {datasetId} swoim elementem datasetId. Aby uzyskać więcej informacji, zobacz sekcję Sprawdzanie stanu tworzenia zestawu danych w samouczku Używanie twórcy do tworzenia map wnętrz.

Tworzenie zestawu tras

Zestaw tras to kolekcja danych mapy wewnętrznej, która jest używana przez usługę wayfinding.

Zestaw tras jest tworzony na podstawie zestawu danych. Zestaw tras jest niezależny od zestawu danych, co oznacza, że jeśli zestaw danych zostanie usunięty, zestaw tras nadal istnieje.

Po utworzeniu zestawu tras możesz użyć interfejsuAPIego, aby uzyskać ścieżkę od punktu początkowego do punktu docelowego w obiekcie.

Aby utworzyć zestaw tras:

  1. Wykonaj następujące żądanie HTTP POST:

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

  2. Skopiuj wartość klucza Operation-Location z nagłówka odpowiedzi.

Klucz Operation-Location jest adresem URL stanu używanym do sprawdzania stanu tworzenia zestawu tras, jak pokazano w następnej sekcji.

Sprawdź stan tworzenia zestawu tras i pobierz identyfikator routeetId

Aby sprawdzić stan procesu tworzenia zestawu tras i pobrać identyfikator routesetId:

  1. Wykonaj następujące żądanie HTTP GET:

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

    Uwaga

    Pobierz element operationId z klucza Operation-Location w nagłówku odpowiedzi podczas tworzenia nowego zestawu tras.

  2. Skopiuj wartość klucza Resource-Location z nagłówka odpowiedzi. Jest to adres URL lokalizacji zasobu i zawiera wartość routesetId:

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

Zanotuj wartość parametru routesetId. Jest to wymagane we wszystkich żądaniach findowania i po otrzymaniu identyfikatora obiektu.

Uzyskiwanie identyfikatora obiektu

Właściwość facilityId, zestawu tras, jest wymaganym parametrem podczas wyszukiwania ścieżki wayfinding. Pobierz element facilityId , wykonując zapytanie dotyczące zestawu tras.

  1. Wykonaj następujące żądanie HTTP GET:

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

  2. Jest facilityId to właściwość facilityDetails obiektu, którą można znaleźć w treści odpowiedzi żądania zestawu tras, który znajduje się FCL43 w poniższym przykładzie:

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

Uzyskiwanie ścieżki tworzenia sposobu

Użyj interfejsu API tworzenia metody, aby wygenerować ścieżkę z zestawu tras utworzonego w poprzedniej sekcji. Interfejs API tworzenia metody wymaga zapytania zawierającego punkty początkowe i końcowe na mapie wewnętrznej wraz z liczbami porządkowymi na poziomie podłogi. Aby uzyskać więcej informacji na temat sposobu programowania dla twórców, zobacz artykuł wayfinding w artykule dotyczącym pojęć.

Aby utworzyć zapytanie wayfinding:

  1. Wykonaj następujące żądanie HTTP GET (zastąp ciąg {routesetId} identyfikatorem routesetId uzyskanym w sekcji Sprawdzanie stanu tworzenia zestawu tras i {facilityId} identyfikatorem obiektu uzyskanym w sekcji Pobierz identyfikator obiektu):

    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}

    Napiwek

    Parametr AvoidFeatures może służyć do określenia czegoś dla usługi wayfinding, aby uniknąć podczas określania ścieżki, takich jak windy lub schody.

  2. Szczegóły ścieżki i nóg są wyświetlane w treści odpowiedzi.

W podsumowaniu przedstawiono szacowany czas podróży w sekundach dla całkowitej podróży. Ponadto szacowany czas dla każdej sekcji podróży jest wyświetlany na początku każdej nogi.

Usługa wayfinding oblicza ścieżkę przez określone interweniujące punkty. Każdy punkt jest wyświetlany wraz ze szczegółami szerokości i długości geograficznej.