このチュートリアルでは、ハイブリッドクエリの使用方法について説明します。
プロシージャ
適切な自由形式の入力を組み合わせることができます。 たとえば、エンドユーザーが自由形式のテキストを 1 つの検索ボックスに入力し、アプリケーションがローカルフォーカスの背景に構造化された要素を提供する場合に役立ちます。
別の例として、アプリケーションがエンドユーザーに自由形式の住所テキストの入力ボックス ( 郵便番号のドロップダウンボックスなど ) を提供する場合があります。
141 Boulevard Émile Thomas
郵便番号がに設定された住所検索 83300
は、次の条件で作成できます。
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 platform の認証オプションの詳細については、『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 リファレンス。