페이지 이동경로
  • Docs>
  • Local>
  • Concepts

Local

Concepts

This document introduces the features of the Local API. To see the documentation for the Map SDK guide, visit Kakao Map.

Overview

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.

Example of Local API

Prerequisite

To use the Local API, complete the following steps:

  1. Register an application.
  2. Activate the Kakao Map API: Set [State] to [On] in [My Application] > [Kakao Map] > [Kakao Map Activation].
    • If any developer, who already owns the Kakao Map activated app and needs to activate the Kakao Map API additionally, Request for app permissions is required.
Note: Kakao Map Activation

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.

Usage policy

Quota

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 Billing for the details.

Map SDK

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.

Kakao SDK: Not supported

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.

Features

  • Refer to Scope of support to know whether each Kakao SDK supports each feature.
Feature Description Documentation
Convert address to coordinates Provides the coordinates of the requested address. REST API
Convert coordinates to region code Converts coordinate values in the selected coordinate system into the administrative and legal-status area information. REST API
Convert coordinates to address Converts the X and Y coordinates of a location to the land-lot number address and road name address. REST API
Transform coordinates Transforms the specified X and Y coordinates ​​in a coordinate system to another X and Y coordinates in the designated coordinate system.
Supported coordinate systems: WGS84, WCONGNAMUL, CONGNAMUL, WTM, TM, KTM, UTM, BESSEL, WKTM, WUTM
REST API
Search place by keyword Provides the results for places searched by search query along with the URL of detailed information for each place. REST API
Search place by category Provides the results for places searched by predefined group code along with the URL of detailed information for each place. REST API