チュートリアル: Azure Maps Creator を使用してフロアガイドを作成する

[アーティクル]
10/26/2023

このチュートリアルでは、Microsoft Azure Maps で使用するフロアガイドを作成する方法について説明します。このチュートリアルでは、次の方法について説明します。

フロアガイドの描画パッケージをアップロードする。
描画パッケージをマップデータに変換する。
マップデータからデータセットを作成する。
データセットのデータからタイルセットを作成する。
タイルセットから既定のマップ構成 ID を取得します。

また、GeoJSON パッケージからデータセットを作成することもできます。詳細については、「GeoJSON パッケージを使用してデータセットを作成する (プレビュー)」を参照してください。

前提条件

このチュートリアルでは、Postman アプリケーションを使用しますが、別の API 開発環境を使用することもできます。

重要

この記事では、地理的な URL us.atlas.microsoft.comを使用します。 Creator サービスが米国内で作成されていない場合は、別の地理的 URL を使用する必要があります。詳細については、「Creator サービスにアクセスする」を参照してください。
URL の例で、{Your-Azure-Maps-Subscription-key} を、実際の Azure Maps サブスクリプションキーに置き換えてください。

描画パッケージをアップロードする

データレジストリの作成方法の記事に記載されている手順に従って、GeoJSON パッケージを Azure Storage アカウントにアップロードし、Azure Maps アカウントに登録します。

重要

一意識別子 (udid) の値を必ず書き留めてください。必要になります。 udid は、ソースコードと HTTP 要求から Azure ストレージアカウントにアップロードした GeoJSON パッケージを参照する方法です。

描画パッケージを変換する

描画パッケージがアップロードされたので、アップロードされたパッケージの udid 値を使用して、パッケージをマップデータに変換します。変換 API は、Creator の実行時間の長い操作の記事で定義されたパターンを実装する長時間トランザクションです。

Drawing パッケージを変換するには、次の手順を行います。

Postman アプリ内で [新規] を選択します。
[新規作成] ウィンドウで [HTTP 要求] を選択します。
[Request name] に、要求の名前を入力します (「POST Convert Drawing Package」など)。
POST HTTP メソッドを選択します。
Conversion サービスへの次の URL を入力します。 {Your-Azure-Maps-Subscription-key} を実際の Azure Maps サブスクリプションキーに置き換えます。 udid を、アップロードされたパッケージの udid 値に置き換えます。
```
https://us.atlas.microsoft.com/conversions?subscription-key={Your-Azure-Maps-Subscription-key}&api-version=2023-03-01-preview&udid={udid}&inputType=DWG&dwgPackageVersion=2.0
```
[Send] を選択します。
応答ウィンドウで、 [Headers](ヘッダー) タブを選択します。
Operation-Location キーの値をコピーします。これには、変換の状態を確認するために使用する、状態 URL が含まれます。

描画パッケージの変換の状態を確認する

変換操作が完了すると、conversionId 値が返されます。描画パッケージの変換プロセスの状態を確認すると、conversionId 値にアクセスできます。次に、conversionId 値を使用して、変換されたデータにアクセスできます。

変換プロセスの状態を確認し、conversionId 値を取得するには、次の手順を行います。

Postman アプリ内で [新規] を選択します。
[新規作成] ウィンドウで [HTTP 要求] を選択します。
[Request name] に、要求の名前を入力します (「GET Conversion Status」など)。
GET HTTP メソッドを選択します。
「描画パッケージを変換する」セクションでコピーした、状態 URL を入力します。要求は次の URL のようになります。
```
https://us.atlas.microsoft.com/conversions/operations/{operationId}?api-version=2.0&subscription-key={Your-Azure-Maps-Subscription-key}
```
[Send] を選択します。
応答ウィンドウで、 [Headers](ヘッダー) タブを選択します。
リソースの場所の URL である、"Resource-Location" キーの値をコピーします。リソースの場所の URL には、一意識別子 conversionId が含まれます。これを他の API で使用して、変換されたマップデータにアクセスできます。

サンプルの描画パッケージは、エラーや警告なしに変換されます。ただし、独自の描画パッケージからエラーまたは警告を受け取った場合は、Drawing Error Visualizer へのリンクが JSON 応答に含められています。 Drawing Error Visualizer を使用して、エラーと警告の詳細を調べることができます。変換エラーと警告を解決するための推奨事項を確認するには、「Drawing Conversion のエラーと警告」を参照してください。

次の JSON フラグメントは、変換の警告のサンプルを示しています。

{
    "operationId": "{operationId}",
    "created": "2021-05-19T18:24:28.7922905+00:00",
    "status": "Succeeded",
     "warning": {
        "code": "dwgConversionProblem",
        "details": [
            {
                "code": "warning",
                "details": [
                    {
                        "code": "manifestWarning",
                        "message": "Ignoring unexpected JSON property: unitProperties[0].nonWheelchairAccessible with value False"
                    }
                ]
            }
        ]
    },
    "properties": {
        "diagnosticPackageLocation": "https://atlas.microsoft.com/mapData/ce61c3c1-faa8-75b7-349f-d863f6523748?api-version=1.0"
    }
}

