Addressの結果

HERE Geocoding and Search は、非常に詳細なアドレス関連の結果を返します。

resultType 値 localityは、 street、 houseNumber、 administrativeArea、addressBlock、 intersection、 postalCodePointのいずれかです。

これらの各Addressの結果には、詳細な優先順位付けを可能にする追加のサブタイプを含めることができます。たとえば、 locality の結果は、 locality サブタイプ city、 postalCode、district 、subdistrictのいずれかになります。

Addressのサブタイプは、次の表に要約できます。

`resultType` 値	サブタイプフィールド	サブタイプのフィールド値
`locality`	`localityType`	`city` `postalCode` `district` `subdistrict`
`administrativeArea`	`administrativeAreaType`	`country` `state` `county`
`houseNumber`	`houseNumberType`	`PA` `interpolated`
`addressBlock`	`addressBlockType`	`block` `subblock`
`intersection`	( なし )
`street`	( なし )
`postalCodePoint`	( なし )

Addressのタイプの結果は、住所の最も高い粒度を表していることに注意してください。たとえば、 houseNumberタイプの結果には、レスポンス要素addressに常に houseNumber フィールドが含まれます。追加の要素は street、city、および country フィールドです。A streetタイプの結果自体には、レスポンス要素addressにフィールドhouseNumberがありません。

Locality

タイプの結果 locality には、 localityType タイプの結果をさらに定義する追加のフィールドがあります。postalCode、 city、 district、 subdistrict

警告

新しい localityType 値は、予告なくリストに追加されます。 HERE Geocoding and Search を使用するアプリケーションは、一覧表が固定されていると想定してはなりません。

localityType 各値の結果の例 :

city

PARIS, イルドフランス , フランス :

{
  "title": "Paris, Ile-de-France, France",
  "id": "here:cm:namedplace:20002128",
  "resultType": "locality",
  "localityType": "city",
  "address": {
      "label": "Paris, Ile-de-France, France",
      "countryCode": "FRA",
      "countryName": "France",
      "stateCode": "IDF",
      "state": "Ile-de-France",
      "county": "Paris",
      "city": "Paris",
      "postalCode": "75001"
  },
  "position": { "lat": 48.85717, "lng": 2.3414 },
  "mapView": { "west": 2.22383, "south": 48.81571, "east": 2.4698, "north": 48.90248 }
}

postalCode

10965 、ベルリン、ドイツ :

{
  "title": "10965, Berlin, Germany",
  "id": "here:cm:namedplace:22067656",
  "resultType": "locality",
  "localityType": "postalCode",
  "address": {
      "label": "10965, Berlin, Germany",
      "countryCode": "DEU",
      "countryName": "Germany",
      "stateCode": "BE",
      "state": "Berlin",
      "countyCode": "B",
      "county": "Berlin",
      "city": "Berlin",
      "postalCode": "10965"
  },
  "position": { "lat": 52.48663, "lng": 13.38445 },
  "mapView": { "west": 13.42115, "south": 52.47668, "east": 13.36716, "north": 52.49658 }
}

district

バックベイ、ボストン、マサチューセッツ州、米国：

{
  "title": "Back Bay, Boston, MA, United States",
  "id": "here:cm:namedplace:23026323",
  "resultType": "locality",
  "localityType": "district",
  "address": {
      "label": "Back Bay, Boston, MA, United States",
      "countryCode": "USA",
      "countryName": "United States",
      "stateCode": "MA",
      "state": "Massachusetts",
      "county": "Suffolk",
      "city": "Boston",
      "district": "Back Bay"
  },
  "position": { "lat": 42.35093, "lng": -71.07606 },
  "mapView": { "west": -71.09317, "south": 42.33982, "east": -71.06046, "north": 42.36159 }
}

subdistrict

インド、ニューデリー、ニューデリー、グールマーケット、 DIG エリア :

{
  "title": "Dig Area, Gole Market, New Delhi, Delhi, India",
  "id": "here:cm:namedplace:27681054",
  "resultType": "locality",
  "localityType": "subdistrict",
  "address": {
      "label": "Dig Area, Gole Market, New Delhi, Delhi, India",
      "countryCode": "IND",
      "countryName": "India",
      "stateCode": "DL",
      "state": "Delhi",
      "county": "New Delhi",
      "city": "New Delhi",
      "district": "Gole Market",
      "subdistrict": "Dig Area",
      "postalCode": "110001"
  },
  "position": { "lat": 28.6351, "lng": 77.2034 },
  "mapView": { "west": 77.19864, "south": 28.6282, "east": 77.20862, "north": 28.64109 }
}

