マップ

HERE Map Attributes API は、すべての HERE Map Data および顧客のプライベートマップ データをベースにしており、簡単にアクセスできます。 したがって、 HERE Map Attributes API は複数のマップで動作します。例 :

HERE Map Attributes API では、 HERE Maps および顧客の地図が使用されます。 マップは、レイヤーのコレクションです。 レイヤーには、ジオメトリとアトリビューションを持つマップオブジェクトが含まれています。 レイヤーのコンテンツがタイルに分割され、効率的な検索、地図の表示、経路指定、地図の一致、ドライバーの警告が可能になります。

resource/v8/maps/list.html に、利用可能なマップが表示されます。 コアマップの内容は地域マップに分割されますが、常に単一のグローバルマップとして使用できます。 その他のコンテンツは、主に世界各国のマップで提供されます。

レイヤー

HERE Map Attributes API では、 HERE Map Data が主題図のレイヤーにグループ化されます。 各レイヤーには、道路セグメント、ジャンル別施設、川のポリゴンなどの行 ( マップオブジェクト ) が含まれています。これらのポリゴンは、ジオメトリおよび属性 ( 列 ) です。 一部のレイヤーは、道路セグメントレイヤーの制限速度のように、属性を追加して別のレイヤーのオブジェクトを拡張するだけです。 ジオメトリのないレイヤーは、「ジオメトリ」レイヤーではなく「属性」レイヤーと呼ばれます。

レイヤーは、特定の使用例で作成されます。

• ドライバーに警告を表示するレイヤー
• 分岐点表示ガイダンスを提供するレイヤー
• 燃料効率の高いドライビングを可能にするレイヤー
• 安全な運転を可能にする層
• 管理リージョンの階層を記述するポリゴンへのアクセスを提供するレイヤ

適切なレイヤーを使用して、データの転送を最小限に抑えるために、関連するデータのみを要求します。 HERE Map Attributes API によって提供されるレイヤーは頻繁に変更されるため、現在サポートされているレイヤーをリソースのレイヤーで確認してください。

resource/v8/layers/ doc.html に、制限速度レイヤーの属性 ( 列 ) を示します。

resource/v8/maps/attributes? in=tile:tieId は、レイヤー speed_limits_fc2 の 1 つのタイル のコンテンツを示します。

制限速度レイヤーのタイルコンテンツの例 :

レイヤーを使用する一般的な例は、特定のルートに沿って情報を取得する必要がある場合です。 ルートは通常、より小さな道路から出発し、より大きな道路を通り、高速道路のような道路を走行することで主な目的地に到着します。そして、目的地に近づくと、小さな道路に戻ります。 ルート全体の狭い道路に関するすべての情報を取得すると、大量のデータ転送が発生する可能性があります。 したがって、ロードリンク関連のレイヤーは、 HERE Maps で使用される機能クラスに対応する 5 つのレイヤーに分割されます。 データ処理をシンプルにするために、各レイヤーは 1 つのフラットテーブルで構成され、数値またはテキスト文字列の単純なレコードが属性のキー / 値のペアとして表されます。

転送されるデータ量を削減するために、一部の列が非正規化またはエンコードされます。 非正規化は、コンマで区切られた値のリストを列に格納することで行います。 エンコードは、静的な文字列値、車両タイプのビットマスクなどを表す略語または数値を使用して行われます。 たとえば、各ジオメトリは、座標 (x, y, z レベルの列 ) ごとに 1 つの列で提供されます。 各座標は、 1E-5 WGS 度 ( または ADAS 精度の場合は 1E-7) の整数値のコンマ区切りのリストです。 最初の値は絶対値です。 後続の各値は前の値を基準にしています。ゼロ (0) の値は空の文字列に削減されます。

次のタイルレイヤーを使用できます。

