注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。
オントロジーオブジェクト
Mapアプリケーションは、地理空間データが付随するオントロジーオブジェクトをサポートします。
ポイントジオメトリ
ポイントジオメトリは、geohashプロパティタイプを使用して指定できます。geohashプロパティの内容は以下のいずれかの文字列である必要があります。
[latitude],[longitude]: たとえば、57.64911,10.40744。座標はWGS 84 CRS（標準緯度と経度）を使用する必要があります。- Geohash ↗: たとえば、
u4pruydqqvj。GeohashはGeohash長方形の左下隅を使用してポイントに変換されます。
geohashプロパティを持つオブジェクトは、地理空間検索のためにインデックスが作成されます。
サークル
サークルジオメトリは、オブジェクトタイプのCapabilitiesタブのGeospatialセクションでRadiusプロパティを選択することで指定できます。半径プロパティは、メートル単位の任意の数値プロパティで構いません。
サークルジオメトリは地図上にのみレンダリングされ、検索のためにインデックスは作成されません。サークルジオメトリに基づいて地理空間的に検索可能なオブジェクトが必要な場合は、ポリゴンを使用してサークルを近似する必要があります。
ポリゴンおよびラインジオメトリ
ポリゴンおよびラインジオメトリは、geoshapeプロパティタイプを使用して指定できます。geoshapeプロパティの内容は、以下の要件を満たすGeoJSONジオメトリ文字列である必要があります。
- GeoJSONのLineString、Polygon、MultiLineString、MultiPolygon、MultiPoint、またはPointである必要があります。ただし、ポイントジオメトリは
geoshapeプロパティタイプを使用しないでください。ポイントジオメトリにはgeohashプロパティタイプを使用してください。 - Feature、FeatureCollection、またはGeometryCollectionでないこと。
- GeoJSON仕様（RFC 7946）↗に準拠していること。
- WGS 84座標を使用すること。
- ポリゴンおよびMultiPolygonsは、GeoJSON仕様に従って有効である必要があります。ポリゴンおよびMultiPolygonsは閉じていること、外部リングは右手/反時計回りの順序を使用すること、自己交差がないこと。
これは、geoshapeプロパティの有効なGeoJSONの例です。
Copied!1 2 3 4 5 6 7{ "type": "LineString", "coordinates": [ [100.0, 0.0], // 緯度100.0、経度0.0の座標 [101.0, 1.0] // 緯度101.0、経度1.0の座標 ] }
`geoshape` プロパティを持つオブジェクトは、地理空間検索のためにインデックス付けされます。
## コロプレス
[コロプレスビジュアライゼーション](./visualize-choropleths.md)をレンダリングするには、オントロジーを設定してオブジェクトを地域にグループ化できるようにする必要があります。これには、**境界識別子** と **リンクされたオブジェクト** の 2 つの方法があります。
### 境界識別子
Maps は、ISO 3166 国コード、米国州の略語など、一般的な地域識別子タイプで設定されたオブジェクトのためのコロプレスをレンダリングすることをサポートします。これらの境界タイプのポリゴンジオメトリは、Map アプリケーションに組み込まれているため、データにこれらの識別子タイプのいずれかが既に含まれている場合、データ統合が容易になります。これらの識別子は、マップしたいオブジェクトタイプのプロパティに特定の [Value Type](../object-link-types/value-types-overview.md) を付けることで設定されます。
境界識別子を設定するには、まず Marketplace で「Choropleth Value Types」プロダクトを検索してインストールします。このプロダクトには、Map アプリケーションがコロプレスとしてレンダリングできるオントロジーの値タイプが含まれています。
現在サポートされている地域タイプとそれらを識別する方法は以下の通りです：
- Admin 0（グローバルな行政レベル 0 の境界）
- ISO 3166 アルファ-2 国コード
- ISO 3166 アルファ-3 国コード
- 米国州
- FIPS コード
- USPS 略語
- 米国郡
- FIPS コード
- ANSI コード
オブジェクトタイプにこれらの識別子のいずれかを含むプロパティが既にある場合、そのプロパティの Value Type ドロップダウンメニューで対応する値タイプを選択します。
上記の地域タイプのいずれかを表示したいが、データにサポートされている識別子の代わりに緯度/経度のポイントが含まれている場合は、Marketplace から「Choropleth Boundary Datasets」プロダクトを使用して地域識別子を付けます。このプロダクトには、実際のジオメトリおよび地域の他のメタデータを含むデータセットが含まれています。Pipeline Builder の [Geometry intersection join](../pipeline-builder/transforms-geospatial.md#geometry-intersection-joins) を使用して各ポイントがどの地域内にあるかを見つけ、対応する地域識別子を付け、その後オントロジーマネージャーで対応する値タイプを設定します。
### リンクされたオブジェクト
上記に含まれない地域タイプのコロプレスを表示したい場合、または地域のジオメトリおよびプロパティにさらに制御を加えたい場合は、任意のジオメトリを持つオブジェクトタイプを作成できます。その後、集約したいオブジェクトタイプからその地域オブジェクトタイプへの多対1のリンクを作成します。
たとえば、各販売地域の注文合計値を示すコロプレスを表示したい場合、オントロジーを設定する簡単な方法は次のとおりです：
- 各販売地域のジオメトリを含む geoshape プロパティを持つ「Sales region」オブジェクトタイプ
- 次のプロパティを持つ「Order」オブジェクトタイプ：
- 各注文が行われた地域の主キーを含む「Sales region」
- 注文の合計値を含む「Value」
- 「Order」から「Sales region」への多対1のリンク
コロプレスを表示するには：
1. [検索ダイアログ](./add-to-map.md#add-ontology-objects)を使用して「Order」オブジェクトをマップに追加します
2. 「Order」レイヤーに [**Choropleth** ジオメトリ](./visualize-objects.md#geometries) を追加します
3. [**Regions** セクション](./visualize-choropleths.md#group-by-linked-objects)で **Linked object** オプションを選択し、「Order」オブジェクトから関連する「Sales region」へのリンクタイプを選択します
4. [スタイリング集計](./visualize-choropleths.md#styling-by-aggregation) で「Value」プロパティを使用して各地域の色を制御します
## H3 六角形
オブジェクトには、[H3 地理空間インデックスシステム ↗](https://h3geo.org/docs/) からの H3 セル ID を含む文字列プロパティを含めることができます。これらは、マップ上で関連する六角形としてレンダリングされます。
文字列プロパティが H3 セル ID を含むことを指定するには、オブジェクトタイプの **Capabilities** タブの **Geospatial** セクションでそのプロパティを **H3 cell** に選択します。
:::callout{theme=warning}
H3 六角形は Map 上でのみレンダリングされ、検索用にインデックス付けされません。H3 六角形に基づいてオブジェクトを地理空間的に検索可能にする必要がある場合は、H3 セル ID を GeoJSON ポリゴンに変換し、それらを [上記](#polygons-and-lines) に記載されているように `geoshape` プロパティに含める必要があります。
:::
## ジオレクティファイド画像
オブジェクトには、衛星写真、航空画像、物理地図のスキャンなどのジオレクティファイド画像を添付できます。ジオレクティファイド画像には、次の 2 つのプロパティが必要です：
* レンダリングする画像の URL を含む `String` プロパティ。サポートされる画像ファイル拡張子には `.png`、`.jpg`、`.jpeg`、`.gif`、`.webp`、`.bmp`、`.ico`、および `.svg` が含まれます。画像 URL プロパティの ID は画像境界プロパティの設定に使用されます。
* 画像のジオレクティファイド境界を表す GeoJSON ポリゴンを含む `geoshape` プロパティ。ポリゴンは、左下隅から始めて時計回りに頂点を指定する必要があります。
* 画像境界プロパティには、以下の形式で画像 URL プロパティの ID を示すタイプクラスが必要です：
* Kind: `geo`
* Value: `bounds.<image URL property ID>`（`<image URL property ID>` は画像 URL プロパティの ID）
* たとえば、画像 URL プロパティの ID が `image_url` である場合、タイプクラスは次のようになります：Kind: `geo`、Value: `bounds.image_url`
ジオレクティファイド画像を持つオブジェクトも、すべての `geoshape` プロパティと同様に地理空間検索のためにインデックス付けされます。
## メディアセットからのタイル画像 [ベータ]
ジオリファレンスされたラスター画像は、GeoTIFF 画像（`.tiff`, `.tif`）を [メディアセット](../data-integration/media-sets.md#media-sets-beta) にアップロードすることでタイル形式で表示することもできます。その後、[メディアリファレンスプロパティ](../data-integration/media-sets.md#ontologize-media-using-media-references) を持つオブジェクトタイプをマップに追加し、ユーザーが Map をパンやズームするときに、画像の表示部分のみがロードされます。
## トラック
オブジェクトは、オブジェクトの緯度および経度を時間の経過にわたって表す数値 [time series プロパティ](../time-series/time-series-overview.md) を持つことができ、ユーザーはオブジェクトが時間の経過とともに移動した経路と任意の時点での位置を確認できます。
オブジェクトタイプのトラックを設定するには、オブジェクトタイプの **Capabilities** タブの **Geospatial** セクションで **Track Latitude** および **Track Longitude** プロパティを選択します。両方のプロパティは、オブジェクトの位置を時間の経過とともに表す数値 time series プロパティでなければなりません。[time series の設定](../time-series/time-series-setup.md) に関する詳細な設定方法や、マップでトラックを視覚化するためのオプションに関する詳細は [トラックジオメトリ](./visualize-tracks.md) を参照してください。
## イベント
イベントは、ある時点または期間に発生するオントロジーオブジェクトです。オブジェクトタイプは、**Capabilities** タブの **Event** セクションで **Event start time** および **Event end time** タイムスタンププロパティを指定することでイベントとして設定できます。
### マップ上のイベントオブジェクト
イベントオブジェクトが Map に追加されると、現在の時点でのみ表示されるように設定できます（つまり、選択されたタイムスタンプがイベント期間内にある場合）。
### マップ上のオブジェクトにリンクされたイベントオブジェクト
マップ上のオブジェクトにイベントオブジェクトがリンクされている場合、イベントオブジェクトは時系列分析のために **Series** パネルに追加でき、現在のイベント数インジケーターをオブジェクトラベルに追加できます。たとえば、`road` オブジェクトがマップ上で線として表され、`road` オブジェクトにリンクされた `traffic accident` イベントがある場合、ユーザーはインジケーターを使用して任意の時点で各道路の交通イベント数を確認できます。
これを可能にするために、イベントオブジェクトタイプは **Capabilities** タブの **Event** セクションでイベントの重大度を示す **Event intent** を設定する必要があります。