独自のデータを使用する - 廃止

📘

注

カスタムレイヤーとカスタムルート検索のサポートは廃止されました。

概要

プライベートマップは、店舗所在地の管理、追加の地図表示コンテンツ、店舗検索などの検索機能によく利用されます。

アトリビューション機能を使用してポイント、ポリライン、ポリゴンを含むプライベートマップを独自のレイヤーで作成できます。これらのマップは、HEREマップと同様に検索、取得、利用することができます。

プライベートマップには道路ネットワークへの変更を含めることもでき、HEREマップネットワークへのオーバーレイとして機能します。この方法により、HERE Routing API V8の返すルートを変更できます。オーバーレイマップを使用すると、道路の追加や道路属性 (アクセス権、一方通行の道路、重量制限、速度制限など) の変更が可能です。特定の道路がルーティングから除外することもできます。

このようなオーバーレイを活用することで、施設内の道路、個々の商品・資材搬入口までの経路指定が可能になります。また、運行管理のために特定の道路をブロック/allow/preferすることもできます。

マップレイヤー

カスタムマップには複数のレイヤーを含めることができます。1つのレイヤーには、同じタイプのオブジェクトを含める必要があります。検索、表示、更新を同時に行うオブジェクトは、1つのレイヤーにグループ化します。

レイヤー例：

• 店舗の場所
• 配送トラックの位置
• 店舗および倉庫周辺の到達等値線ポリゴン

カスタムマップコンテンツをアップロードする

RESTコールを介してプライベートマップをアップロードします。マップレイヤーはcsvまたはシェープファイル形式でアップロードできます。道路地図はoverlay.json形式でアップロードできます。

地図の保管場所

カスタムマップに使用できるストレージタイプには、「更新可能」と「読み取り専用」の2種類があります。 個々のレコードの挿入/更新/削除、および「更新可能」な地図ストレージへのレコードの追加を行うことができます。 「読み取り専用」ストレージ内の地図は変更できません。代わりに、地図全体を再度アップロードする必要があります。 カスタムマップのデフォルトのストレージタイプは「更新可能」です。道路オーバーレイマップは常に「読み取り専用」ストレージに保存されます。 検索と取得のパフォーマンスが向上するため、ほとんど変更されない大きな地図の場合は、「読み取り専用」を選択します。

ファイル形式の要件

csv形式とシェープファイル形式のジオメトリー行は、任意の属性列を持つことができます。csvファイルの各行には、マップオブジェクト属性とWKT (Well-Known Text) 形式のジオメトリー (ポイント、ライン、ポリゴン) が含まれます。列名は[A-Za-z][A-Za-z0-9_]*形式に準拠している必要があります。使用できる空白文字は、スペースのみです。

列の値は、UTF-8エンコードで4000文字を超えないプレーンテキスト文字列です。csv形式で数値列を作成するには、列名の後ろにnumberを追加します。それらの列の検索フィルターに数値式を適用できるようになります。

バックスラッシュの引用符のようなエスケープ文字は認識されません (特殊な意味を持たないプレーン文字として解釈されます)。csvファイルのジオメトリー列のWKTは、最後の列である必要があります。最後の列でない場合は、最後の列の後に移動します。

レイヤーにGEOMETRY_ID列が含まれている場合、数値かつレイヤー内で一意である必要があります。レイヤーにGEOMETRY_ID列が含まれていない場合は、変更や削除などのアクションの各ジオメトリーレコードを一意に識別するために、この列が追加されます。

レイヤーをアップロードする

1つのストアを持つレイヤーをアップロードするには、次のリソースを使用します。アップロードにはPOSTリクエストを使用してください。

https://smap.hereapi.com/v8/maps/upload?layerId={YOUR_APP_ID}.MY_STORES.GROCERIES&apiKey={YOUR_API_KEY}

POSTボディのコンテンツの例：

POI_ID	NAME	SIZE_SQM	WKT
12345	Walmart_Munich	650	POLYGON((12.43236 41.93602,12.40524 41.86165,12.70084 41.89233,12.70084 41.89233,12.43236 41.93602))

オーバーレイをアップロードする

道路アクセス権を変更して道路を追加するオーバーレイをアップロードするには、以下のリソースを使用します。アップロードにはPOSTリクエストを使用してください。

curl -gX POST 'https://fleet.ls.hereapi.com/v8/maps/overlays/upload?'\
'map_name=OVERLAYTEST12345'\
'&overlay_spec=%5B%7B%22op%22%3A%22override%22%2C%22shape%22%3A%5B%5B50.10765%2C8.68774%5D%2C%5B50.10914%2C8.68771%5D%5D%2C%22layer%22%3A%22LINK_ATTRIBUTE_FCn%22%2C%22data%22%3A%7B%22VEHICLE_TYPES%22%3A%220%22%7D%7D%2C%7B%22op%22%3A%22create%22%2C%22shape%22%3A%5B%5B50.10937%2C8.68422%5D%2C%5B50.10807%2C8.68525%5D%2C%5B50.10737%2C8.68387%5D%5D%2C%22data%22%3A%7B%22NAMES%22%3A%22ENGBNDemoRoad%22%7D%7D%5D'\
'&apiKey={YOUR_API_KEY}'

プライベートマップを一覧表示する

お客様のプライベートマップを一覧表示するには、次のリソースを使用します。mapTypeの値は、0 (デフォルトの公共+プライベート)、1 (公共)、2 (プライベート) のいずれかである必要があります。

https://smap.hereapi.com/v8/maps/list.html?mapType=2&apikey={YOUR_API_KEY}

マップレイヤーを一覧表示する

マップのレイヤーを一覧表示するには、以下のリソースを使用します。

https://smap.hereapi.com/v8/maps/layers/list.html?map_name=MY_STORES&apiKey={YOUR_API_KEY}

例