結果のスコアリングを使用
このチュートリアルでは、 API がスコアリング情報を返す方法について説明します。
プロシージャ
/geocode
エンドポイントがスコアリング情報を返します。スコアリング情報は、元のクエリとの一致度を結果ごとに示します。 このエラーは、顧客のユースケース に対する「コスト」に応じて、顧客のアプリケーションが結果を承認または拒否するために使用できます。
住所の自由形式のテキストクエリ 240 Washington St., Boston
は、次のように作成されます。
GET https://geocode.search.hereapi.com/v1/
geocode
?q=240+Washington+St.%2C+Boston
&apiKey={YOUR_API_KEY}
次のパラメータが使用されます。
- Q - フリーテキストのクエリを入力します。
- apiKey - お客様の API キー 。
注
この要求は API キー 認証を使用します。 HERE platform の認証オプションの詳細については、『ID およびアクセス管理ガイド』を参照してください。
住所が正しいか、誤りや入力ミスがないか、アドレス指定に関連のないコンテンツが含まれていません。
上記のリクエストに対する応答は、次のように表示されます。
{
"items": [
{
"title": "240 Washington St, Boston, MA 02108-4603, United States",
"id": "here:af:streetsection:YCY1nQWrJ5eBrHv075VVOD:CggIBCDns4LfAhABGgMyNDAoZA",
"resultType": "houseNumber",
"houseNumberType": "PA",
"address": {
"label": "240 Washington St, Boston, MA 02108-4603, United States",
"countryCode": "USA",
"countryName": "United States",
"stateCode": "MA",
"state": "Massachusetts",
"county": "Suffolk",
"city": "Boston",
"district": "Downtown Boston",
"street": "Washington St",
"postalCode": "02108-4603",
"houseNumber": "240"
},
"position": {
"lat": 42.35814,
"lng": -71.05765
},
"access": [
{
"lat": 42.35815,
"lng": -71.05788
}
],
"mapView": {
"west": -71.05887,
"south": 42.35724,
"east": -71.05643,
"north": 42.35904
},
"scoring": {
"queryScore": 1,
"fieldScore": {
"city": 1,
"streets": [
1
],
"houseNumber": 1
}
}
},
{
"title": "240 Washington St, Boston, MA 02135-3508, United States",
"id": "here:af:streetsection:6SnFDsUujYAamxhLX-Vr1D:CgcIBCDRnLAhEAEaAzI0MChk",
"resultType": "houseNumber",
"houseNumberType": "PA",
"address": {
"label": "240 Washington St, Boston, MA 02135-3508, United States",
"countryCode": "USA",
"countryName": "United States",
"stateCode": "MA",
"state": "Massachusetts",
"county": "Suffolk",
"city": "Boston",
"district": "Brighton Center",
"street": "Washington St",
"postalCode": "02135-3508",
"houseNumber": "240"
},
"position": {
"lat": 42.34754,
"lng": -71.14943
},
"access": [
{
"lat": 42.34765,
"lng": -71.14925
}
],
"mapView": {
"west": -71.15065,
"south": 42.34664,
"east": -71.14821,
"north": 42.34844
},
"scoring": {
"queryScore": 1,
"fieldScore": {
"city": 1,
"streets": [
1
],
"houseNumber": 1
}
}
}
]
}
結果には 、次の 2 つの部分で構成されるブロック scoring
が含まれます。
-
queryScore
– 0 ~ 1 の値で、返された住所に一致する入力の割合を表します。 すべての入力トークンが認識され、照合された場合、 1 になります。 入力クエリに追加の情報 ( 個人の名前、電話番号、または 2 回鳴るヒント ) が含ま queryScore
れている場合、の値は低くなりますが、結果は正しい可能性があります。 ただし、 low queryScore
の場合、結果が入力クエリの住所の一部の関連する部分と一致しないことを示している可能性があります。 -
fieldScore
–結果フィールドがクエリの対応する部分とどの程度一致するかを示す 0 ~ 1 の値。 国内での住所指定に重要なすべてのフィールドが高品質と一致する場合 queryScore
、追加の非住所情報のため、このフィールドの値が低くなると想定できます。 その結果、まだ自信を持っています。
/geocode
パラメータの詳細については、次のトピックを参照してください。 API リファレンス。