場所の結果

場所の結果は POI (施設情報) を表します。ポイントには名前、位置、住所、ポイントを特徴付けている機能を
定義したカテゴリーのリストが含まれます。「場所の結果」(短縮して「場所」とも呼ばれます)は
さまざまで、レストラン、電気自動車充電所、空港、スタジアムなどがあります。

HERE Geocoding and Searchの場所の結果は、resultTypeレスポンス要素のplace値から特定できます。

場所のカテゴリーとフードタイプ

サブタイプのフィールドcategoriesには、その位置のさまざまな機能を参照するIDのリストが
含まれます。

レストランの結果(レベル2カテゴリーIDが100-1000の結果)の場合、サブタイプfoodTypesにはレストランが提供する料理のIDの
リストが含まれます。

マルセイユのGlacier Vanille Noireの場合：

  {
    "title": "Vanille Noire",
    "id": "here:pds:place:250jx7ps-8f300d0f8ec60e31fb76a3d22f00f18f",
    "language": "en",
    "resultType": "place",
    "address": {
        "label": "Vanille Noire, 13 Rue Caisserie, 13002 Marseille, France",
        "countryCode": "FRA",
        "countryName": "France",
        "stateCode": "PAC",
        "state": "Provence-Alpes-Cote d'Azur",
        "county": "Bouches-du-Rhône",
        "city": "Marseille",
        "district": "2nd Arrondissement",
        "street": "Rue Caisserie",
        "postalCode": "13002",
        "houseNumber": "13"
    },
    "position": { "lat": 43.2972, "lng": 5.36871 },
    "access": [{ "lat": 43.29723, "lng": 5.36866 }],
    "categories": [
        { "id": "100-1000-0000", "name": "Restaurant", "primary": true },
        { "id": "600-6300-0064", "name": "Food/Beverage Specialty Store" },
        { "id": "700-7200-0253", "name": "Catering & Other Food Services" }
    ],
    "references": [
        { "supplier": { "id": "core" }, "id": "1149014863" },
        { "supplier": { "id": "tripadvisor" }, "id": "25550756" },
        { "supplier": { "id": "tripadvisor" }, "id": "6596803" },
        { "supplier": { "id": "yelp" }, "id": "LNW8pvVArKkCYg_SM0WfXQ" }
    ],
    "foodTypes": [{ "id": "800-063", "name": "Ice Cream", "primary": true }],
    "contacts": [
        {
            "phone": [{ "value": "+33777336819" }],
            "mobile": [{ "value": "+33777336819", "categories": [{ "id": "100-1000-0000" }, { "id": "600-6300-0064" }] }],
            "www": [{ "value": "https://www.facebook.com/275599309268684", "categories": [{ "id": "600-6300-0064" }] }],
            "email": [{ "value": "[email protected]", "categories": [{ "id": "100-1000-0000" }] }]
        }
    ],
    "openingHours": [
        {
            "text": ["Mon-Sun: 13:00 - 19:00"],
            "isOpen": true,
            "structured": [
                { "start": "T130000", "duration": "PT06H00M", "recurrence": "FREQ:DAILY;BYDAY:MO,TU,WE,TH,FR,SA,SU" }
            ]
        }
    ]
}

place タイプの結果には 1 つ以上のカテゴリーが必要です。

場所に該当する可能性があるカテゴリーのリストから、1 つをプライマリにする必要があります。これはブール型属性primaryで指定します。
この属性はcategoriesリスト要素の1つに設定されています。先ほどの例では、プライマリカテゴリーは 100-1000-0000 (レストラン) となります。

このレストランでは、フードタイプ800-063 (アイスクリーム)を提供しています。

カテゴリーとフードタイプの名前で使用される言語はHERE Geocoding and Searchの「言語の動作」に従います。

📘
注：
place結果タイプはカバレージに応じて郵便番号または詳細な郵便番号を返すことができます。詳細については、住所の結果の詳細な郵便番号を参照してください。

場所のその他のベース属性

必須のcategoriesフィールドとオプションのfoodTyesフィールドに加え、場所の結果には
placeタイプに固有のその他の属性が含まれる場合があります。

contacts - place 結果のプレースカテゴリーごとの問い合わせ情報 (電話、Web など) のリスト
openingHours - place 結果のプレースカテゴリーごとの営業時間のリスト
chains - 場所のチェーンメタデータ。顧客がチェーンアイコンを選択できるようにします。
accessRestriction - プレースカテゴリーごとの車両規制情報のリスト。

この情報は現在、次のいずれかのカテゴリーに該当する場所でのみ利用可能です。
- レベル 2 800-8500：駐車場
- レベル 3 700-7900-0131：トラック駐車場
references - データソースID (場所の結果に以下のような
特定のサプライヤーからの情報を使用している場合)。たとえば、
- yelp：Yelp Fusion API に使用
- tripadvisor：Tripadvisor 位置情報エンドポイントに使用
- core：コアPOI (施設情報)コンテンツ(RDF、GDF、NAVSTREETS、File Geodatabase、POI XML)を含むHERE Map Data製品の場合

{}

場所の結果を返すエンドポイント：
/discover、
/autosuggest、
/lookup、
/browse、
/geocode
/revgeocode

📘
注
/geocodeおよび/revgeocodeエンドポイントが返す場所に追加の属性は含まれません。