地政学的見解

ほとんどの国の国境は国際的に合意されています。一方で、場合によっては、どの地域がどの国の一部であるかに関する国の意見が異なります。たとえば、インドとパキスタンは、カシミール地域が完全にそれぞれの国に属していると考えており、それぞれの国の地図にはその見解が反映されることが予想されます。一方、国際地図では、カシミール地方は国境が係争中の地域として扱われます。

HERE Vector Tile APIでは、これらのいずれかの見解に基づいてレンダリングできるため、顧客は地域の慣習や適用法に準拠できます。

使用可能な政治的見解を取得する

The HERE Vector Tile APIはpoliticalViewsエンドポイントを提供します。このエンドポイントを使用すると、地図で利用可能な地政学的見解を取得できます。

地図で使用可能な地政学的見解のリストをリクエストするには、次の例に示すように、/politicalViewsエンドポイントを使用します。

https://vector.hereapi.com/v2/vectortiles/politicalViews
?apiKey=YOUR_HERE_API_KEY

詳細については、「APIリファレンス」を参照してください。

politicalViewsリクエストを行うと、レスポンスは以下の簡略化された例のようになり、マップレイヤーごとに利用可能な政治的見解が一覧表示されます。

{
  "base": [
    "ab",
    "ar",
    "cy",
    "eg"
  ],
  "core": [
    "ab",
    "ar",
    "cy",
    "eg"
  ]
}

📘
注

地政学的見解のリストはクライアントアプリケーションに保存できます。

リストは24時間ごとに更新する必要があります。

政治的見解に基づいて地図を表示する

デフォルトでは、レンダラーにはインターナショナルビューが表示されます。アプリケーションが政治的見解を必要とする特定の国のユーザーを対象としている場合にのみ、政治的見解を選択してください。

📘
注
一部のレンダラーは政治的見解の切り替えをまったくサポートしていない可能性があります。

政治的見解の選択はレンダラーによって異なります。HERE Maps API for Javascriptの場合は、単一のパラメーターを設定することでこれを構成できます。

マップデータにおける政治的見解の可視化

HERE OMVタイルでは、政治的見解は追加のkind::xx属性を使用して実装されます (ここで、xxは使用可能な地政学的見解の1つを表します)。選択された政治的見解xxを持つ政治的見解対応レンダラーは、地図のスタイルを設定するために、kindの値をkind:xxの値で上書きします (後者の属性が特定のエンティティに存在する場合)。

例：南パタゴニア氷原

南パタゴニアで、特定の場所を表示したい場合があるとします。この場所は、チリとアルゼンチンの間で南パタゴニア氷原の一部が争われています。対応するベクトルタイルのデータには、次のプロパティが含まれています。

紛争中の地域の周囲の長方形の境界の場合：

"properties": {
    "$layer": "boundaries",
    "kind": "disputed",
    "kind:ar": "unrecognized_disputed",
    ...
}

次のプロパティがある、その地域を通過する追加の境界の場合：

"properties": {
    "$layer": "boundaries",
    "kind": "",
    "kind:ar": "country",
    ...
}

つまり、インターナショナルビュー (kind属性のみが考慮される) では、紛争中の長方形の地域 (kind=disputedを含む) は、争われていることを視覚化するために破線の境界で描画されますが、その地域を通過する境界は重要ではない (値のないkind) とみなされ、まったく描画されません。

対照的に、アルゼンチンのビュー (kind:arの値がkindの値よりも優先される) では、長方形の境界 (kind:ar=unrecognized_disputed) は認識されず、まったく描画されません。代わりに、その地域を通過する境界 (kind:ar=countryを含む) は、チリとアルゼンチンの間の国境であると見なされます。

次の図は、前の例で説明したように、国際的な政治的見解とアルゼンチンの政治的見解の地図の違いを示しています。

インターナショナルビュー	アルゼンチンのビュー