ハイブリッドクエリを作成する

このチュートリアルでは、ハイブリッドクエリを使用する方法を説明します。

手順

修飾された入力と自由形式の入力を組み合わせることができます。たとえば、エンドユーザーが自由形式のテキストを 1 か所の検索ボックスに入力し、アプリケーションがバックグラウンドで地域に特化した構造化要素を提供する場合に役立ちます。

また、アプリケーションでエンドユーザーに自由形式の住所テキストの入力ボックスと、郵便番号のドロップダウンボックスを表示する例も考えられます。

郵便番号が 83300 に設定された住所クエリ 141 Boulevard Émile Thomas は、次のように作成できます。

GET https://geocode.search.hereapi.com/v1/
    geocode
    ?q=141+Boulevard+Émile+Thomas
    &qq=
        postalCode=83300
    &apiKey={YOUR_API_KEY}

次のパラメーターを使用します。

q - フリーテキストクエリを入力します。
qq - 修飾クエリを入力します。修飾クエリはフリーテキストクエリに似ていますが、構造化されています。セミコロンで区切って複数のサブパラメーターを指定できるため、クエリのさまざまな側面を指定できます。
apiKey - APIキー。

📘
注
このリクエストはAPIキー認証を使用します。HEREプラットフォームの認証オプションの詳細については、「Identity & Access Management Guide」(IDとアクセス管理ガイド)を参照してください。

上のリクエストに対するレスポンスは次のようになります。

{
  "items": [
    {
      "title": "141 Boulevard Émile Thomas, 83300 Draguignan, France",
      "id": "here:af:streetsection:hqlRKFTx4wa5F6e9DhA2HA:CggIBCCd0YiOAxABGgMxNDEoZA",
      "resultType": "houseNumber",
      "houseNumberType": "PA",
      "address": {
        "label": "141 Boulevard Émile Thomas, 83300 Draguignan, France",
        "countryCode": "FRA",
        "countryName": "France",
        "stateCode": "PAC",
        "state": "Provence-Alpes-Côte d'Azur",
        "county": "Var",
        "city": "Draguignan",
        "street": "Boulevard Émile Thomas",
        "postalCode": "83300",
        "houseNumber": "141"
      },
      "position": {
        "lat": 43.52944,
        "lng": 6.47991
      },
      "access": [
        {
          "lat": 43.52938,
          "lng": 6.48023
        }
      ],
      "mapView": {
        "west": 6.47867,
        "south": 43.52854,
        "east": 6.48115,
        "north": 43.53034
      },
      "scoring": {
        "queryScore": 1,
        "fieldScore": {
          "streets": [
            1
          ],
          "houseNumber": 1,
          "postalCode": 1
        }
      }
    }
  ]
}

追加情報

/geocodeエンドポイントパラメーターの詳細については、「APIリファレンス」を参照してください。