Služba wayfinding pro vnitřní mapy (Preview)

  • Článek

Služba Azure Mapy Creator wayfinding umožňuje přejít z místa na libovolné místo v interiérové mapě. Služba využívá schody a výtahy k navigaci mezi podlahami a poskytuje pokyny, které vám pomůžou procházet fyzické překážky. Tento článek popisuje, jak vygenerovat cestu z počátečního bodu do cílového bodu v ukázkové vnitřní mapě.

Požadavky

Důležité

  • Tento článek používá zeměpisnou us.atlas.microsoft.com adresu URL. Pokud se služba Creator nevytvořila v USA, musíte použít jinou geografickou adresu URL. Další informace najdete v tématu Přístup ke službám Creator.
  • V příkladech adres URL v tomto článku budete muset:
    • Nahraďte {Your-Azure-Maps-Subscription-key} klíčem předplatného Azure Mapy.
    • Nahraďte {datasetId} vaším datasetId. Další informace najdete v části Kontrola stavu vytvoření datové sady v kurzu Vytvoření interiérových map v nástroji Use Creator.

Vytvoření sady tras

Sada tras je kolekce dat vnitřních map, která se používají službou wayfinding.

Sada tras se vytvoří z datové sady. Sada tras je nezávislá na datové sadě, což znamená, že pokud je datová sada odstraněná, sada tras bude i nadále existovat.

Jakmile vytvoříte sadu tras, můžete pomocí rozhraní API pro určení cesty získat cestu od počátečního bodu k cílovému bodu v rámci zařízení.

Vytvoření sady tras:

  1. Spusťte následující požadavek HTTP POST:

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

  2. Zkopírujte hodnotu klíče operation-location z hlavičky odpovědi.

Klíč umístění operace je adresa URL stavu, která slouží ke kontrole stavu vytváření sady tras, jak je znázorněno v další části.

Zkontrolujte stav vytvoření sady tras a načtěte id trasy.

Pokud chcete zkontrolovat stav procesu vytváření sady tras a načíst id trasy:

  1. Spusťte následující požadavek HTTP GET:

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

    Poznámka:

    operationId Při vytváření nové sady tras získejte klíč z klíče umístění operace v hlavičce odpovědi.

  2. Zkopírujte hodnotu klíče umístění prostředku z hlavičky odpovědí. Je to adresa URL umístění prostředku a obsahuje routesetId:

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

Poznamenejte si .routesetId Vyžaduje se to všemi požadavky a když získáte ID zařízení.

Získání ID zařízení

Vlastnost facilityIdsady tras je povinný parametr při hledání cesty. facilityId Získejte dotazování na sadu tras.

  1. Spusťte následující požadavek HTTP GET:

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

  2. Jedná facilityId se o vlastnost objektu facilityDetails , kterou najdete v textu odpovědi požadavku sady tras, což je FCL43 v následujícím příkladu:

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

Získání cesty wayfinding

Pomocí rozhraní API pro definici cesty vygenerujte cestu ze sady tras, kterou jste vytvořili v předchozí části. Rozhraní API pro definici cesty vyžaduje dotaz, který obsahuje počáteční a koncové body v vnitřní mapě spolu s pořadovými čísly úrovně podlahy. Další informaceoch

Vytvoření dotazu wayfinding:

  1. Spusťte následující požadavek HTTP GET (nahraďte {routesetId} identifikátorem routesetId získaným v části Zkontrolujte stav vytvoření sady tras a {facilityId} id zařízení získané v části Získat ID zařízení):

    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}

    Tip

    Parametr AvoidFeatures lze použít k zadání něčeho pro službu určení cesty, aby se zabránilo při určování cesty, jako jsou výtahy nebo schody.

  2. Podrobnosti o cestě a nohách se zobrazují v těle odpovědi.

Souhrn zobrazuje odhadovanou dobu trvání cesty v sekundách pro celkovou cestu. Kromě toho se na začátku každé části cesty zobrazí odhadovaný čas.

Služba wayfinding vypočítá cestu přes konkrétní body. Každý bod se zobrazí spolu s podrobnostmi o zeměpisné šířce a délce.