Simple Reverse Geocoding Service

Give me your short comment.

This service calculate the name of the place (prefecture, municipality and Aza or section) where parameters specifies.

Supported areas are only the land areas in Japan, and supported language is only Japanese.

Scripts and data package of this service is distributed. See Reverse Geocoding Service Distribution Site(only Japanese version).

Web Services act to provide single feature, applications are built by some Web Services.

Please read Terms of Use before using the services.

This service has Additional Terms of Use. Please read it before using this service.

Service URL

The URL for this service is http://www.finds.jp/ws/rgeocode.php .

Parameters

See also Toy Service General Specs.

jsonp (General)
If this is set by a function name, JSONP style documents are returned. If this is set without a function name, JSON style documents are returned.
json (General)
If this is set, JSON style documents are returned. The value may be set by any value or may not be set.
php (General)
If this is set, PHP Serialization style documents are returned. The value may be set by any value or may not be set.
lat
Latitude of the location ,with decimal degree (degree+minutes/60+seconds/3600), north latitude is given positive value.
lon
Longitude of the location, with decimal degree (degree+minutes/60+seconds/3600), east longitude is given positive value.
lr
Radius of the retrieve circle for home-numbers from Bloc Level Location Reference Information, in meter, 500 meters by default, between 100 and 1000.
lx
Maximum candidates for home-numbers from Bloc Level Locaiton Reference Information. 1 by default, between 1 and 100.
ar
Radius of the retrieve circle for Azas or sections from Section Level Location Reference Information, in meter, 0(disabled) by default, between 1000 and 10000. If not specified positive value, retrieve for sections is disabled.
ax
Maximum candidates for sections from Section Level Location Reference Information, 0 by default, between 1 and 100. If not specified positive value, retrieve for sections is disable.

Response document

Root element

The name of the root element is rgeocode .

Response status

CodeDescription
200Service finished successfully (General)
201If no home-number is found (result/local element is not avilable) and no section is found (result/aza element is not avialable)
202If section is found (result/aza element is available). In this case, no home-number is found.
400Service failed because of wrong parameters (General)
500Service failed inside the server (General)

"result" element

See also Toy Service General Specs.

result element has elements as below.

<prefecture>
This element has elements on the prefecture. This is available only if this service finished successfully (status element has an integer value between 200 and 299).
<pcode>
This element has the code of the prefecture (between 1 and 47).
<pname>
This element has the name of the prefecture.
<municipality>
This element has elements on the municipality. This is available only if this service finished successfully (status element has an integer value between 200 and 299).
<mcode>
This element has the code of municipality (NOTICE).
<mname>
This element has the name of the municipality.
<local> (allowed to be multiple)
This element has elements on blocs and home-numbers. This is available only if blocs and home-number are found (status element has 200) (Notice).
<section>
This element has the name of the section or the bloc.
<homenumber>
This element has the name of the home-number (Notice).
<longitude>
This element has the longitude (decimal degree) of representative home-number point.
<latitude>
This element has the latitude (decimal degree) of representative home-number point.
<aza> (allowed to be multiple)
This element has elements on sections Aza or section. This is available only if sections are found (status element has 202) (Notice).
<name>
This element has the name of Aza or section.
<latitude>
This element has the longitude (decimal degree) of representative Aza or section point.
<latitude>
This element has the latitude (decimal degree) of representative Aza or section point.

NOTICE

The region which does not belong to any municipality
A few of reclaimed lands is not belonging to any municipality. In this case, municipality code is set by (prefectural code) + "000" (For example, the region which belongs to Chiba, the code is set by 12000). The name of them is "SHOZOKU-MITEI-CHI" (actually in Kanji).
"local" element
The condition under that "local" elements are available are below.
  • The location specified by the parameter is belonging to the municipality where there are representative home-number points (or there arecity planning areas).
  • There are representative home-number points within the circle with the center where the parameters specified and with the radius specified by lr(meters) parameter.
"homenumber" element
The value of "homenumber" element is often different from real home-number; because of accurancy of the original data, conflict between the original data and real home-number, etc. Moreover, if the location where the parameters specified is near by boundaries of city planning areas, this service results unreliable home-number. Please note this and be careful to handle the information on home-number.
"aza" element
The condition under that "aza" elements are available are below.
  • No home-number point is found.
  • The location specified by the parameter is belonging to the municipality where there are representative Aza or section points.
  • There are representative Aza or section points within the circle with the center where the parameters specified and with the radius specified by ar(meters) parameter.

Example

The response documents are written as XML document, or JavaScript or PHP programing language. Human being may be able to read not so easily.

National Agricultural Research Center for Western Region (MAP)
A sample for the location where the location reference data is not avialable - Sera-Cho, Hiroshima (MAP)
Specifing ax=50, ar=10000 to get both of aza (which is rough but covers all) and bloc (which is precision but covers only city areas) - Sera-Cho, Hiroshima (MAP)
A sample for the region which does not belong to any municipality - Near by Funabashi-Shi, Chiba (MAP)
Error because of wrong location (About 400km south of Shionomisaki, 30.0N 136.0E)(MAP)
Error because of no parameter

Geodetic system

The geodetic system which this service is based on is JGD2000 (GSR-80 Spheroid).

Additional Terms of Use

Please applyt not only Terms of Use(General) but also Additional Terms of Use below before using this service.

  • The "homenumber" values in response documents are different from real home-numbers and may affect privacy of someone. Please be careful to handle the values.
  • If works using this service with handling "homenumber" are distributed or publicated, please show above to the users (If they do not handle "homenumber" values, this is not needed).


© 2011 National Agriculture and Food Research Organization | NARO Official Website

[To TOP]