結果localityを返すエンドポイント : /discover、 /autosuggest、 /lookup、/browse、 /geocode、/autocomplete、/revgeocode

Administrative Area

タイプの結果 administrativeArea には、 administrativeAreaType タイプの結果をさらに定義する追加のフィールドがあります。country、、 state county

警告

新しい administrativeAreaType 値は、予告なくリストに追加されます。 HERE Geocoding and Search を使用するアプリケーションは、一覧表が固定されていると想定してはなりません。

administrativeAreaType 各値の結果の例 :

country

アンドラ :

{
  "title": "Andorra",
  "id": "here:cm:namedplace:20300625",
  "resultType": "administrativeArea",
  "administrativeAreaType": "country",
  "address": {
      "label": "Andorra",
      "countryCode": "AND",
      "countryName": "Andorra",
  },
  "position": { "lat": 42.50514, "lng": 1.52604 },
  "mapView": { "west": 1.41382, "south": 42.42873, "east": 1.78659, "north": 42.65601 }
}

state

CA 、米国：

{
  "title": "CA, United States",
  "id": "here:cm:namedplace:21009408",
  "resultType": "administrativeArea",
  "administrativeAreaType": "state",
  "address": {
      "label": "CA, United States",
      "countryCode": "USA",
      "countryName": "United States",
      "stateCode": "CA",
      "state": "California"
  },
  "position": { "lat": 38.57944, "lng": -121.49085 },
  "mapView": { "west": -124.40962, "south": 32.53429, "east": -114.13084, "north": 42.00946 }
}

county

ベルン－ミッテラン、ベルン、スイス :

{
  "title": "Bern-Mittelland, Berne, Switzerland",
  "id": "here:cm:namedplace:20138838",
  "resultType": "administrativeArea",
  "administrativeAreaType": "county",
  "address": {
      "label": "Bern-Mittelland, Berne, Switzerland",
      "countryCode": "CHE",
      "countryName": "Switzerland",
      "stateCode": "BE",
      "state": "Berne",
      "county": "Bern-Mittelland"
  },
  "position": { "lat": 46.89559, "lng": 7.46262 },
  "mapView": { "west": 7.08269, "south": 46.67091, "east": 7.73215, "north": 47.12267 }
}

結果administrativeAreaを返すエンドポイント : /discover、 /autosuggest、 /lookup、/browse、 /geocode、/autocomplete、/revgeocode

Address block

タイプの結果 addressBlock は、日本の住所システムの一部です。結果には、タイプの結果をさらに定義する追加のフィールドaddressBlockTypeがあります： block、subblock

警告

新しい addressBlockType 値は、予告なくリストに追加されます。 HERE Geocoding and Search を使用するアプリケーションは、一覧表が固定されていると想定してはなりません。

addressBlockType 各値の結果の例 :

block

Yo Wakuramachi, Nanao-shi, Ishikawa, 926-0175 Japan: （〒 926-0175 石川県七尾市若浦町代ヨ）

{
  "title": "Yo Wakuramachi, Nanao-shi, Ishikawa, 926-0175 Japan",
  "id": "here:xs1:namedplace-loc:45000060",
  "resultType": "addressBlock",
  "addressBlockType": "block",
  "address": {
      "label": "Yo Wakuramachi, Nanao-shi, Ishikawa, 926-0175 Japan",
      "countryCode": "JPN",
      "countryName": "Japan",
      "state": "Ishikawa",
      "city": "Nanao-shi",
      "subdistrict": "Wakuramachi",
      "block": "Yo",
      "postalCode": "926-0175"
  },
  "position": { "lat": 37.08958, "lng": 136.91425 },
  "mapView": { "west": 136.91076, "south": 37.08727, "east": 136.91688, "north": 37.09136 }
}

subblock

Yo-80 Wakuramachi, Nanao-shi, Ishikawa, Japan: （石川県七尾市若浦町ヨ-80）