• ADAS_ATTRIB_FC1...5 曲率、高さ、勾配、建物内
• ADMIN_PLACE_0/1/2/8/9 管理エリア情報
• ADMIN_POLY_0/1/2/8/9 管理領域の形状
• BASIC_HEIGHT_FC1...5 リンクの高さ
• BUILDING 建物のタイプ、高さ、フットプリントの形状
• CARTO_LINE_DO0/1/2/8/9 マップ作成用ラインの種類、名前、ジオメトリ
• CARTO_POLY_DO0/1/2/8/9 マップ作成用ポリゴンの種類、名前、ジオメトリ
• CARTO_POLY_OCEAN マップ作成用海洋ポリゴン名、ジオメトリ
• CARTO_POLY_RIVER_DO0/1/2/8/9 マップ作成用川のポリゴンタイプ、名前、ジオメトリ
• CARTO_POLY_TOLL_HAZ マップ作成用トールゾーンおよび危険区域のポリゴン名、ジオメトリ
• CENSUS_0/1/2/8/9 国勢調査の基本情報
• CEN_* 国別の国勢調査情報
• CITY_POI_0/1/2/8/9 市街地中心の POI 情報、位置情報
• DISTANCE_MARKERS_FC1...5 距離マーカー情報、位置
• DTM_HEIGHT デジタル地形モデルのグリッドの高さ
• EVCHARGING_POI 電気自動車充電スタンド情報、位置
• FUELSTATION_POI ガソリン、ディーゼル、 EV の充電サービス
• JUNCTION_VIEW 2D ジャンクション情報、位置、画像への参照
• LANE_CONN_FC1...5 レーンレベルガイダンスリンク接続情報
• LINK_ATTRIBUTE2_FC1...5 ルーティング、マップ表示の詳細リンク情報
• LINK_ATTRIBUTE_FC1...5 ルーティングの基本的なリンク情報、マップ表示
• LINK_FC1...5 ルーティング、ガイダンスの接続情報をリンクします
• LINK_TMC_FC1...5 ライブトラフィック処理のために TMC をリンクします
• MICROPOINT_ADDRESS 住所の場所、番地の建物の単位を含む情報、マップ表示のレベル
• NATURAL_GUIDANCE 自然指導情報
• POINT_ADDRESS 住所の場所、マップ表示用の番地の情報
• POI_BIG ジャンル別施設情報、マップ表示の場所
• POI_BIGGER ジャンル別施設のタイプ、情報、マップ表示の場所
• POI_SMALL ジャンル別施設のタイプ、情報、マップ表示の場所
• POI_SMALLER ジャンル別施設のタイプ、情報、マップ表示の場所
• PSTLCB_GEN 郵便番号境界の一般化されたジオメトリ
• PSTLCB_MP 郵便番号の境界の中間地点
• PSTLCB_UNGEN 郵便番号の境界のジオメトリ
• PSTLCMIDP マップ表示用の郵便番号エリアの中間地点
• PUBLIC_TRANSPORT_POI 公共交通機関の停留所、バス停、マップ表示用の地下鉄の駅などがあります
• ROAD_ADMIN_FC1...5 道路リンクの管理階層、郵便番号
• ROAD_ADMIN_NAMES_FC1...5 管理階層の道路リンクの正式な名前 ( ビルアップ、都市、地区、州、国 ) 。
• ROAD_GEOM_FC1...5 道路リンク情報、マップ表示のためのジオメトリ
• ROAD_NAME_FC1...5 道路リンク名
• ROAD_OVERVIEW マップ表示用の一般化された rad ジオメトリ
• ROAD_ROUGHNESS_FC1...5 ドライバーへの警告の路面粗さの分類
• ROUNDABOUT_FC1...5 ロータリー情報
• ROUTING_FC1...5 リンク情報、接続性、ルーティング条件のコンパクトな表現
• SAFETY_ALERTS ドライバーへの警告を目的とした、事故現場およびスピードカメラの位置
• SIGNPOST 方向指示標識情報
• SPEED_LIMITS_COND_FC1...5 制限速度の条件付き情報
• SPEED_LIMITS_FC1...5 車速制限情報
• SPEED_LIMITS_VAR_FC1...5 可変速度標識情報
• TOLLCOST_FC1...5 トールの計算および最適化のための Road トールのコスト情報
• TOLL_BOOTH_FC1...5 トールの計算および最適化のためのトールブース情報
• TOLL_LINK_FC1...5 トール計算 / 最適化のためのロードリンクトール情報
• TOPO_SEG_LINK_FC1...5 トポロジセグメント ID とオフセット 範囲のより新しいリンク ID の間をマップします。
• TRAFFIC_PATTERN_FC1...5 時間帯および曜日ごとの一般的なリンク速度
• TRAFFIC_SIGN_FC1...5 ドライバーアラートの交通標識情報
• TRAFFIC_SPEED_RECORD_FC1...5 過去 15 分間に解決されたライブトラフィック情報
• TRUCK POI トラックに特化した REST エリアとレストラン情報
• TRUCK_RESTR_FC1...5 ルート探索のためのトラック制限情報
• TRUCK_SPEED_LIMITS_FC1...5 トラック速度制限情報
• TURN_RESTR_FC1...5 制限情報を切り替えます
• VIRT_CONN 仮想接続リンク情報、ルーティング用のジオメトリ、マップ表示
• ARCHIVED_WEATHER 過去の天気予報。 履歴データは 15 分間隔で保存されます。

