Skip to Content

Kakao Map

Use map-related features such as place search, address conversion, and coordinate conversion through the Kakao Map API.

Key Features

  • Keyword-based place search
  • Category-based place search
  • Address to coordinate conversion
  • Coordinate to address conversion
  • Coordinate to administrative region information conversion
  • Coordinate system conversion

Basic Information

Authentication Method

Authenticate using API Key.

Input Parameters

  • API Key (required): REST API key issued from Kakao Developers Center

Supported MCP Tools

Place Search Tools

search_places

Search for places on Kakao Map based on keywords.

Input Parameters:

  • query (required): Search keyword
  • x (optional): X value of center coordinate (longitude)
  • y (optional): Y value of center coordinate (latitude)
  • radius (optional): Radius distance from center coordinate (meters)
  • page (optional): Result page number (1~45)
  • size (optional): Number of documents to show per page (1~15)

Search for places on Kakao Map by category.

Input Parameters:

  • category_group_code (required): Category group code
  • x (optional): X value of center coordinate (longitude)
  • y (optional): Y value of center coordinate (latitude)
  • radius (optional): Radius distance from center coordinate (meters)
  • page (optional): Result page number
  • size (optional): Number of documents to show per page

Coordinate Conversion Tools

map_address_to_coord

Convert addresses to coordinates.

Input Parameters:

  • query (required): Address search term

map_coord_to_address

Convert coordinates to addresses.

Input Parameters:

  • x (required): X coordinate (longitude)
  • y (required): Y coordinate (latitude)

map_coord_to_region_code

Convert coordinates to Korean administrative region information.

Input Parameters:

  • x (required): X coordinate (longitude)
  • y (required): Y coordinate (latitude)

map_trans_coord

Convert coordinates between coordinate systems.

Input Parameters:

  • x (required): X coordinate
  • y (required): Y coordinate
  • input_coord (required): Input coordinate system
  • output_coord (required): Output coordinate system

Usage Example

For example,

  • When you input the prompt “Find cafes near Gangnam Station”,
  • The LLM will call the search_places tool through MCP to search for cafes near Gangnam Station.
  • Then, it responds in the chat based on the tool call results.

API Key Setup Method

  1. Register an application in Kakao Developers Center.
  2. Get a REST API key.
  3. Select Kakao Map integration in QueryPie AI.
  4. Complete the connection by entering the issued API key.

Precautions

  • Keep your generated API Key secure.
  • Check daily call limits and use appropriately.
  • Coordinates use the WGS84 coordinate system by default.
Last updated on