地政学的見解

HERE Geocoding and Search では、特定の国の観点から、未解決の要求がある地域を表示できます。既定では、 HERE Geocoding and Search は、このような係争中の地域について、 HERE 地政学委員会によって定義された中立的な見解を示します。

顧客アプリケーションは politicalView 、パラメータを設定することで、地政学的見解を選択できます。このパラメータは、すべての大文字の単一 ISO 3166-1 アルファ -3 国コードを受け入れます。は politicalView 、異議を申し立てた地域内のすべての結果タイプに影響を与えます。

たとえば、現在サポートされている地政学見解の 1 つに、フォークランド諸島のスタンレーに対するアルゼンチンの見解があります。 HERE Geocoding and Search は、フォークランド諸島の一部としてデフォルトで表示されます。アルゼンチン市場をターゲットとする顧客アプリケーションの場合、 HERE Geocoding and Search ではアルゼンチンの一部として表示されているスタンリーを使用してアルゼンチンの地政学的見解を設定できます。

現在サポートされている地政学的見解および異議を申し立てられている地域の一覧表については、サポートされている地政学的見解を参照してください。サポートされている地政学見解の一覧表は、次の HERE Geocoding and Search リリースで拡張されます。

関連するエンドポイント : /geocode、 /revgeocode、 /autocomplete、 /discover、 /autosuggest、/lookup、/browse

次の例では、 politicalView ユーザーがパラメータを指定せずにフォークランド諸島のStanleyにある　Daiary Paddock Road, を検索しています。

GET https://geocode.search.hereapi.com/v1/
    geocode
    ?q=dairy paddock road
    &at=-51.7849655,-58.9185672
    &lang=en-US
    &apiKey={YOUR_API_KEY}

HERE Geocoding and Search は、フォークランド諸島の一部として示されている、Daiary Paddock Roadの結果を返します。

{
    "items": [
        {
            "title": "Dairy Paddock Road, Stanley, Falkland Islands",
            "id": "here:af:street:qiUkYNPzbysXsXmMMZcLtB",
            "resultType": "street",
            "address": {
                "label": "Dairy Paddock Road, Stanley, Falkland Islands",
                "countryCode": "FLK",
                "countryName": "Falkland Islands",
                "county": "Falkland Islands",
                "city": "Stanley",
                "street": "Dairy Paddock Road"
            },
            "position": {
                "lat": -51.69499,
                "lng": -57.86533
            },
            "distance": 73208,
            "mapView": {
                "west": -57.86554,
                "south": -51.69655,
                "east": -57.86504,
                "north": -51.69344
            },
            "scoring": {
                "queryScore": 1.0,
                "fieldScore": {
                    "streets": [
                        1.0
                    ]
                }
            }
        }
    ]
}

politicalViewのパラメータをARGに設定した同じクエリ。

GET https://geocode.search.hereapi.com/v1/
    geocode
    ?q=dairy paddock road
    &at=-51.7849655,-58.9185672
    &lang=en-US
    &politicalView=ARG
    &apiKey={YOUR_API_KEY}

HERE Geocoding and Search は、アルゼンチンのスタンリーにあるDairy Paddock Roadの結果を返します。

{
    "items": [
        {
            "title": "Dairy Paddock Road, Puerto Argentino, Argentina",
            "id": "here:af:street:RTR6gs71ARSRWkMWTagJHD",
            "politicalView": "ARG",
            "resultType": "street",
            "address": {
                "label": "Dairy Paddock Road, Puerto Argentino, Argentina",
                "countryCode": "ARG",
                "countryName": "Argentina",
                "stateCode": "TF",
                "state": "Land of Fire, Ant. and S. Atl. Is.",
                "county": "Islas Malvinas (Arg.)",
                "city": "Puerto Argentino",
                "street": "Dairy Paddock Road"
            },
            "position": {
                "lat": -51.69499,
                "lng": -57.86533
            },
            "distance": 73208,
            "mapView": {
                "west": -57.86554,
                "south": -51.69655,
                "east": -57.86504,
                "north": -51.69344
            },
            "scoring": {
                "queryScore": 1.0,
                "fieldScore": {
                    "streets": [
                        1.0
                    ]
                }
            }
        }
    ]
}

