API Reference
카카오맵 주소 → 좌표 변환
주소 또는 장소명을 위도/경도 좌표로 변환합니다.
카카오맵 주소 → 좌표 변환
도로명·지번 주소를 위도/경도 좌표로 변환합니다.
엔드포인트
GET /v1/kakaomap-geocode
Upstream
- Base URL:
https://app.map.kakao.com - Path:
/search/address.json
요청 파라미터
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
address | string | ✅ | - | 주소 또는 장소명 |
요청 예시
{
"address": "서울 강남구 강남대로 390"
}응답 스키마
아래 스키마는 adapter의 Zod output schema에서 직접 생성됩니다.
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"address_name": {
"type": "string"
},
"lat": {
"type": "number"
},
"lng": {
"type": "number"
},
"address_type": {
"type": "string"
}
},
"required": [
"address_name",
"lat",
"lng",
"address_type"
],
"additionalProperties": false
}
}
},
"required": [
"items"
],
"additionalProperties": false
}응답 예시
{
"data": {
"addresses": [
{
"addr": "서울 강남구 역삼동 820-9",
"doc_id": "E3A12345",
"lon": 127.02861,
"lat": 37.497952,
"x": 203512,
"y": 443215,
"zone_no": "06234",
"building": "",
"addr_type": "REGION_ADDR",
"dong_type": ""
},
{
"addr": "서울 강남구 강남대로 390",
"doc_id": "E3A67890",
"lon": 127.028592,
"lat": 37.49795,
"x": 203510,
"y": 443213,
"zone_no": "06234",
"building": "",
"addr_type": "ROAD_ADDR",
"dong_type": ""
}
]
},
"pagination": null,
"meta": {
"source": "kakaomap-geocode",
"fetchedAt": "2026-03-24T00:00:00.000Z"
}
}