次の非タイルレイヤーを使用できます。

• ADMIN_REGULATIONS 管理レベルの規制、タイムゾーン
• ADMIN_TRUCK_RESTR 管理レベルのトラックの制限
• COUNTRY 国情報
• TC_ADMIN 管理者レベルの道路トール情報
• TC_SYSTEM トールオペレータ情報
• TC_TOLLSYS_NAMES トール演算子の名前
• TC_VEH_TYPES トール車両タイプ情報
• TRAFFIC_PATTERN 交通速度カーブ

詳細およびライセンス情報について は、 /v8/maps/layers/list.html サービスドキュメントを参照してください。

リソース v8/maps/layers/list.html に、使用可能なコアマップレイヤを示します。

一部のレイヤーには、トール 車両タイプの定義などの非空間データ ( 場所に依存しない ) が含まれています。 HERE Map Attributes API では、これらのレイヤーを「タイリングされていない」コンテンツレイヤーと呼びます。 アプリケーションは、常にフルレイヤーの内容を取得します（タイル ではなく、空間検索は行いません）。

別の例 : （タイリングされた）トラフィックパターンレイヤーのレコードにはが含ま PATTERN_IDれています。 オーディションに PATTERN_IDは、それぞれの完全な仕様を含む非タイルレイヤーがあります。

ファイル参照

フラットテキストファイル形式は HERE Core マップ データに適していますが、分岐点表示などのピクセル画像には適していません。 この種類のマップコンテンツでは、レイヤーにファイルパスが含まれています。

HERE Map Attributes API を介してコンテンツ自体を取得するには、 layer パラメーターの後にある path パラメーターを使用します。 ジャンクションビューの SVG などの外部ファイルデータで拡張できる場合、タイリングされたレイヤーまたはタイリングされていないレイヤーのパス情報が公開されます。

resource/v8/maps/file.bin ジャンクションビューのイメージを取得します。

インデックス

一部のレイヤーでは、特定の属性の検索インデックスを提供して効率的に検索できます。 たとえば、マップ データ 属性もインデックス化され、属性のキー / 値のペアに特定の値を含むタイルを要求できます。 resource/v8/maps/indexes.html に、コアマップレイヤで使用可能なインデックスを示します。

探しているマップオブジェクトの空間的な位置が不明な場合は、インデックスを使用します。 たとえば、リンク ID または管理者の場所 ID がわかっているとします。 場所がわかっている場合は、 tile.json または空間検索リソースを使用してデータを取得します。

index.json リソースは、 tile.json を介して取得できるように、要求されたオブジェクトがどのタイルであるかを示します。

resource /v8/maps/index は、道路ジオメトリレイヤーのタイルのリンク ID 17339738 および 17339811 が存在する場所を検索します。

タイルとタイルのサイズ ( レベル )

各レイヤーのデータは「長方形」の WGS84 度のタイルに分割され、効率的にアクセスできます。

（ A でカバーされているリージョン）マップ タイルのサイズは、レイヤーのタイルサイズの「レベル」によって異なります。 「レベル」番号が小さいほど、タイルのカバー範囲が広くなります。 たとえば、レベル 2 のタイルは、レベル 10 のタイルよりも広いリージョンをカバーします。

次の図に示すように、タイリングでは世界が再帰的に半分に分割されます。

• レベル 0 には 2 つの 1 つのタイル ( グリニッジの東と西 ) が含まれ、各タイルは 180 x 180 度で構成されています。
• レベル 1 には 4 つの 2 つのタイルが含まれ、 2 つのレベル 0 の各タイルは 4 つのパートに分割されます。
• レベル N では、各タイルは各方向に 180.0/(2 レベル ) 度で構成されています。

各レイヤーには固定のタイリングサイズ（レベル）があります。 道路リンクベースのレイヤーの場合、レベルは常に「道路機能クラス」 + 8 になります。たとえば、機能クラス 2 （ほぼ第 2 レベル）の道路を含むレイヤーのタイリングレベルは 10 になります。

レイヤーのタイリングは、ナビゲーションデータ標準（ NDS ）のタイリング方式に従います。

タイルは、その左と下の境界を「所有」します。つまり、これらの境界上のオブジェクトがこのタイルに属しています。 タイルの右上または右側の境界にあるマップオブジェクトは、それぞれのネイバータイルに属しています。 ただし、ポイントの場合、タイルには、右側または上部の境界にあるポイントも含まれています ( コピーされたもの ) 。

ポリラインとポリゴンはタイルの境界でカットされます。

