Concepts
This document introduces the features of the Local API. To see the documentation for the Map SDK guide, visit Kakao Map.
The Local API provides features to search for a specific place by search query or category group code, or convert the requested coordinates into addresses or administrative area information. This API supports both the land-lot number address and road name address systems.
To use the Local API, complete the following steps:
- Register an application.
- Activate the Kakao Map API: Set [State] to [On] in [Kakao Map] > [Usage settings] on the app management page.
- If any developer, who already owns the Kakao Map activated app and needs to activate the Kakao Map API additionally, Request additional features is required.
Starting December 1, 2024, new apps which need to call the Kakao Map API must activate the Kakao Map feature in app settings. See Notice for more details.
Kakao APIs provide each app with monthly and daily quotas to support stable service. You can see the currently applied quota information in the Quota.
If your service needs additional quotas beyond the Free quotas, additional settings for billing are required. See Paid API for the details.
Map API allows you to provide various location-based services using a map in your Web and mobile applications. To see more about the Map SDK, go to Kakao Maps API website.
You can use the Local API only using a REST API. To use a map in the service application or web page, use the Map SDK.
| API | Method | URL | Description |
|---|---|---|---|
| Convert address to coordinates | GET | https://dapi.kakao.com/v2/local/search/address.${FORMAT} | Provides the coordinates of the requested address with the land-lot number address, road name address, coordinates, zip code, building name, etc., to display the address precisely on the map. |
| Convert coordinates to region code | GET | https://dapi.kakao.com/v2/local/geo/coord2regioncode.${FORMAT} | Converts the coordinates in the selected coordinate system into the administrative and legal-status area information. |
| Convert coordinates to address | GET | https://dapi.kakao.com/v2/local/geo/coord2address.${FORMAT} | Converts the X and Y coordinates of a location to the land-lot number address and road name address. |
| Transform coordinates | GET | https://dapi.kakao.com/v2/local/geo/transcoord.${FORMAT} | Converts the specified X and Y coordinates in a coordinate system to another X and Y coordinates in the designated coordinate system, which allows compatibility with other coordinate systems. |
| Search place by keyword | GET | https://dapi.kakao.com/v2/local/search/keyword.${FORMAT} | Provides the search results for places that match the search query in the specified sorting order. |
| Search place by category | GET | https://dapi.kakao.com/v2/local/search/category.${FORMAT} | Provides the search results for places by predefined group code in the specified order. |