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

料理のカテゴリーエントリーポイント

このエントリーポイントは、特定の場所で利用できる料理のカテゴリを取得するために使用されます。 このエントリーポイントを使用して、ユーザーに選択するカテゴリのリストを提供できます。 Cuisine Categories エントリーポイントは、地域に関連する一連のカテゴリを、指示された非周期グラフで表示します。 カテゴリグラフは今後変更される可能性があり、リクエストの場所によって異なる場合があります。

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

エントリーポイント URI

/categories/cuisines

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

パラメーター タイプ 説明
の時刻 位置 (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 メソッドを使用すると、特定の位置に関連する料理カテゴリにアクセスできます。 リクエストに該当する場所が指定されていない場合、 API によって認識されたすべての料理カテゴリのグラフがレスポンスに含まれます。

応答メディアタイプ

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

リクエストの例

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

応答の例

{
  "items": [
    {
      "id": "cuisines",
      "title": "Cuisines",
      "type": "urn:nlp-types:category",
      "href": "http://...",
      "within": [ "eat-drink", "food-drink" ]
    },
    {
      "id": "cuisines.barbecue",
      "title": "Barbecue",
      "type": "urn:nlp-types:category",
      "href": "http://...",
      "within": [ "cuisines" ]
    },
    {
      "id": "cuisines.burger",
      "title": "Burgers",
      "type": "urn:nlp-types:category",
      "href": "http://...",
      "within": [ "cuisines" ]
    },
    ...
  ]
}