{
  "title": "Yo-80 Wakuramachi, Nanao-shi, Ishikawa, Japan",
  "id": "here:xs1:pointaddress:15349663",
  "resultType": "addressBlock",
  "addressBlockType": "subblock",
  "address": {
      "label": "Yo-80 Wakuramachi, Nanao-shi, Ishikawa, Japan",
      "countryCode": "JPN",
      "countryName": "Japan",
      "state": "Ishikawa",
      "city": "Nanao-shi",
      "subdistrict": "Wakuramachi",
      "block": "Yo",
      "subblock": "80"
  },
  "position": { "lat": 37.09006, "lng": 136.91445 }
}

結果addressBlockTypeを返すエンドポイント : /discover、 /autosuggest、 /lookup、/browse、 /geocode、/revgeocode

House Number

houseNumber 結果は、住居レベルの詳細住所を含むAddressの結果です。

タイプの結果 houseNumber には、タイプの結果をさらに定義する追加のフィールドhouseNumberType があります。：interpolated, PA

PA 「ポイントアドレス」を表し、その家の非常に正確な位置を示します。ポイントアドレスは、個々のアドレスをポイントオブジェクトとして表します。信頼できる送信元からポイントアドレスが送信されています。住所がどこにあるかを確信を持って伝えることができます。

interpolated 結果の精度はわずかに低下しますが、高度に最適化された補間アルゴリズムに基づいています。これらは、アドレス範囲に基づく線形補間の結果としてのおおよその位置です。住所範囲は、特にアメリカではブロックあたりの一般的なものです。補間された住所については、住所が実際に存在することを確信して表明することはできません。しかし、補間によって、ほとんどの使用例のユーザーをターゲットの場所に近づける、適切な位置の近似が提供されます。

警告

新しい houseNumberType 値は、予告なくリストに追加されます。 HERE Geocoding and Search を使用するアプリケーションは、一覧表が固定されていると想定してはなりません。

houseNumberType 各値の結果の例 :

PA

Invalidenstra ß e 116 、 10115 Berlin 、ドイツ :

{
  "title": "Invalidenstraße 116, 10115 Berlin, Germany",
  "id": "here:af:streetsection:tVuvjJYhO86yd5jk1cmzNB:CgcIBCCE59BeEAEaAzExNihk",
  "resultType": "houseNumber",
  "houseNumberType": "PA",
  "address": {
      "label": "Invalidenstraße 116, 10115 Berlin, Germany",
      "countryCode": "DEU",
      "countryName": "Germany",
      "stateCode": "BE",
      "state": "Berlin",
      "countyCode": "B",
      "county": "Berlin",
      "city": "Berlin",
      "district": "Mitte",
      "street": "Invalidenstraße",
      "postalCode": "10115",
      "houseNumber": "116"
  },
  "position": { "lat": 52.53086, "lng": 13.38469 },
  "access": [{ "lat": 52.531, "lng": 13.38461 }],
  "mapView": { "west": 13.374, "south": 52.5279, "east": 13.39892, "north": 52.53262 }
}

houseNumber 結果には 2 種類の座標が含まれます。 1 つはアクセスポイント ( またはナビゲーション座標 ) で、ドライブを開始または終了するポイントです。もう 1 つの点は位置または表示点です。ポイントの住所の場合、このポイントはソースおよび国によって異なります。このポイントは、屋上のポイント、建物の入口に近いポイント、または建物、私道、または建物に属する駐車場に近いポイントです。

interpolated

32 Kings Road, Aylesbury, HP21 7RR, イギリス :

{
  "title": "32 Kings Road, Aylesbury, HP21 7RR, England",
  "id": "here:af:streetsection:i9hvb4V431Jy2My7jXGrqD:EAIaAjMyKGQ",
  "resultType": "houseNumber",
  "houseNumberType": "interpolated",
  "address": {
      "label": "32 Kings Road, Aylesbury, HP21 7RR, England",
      "countryCode": "GBR",
      "countryName": "England",
      "countyCode": "BKM",
      "county": "Buckinghamshire",
      "city": "Aylesbury",
      "district": "Aylesbury",
      "street": "Kings Road",
      "postalCode": "HP21 7RR",
      "houseNumber": "32"
  },
  "position": { "lat": 51.81521, "lng": -0.80388 },
  "access": [{ "lat": 51.81509, "lng": -0.80396 }],
  "mapView": { "west": -0.80415, "south": 51.81439, "east": -0.80142, "north": 51.81515 }
}

補間された住所結果のアクセスポイントは、住所範囲と道路の形状に基づいて計算されます。位置 ( 表示 ) ポイントは、道路のジオメトリから事前に設定されたオフセットです。

