> For the complete documentation index, see [llms.txt](https://fatos-doc.fatos.biz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://fatos-doc.fatos.biz/fatos-api/search/reverse.md).

# Geocoding

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.

{% hint style="info" %}
See the [**API Key Issuance page**](/get-your-api-key.md) for information on using keys.
{% endhint %}

| 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        | <p>Search Language<br>Default : en</p>                   | 한국어: kr, 영어: en, 태국어: th … |
| pno       | N        | <p>Page number<br>Default : 1</p>                        | pno=1                      |
| cpp       | N        | <p>Number of searches per page <br>Default : 20</p>      | 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

```javascript
{
    "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": "서울 구로구 구로동"
        },
        ...
    ]
}
```