Geocoding

Convert geographic coordinates into addresses

Geocoding uses latitude and longitude information to provide an address. An optional description of the zoom level provides information suitable for the OpenLayers room level.

See the API Key Issuance page for information on using keys.

Method	Request URI	Response Type
GET	https:/api.fatos.biz/search/v1/geocoding	JSON

Parameter

Parameter	Required	Description	Sample
key	Y	Your API Key.	key=xxxxxxxxxxx
cx	Y	User's current location X coordinate (wgs84) (Longitude)	cx=126.896038
cy	Y	User's current location Y coordinate (wgs84) (Latitude)	cy=37.482901
lang	Y	Search Language Default : en	한국어: kr, 영어: en, 태국어: th …
pno	N	Page number Default : 1	pno=1
cpp	N	Number of searches per page Default : 20	cpp=20

Response

NAME	Type	Description
err	string	If there is an error, write the contents of the error
stype	int	The type of search used for the search. Internal Use
sort	int	The sort type used in the search. Internal Use
pno	int	Page number
cpp	int	Number of searches per page
total	int	Number of searches
src_type	int	Not currently used.
data_type	int	Not currently used.
items	Array	Search list
id	string	Search ID
flg	int	Type of data. Internal Use
pid	string	Parent ID – Not currently used.
src	int	Source Type
cate	string	Large classification code. Internal Use
dist	int(meter)	Distance
entx	double	Entry point X coordinates (WGs84)
enty	double	Entry point Y coordinates (WGs84)
name	string	Expression name
posx	double	Center X coordinates (WGs84)
posy	double	Center Y coordinates (WGs84)
addr1	string	Address
addr2	string	In Korea, the road name address
cate2	string	Division code. – Not currently used.
phone	string	Phone number: delimiter comma (,)
props	array	POI Properties – Not currently used.
hassub	int	Sub POI Existence (0: None, Other : Yes) – Not currently used.
s_dist	int(meter)	Screen Distance
addr_en	string	an English address
entries	array	Multiple Entry Points List – Not currently used.
name_en	string	an English name

Response Sample

{
    "err": null,
    "stype": 4,
    "sort": 2,
    "total": 2,
    "pno": 1,
    "cpp": 2,
    "src_type": null,
    "data_type": 0,
    "items": [
        {
            "id": "899000300",
            "name": null,
            "name_en": null,
            "addr1": "서울 구로구 구로동 222-8",
            "addr2": "서울 구로구 디지털로30길 31",
            "cate": null,
            "cate2": null,
            "geom": "{\"type\":\"Point\",\"coordinates\":[126.896046586,37.482876299]}",
            "posx": 126.89604658558389,
            "posy": 37.48287629854469,
            "entx": 126.89560218600175,
            "enty": 37.48282074177592,
            "hassub": 0,
            "phone": null,
            "pid": null,
            "entries": null,
            "props": null,
            "dist": 3,
            "wgpt": null,
            "src": 8,
            "flg": 3,
            "addr3": "서울 구로구 구로동"
        },
        ...
    ]
}