PA building 情報を提供します

ポイントアドレスの結果に建物名が含まれることもあります。建物名は、建物またはプロパティの名前を表すテキストのアドレスです。自宅の電話番号の代わりに使用することも、自宅の電話番号に追加することもできます。 HERE Geocoding and Search は houseNumber 、と houseNumberTypePAplace の結果の建物名のみを返し、住所に建物名が含まれている場合は結果の建物名を返します。

HERE Geocoding and Search では、ビルディング名が buildingaddress 個 titlelabel々のフィールドとしてブロックおよび結果の項目と住所に含まれます。

Rowes Arcade 、 235 Edward St 、 Brisbane City QLD 4000 、オーストラリア :

{
  "items": [
    {
      "title": "Rowes Arcade, 235 Edward St, Brisbane City QLD 4000, Australia",
      "id": "here:af:streetsection:0F0TpRZ0MvzcapjbTh.5eD:CggIBCDjguazARABGgMyMzUiDFJvd2VzIEFyY2FkZQ",
      "resultType": "houseNumber",
      "houseNumberType": "PA",
      "address": {
        "label": "Rowes Arcade, 235 Edward St, Brisbane City QLD 4000, Australia",
        "countryCode": "AUS",
        "countryName": "Australia",
        "stateCode": "QLD",
        "state": "Queensland",
        "city": "Brisbane",
        "district": "Brisbane City",
        "street": "Edward St",
        "postalCode": "4000",
        "houseNumber": "235",
        "building": "Rowes Arcade"
      },
      "position": { "lat": -27.46794, "lng": 153.02697 },
      "access": [{ "lat": -27.46812, "lng": 153.02676 }],
      "mapView": { "west": 153.02596, "south": -27.46884, "east": 153.02798, "north": -27.46704 },
    }
  ]
}

警告

HERE Geocoding and Search は現在、応答に名前を作成しており、クエリの一部として認識しています。ただし、建物名のみに基づいて住所を検索することは許可されていません。検索には、番地名と番地などのその他の詳細な住所情報、または IRL および SGP の場合は詳細な郵便番号が含まれている必要があります。

結果houseNumberTypeを返すエンドポイント : /discover、 /autosuggest、 /lookup、/geocode、 /autocomplete、/revgeocode

番地

タイプの結果 street にはそれ以上のサブディビジョンはありません。

たとえば、 Avenue des Champs-Ellysees, 75008 Paris, France:

{
    "title": "Avenue des Champs-Élysées, 75008 Paris, France",
    "id": "here:af:street:D0.fKrXcM4xmEKKVsiuq5C",
    "resultType": "street",
    "address": {
        "label": "Avenue des Champs-Élysées, 75008 Paris, France",
        "countryCode": "FRA",
        "countryName": "France",
        "stateCode": "IDF",
        "state": "Ile-de-France",
        "county": "Paris",
        "city": "Paris",
        "district": "8e Arrondissement",
        "street": "Avenue des Champs-Élysées",
        "postalCode": "75008"
    },
    "position": { "lat": 48.86951, "lng": 2.30846 },
    "mapView": { "west": 2.29582, "south": 48.86417, "east": 2.32067, "north": 48.87353 }
}

結果streetを返すエンドポイント : /discover、 /autosuggest、 /lookup、/browse、 /geocode、/autocomplete、/revgeocode

交差点

タイプの結果 intersection にはそれ以上のサブディビジョンはありません。

たとえば、 Friedrichstra ß e & Unter den Linden, 10117 Berlin, Germany の場合 :

{
    "title": "Friedrichstraße & Unter den Linden, 10117 Berlin, Germany",
    "id": "here:cm:node:61050828",
    "resultType": "intersection",
    "address": {
        "label": "Friedrichstraße & Unter den Linden, 10117 Berlin, Germany",
        "countryCode": "DEU",
        "countryName": "Germany",
        "stateCode": "BE",
        "state": "Berlin",
        "countyCode": "B",
        "county": "Berlin",
        "city": "Berlin",
        "district": "Mitte",
        "streets": ["Friedrichstraße", "Unter den Linden"],
        "postalCode": "10117"
    },
    "position": { "lat": 52.5169, "lng": 13.38883 },
    "mapView": { "west": 13.38698, "south": 52.51578, "east": 13.39068, "north": 52.51802 }
}

