Japan
To reflect the Japanese administrative system and to support Japan use cases, we provide a response that includes block
and subblock
as additional hierarchical structures to support the country-specific scheme like chiban, aza, etc.
Getting Credentials
Use of Geocoding and Search Japan requires a premium credential. For more information, see Get Credentials.
Discover
For more information, see Discover.
To discover the nearest station at the geo-position (35.6899274, 139.8268034)
use the following request:
GET https://discover.search.hereapi.com/v1/
discover
?at=35.6899274%2C139.8268034
&q=駅
&limit=2
Bearer [your token]
The response to the above request is the following:
{
"items": [
{
"title": "飯田橋駅",
"id": "here:xs1:place:55410615",
"resultType": "place",
"address": {
"label": "東京都千代田区飯田橋駅",
...
}
...
}
{
"title": "東京地下鉄(株)/定期券うりば飯田橋駅定期券うりば",
"id": "here:xs1:place:66464836",
"resultType": "place",
"address": {
"label": "東京都千代田区東京地下鉄(株)/定期券うりば飯田橋駅定期券うりば",
...
}
...
}
]
}
Geocode
For more information, see Geocode.
A free-form text query for address in Tokyo, 港区六本木6-10-1
is the following:
GET https://geocode.search.hereapi.com/v1/
geocode
?q=港区六本木6-10-1
Bearer [your token]
The response to the above request is the following:
{
"items": [
{
"title": "〒106-0032 東京都港区六本木6丁目10-1",
"id": "here:xs1:pointaddress:912923:CgcIBCDou8cNEAEaA--8kShk",
"resultType": "houseNumber",
"houseNumberType": "PA",
"address": {
"label": "〒106-0032 東京都港区六本木6丁目10-1",
"countryCode": "JPN",
"countryName": "日本",
"state": "東京都",
"city": "港区",
"subdistrict": "六本木",
"block": "6丁目",
"subblock": "10",
"postalCode": "106-0032",
"houseNumber": "1"
},
"position": {
"lat": 35.66045,
"lng": 139.72923
},
"access": [
{
"lat": 35.66045,
"lng": 139.72923
}
],
"mapView": {
"west": 139.72812,
"south": 35.65955,
"east": 139.73034,
"north": 35.66135
},
"scoring": {
"queryScore": 1,
"fieldScore": {
"city": 1,
"subdistrict": 1,
"block": 1,
"subblock": 1,
"houseNumber": 1
}
}
}
]
}
A free-form text query for address in Kumamoto Prefecture, 熊本県菊池郡大津町引水18-3
is the following:
GET https://geocode.search.hereapi.com/v1/
geocode
?q=熊本県菊池郡大津町引水18-3
Bearer [your token]
The response to the above request is the following:
{
"title": "〒869-1234 熊本県菊池郡大津町引水18-3",
"id": "here:xs1:pointaddress:502437120:CgcIBCCC0foXEAEaA--8kyhk",
"resultType": "houseNumber",
"houseNumberType": "PA",
"address": {
"label": "〒869-1234 熊本県菊池郡大津町引水18-3",
"countryCode": "JPN",
"countryName": "日本",
"state": "熊本県",
"county": "菊池郡",
"city": "大津町",
"subdistrict": "引水",
"subblock": "18",
"postalCode": "869-1234",
"houseNumber": "3"
},
"position": {
"lat": 32.87821,
"lng": 130.87493
},
"access": [
{
"lat": 32.87821,
"lng": 130.87493
}
],
"mapView": {
"west": 130.87386,
"south": 32.87731,
"east": 130.876,
"north": 32.87911
}
}
Autosuggest
For more information, see Autosuggest.
For 大学
suggestions intending to have 大学病院
somewhere in Tokyo, a query would be the following:
GET https://autosuggest.search.hereapi.com/v1/
autosuggest
?at=35.6990575,139.7623009
&q=大学
&limit=2
Bearer [your token]
And the response is the following:
{
"items": [
{
"title": "大学進学センター",
"id": "here:xs1:place:67023767",
"resultType": "place",
"address": {
"label": "東京都千代田区大学進学センター",
"countryCode": "JPN",
"countryName": "日本",
"state": "東京都",
"city": "千代田区"
},
"distance": 797,
"categories": [
{
"id": "800-8200-0000",
"name": "教育施設"
}
],
"highlights": {
"title": [
{
"start": 0,
"end": 2
}
],
"address": {
"label": [
{
"start": 7,
"end": 9
}
]
}
}
},
{
"title": "大学図書",
"id": "here:xs1:place:66761453",
"resultType": "place",
"address": {
"label": "東京都千代田区大学図書",
"countryCode": "JPN",
"countryName": "日本",
"state": "東京都",
"city": "千代田区"
},
"distance": 346,
"categories": [
{
"id": "600-6700-0000",
"name": "ブックショップ"
}
],
"highlights": {
"title": [
{
"start": 0,
"end": 2
}
],
"address": {
"label": [
{
"start": 7,
"end": 9
}
]
}
}
}
],
"queryTerms": []
}
Browse
For more information, see Browse.
For example, a customer application wants to expose an icon representing a convenience store, and use the category id 600-6000-0061
as the value for the categories parameter of a /browse
query:
GET https://browse.search.hereapi.com/v1/
browse
?at=35.7064554,139.7398739
&categories=600-6000-0061
&limit=2
Bearer [your token]
{
"items": [
{
"title": "ファミリーマート東五軒町店",
"id": "here:xs1:place:66741668",
"resultType": "place",
"address": {
"label": "東京都新宿区ファミリーマート東五軒町店",
"countryCode": "JPN",
"countryName": "日本",
"state": "東京都",
"city": "新宿区"
},
"distance": 41,
"categories": [
{
"id": "600-6000-0061"
}
]
},
{
"title": "セブン-イレブン新宿東五軒町店",
"id": "here:xs1:place:66468563",
"resultType": "place",
"address": {
"label": "東京都新宿区セブン-イレブン新宿東五軒町店",
"countryCode": "JPN",
"countryName": "日本",
"state": "東京都",
"city": "新宿区"
},
"distance": 142,
"categories": [
{
"id": "600-6000-0061"
}
]
}
]
}
Lookup by ID
For more information, see Lookup.
The HERE ID for 札幌站(Sapporo Station)
is here:xs1:place:55409089
. To retrieve details for such a place, send the following request:
GET https://lookup.search.hereapi.com/v1/
lookup
?id=here:xs1:place:55409089
Bearer [your token]
The response to the above query is the following:
{
"title": "札幌站",
"id": "here:xs1:place:55409089",
"resultType": "place",
"address": {
"label": "日本北海道札幌市北区札幌站",
"countryCode": "JPN",
"countryName": "日本",
"state": "北海道",
"city": "札幌市",
"district": "北区"
},
"position": {
"lat": 43.06859,
"lng": 141.35075
},
"access": [
{
"lat": 43.06859,
"lng": 141.35075
}
],
"categories": [
{
"id": "400-4100-0035"
}
]
}
Reverse Geocode
For more information, see Reverse Geocode.
For example, a user selects a point on a map in Yokohama, and submits the map geocoordinates in a request to the revgeocode endpoint as the following:
GET https://revgeocode.search.hereapi.com/v1/
revgeocode
?at=35.4548435%2C139.6304529
&lang=ja-JP
Bearer [your token]
The response shows the nearest address available.
{
"items": [
{
"title": "神奈川県横浜市西区みなとみらい2丁目2-1",
"id": "here:xs1:pointaddress:1050762:Ch0SFmhlcmU6eHMxOnBvaW50YWRkcmVzczogqvPkDhABGgPvvJE",
"resultType": "houseNumber",
"houseNumberType": "PA",
"address": {
"label": "神奈川県横浜市西区みなとみらい2丁目2-1",
"countryCode": "JPN",
"countryName": "日本",
"state": "神奈川県",
"city": "横浜市",
"district": "西区",
"subdistrict": "みなとみらい",
"block": "2丁目",
"subblock": "2",
"houseNumber": "1"
},
"position": {
"lat": 35.4548,
"lng": 139.63087
},
"access": [
{
"lat": 35.4548,
"lng": 139.63087
}
],
"distance": 39,
"mapView": {
"west": 139.62987,
"south": 35.45365,
"east": 139.63282,
"north": 35.45636
}
}
]
}