Places (Search) API 開発者ガイド ( 場所 ( 検索 ))

カテゴリエントリーポイントを配置します

このエントリーポイントを使用して、特定の場所で利用できる場所のカテゴリを取得します。このエントリーポイントを使用して、ユーザーに選択するカテゴリのリストを提供できます。 Place Categories エントリーポイントは、誘導された非周期グラフで編成された、ローカルに関連するカテゴリのセットを表します。カテゴリグラフは今後変更される可能性があり、リクエストの場所によって異なる場合があります。永続的なトップレベルの Place カテゴリのセットは、 Categories で見つけることができます。

Place Categories エントリーポイントは Places ( 検索 ) APICore エントリーポイントです。

エントリーポイント URI

/categories/places

エントリーポイントパラメータ

パラメーター	タイプ	説明
の時刻	位置 (format:) `latitude,longitude[;cgen=(map\|gps\|sgps)][;u=\d+]`。 Geolocation ヘッダー、 X-Map-Viewport ヘッダー、または `in` が設定されていない場合は必須です。	緯度、経度で表された検索場所の座標。不確実性や座標の生成方法など、より多くのコンテキストを提供する追加のパラメーターを渡すことができます。たとえば、「 52.5304417,13.4111201 」、「 52.5304417,13.4111201 ； cgen=gps ； u=100 」または「 52.5304417,13.4111201 ； u=100 」のように入力します。詳細については、ロケーションコンテキストのドキュメントを参照してください。
インチ	領域。 Geolocation ヘッダー、 X-Map-Viewport ヘッダー、 `at` またはパラメーターのいずれかが設定されていない場合に必要です。	このパラメータは、結果を指定した領域の境界に限定します。検索範囲は次のように表現できます。 `circle` 中心点（緯度）と中心点（経度）で指定し、その点を中心とする半径を指定します。形式 : latitude 、 longitude; r=\\d+(\\.\\d+)?[; cgen=(map\|gps\| sgps)][; u=\\d+] `bounding box` West 経度、 South 緯度、 east 経度、 north 緯度を示す 4 つの値で指定します。詳細については、ロケーションコンテキストのドキュメントを参照してください。

メソッドを取得します

get メソッドを使用すると、特定の位置に関連する Place カテゴリにアクセスできます。リクエストにそのような場所が指定されていない場合、応答には API によって認識されたすべての場所のカテゴリを含むグラフが含まれます。

応答メディアタイプ

このエンドポイントへの要求に対する応答 urn:nlp-types:category-graph には、メディアタイプが割り当てられます。 urn:nlp-types:category-graph 応答の構造および内容の詳細については、メディアタイプのドキュメントを参照してください。

リクエストの例

https://places.sit.ls.hereapi.com/places/v1/categories/places
?app_id={YOUR_APP_ID}
&app_code={YOUR_APP_CODE}
&at=52.50449,13.39091
&pretty

応答の例

{
  "items": [
    {
      "id": "eat-drink",
      "title": "Eat & Drink",
      "icon": "http://...",
      "type": "urn:nlp-types:category",
      "href": "http://...",
      "within": [ ]
    },
    {
      "id": "restaurant",
      "title": "Restaurant",
      "icon": "http://...",
      "type": "urn:nlp-types:category",
      "href": "http://...",
      "within": [ "eat-drink" ]
    },
    {
      "id": "snacks-fast-food",
      "title": "Snacks/Fast food",
      "icon": "http://...",
      "type": "urn:nlp-types:category",
      "href": "http://...",
      "within": [ "eat-drink" ]
    },
    ...
  ]
}