したがって、境界上に人工的な点が作成され、そのようにマークされます。 これらの人工的な点は、同じ座標を持つ両方のタイルに存在します。 タイルの境界でカットされたポリゴンは、両側で閉じられます。 このタイリングスキーマでは、次のいずれかの操作を行うことができます。

• タイリングを無視し、タイリングされたフラグメントを別々のマップオブジェクトとして使用します
• 追加の形状を削除し、タイル状の形状を元に戻します
• 人工的なタイリング線の描画を多角形の境界線として非表示にします

タイル状の形状の一部が、リンク ID や直交 / フェース ID などの同じ永続 ID を持っている場合、互いに属していると識別できます。

一部のレイヤーではジオメトリがタイルピースにカットされませんが、オブジェクトのジオメトリ全体がカバーする各タイルにコピーされます。 これについては、各レイヤーのドキュメントで説明されています。 レイヤーの詳細について は、「レイヤー、インデックス、および属性」を参照してください。

タイルリンクは次のように表されます。

• タイル A - 開始ノード、シェイプポイント、人工シェイプポイント
• タイル B - 人工的なシェイプポイント、シェイプポイント、エンドノード

人工シェイプは、前のシェイプポイントを基準とした相対座標値としても表されます。

座標「緯度」、「経度」のマップオブジェクトをリクエストするタイルはどれですか？

レイヤー内の特定の座標をカバーするタイル ID を次のように計算します。

          tile size = 180° / 2^level [degree]
          tileY = trunc((latitude  +  90°) / tile size)
          tileX = trunc((longitude + 180°) / tile size)
          tileID = tileY * 2 * (2^level) + tileX

マップ オブジェクト識別子

各レイヤーには、「識別子」と呼ばれる 1 つ（または複数）のキー属性があります。 たとえば、道路セグメントは、グローバル、一意、永続的にリンク ID で識別されます。

オブジェクトの HERE マップ オブジェクト識別子は変更されません。 ただし、道路セグメントが分割された場合、パーツは新しい（異なる）識別子を取得し、古い識別子は使用されなくなります。

識別子を使用して、複数のレイヤーにまたがるマップオブジェクトを結合します。 たとえば、道路ジオメトリレイヤーのリンク ID を取得して、制限速度レイヤーの制限速度値に基づいて識別子を付けます。

最も頻繁に使用される識別子は、リンク ID です。

• リンクは、固定された属性のセットを持つ道路です。 リンクは、交差点で終了するか、制限速度などの属性が変更されたときに終了します。
• リンクの両端にノードがあります。 左下のノード ( 下の緯度、または下の経度と等しい場合、または下の z レベルと等しい場合 ) は、参照ノードと呼ばれます。 もう一方のノードは非参照ノードと呼ばれます。 ノードは、道路沿いの属性の変更に 2 つのリンクを接続できます。または、交差点がある場合は複数のリンクを接続できます。
• 各リンクは、リンク ID によってグローバルに識別されます。

リージョンをマップします

HERE マップは、次のリージョンに分かれています。

• ANTARC –南極大陸
• アジア太平洋地域
• AUS ：オーストラリア
• 中国料理
• eEU –東欧
• HKG –香港
• 指標–インド
• JPN - 日本
• MEA –中東アフリカ
• NA –北米
• SAM ：南米
• TWN –台湾
• WEU –西ヨーロッパ

HERE Map Attributes API への要求は、 region パラメータを使用して 1 つ以上のリージョンを参照できます。 ただし、ほとんどの場合、リージョンパラメータはオプションです。ただし、 doc/maps リソースを使用する場合を除きます。

マップのリリース

HERE は、地図の内容を毎週更新します。 既定では、 HERE Map Attributes API は各地図地域で利用可能な最新の地図リリースを提供します。 ただし、 API では、古い地図リリースもオンデマンドで提供されており、 release パラメータを使用して選択できます。 古い地図コンテンツの可用性と価格については、 TCS （テクニカル カスタマー サポート） にお問い合わせください。

顧客のマップ - 自分のデータを持ってきてください

顧客は、アトリビューション機能を使用して、ポイント、ポリライン、およびポリゴンを含む独自のプライベートマップを独自のレイヤーで作成できます。 顧客のマップは、 HERE Maps と同じ方法で検索、取得、および使用できます。 顧客は、店舗の場所、追加のマップ表示コンテンツ、店舗検索などの検索にプライベートマップを使用します。

顧客地図には、道路ネットワークに対する変更を含めることもできます。 これらのマップは、 HERE マップネットワークに「オーバーレイ」し、ルーティングサービスの動作を変更します。 オーバーレイマップを使用すると、道路の追加、道路属性の変更 ( アクセス権、一方向の方向、重量制限、走行速度など ) 、道路のブロックを行うことができます。 顧客は、オーバーレイマップを使用して、個人の施設内の道路、個々の荷降ろし所までの経路指定を可能にするか、または車両の特定の道路をブロック / 許可 / 優先することができます。

