地政学的見解を尊重する
地図に表示される政治的境界は、表示されている国によって異なります。一部の地域では国境が争われ、異なる国が同じ地域に対して権利を主張しています。HERE Raster Tile APIは、地図をレンダリングするときに使用する国の視点を指定できるpviewパラメーターを使用してこの問題を解決します。
pviewを使用すると、次のことが可能になります。
- 国境線を特定の国の視点で表示する
- 紛争地域をユーザーに代わって適切に処理する
- 国コード(ISO 3166-1 alpha-2フォーマット)を使用して地政学的な視点を指定する
たとえば、pview=IN (インドの視点)でタイルをリクエストすると、インドが定義するインド-パキスタンの国境が表示されます。pview=PK (パキスタンの視点)では、同じ地域がパキスタンの定義どおりに表示されます。pviewを指定しない場合、デフォルトのインターナショナルビューが表示されます。
構文
次のスニペットは、pviewパラメーターを含むサンプルリクエストです。
GET https://maps.hereapi.com/v3/base/mc/6/21/31/png?pview=GY&apiKey={YOUR_API_KEY}pview=GYはガイアナの地政学的視点を前提とした地図を作成します。
pviewパラメーターでは許容値として、AR、PK、INなどのISO 3166-1言語コードを使用できます。
サポートされている地政学的ビューのリストをリクエストする
利用可能なすべての地政学的見解の現在のリストを取得するには、次の例に示すように、/politicalViewsエンドポイントにリクエストします。
GET https://maps.hereapi.com/v3/politicalViews?apiKey={YOUR_API_KEY}レスポンスボディはJSONファイルであり、ISO 3166-1 alpha-2スキーマに準拠した国コードのリストを提供します。各コードは、特定のマップリソースタイプで使用可能な地政学的ビューに対応しています。次のスニペットは、/politicalViewsエンドポイントから取得したJSONレスポンスの簡略化した例です。
{"background":["AB","AE","AR","BR","CY","EG","EH","GE","GF","GR","GY","HR","IL","IN","KE","MA","MW","NT","OS","PK","PS","RS","RU","SD","SR","SS","SY","TR","TZ","US","UY","VN","XK"],"base":["AB","AE","AR","BR","CY","EG","EH","GE","GF","GR","GY","HR","IL","IN","KE","MA","MW","NT","OS","PK","PS","RS","RU","SD","SR","SS","SY","TR","TZ","US","UY","VN","XK"],"blank":["AB","AE","AR","BR","CY","EG","EH","GE","GF","GR","GY","HR","IL","IN","KE","MA","MW","NT","OS","PK","PS","RS","RU","SD","SR","SS","SY","TR","TZ","US","UY","VN","XK"],"label":["AB","AE","AR","BR","CY","EG","EH","GE","GF","GR","GY","HR","IL","IN","KE","MA","MW","NT","OS","PK","PS","RS","RU","SD","SR","SS","SY","TR","TZ","US","UY","VN","XK"]}例
次の例は、さまざまな地政学的視点の設定が、地図の国境線と領土にどのように影響するかを示しています。それぞれの例は、同じ地理的位置を異なるpviewパラメーター値でレンダリングしたものです。これにより、同じ地域が異なる国の視点でどのように表示されるかを比較できます。
インターナショナルな視点
インド亜大陸のカシミール地域の特定の場所を表示する場合、最初のリクエストではデフォルトのインターナショナルビューが表示されます。このビューでは、インドとパキスタンの国境が点線で表示され、ジャンムー、カシミール、ラダックの各領土を可視化しています。
GET https://maps.hereapi.com/v3/base/mc/4/11/6/png?size=512&apiKey={YOUR_API_KEY}&lang=en
パキスタンの視点
同じタイルをパキスタン側のビューを使用してリクエストすると、実線の国境が表示され、これらの領域に対するパキスタンの政治的姿勢が示されます。
GET https://maps.hereapi.com/v3/base/mc/4/11/6/png?size=512&apiKey={YOUR_API_KEY}&lang=en&pview=PK
インドの視点
次の例に示すように、このタイルをインドのビューを使用してリクエストすることもできます。
GET https://maps.hereapi.com/v3/base/mc/4/11/6/png?size=512&apiKey={YOUR_API_KEY}&lang=en&pview=IN
次のステップ
- マップラベルのローカライズについては、「ラベルの言語を設定する」を参照してください。
- 使用可能なビジュアルテーマについては、「スタイルを適用する」を参照してください。
- APIエンドポイントとリクエストパラメーターの詳細については、「APIリファレンス」を参照してください。
26 日前の更新