HERE Geocoding and Search が専用の地政学的見解を持たない有効な 3 文字の国コードについては、デフォルトのビューに戻ります。たとえば、politicalView=USA または politicalView=FRA は、どのような方法でもレスポンスに影響を与えません。

このフォールバックロジックによる誤解を避けるために、 HERE Geocoding and Search では、結果の各項目に対するレスポンスに、結果の項目の実際の地政学的見解を示す新しいフィールドpoliticalViewが含まれています。リクエストに politicalView パラメータが含まれている場合にのみ、レスポンスに含まれます。現在 politicalView 、このフィールドでサポートされている値は default および ARGです。

上記の 2 つの例のうち最初 politicalView の方では、顧客アプリケーションがパラメータを設定していません。そのため、結果の項目には 2 番目の例の politicalView フィールドが含まれていません。結果の項目にはアルゼンチンの地政学的見解が含まれ、その回答には politicalView フィールドが含まれており、ARG に設定されています。

politicalView パラメータがに設定された同じクエリー DEUです。有効な値ですが、フォークランド諸島に関する専用の地政学的見解はありません。

GET https://geocode.search.hereapi.com/v1/
    geocode
    ?q=dairy paddock road
    &at=-51.7849655,-58.9185672
    &lang=en-US
    &politicalView=DEU
    &apiKey={YOUR_API_KEY}

HERE Geocoding and Search は、フォークランド諸島の一部として、スタンレーにあるDaiary Paddock Roadのデフォルトの地政学的見解を戻します。結果アイテムには politicalView 、 default次のように設定されたフィールドが含まれます。

{
    "items": [
        {
            "title": "Dairy Paddock Road, Stanley, Falkland Islands",
            "id": "here:af:street:qiUkYNPzbysXsXmMMZcLtB",
            "politicalView": "default",
            "resultType": "street",
            "address": {
                "label": "Dairy Paddock Road, Stanley, Falkland Islands",
                "countryCode": "FLK",
                "countryName": "Falkland Islands",
                "county": "Falkland Islands",
                "city": "Stanley",
                "street": "Dairy Paddock Road"
            },
            "position": {
                "lat": -51.69499,
                "lng": -57.86533
            },
            "distance": 73208,
            "mapView": {
                "west": -57.86554,
                "south": -51.69655,
                "east": -57.86504,
                "north": -51.69344
            },
            "scoring": {
                "queryScore": 1.0,
                "fieldScore": {
                    "streets": [
                        1.0
                    ]
                }
            }
        }
    ]
}

パラメータpoliticalViewに認められていない値がある場合、 GS7 は「 400 」エラーコードを返します。認められていない値の例 : politicalView=Argentina politicalView=arg politicalView=default politicalView=UK,ARG

ID での地政学的見解のLookup

異なる地政学的見解を持つ、異議を申し立てられた地域の住所、番地、行政区は、それぞれ異なる値 idを持つことがあります。 Endpoint/lookupに問い合わせている間、顧客のアプリケーションは値 id と値politicalViewを一致させることを保証する必要があります。それ以外の場合、Endpoint/lookupはエラーコード404 (Not Found): Location ID conflicts with political viewでレスポンスします。これは、placeの結果とは異なります。同じidを持つ場所出会っても、地政学的見解については独立しています。 Endpoint/lookupは、/lookup で呼ばれるpolitical viewのパラメータで指定され地政学的見解の管理構造を含むこの場所を返します。

地政学的見解

地政学的見解

ID での地政学的見解のLookup

「」に一致する結果は件です

「」に一致する結果はありません

開発者

地政学的見解

ID での地政学的見解のLookup

「」に一致する結果は 件です

「」に一致する結果はありません

開発者

「」に一致する結果は件です