Category

Find a POI (Point of Interest) by the category nearby arbitary location.

Method	Request	Response
GET	https://maps.mogoscorp.com/api/v2/search	JSON

Request

Parameter (Required)	Descripton	Remark
key	Your API Key.	string
keyword	Category name to be searched. e.g. keyword=cafe	string
cx	Longitude of the current location (WGS84). e.g. cx=126.896038	string
cy	Latitude of the current location (WGS84). e.g. cy=37.482901	string
lang	Search Language. default : en. th : Thailand en : English kr : Korean	string
type	Type of search 0: Search by name 1: Search by categoty 2: Search by address 3: Search by postal code	int

Parameter (Optional)	Description	Remark
sx	Longitude of arbitrary locations that are the basis for the search (WGS84). e.g. sx=126.896038	string
sy	Latitude of arbitrary locations that are the basis for the search (WGS84). e.g. sy=37.482901	string
pno	Page number. (Default : 1)	int
cpp	Number of searches per page. (Default : 20)	int

Example

// Some code

For "keyword" parameter as search category, you can get all category list at https://maps.mogoscorp.com/api/v2/search/cates?key={YOUR_API_KEY}

Response

Parameter	Description	Remark
err	If there is an error, it's the contents of the error	string
stype	The type of search used for the search. (Internal use only)	int
sort	The sort type used in the search. (Internal use only)	int
pno	Page number.	int
cpp	Number of searches per page.	int
total	Number of items searched	int
items	List of retrieved results.	array
id	Search ID.	string
flg	Type of data. (Internal use only)	int
pid	Parent ID. (currently Not used)	string
src	Source type	int
cate	Large classification code. (Internal use only)	string
dist	Distance (unit : meter)	int
entx	Longitude of entry point (WGS84).	double
enty	Latitude of entry point (WGS84).	double
name	Display name.	string
posx	Longitude of center.	double
posy	Latitude of center.	double
addr1	Address.	string
addr2	Another address.	string
cate2	Division code. (currently Not used)	string
phone	Phone number. delimiter comma (,).	string
props	POI Properties. (currently Not used)	array
hassub	Sub POI Existence (0: None, Other : Yes) (currently Not used)	int
addr_en	English address	string
entries	Multiple entry points list. (currently Not used)	array
name_en	English name	string
geom_type	geometry type	string

Example

{
    "err": null,
    "stype": 0,
    "sort": 0,
    "pno": 1,
    "cpp": 20,
    "total": 7,
    "src_type": null,
    "data_type": 1,
    "items": [
        {
            "id": "1002511501",
            "flg": 3,
            "pid": null,
            "src": 8,
            "cate": "739999",
            "dist": 16,
            "entx": 126.89557441171448,
            "enty": 37.48279296688024,
            "name": "MOGOS",
            "posx": 126.89618546251323,
            "posy": 37.482820752242,
            "addr1": "222-8 Guro-dong Guro-gu Seoul",
            "addr2": "31 Digital-ro 30-Gil Guro-gu Seoul",
            "cate2": null,
            "phone": null,
            "props": null,
            "hassub": 0,
            "s_dist": 16,
            "addr_en": "222-8 Guro-dong Guro-gu Seoul",
            "entries": null,
            "name_en": "MOGOS",
            "geom_type": "ST_Point"
        },
        ...
    ]
}

Do note that search can take both (cx, cy) and (sx, sy) as parameters. If you are looking for search result around your current position, use (cx, cy). If you move the map and would like search result around the position where you moved map to, use (sx, sy). If you provide both (cx, cy) and (sx, sy), (sx, sy) has a higher priority.

For "lang" parameter, you can find all language codes at https://maps.mogoscorp.com/api/v2/search/langs?key={YOUR_API_KEY} However, we currently provide services only for "ko", "th", "en"

The MOGOS Maps API requires an API Key, which can be obtained from the MOGOS Console website or contact [e-mail].