地政学的見解

HERE Vector Tile APIは 、マップの利用可能な地政学的見解を取得するために使用できる pviewsエンドポイントを提供します。マップで使用可能な地政学的見解のリストを要求するには、 pviewsエンドポイントを使用します。

リクエストpviews を作成すると、次の例のようなレスポンスが返されます。

{
    "base": [
      "cn",
      "ar"
    ]
}

地政学的見解のリストをクライアント アプリケーション に保存できます。 この値は 24 時間ごとに更新する必要があります。

レイヤーの境界と場所の説明を確認して、詳細情報を取得してください。

これらのビューを使用して、国際的またはローカルな国の視点に基づいて、境界とラベルのあるマップを表示できます。 一般に、地図が独自のローカルビューを持つ特定の国を対象としている場合を除き、国際ビューが使用されます。 レンダラーがkind:xxの値を指定した 場合、xxは利用可能な地政学的ビューの 1 つを表し、そのビューでデータが利用可能になると、選択した国ビューの境界とラベルが表示されます。 それ以外の場合は、デフォルトの境界とラベルが表示されます。

一般的なシナリオは、世界の特定の地域が複数の国によって争われているか、または特定の国によって独立した州または別の国の一部として認識されていない場合に発生します。 その結果、各国はそのエリアをその一部として描写し、特定のラベルを適宜表示または制限します。 A 国の地政学的観点から特定のタイルを要求すると、回答には A 国の地域が示されます。同様に、 B 国の地政学的観点からタイルを要求すると、その地域が B 国に属していることが示されます

たとえば、ユーザーが South Patagonia の特定の場所を参照したいとします。

そのタイルのデータには、boundariesに関する次の情報が含まれています。

"properties": {
    "$layer": "boundaries",
    "$zoom": 5,
    "$id": 0,
    "kind": "country",
    "kind_detail": 2,
    "sort_rank": 262,
    "min_zoom": 1,
    "kind:ar": "unrecognized_country"
}
(...)
"properties": {
        "$layer": "boundaries",
        "$zoom": 5,
        "$id": 0,
        "kind": "disputed",
        "kind_detail": 2,
        "sort_rank": 261,
        "min_zoom": 1,
        "kind:ar": "unrecognized_disputed"
    }

kind:ar つまり、これらのboundariesはアルゼンチンの地政学的な見方によって争われています。 既定では、レンダラーがこの設定を反映しない場合、既定のビュー ( 国際ビュー ) が表示され、チリとアルゼンチンの南パタゴニアの氷のフィールドを示す破線の境界線が表示されます。

kind:arアルゼンチンの同じタイルビューを使用する場合は、アイスフィールドに対するアルゼンチンの ビューを表す実線の枠線が表示されます。

別の例として、キプロスの国ラベルがあります。 ラベルには、選択した政治的ビューに応じて異なる表現があります。

既定値

"properties": {
    "name:sq": "Qipro",
    "name:ko": "키프러스",
    "name": "Κύπρος",
    ...
    "kind": "country",
    "kind:tr": "unrecognized_country",
    "kind:nt": "unrecognized_country",
    "kind:cy": "unrecognized_country",
    "iso_code": "CY",
    "min_zoom": 5
}

キプロス

"properties": {
    "name:sq": "Qipro",
    "name:ko": "키프러스",
    "name": "Κύπρος",
    ...
    "kind:cy": "country",
    "iso_code": "CY",
    "min_zoom": 5
}

トルコ料理

"properties": {
    "name:tr": "Güney Kıbrıs Rum Yönetimi",
    "name:en": "Greek Cypriot Administration",
    "name": "Güney Kıbrıs Rum Yönetimi",
    "kind:tr": "country",
    "iso_code": "CY",
    "min_zoom": 5
}

北キプロス共和国

"properties": {
    "name:tr": "Güney Kıbrıs Rum Yönetimi",
    "name:en": "Greek Cypriot Administration",
    "name": "Güney Kıbrıs Rum Yönetimi",
    "kind:nt": "country",
    "iso_code": "CY",
    "min_zoom": 5
}