結果intersectionを返すエンドポイント : /discover、 /autosuggest、 /lookup、/geocode、 /autocomplete

郵便番号の場所

タイプの結果 postalCodePoint にはそれ以上のサブディビジョンはありません。郵便番号の検索結果は、以下の国で表示されます。カナダ、イギリス、オランダ、米国いくつかの例を示します。

H3R 3B5 Churchill Rd, Mt Royal, QC, カナダ

{
    "title": "H3R 3B5 Chemin Churchill, Mont-Royal, QC, Canada",
    "id": "here:af:streetsection:35DkO-tTO6MAMBjEYFROWB:EAMyB2gzcnwzYjU:EAMyB2gzcnwzYjU",
    "resultType": "postalCodePoint",
    "address": {
        "label": "H3R 3B5 Chemin Churchill, Mont-Royal, QC, Canada",
        "countryCode": "CAN",
        "countryName": "Canada",
        "stateCode": "QC",
        "state": "Québec",
        "county": "Montréal",
        "city": "Mont-Royal",
        "street": "Chemin Churchill",
        "postalCode": "H3R 3B5"
    },
    "position": { "lat": 45.51202, "lng": -73.63894 },
    "mapView": { "west": -73.64054, "south": 45.5109, "east": -73.63734, "north": 45.51314 }
}

EC2Y 5HN London Wall, London, イギリス

{
    "title": "EC2Y 5HN London Wall, London, England",
    "id": "here:af:streetsection:FRsFWpGlT-EcxVmUdaz4ZC:EAMyCGVjMnl8NWhu",
    "resultType": "postalCodePoint",
    "address": {
        "label": "EC2Y 5HN London Wall, London, England",
        "countryCode": "GBR",
        "countryName": "England",
        "countyCode": "LDN",
        "county": "London",
        "city": "London",
        "district": "City of London",
        "street": "London Wall",
        "postalCode": "EC2Y 5HN"
    },
    "position": { "lat": 51.5176, "lng": -0.09613 },
    "mapView": { "west": -0.09794, "south": 51.51648, "east": -0.09432, "north": 51.51872 }
}

Westsingel 3811 BB 、 Amersfoort 、 Nederland

{
    "title": "EC2Y 5HN London Wall, London, England",
    "id": "here:af:streetsection:FRsFWpGlT-EcxVmUdaz4ZC:EAMyCGVjMnl8NWhu",
    "resultType": "postalCodePoint",
    "address": {
        "label": "EC2Y 5HN London Wall, London, England",
        "countryCode": "GBR",
        "countryName": "England",
        "countyCode": "LDN",
        "county": "London",
        "city": "London",
        "district": "City of London",
        "street": "London Wall",
        "postalCode": "EC2Y 5HN"
    },
    "position": { "lat": 51.5176, "lng": -0.09613 },
    "mapView": { "west": -0.09794, "south": 51.51648, "east": -0.09432, "north": 51.51872 }
}

94115-1234 Broadway, San Francisco, CA, 米国

{
    "title": "EC2Y 5HN London Wall, London, England",
    "id": "here:af:streetsection:FRsFWpGlT-EcxVmUdaz4ZC:EAMyCGVjMnl8NWhu",
    "resultType": "postalCodePoint",
    "address": {
        "label": "EC2Y 5HN London Wall, London, England",
        "countryCode": "GBR",
        "countryName": "England",
        "countyCode": "LDN",
        "county": "London",
        "city": "London",
        "district": "City of London",
        "street": "London Wall",
        "postalCode": "EC2Y 5HN"
    },
    "position": { "lat": 51.5176, "lng": -0.09613 },
    "mapView": { "west": -0.09794, "south": 51.51648, "east": -0.09432, "north": 51.51872 }
}

結果postalCodePointを返すエンドポイント : /discover、 /autosuggest、 /lookup、/geocode、 /autocomplete、/revgeocode

Addressの結果

Addressの結果

Locality

警告

Administrative Area

警告

Address block

警告

House Number

警告

警告

番地

交差点

郵便番号の場所

「」に一致する結果は件です

「」に一致する結果はありません

開発者

Addressの結果

Locality

警告

Administrative Area

警告

Address block

警告

House Number

警告

警告

番地

交差点

郵便番号の場所

「」に一致する結果は 件です

「」に一致する結果はありません

開発者

「」に一致する結果は件です