OLP カタログレイヤーフィーチャー
OLP CLI は、次のものをサポートしています。
- インタラクティブなマップ レイヤーの機能を一覧表示します
- インタラクティブなマップ レイヤーから機能を取得できます
- インタラクティブなマップ レイヤー で機能を更新します
- インタラクティブなマップ レイヤーに機能を追加します
- インタラクティブなマップ レイヤーからフィーチャーを削除します
カタログレイヤーフィーチャーリスト
指定したインタラクティブマップ レイヤーの機能を標準出力に一覧表示します。
olp catalog layer feature list <catalog HRN> <layer ID> [command options]
必須パラメータ :
-
<catalog HRN>
カタログの HERE リソースネーム 。 -
<layer ID>
レイヤーの ID 。
オプションのパラメータ :
--ids <ID1 ID2 ...>
取得する機能 ID のリスト。スペースで区切ります。 --filter <filter query>
フィルタクエリを使用して、プロパティ値に基づいてフィーチャを検索します。 複数のプロパティを検索するには、セミコロンを使用します。 たとえば、 --filter "p.age>20;p.country=Germany"
です。 HERE p.
- 接頭辞はフィーチャーのプロパティマップを参照します 詳細について は、「機能の検索」を参照してください。 westLongitude, southLatitude, eastLongitude, northLatitude
形式で領域を検索するバウンディング ボックス 。 座標は WGS '84 形式です。 たとえば、--bbox 13.082,52.416,13.628,52.626
です。 --limit <limit>
取得するフィーチャの数。 デフォルトの制限は 200 です。 -
--credentials <path to credentials file>
コマンドで使用する資格情報ファイルの名前。 資格情報ファイルは、プラットフォームポータルとは別にダウンロードされます。 -
--profile <profile name>
olpcli.ini
ファイルから使用する資格情報プロファイルの名前。 --quiet
新しい行に機能 ID を表示します。 -
--scope <project HRN>
リクエストのスコープとして使用するプロジェクト HERE リソースネーム を指定します。 で指定された値 --scope
は here.token.scope
、コマンドに使用された資格情報ファイルで指定された値よりも優先されます。
資格情報 およびプロファイルの使用方法の詳細について は、「資格情報 の設定」を参照してください。
例 :
次のコマンドは、カタログ catalog1
内の対話式マップ レイヤー layer1
から 200 のフィーチャーを一覧表示します。
olp catalog layer feature list hrn:here:data::org:catalog1 layer1
出力 :
ID geometryType createdAt updatedAt
QBqnw3VUGo5bxpNs Point 14/05/2021 04:30 14/05/2021 04:30
sQkir7fa7jJZuOHK Point 14/05/2021 05:27 15/05/2021 06:45
C5k0BquzEspp7N5I LineString 15/05/2021 03:13 16/05/2021 04:30
sAjKucaagZPem005 Polygon 17/05/2021 07:46 18/05/2021 06:36
08MeHAD5fmhgX2MY Polygon 21/05/2021 06:58 22/05/2021 02:30
Use olp catalog layer feature get <catalog HRN> <layer ID> --ids=<featureId> to download features
カタログレイヤーフィーチャー GET
このコマンドは、インタラクティブマップ レイヤーからデータを取得するために使用します。 デフォルトでは、コマンド出力は標準出力で JSON 形式で表示されます。 このコマンドには、必要に応じてデータを取得するために使用できるさまざまなオプションがあります。
olp catalog layer feature get <catalog HRN> <layer ID> [command options]
必須パラメータ :
-
<catalog HRN>
カタログの HERE リソースネーム 。 -
<layer ID>
レイヤーの ID 。
オプションのパラメータ :
--ids <ID1 ID2 ...>
取得する機能 ID のリスト。スペースで区切ります。 --filter <filter query>
フィルタクエリを使用して、プロパティ値に基づいてフィーチャを検索します。 複数のプロパティを検索するには、セミコロンを使用します。 たとえば、 --filter "p.age>20;p.country=Germany"
です。 HERE p.
- 接頭辞はフィーチャーのプロパティマップを参照します 詳細について は、「機能の検索」を参照してください。 --bbox <bbox>
westLongitude, southLatitude, eastLongitude, northLatitude
形式で領域を検索するバウンディング ボックス 。 座標は WGS '84 形式です。 たとえば、 --bbox 13.082,52.416,13.628,52.626
です。 --limit <limit>
取得するフィーチャの数。 デフォルトの制限は 30,000 です。 --output <path to dir>
ダウンロードした機能を保存する出力ディレクトリ。 指定したディレクトリが存在しない場合は、自動的に作成されます。 ディレクトリが指定されていない場合、デフォルト値はです <current dir>
。 --all
レイヤーから --output
パラメーターで指定したディレクトリにすべてのフィーチャーをダウンロードします。 ディレクトリが指定されていない場合、デフォルトのダウンロード場所はです <current dir>
。 -
--credentials <path to credentials file>
コマンドで使用する資格情報ファイルの名前。 資格情報ファイルは、プラットフォームポータルとは別にダウンロードされます。 -
--profile <profile name>
olpcli.ini
ファイルから使用する資格情報プロファイルの名前。 --quiet
出力ディレクトリへの絶対パスがある場合は、そのパスを表示します。 それ以外の場合、フィーチャーは標準出力に印刷されます。 -
--scope <project HRN>
リクエストのスコープとして使用するプロジェクト HERE リソースネーム を指定します。 で指定された値 --scope
は here.token.scope
、コマンドに使用された資格情報ファイルで指定された値よりも優先されます。
資格情報 およびプロファイルの使用方法の詳細について は、「資格情報 の設定」を参照してください。
例 :
次のコマンドを使用すると、 ID を持つフィーチャー feature1
と feature2
、カタログ catalog1
内の対話式マップ レイヤー interactivemap-layer1
から標準出力にフィーチャーが印刷されます。
olp catalog layer feature get hrn:here:data::org:catalog1 interactivemap-layer1 \
--ids feature1 feature2
olp catalog layer feature get hrn:here:data::org:catalog1 interactivemap-layer1 ^
--ids feature1 feature2
例 :
次のコマンドは、カタログ catalog1
内の対話式マップ レイヤー interactivemap-layer1
から指定した出力ディレクトリにfilter p.age>20;p.country=Germany
を適用して、機能をダウンロードします。 このクエリは、プロパティの経過時間の値が 20 より大きく、国がドイツのフィーチャを返します。
olp catalog layer feature get hrn:here:data::org:catalog1 interactivemap-layer1 \
--filter "p.age>20;p.country=Germany" --output <output-path>
olp catalog layer feature get hrn:here:data::org:catalog1 interactivemap-layer1 ^
--filter "p.age>20;p.country=Germany" --output <output-path>
カタログレイヤーフィーチャーの更新
このコマンドは、 1 つのトランザクションで複数の機能の更新をインタラクティブなマップ レイヤー に実行するために使用します。 このコマンドは .geojson
ファイルをサポートしています。
olp catalog layer feature update <catalog HRN> <layer ID> [command options]
必須パラメータ :
-
<catalog HRN>
カタログの HERE リソースネーム 。 -
<layer ID>
レイヤーの ID 。
オプションのパラメータ :
--modifications <path to input file>
レイヤーの入力 GeoJSON ファイルです。 ファイルが指定されていない場合、コマンドは標準出力からデータを読み取ります。 --batch-size <number-of-features>
データのアップロードに使用されるバッチサイズ。 最小バッチサイズは 1 で、デフォルト値は 1000 です。 -
--credentials <path to credentials file>
コマンドで使用する資格情報ファイルの名前。 資格情報ファイルは、プラットフォームポータルとは別にダウンロードされます。 -
--profile <profile name>
olpcli.ini
ファイルから使用する資格情報プロファイルの名前。 -
--quiet
空の出力を追加情報なしで表示します。 -
--scope <project HRN>
リクエストのスコープとして使用するプロジェクト HERE リソースネーム を指定します。 で指定された値 --scope
は here.token.scope
、コマンドに使用された資格情報ファイルで指定された値よりも優先されます。
資格情報 およびプロファイルの使用方法の詳細について は、「資格情報 の設定」を参照してください。
注
大規模なフィーチャーの変更をアップロードする場合 --modifications
は、パラメーターを使用します。 このパラメータを使用しない場合は、 50 MB までの機能の変更のみを渡します。
入力 :
入力には 、各FeatureModification
にFeatureCollection
が含まれているFeatureModification
のリストと、FeatureCollection
内の特定のフィーチャーのセットが存在するか、または存在しない場合に実行するアクションを指定する詳細が含まれています。 FeatureModification
によって指定されたアクション onFeatureExists
は、すべてのエントリについて、含まれているフィーチャがすでに存在する場合にそのフィーチャで実行 onFeatureNotExists
されますが、によって指定されたアクションは、そのフィーチャが新たに作成されたときに実行されます。
{
"type": "FeatureModificationList",
"modifications": [
{
"type": "FeatureModification",
"featureData": {
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"id": "BfiimUxHjj",
"geometry": {
"type": "Point",
"coordinates": [
-2.960847,
53.430828
]
},
"properties": {
"name": "Anfield",
"@ns:com:here:xyz": {
"tags": [
"football",
"stadium"
]
},
"amenity": "Football Stadium",
"capacity": 54074,
"description": "Home of Liverpool Football Club"
}
}
]
},
"onFeatureNotExists": "create",
"onFeatureExists": "retain"
},
{
"type": "FeatureModification",
"featureData": {
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"id": "BfiimUxHxx",
"geometry": {
"type": "Point",
"coordinates": [
-2.960839,
53.340012
]
},
"properties": {
"name": "Anfield",
"@ns:com:here:xyz": {
"tags": [
"cricket",
"stadium"
]
},
"amenity": "Cricket Stadium",
"capacity": 54074,
"description": "Home of Surrey Cricket Club"
}
}
]
},
"onFeatureNotExists": "create",
"onFeatureExists": "delete"
}
]
}
例 :
次のコマンドを使用すると、指定した入力ファイルからカタログ catalog
内の対話式マップ レイヤー interactivemap-layer
にデータがアップロードされます。
olp catalog layer feature update hrn:here:data::org:catalog interactivemap-layer \
--modifications path/to/input.json
olp catalog layer feature update hrn:here:data::org:catalog interactivemap-layer ^ --modifications path/to/input.json
カタログレイヤーフィーチャーが配置されました
このコマンドは、インタラクティブなマップ レイヤーにデータをアップロードするために使用します。 .geojson
ファイルをサポートしています。
olp catalog layer feature put <catalog HRN> <layer ID> [command options]
必須パラメータ :
-
<catalog HRN>
カタログの HERE リソースネーム 。 -
<layer ID>
レイヤーの ID 。
オプションのパラメータ :
--data <path to input file>
レイヤーの入力 GeoJSON ファイルです。 ファイルが指定されていない場合、コマンドは標準入力からデータを読み取ります。 --batch-size <number-of-features>
データのアップロードに使用されるバッチサイズ。 最小バッチサイズは 1 で、デフォルトは 1000 です。 -
--credentials <path to credentials file>
コマンドで使用する資格情報ファイルの名前。 資格情報ファイルは、プラットフォームポータルとは別にダウンロードされます。 -
--profile <profile name>
olpcli.ini
ファイルから使用する資格情報プロファイルの名前。 -
--quiet
空の出力を追加情報なしで表示します。 -
--scope <project HRN>
リクエストのスコープとして使用するプロジェクト HERE リソースネーム を指定します。 で指定された値 --scope
は here.token.scope
、コマンドに使用された資格情報ファイルで指定された値よりも優先されます。
資格情報 およびプロファイルの使用方法の詳細について は、「資格情報 の設定」を参照してください。
注
入力機能で ID が使用可能な場合、サービスは同じ ID を使用します。使用できない場合は、これらの機能に UUID が生成されます。
例 :
次のコマンドを使用すると、指定した入力ファイルからカタログ catalog1
内の対話式マップ レイヤー interactivemap-layer1
にデータがアップロードされます。
olp catalog layer feature put hrn:here:data::org:catalog1 interactivemap-layer1 \
--data <input_file_path>
olp catalog layer feature put hrn:here:data::org:catalog1 interactivemap-layer1 ^
--data <input_file_path>
カタログレイヤーフィーチャーが削除されました
このコマンドは、インタラクティブなマップ レイヤー からフィーチャーを削除するために使用します。
olp catalog layer feature delete <catalog HRN> <layer ID> [command options]
必須パラメータ :
-
<catalog HRN>
カタログの HERE リソースネーム 。 -
<layer ID>
レイヤーの ID 。 --ids <ID1 ID2 ...>
レイヤーから削除するフィーチャー ID のリストです。スペースで区切ります。
オプションのパラメータ :
-
--credentials <path to credentials file>
コマンドで使用する資格情報ファイルの名前。 資格情報ファイルは、プラットフォームポータルとは別にダウンロードされます。 -
--profile <profile name>
olpcli.ini
ファイルから使用する資格情報プロファイルの名前。 -
--quiet
空の出力を追加情報なしで表示します。 -
--scope <project HRN>
リクエストのスコープとして使用するプロジェクト HERE リソースネーム を指定します。 で指定された値 --scope
は here.token.scope
、コマンドに使用された資格情報ファイルで指定された値よりも優先されます。
資格情報 およびプロファイルの使用方法の詳細について は、「資格情報 の設定」を参照してください。
例 :
次のコマンドを実行すると、 カタログ catalog1
の対話式マップ レイヤー interactivemap-layer1
から ID feature1
および feature2
を持つ機能が削除されます。
olp catalog layer feature delete hrn:here:data::org:catalog1 interactivemap-layer1 \
--ids feature1 feature2
olp catalog layer feature delete hrn:here:data::org:catalog1 interactivemap-layer1 ^
--ids feature1 feature2