顧客のマップには複数のレイヤーを含めることができます。 一般的に、検索、表示、更新されているオブジェクトは 1 つのレイヤーにまとめられます。 1 つのレイヤー内で、マップオブジェクトのタイプは同じである必要があります。 レイヤーには、ポイント、ライン、またはポリゴンが含まれています。 1 つのレイヤーには、マップ表示およびストアロケーターアプリケーションの保存場所が含まれ、もう 1 つのレイヤーには店舗およびウェアハウスの周囲の到着 等値線 (Isoline) ポリゴンが含まれます。さらに、別のレイヤーには、配達トラックの 5 分ごとの正確な位置が含まれます。

ホーム PRD で独自のデータを作成、視覚化、管理できます。

カスタム地図コンテンツをアップロードしています

顧客は、 HERE Map Attributes API REST コールを使用してプライベート地図をアップロードおよび更新できます。 マップレイヤーは、 csv のプレーンテキストまたはシェープファイル形式でアップロードできます。 道路地図は "overlay.json" 形式でアップロードできます。

csv およびシェープファイル形式のジオメトリ行には、任意の属性列を含めることができます。 csv ファイルの各行には、マップ オブジェクト属性と WKT ジオメトリ ( ポイント、ライン、ポリゴンなど ) が含まれています。 列名は [a-z] [a-zA-Z0-9_] * に準拠している必要があります。 列名には、空白以外の空白文字は使用できません ( タブ、 CR 、 LF 、バックスペース、 Unicode FFFE 、 または同様の休憩）。

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

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

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

次 のコンテンツを含むリソース /v8/maps/upload を POST ボディ のファイルに保存すると、 1 つのストアを持つレイヤーがアップロードされます。 アップロードには POST リクエストを使用する必要があります。

POI_ID NAME SIZE_m2 WKT 12345 Walmart_Munich 650 ポリゴン (12.43236 41.93602,12.40524 41.86165,12.70084 41.89233,12.70084 41.89233,12.43236 41.93602)

resource/v8/maps/overlays/upload 道路の通行許可を変更して道路を追加するオーバーレイをアップロードします。 アップロードには POST リクエストを使用する必要があります。

resource/v8/maps/list.html には、顧客のプライベート地図が一覧表示されます。'mapType' の値は、 0 （デフォルトのパブリック + プライベート）、 1 パブリック、 2 プライベートのいずれかにする必要があります。/v8/maps/layers/list.html マップのレイヤーの一覧を示します。

ホーム PRD で独自のデータを作成、視覚化、管理できます。

カスタムマップ タイルサイズ

検索 / 表示のパフォーマンスを最適化するには、レイヤーのタイルサイズを選択します。 デフォルトはレベル 12 で、 3 km × 3 km のタイルが使用されます。

2 km × 2 km の市の中心部に 10,000 ポイントなど、局所的に高密度なジオメトリが層に含まれている場合は、より小さなグリッドサイズを選択する必要があります。 それ以外の場合、この都市での各検索操作には、 10,000 ポイントすべてが含まれます。 参考までに、レベル 13 は 1.5km × 1.5km のグリッド、レベル 14 は 750m × 750m のグリッドです。

レイヤー内のジオメトリが大きなリージョンに散在している場合は、たとえば地球を 100 ポイント移動する場合は、大きいグリッドサイズを選択する必要があります。 それ以外の場合、各検索操作は 10 、 000 個の空のタイルで実行されます。 参考までに、レベル 11 は 6km x 6km のグリッド、レベル 10 は 12km x 12km のグリッド、レベル 9 は 24km x 24km のグリッド、レベル 8 は 48km x 48km のグリッドです。

検索できるタイル数は 150 に制限されています。 これが重要な場合は、タイルサイズを選択する際に考慮する必要があります。

マップストレージ

カスタムマップには、「更新可能」と「読み取り専用」の 2 つのストレージタイプがあります。 個々のレコードの挿入、更新、削除、および「更新可能」なマップストレージへのレコードの追加を行うことができます。 「読み取り専用」ストレージ内の地図は変更できません。 代わりに、地図全体を再度アップロードする必要があります。

カスタムマップのデフォルトの保存場所は更新可能ですが、道路のオーバーレイマップは常に「読み取り専用」の保存場所に保存されます。 検索と取得のパフォーマンスが向上するため、ほとんど変更されない大きなマップの場合は、「読み取り専用」を選択します。