ジオコード エリア

このチュートリアルでは、領域の地理座標を検索する方法について説明します。

プロシージャ

/geocode エンドポイントを使用して、都市、都市の地区、郵便番号、国、州、国などの地域の地理座標を検索することもできます。 地理座標はこの領域のルーティングの宛先です。 行政地区の場合、「有名な」通り、中央駅、または自動車を利用できるその他の重要な道路になることがあります。

たとえば、ドイツの首都の地理座標を返す自由形式のテキストクエリ Berlin は、次のように記述できます。

GET https://geocode.search.hereapi.com/v1/
    geocode
    ?q=Berlin
    &apiKey={YOUR_API_KEY}

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

• Q - フリーテキストのクエリを入力します。
• apiKey - お客様の API キー 。

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

{
  "items": [
    {
      "title": "Berlin, Deutschland",
      "id": "here:cm:namedplace:20187403",
      "resultType": "locality",
      "localityType": "city",
      "address": {
        "label": "Berlin, Deutschland",
        "countryCode": "DEU",
        "countryName": "Deutschland",
        "stateCode": "BE",
        "state": "Berlin",
        "countyCode": "B",
        "county": "Berlin",
        "city": "Berlin",
        "postalCode": "10117"
      },
      "position": {
        "lat": 52.51604,
        "lng": 13.37691
      },
      "mapView": {
        "west": 13.08835,
        "south": 52.33812,
        "east": 13.761,
        "north": 52.6755
      },
      "scoring": {
        "queryScore": 1,
        "fieldScore": {
          "city": 1
        }
      }
    }
  ]
}

領域の結果には、次の高レベルのエレメントが含まれます。

• resultType - または locality administrativeArea
• localityType - ローカルのタイプ。 resultType が、locality、
  • postalCode
  • city
  • district
  • subdistrict
  の場合に返されます
• administrativeAreaType - 管理エリアのタイプ。 resultType の場合に返されます administrativeArea
  • country
  • state
  • county
• title –エリア名の代表的な文字列
• address - エリアの詳細な管理構造
• position - 結果の代表的な地理的位置 (WGS 84) 。 これは、結果を地図に表示し、結果にアクセスするために使用されます
• mapView - 表示用に最適化された場所のバウンディング ボックス
• id - 結果オブジェクトの識別子。 その値を使用 して、/lookup　エンドポイントを介してまったく同じオブジェクトを取得
• scoring - /geocode エンドポイントがスコアリング情報を返します。スコアリング情報は、元のクエリとの一致度を結果ごとに示します。 エンド ユーザーアプリケーションでは、ユースケースの「コスト」の誤りに応じて、このエラーを受け入れたり拒否したりするために使用できます。

access 位置は面積結果に含まれていません。

追加情報

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