ガイドAPIリファレンス
ガイド
  1. ラスタタイルAPI v3開発ガイド
  2. HERE Raster Tile APIガイド
  3. HERE Raster Tile APIの概念

地政学的見解 - HERE Raster Tile API

HERE Raster Tile APIには、国際的見解や現地国の見解 (地政学的見解) に基づいた境界のある地図をレンダリングするために使用できるpviewパラメーターが用意されています。値はISO 3166-1 alpha-2国コードスキーマに準拠しています。ローカルの見解が利用できる特定の国で地図が使用される場合を除き、通常は国際的見解が使用されます。pview パラメーターが指定され、見解がサポートされている場合は、選択した国の見解の境界が表示されます。そうでない場合は、デフォルトの境界ビューが表示されます。

典型的なユースケースは、世界の特定の地域が複数の国々によって争われていると見なされるケースです。そのため、国ごとにその地域がその一部として表示されます。国Aの地政学的見解で特定のタイルをリクエストすると、レスポンスでは、その地域が国Aに属する地域として表示されます。同様に、国Bの地政学的見解でタイルをリクエストすると、レスポンスでは、その地域が国Bに属する地域として表示されます。

📘

注

次の例では、HERE APIキーを使用してリクエストを認証します。使用可能な認証オプションについては、「利用開始」を参照してください。

任意：サポートされている地政学的見解のリストを取得する

利用可能なすべての地政学的見解の現在のリストを取得するには、次の例に示すように、/politicalViewsエンドポイントにリクエストします。

https://maps.hereapi.com/v3/politicalViews
?apiKey=YOUR_HERE_API_KEY

レスポンス：

レスポンスボディはJSONファイルであり、ISO 3166-1 alpha-2スキーマに準拠した国コードのリストを提供します。各コードは、特定のマップリソースタイプで使用可能な地政学的見解に対応しています。次のスニペットは、/politicalViewsエンドポイントから取得したJSONレスポンスの簡単な例を示しています。

{
  "background":["AB","AR","CN","CY"],
  "base":["AB","AR","CN","CY"],
  "blank":["AB","AR","CN","CY"],
  "label":["AB","AR","CN","CY"]
}

地政学的見解を適用する

たとえば、インド亜大陸のカシミール地方の特定の場所を表示する場合、最初のリクエストにはデフォルトの国際的見解が表示されます。この見解では、インドとパキスタンの境界線が点線で表示され、ジャンムー、カシミール、ラダックの各領域を区別しています。

https://maps.hereapi.com/v3/base/mc/4/11/6/png?size=512
&apiKey=YOUR_HERE_API_KEY
&lang=en

レスポンス：

同じタイルをパキスタンの見解を使用してリクエストすると、実線の国境が表示され、これらの領域に対するパキスタンの政治的姿勢が示されます。

https://maps.hereapi.com/v3/base/mc/4/11/6/png
?size=512
&apiKey=YOUR_HERE_API_KEY
&lang=en
&pview=PK

レスポンス：

次の例に示すように、このタイルをインドの見解を使用してリクエストすることもできます。

https://maps.hereapi.com/v3/base/mc/4/11/6/png?size=512
&apiKey=YOUR_HERE_API_KEY
&lang=en
&pview=IN

レスポンス：

次のステップ

  • サポートされているすべてのエンドポイントとパラメーターについては、「APIリファレンス」を参照してください。
  • HERE Raster Tile APIをより実践的に体験するには、このガイドのチュートリアルセクションを参照してください。

14 日前の更新