データセットを作成する

データセットは、建物、階層、部屋などのマップ地物のコレクションです。データセットを作成するには、Dataset Create API を使用します。 Dataset Create API は、変換された描画パッケージの conversionId 値を受け取り、作成されたデータセットの datasetId 値を返します。

データセットを作成するには、次の手順を行います。

Postman アプリ内で [新規] を選択します。
[新規作成] ウィンドウで [HTTP 要求] を選択します。
[Request name] に、要求の名前を入力します (「POST Dataset Create」など)。
POST HTTP メソッドを選択します。
データセットサービスへの次の URL を入力します。 {conversionId} を、「描画パッケージの変換の状態を確認する」で取得した conversionId 値に置き換えます。
```
https://us.atlas.microsoft.com/datasets?api-version=2023-03-01-preview&conversionId={conversionId}&subscription-key={Your-Azure-Maps-Subscription-key}
```
[Send] を選択します。
応答ウィンドウで、 [Headers](ヘッダー) タブを選択します。
Operation-Location キーの値をコピーします。これには、データセットの状態を確認するために使用する、状態 URL が含まれます。

データセットの作成状態を確認する

データセット作成プロセスの状態を確認し、datasetId 値を取得するには、次の手順を行います。

Postman アプリ内で [新規] を選択します。
[新規作成] ウィンドウで [HTTP 要求] を選択します。
[Request name] に、要求の名前を入力します (「GET Dataset Status」など)。
GET HTTP メソッドを選択します。
「データセットを作成する」セクションでコピーした状態 URL を入力します。要求は次の URL のようになります。
```
https://us.atlas.microsoft.com/datasets/operations/{operationId}?api-version=2023-03-01-preview&subscription-key={Your-Azure-Maps-Subscription-key}
```
[Send] を選択します。
応答ウィンドウで、[Headers] タブを選択します。"Resource-Location" キーの値は、リソースの場所の URL です。リソースの場所の URL には、データセットの一意識別子 (datasetId) が含まれます。
datasetId 値を保存します。これは次のチュートリアルで使用します。

タイルセットを作成する

タイルセットは、マップ上にレンダリングされる一連のベクタータイルです。タイルセットは既存のデータセットから作成されます。ただし、タイルセットは、その基になったデータセットから独立しています。データセットが削除された後も、タイルセットは引き続き存在します。

タイルセットを作成するには、次の手順を行います。

Postman アプリ内で [新規] を選択します。
[新規作成] ウィンドウで [HTTP 要求] を選択します。
[Request name] に、要求の名前を入力します (「POST Tileset Create」など)。
POST HTTP メソッドを選択します。
Tileset サービスへの次の URL を入力します。 {datasetId} を、「データセットの作成状態を確認する」セクションで取得した datasetId 値に置き換えます。
```
https://us.atlas.microsoft.com/tilesets?api-version=2023-03-01-preview&datasetID={datasetId}&subscription-key={Your-Azure-Maps-Primary-Subscription-key}
```
[Send] を選択します。
応答ウィンドウで、 [Headers](ヘッダー) タブを選択します。
Operation-Location キーの値をコピーします。これには、タイルセットの状態を確認するために使用する、状態 URL が含まれます。

タイルセットの作成の状態を確認する

タイルセット作成プロセスの状態を確認し、tilesetId 値を取得するには、次の手順を行います。

Postman アプリ内で [新規] を選択します。
[新規作成] ウィンドウで [HTTP 要求] を選択します。
[Request name] に、要求の名前を入力します (「GET Tileset Status」など)。
GET HTTP メソッドを選択します。
「タイルセットを作成する」セクションでコピーした状態 URL を入力します。要求は次の URL のようになります。
```
https://us.atlas.microsoft.com/tilesets/operations/{operationId}?api-version=2023-03-01-preview&subscription-key={Your-Azure-Maps-Subscription-key}
```
[Send] を選択します。
応答ウィンドウで、[Headers] タブを選択します。"Resource-Location" キーの値は、リソースの場所の URL です。リソースの場所の URL には、データセットの一意識別子 (tilesetId) が含まれます。

マップ構成を取得する (プレビュー)

タイルセットを作成したら、Tileset Get HTTP 要求を使用して、mapConfigurationId 値を取得することができます。

Postman アプリ内で [新規] を選択します。
[新規作成] ウィンドウで [HTTP 要求] を選択します。
[Request name] に、要求の名前を入力します (「GET mapConfigurationId from Tileset」など)。
GET HTTP メソッドを選択します。

Tileset サービスへの次の URL を入力します。前の手順で取得したタイルセット ID を渡します。

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

[Send] を選択します。
応答の本文にタイルセット JSON が表示されます。下にスクロールして、mapConfigurationId 値を表示します。
```
"defaultMapConfigurationId": "5906cd57-2dba-389b-3313-ce6b549d4396"
```

詳細については、フロアガイドの概念に関する記事の「マップ構成」を参照してください。

次のステップ

Azure Maps Creator とは

屋内マップ用の Creator

Azure Maps の Indoor Maps モジュールでカスタムスタイルを使用する

チュートリアル: Azure Maps Creator を使用してフロア ガイドを作成する