住所の結果

HERE Geocoding and Searchは非常に詳細な住所関連の結果を返します。

resultType値には、locality、 street、houseNumber、administrativeArea、addressBlock、intersection、postalCodePointがあります。

このような各住所結果には追加のサブタイプを含めることができ、さらに詳細な分類が可能です。たとえば、地域の結果の地域サブタイプには city、postalCode、district、subdistrictがあります。

次の表で住所のサブタイプをまとめています。

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

住所結果のタイプは最も細かい住所を表しています。たとえば、 houseNumberタイプの結果には常にaddressレスポンス要素にhouseNumberフィールドが含まれます。追加の要素は、street、city、countryフィールドです。streetタイプの結果にはhouseNumber フィールドがaddressレスポンス要素に含まれません。

locality

localityタイプの結果には追加のフィールドlocalityTypeが含まれ、次のタイプの結果をさらに定義できます： postalCode、city、district、subdistrict

📘
注
新たなlocalityType値が予告なくリストに追加される可能性があります。HERE Geocoding and Searchを使用しているアプリケーションではリストが固定されたものととらえないことが重要です。

各localityType値の結果の例：

city

Paris, Ile-de-France, Franceの場合：

{
  "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, Berlin, Germanyの場合：

{
  "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

Back Bay, Boston, MA, United Statesの場合：

{
    "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 Area, Gole Market, New Delhi, Delhi, India の場合：

{
  "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

行政区画

administrativeAreaタイプの結果には追加のフィールドadministrativeAreaTypeが含まれ、次のタイプの結果をさらに定義できます： country、state、county

📘
注
新たなadministrativeAreaType値が予告なくリストに追加される可能性があります。HERE Geocoding and Searchを使用しているアプリケーションではリストが固定されたものととらえないことが重要です。

各administrativeAreaType値の結果の例：

country

Andorraの場合：

{
  "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, United Statesの場合：

{
  "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

Bern-Mittelland, Berne, Switzerland の場合：

{
  "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

住所ブロック

addressBlock タイプの結果は日本とその他の国の住所システムの一部です。結果には追加フィールドaddressBlockTypeが含まれ、 block、subblockタイプの結果をさらに定義できます。

HERE Geocoding and SearchでaddressBlockタイプの結果をサポートしている国：

日本
インドネシア - addressBlockType=block。/geocode、/lookupエンドポイント

📘
警告
新たなaddressBlockType値が予告なくリストに追加される可能性があります。HERE Geocoding and Searchを使用しているアプリケーションではリストが固定されたものととらえないことが重要です。

各addressBlockType値の結果の例：

block

Yo Wakuramachi, Nanao-shi, Ishikawa, 926-0175 Japanの場合：

{
  "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 の場合：

{
  "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

住居番号

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

houseNumberタイプの結果には追加のフィールドhouseNumberTypeが含まれ、次のタイプの結果をさらに定義できます： interpolated、PA、MPA

PA は「ポイント住所」を表し、住居の非常に正確な位置を表します。ポイント住所は個々の住所をポイントオブジェクトとして表します。ポイント住所は信頼できる情報ソースからのものです。高い確度でその住所が存在すること、どの位置にあるかを特定できます。

interpolated 結果の精度は若干低いものの、高度に最適化された補間アルゴリズムに基づいています。アドレスレンジに基づく線形補間の結果としてのおおよその位置となります。アドレスレンジは特に米国ではブロック単位が一般的です。

補間された住所の場合、住所が実際に存在する確証はありません。ただし、この補間により、おおよその適当な位置を示し、ほとんどのユースケースで目的地に近い場所にユーザーを誘導できます。

MPA は「マイクロポイント住所」を意味し、ポイント住所の補助的な住所を表します。たとえば、建物、フロア (階数)、スイート (ユニット) です。ポイント住所と比べて、マイクロポイント住所はより詳細な住所とより高い座標精度を備えています。この結果タイプは、「with=MPA」パラメーターがリクエストで設定されている場合(「RESTRICTED」機能 - 「権限」を参照)のgeocodeエンドポイント、またはLookup by IDの結果としてのlookupエンドポイントによってのみ返されます。現在、HERE Geocoding and Searchは次の国でマイクロポイント住所をサポートしています：AUS、AUT、CAN、NZL、USA (PRI準州を含む)。

📘
注
新たなhouseNumberType値が予告なくリストに追加される可能性があります。HERE Geocoding and Searchを使用しているアプリケーションではリストが固定されたものととらえないことが重要です。

各houseNumberType値の結果の例：

PA

Invalidenstraße 116, 10115 Berlin, Germanyの場合：

{
  "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 つのポイントは位置または表示ポイントです。ポイント住所の場合、このポイントはソースと国によって異なります。ポイントは屋上のポイント、建物の入口に近いポイント、建物に属する建物、私道または駐車場に近いポイントとなります。

MPA

710/84 Northbourne Ave, Braddon ACT 2612, Australiaの場合：

{
"title": "710/84 Northbourne Ave, Braddon ACT 2612, Australia",
"id": "here:af:streetsection:.W90ivJgffuB3CYZPYn6fD:ChYIBCCymKydATIMCggIFCDlwrqiAhAEEAEaAjg0",
"language": "en",
"resultType": "houseNumber",
"houseNumberType": "MPA",
"address": {
  "label": "710/84 Northbourne Ave, Braddon ACT 2612, Australia",
  "countryCode": "AUS",
  "countryName": "Australia",
  "stateCode": "ACT",
  "state": "Australian Capital Territory",
  "city": "Canberra",
  "district": "Braddon",
  "street": "Northbourne Ave",
  "postalCode": "2612",
  "houseNumber": "84",
  "unit": "710"
},
"position": { "lat": -35.27422, "lng": 149.13065 },
"access": [{ "lat": -35.27416, "lng": 149.13013 }],
"mapView": { "west": 149.12989, "south": -35.27575, "east": 149.13233, "north": -35.26053 }
}

MPA結果にはPA結果と同じ情報が含まれます。また、セカンダリユニット情報はunitフィールドに加え、結果のtitleと住所のlabelに含まれます。これには建物、フロア (階数)、スイート (ユニット) の詳細が含まれます。MPA は属している PA と同じ位置情報とアクセス座標を共有する場合もありますが、通常 MPA の位置情報とアクセス座標は PA よりも正確です。

interpolated

32 Kings Road, Aylesbury, HP21 7RR, England の場合：

{
  "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 }
}

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

building 情報を含む PA

ポイント住所の結果には、建物名も含まれる場合があります。建物名は建物またはプロパティの名前を表すテキスト住所です。住居番号の代わりとなる場合もあれば、住居番号に追加される場合もあります。

HERE Geocoding and Searchは、houseNumberType PAを含むhouseNumberの結果と、住所に建物名が含まれている場合はplaceの結果に対してのみ建物名を返します。

HERE Geocoding and Searchは建物名を個別フィールドのbuildingとしてaddressブロックに、結果項目のtitleと住所のlabelに含めます。

Rowes Arcade, 235 Edward St, Brisbane City QLD 4000, Australiaの場合：

{
"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では、現在すべてのエンドポイントのレスポンスに建物名を含めています。また、/geocodeエンドポイントでは、建物名検索への包括的なサポートを提供します。/geocode エンドポイントを使用すると、建物名から位置を検索できます。なお、Autocomplete、Autosuggest、Discover Searchなどの他のエンドポイントでは建物名での検索はサポートされていません。

住居番号タイプPAまたはinterpolatedでhouseNumberType結果を返すエンドポイント： /discover、 /autosuggest、 /lookup、 /geocode、 /autocomplete、 /revgeocode

住居番号タイプ MPA で houseNumberType 結果を返すエンドポイント： /lookup、 /geocode - 最後のエンドポイントはリクエストに「with=MPA」パラメーターが設定されている場合のみ。

道路

結果タイプstreetは、これ以上は細分化されません。

Avenue des Champs-Élysées, 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 は、これ以上は細分化されません。郵便番号ポイントの結果が想定される国は、カナダ、アイルランド、イスラエル、マン島、マレーシア、オランダ、ポルトガル、シンガポール、台湾、英国、プエルトリコ準州を含む米国 (ZIP+4に加え、住所固有、私書箱、軍事郵便の3種類の郵便番号を含む) です。いくつかの例を示します。

H3R 3B5 Churchill Rd, Mt Royal, QC, Canada

{
    "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, United Kingdom

{
    "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": "Westsingel 3811 BB, Amersfoort, Nederland",
    "id": "here:af:streetsection:vcV6RFNSviDyTwaBumO8qC:EAMyBzM4MTF8YmI:EAMyBzM4MTF8YmI",
    "resultType": "postalCodePoint",
    "address": {
        "label": "Westsingel 3811 BB, Amersfoort, Nederland",
        "countryCode": "NLD",
        "countryName": "Nederland",
        "stateCode": "UT",
        "state": "Utrecht",
        "county": "Amersfoort",
        "city": "Amersfoort",
        "street": "Westsingel",
        "postalCode": "3811 BB"
    },
    "position": { "lat": 52.1567, "lng": 5.38567 },
    "mapView": { "west": 5.38384, "south": 52.15558, "east": 5.3875, "north": 52.15782 }
}

94115-1234 Broadway, San Francisco, CA, United States

{
    "title": "94115-1234 Broadway, San Francisco, CA, United States",
    "id": "here:af:streetsection:QfdUDbG7suRcC.PvvAfEHB:EAMyCjk0MTE1fDEyMzQ:EAMyCjk0MTE1fDEyMzQ",
    "resultType": "postalCodePoint",
    "address": {
        "label": "94115-1234 Broadway, San Francisco, CA, United States",
        "countryCode": "USA",
        "countryName": "United States",
        "stateCode": "CA",
        "state": "California",
        "county": "San Francisco",
        "city": "San Francisco",
        "district": "Pacific Heights",
        "street": "Broadway",
        "postalCode": "94115-1234"
    },
    "position": { "lat": 37.79424, "lng": -122.43578 },
    "mapView": { "west": -122.4372, "south": 37.79312, "east": -122.43436, "north": 37.79536 }
}

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