Place の結果を除外する方法

このチュートリアルでは、オプションのパラメーターtypesを使用 して、/geocode エンドポイントの結果リストから Place の結果を除外する方法を示します。

プロシージャ

/geocode エンドポイントにはオプションのパラメータtypesがあり 、結果を特定のタイプに限定できます。

placeの結果を除外するために必要な結果タイプのフィルターの値は次のとおりです。

• address - 結果の種類houseNumber、 street、 postalCodePoint、intersection、またはaddressBlockを制限 します。
• area - 結果を結果タイプに限定 : locality または administrativeArea すべてのサブタイプを含みます。

/geocode エンドポイントでサポートされているtypesフィルタのその他の値は次のとおりです。citypostalCode,street, houseNumber - 詳細については、 API リファレンス を確認してください。

たとえば、 'Harfowa, Warszawa' を検索する場合、 'ulica Harfowa' という名前の道路と 'Harfowa' という名前の近くのバス停の 2 つの関連する結果がある可能性があります。 型フィルタを使用しない場合 place 、 resultType がのバスステーション結果のみが返されます。これは、より正確で、クエリ名と完全に一致するためです。

{
  "items": [
    {
      "title": "Harfowa",
      "id": "here:pds:place:616q9wpy-4be9c9c2e0060d9880fa7e8d8d3fc104",
      "resultType": "place",
      "address": {
        "label": "Harfowa, ulica Włodarzewska, 02-384 Ochota, Polska",
        "countryCode": "POL",
        "countryName": "Polska",
        "state": "Woj. Mazowieckie",
        "county": "Warszawa",
        "city": "Warszawa",
        "district": "Ochota",
        "subdistrict": "Szczęśliwice",
        "street": "ulica Włodarzewska",
        "postalCode": "02-384"
      },
      "position": {
        "lat": 52.2017,
        "lng": 20.96456
      },
      "access": [
        {
          "lat": 52.20162,
          "lng": 20.96435
        }
      ],
      "categories": [
        {
          "id": "400-4100-0042",
          "name": "Przystanek autobusowy",
          "primary": true
        }
      ],
      "scoring": {
        "queryScore": 1,
        "fieldScore": {
          "city": 1,
          "placeName": 1
        }
      }
    }
  ]
}

パラメータを使用すると types=address,area 、顧客アプリケーションでは Place の結果が除外されることがあります。

GET https://geocode.search.hereapi.com/v1/
    geocode
    ?q=Harfowa%2C+Warszawa
    &types=address%2Carea
    &apiKey={YOUR_API_KEY}

次のパラメータが使用されます。

• Q - フリーテキストのクエリを入力します。
• types - レスポンスに含めるタイプのコンマ区切りのリスト。
• apiKey - お客様の API キー 。

上記のリクエストに対するレスポンスは、バス停ではなく、通りとのあいまいな一致 ulica Harfowaになります。

{
  "items": [
    {
      "title": "ulica Harfowa, 02-389 Ochota, Polska",
      "id": "here:af:streetsection:RZk.ZvMCIgkrPBiscT2oGB",
      "resultType": "street",
      "address": {
        "label": "ulica Harfowa, 02-389 Ochota, Polska",
        "countryCode": "POL",
        "countryName": "Polska",
        "state": "Woj. Mazowieckie",
        "county": "Warszawa",
        "city": "Warszawa",
        "district": "Ochota",
        "subdistrict": "Szczęśliwice",
        "street": "ulica Harfowa",
        "postalCode": "02-389"
      },
      "position": {
        "lat": 52.20009,
        "lng": 20.96503
      },
      "mapView": {
        "west": 20.96401,
        "south": 52.19966,
        "east": 20.96639,
        "north": 52.20156
      },
      "scoring": {
        "queryScore": 1,
        "fieldScore": {
          "city": 1,
          "streets": [
            0.9
          ]
        }
      }
    }
  ]
}

追加情報

/geocode パラメータの詳細については、次のトピックを参照してください。 API リファレンス。

さまざまなエンドポイントによるtypes フィルタサポートの概要については、次の点を確認してください。 結果をタイプでフィルタリングします。