適切なクエリの作成

このチュートリアルでは、適切なクエリの使用方法について説明します。

プロシージャ

/geocode エンドポイントの適切なアドレス入力は、アドレステキストが別々のフィールドにキャプチャされた場合のオプションです。 たとえば、サインアッププロセスの一部として、または構造化された入力が必要な場合に使用します。

たとえば、住所「 425 W Randolph St, Chicago, IL 606, 米国」は、次のサブパラメータのセットとして認定できます。

• houseNumber = 425
• 番地 = W Randolph St
• 市区町村 = シカゴ
• 州 = IL
• 郵便番号 = 60606
• 国 = 米国

この場合のcountry は、住所の認定フィールドであり、単一の国名または大文字の国コードをサポートしています。 大文字の ISO 3166-1 アルファ -3 国コードのリストで結果を制限するには、パラメーターin を使用してください。

このクエリは、次の条件で作成できます。

GET https://geocode.search.hereapi.com/v1/
    geocode
    ?qq=
        houseNumber=425;
        street=W+Randolph+St;
        city=Chicago;
        state=IL;
        postalCode=60606;
        country=United+States
    &apiKey={YOUR_API_KEY}

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

• qq - 適切なクエリの入力。適切なクエリは、フリーテキストクエリと似ていますが、構造化されています。 複数のサブパラメータをセミコロンで区切って指定できます。このサブパラメータを使用すると、クエリーのさまざまな側面を指定できます。
• apiKey - お客様の API キー 。

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

{
  "items": [
    {
      "title": "425 W Randolph St, Chicago, IL 60606-1506, United States",
      "id": "here:af:streetsection:hdZ6xBRUraY46IQZCqZidD:CgcIBCDMlOElEAEaAzQyNShk",
      "resultType": "houseNumber",
      "houseNumberType": "PA",
      "address": {
        "label": "425 W Randolph St, Chicago, IL 60606-1506, United States",
        "countryCode": "USA",
        "countryName": "United States",
        "stateCode": "IL",
        "state": "Illinois",
        "county": "Cook",
        "city": "Chicago",
        "district": "West Loop",
        "street": "W Randolph St",
        "postalCode": "60606-1506",
        "houseNumber": "425"
      },
      "position": {
        "lat": 41.88432,
        "lng": -87.63877
      },
      "access": [
        {
          "lat": 41.88449,
          "lng": -87.63877
        }
      ],
      "mapView": {
        "west": -87.63998,
        "south": 41.88342,
        "east": -87.63756,
        "north": 41.88522
      },
      "scoring": {
        "queryScore": 1,
        "fieldScore": {
          "country": 1,
          "state": 1,
          "city": 1,
          "streets": [
            1
          ],
          "houseNumber": 1,
          "postalCode": 1
        }
      }
    }
  ]
}

/geocode エンドポイントでは、住所行に結合された街路名と番地もサポートされています。 住所の行は、サブパラメータで指定できます street

上記のクエリは、次の条件で作成することもできます。

• 番地 =425 W Randolph St
• 市区町村 = シカゴ
• 州 = IL
• 郵便番号 = 60606
• 国 = 米国

GET https://geocode.search.hereapi.com/v1/
    geocode
    ?qq=
        street=425+W+Randolph+St;
        city=Chicago;
        state=IL;
        postalCode=60606;
        country=United+States
    &apiKey={YOUR_API_KEY}

追加情報

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