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

テキスト文字列を使用して場所を検索します

chrysler 名前に単語が含まれている場所など、特定の場所を検索するには、次の GET リクエストを送信します。

https://places.ls.hereapi.com/places/v1/autosuggest
?at=40.74917,-73.98529
&q=chrysler
&apiKey={YOUR_API_KEY}
注 : この例 では、 HERE API キー を使用してリクエストを認証します。 使用可能な認証オプションについて は、『 Identity & Access Management 開発者ガイド』を参照してください。
上記のリクエストに対する応答には、次のハイレベルな要素が含まれています。
  • results 提案された場所を表すアイテムを含む配列
  • メタデータ–タイトル、位置、カテゴリ、バウンディング ボックスなど、各場所の情報

ほとんどの Web ブラウザでは、応答を含む折りたたまれた配列が提供されています。

{
  "results": [
    { "Chrysler Building" },
    { "Chrysler Camera Repair" },
    { "Manhattan CHRYSLER" },
    { "Chrysler Cleaners Inc" },
    { "Chrysler Stationery & Gift Inc" },
    { "Chrysler Tower Periodontics" },
    { "Major World CHRYSLER" },
    { "Chrysler Auto Repair" },
    { "Hudson CHRYSLER" },
    { "Teterboro CHRYSLER" },
    { "Riverdale CHRYSLER" },
    { "Major CHRYSLER DODGE Jeep" },
    { "Bayside CHRYSLER" },
    { "Star CHRYSLER" },
    { "Route 46 CHRYSLER" },
    { "Chrysler-Plymouth Authorized Sales & Service" },
    { "Monroe" },
    { "Kacey Chrysler" },
    { "Chrysler Rd" },
    { "CHRYSLER" }
  ]
}

展開すると、アレイ内の各アイテムにその場所に関する追加情報が表示されます。

{
  "title": "Chrysler Building",
  "highlightedTitle": "<b>Chrysler</b> Building",
  "vicinity": "405 Lexington Ave\nNew York, NY 10017",
  "position": [ 40.75185, -73.97572 ],
  "category": "sights-museums",
  "href": "https://...",
  "type": "urn:nlp-types:place"
}