{
"openapi": "3.0.1",
"info": {
"title": "iMPS",
"description": "iMPS OpenAPI Specification",
"version": "V2.0"
},
"servers": [
{
"url": "https://imaps.inavi.com",
"description": "Production Server"
}
],
"tags": [
{
"name": "WEB(JS)",
"description": "JavaScript 기반 아이나비 웹 지도 API",
"x-order": 1,
"tag": "지도"
},
{
"name": "Static Map",
"description": "부드럽고 선명한 고성능 정적 지도",
"x-order": 2,
"tag": "지도"
},
{
"name": "장소/주소 검색",
"description": "다양한 조건을 기반으로 장소 및 관련 정보를 조회합니다",
"x-order": 3,
"tag": "검색"
},
{
"name": "지오코딩",
"description": "주소 ↔ 좌표의 변환 및 검증을 제공합니다",
"x-order": 4,
"tag": "검색"
},
{
"name": "공간 검색",
"description": "좌표 기반의 공간 검색 유틸리티를 제공합니다",
"x-order": 5,
"tag": "검색"
},
{
"name": "W3W",
"description": "what3words기반의 위치 검색·변환하는 기능을 제공합니다",
"x-order": 6,
"tag": "검색"
},
{
"name": "탐색",
"description": "여러 조건에 따라 차량·도보 등의 경로 탐색을 제공합니다",
"x-order": 7,
"tag": "경로"
},
{
"name": "최적화",
"description": "여러 지점의 최적 방문 순서를 제공합니다",
"x-order": 8,
"tag": "경로"
},
{
"name": "복원",
"description": "GPS 데이터를 도로에 맞게 보정해 실제 주행 경로에 근접한 결과를 제공합니다",
"x-order": 9,
"tag": "경로"
},
{
"name": "매트릭스",
"description": "출발/목적지 조합의 최적 거리·시간 정보를 제공합니다",
"x-order": 10,
"tag": "경로"
}
],
"paths": {
"/maps/v3.0/appkeys/{APPKEY}/maps": {
"get": {
"tags": [
"WEB(JS)"
],
"summary": "WEB(JS)",
"description": "IMPS의 웹지도를 생성하여 고품질의 지도 서비스를 제공합니다
**Usage Sample**
",
"operationId": "getMapsResult",
"parameters": [
{
"name": "APPKEY",
"in": "path",
"description": "해당 API 사용 권한이 있는 API 키",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"text/javascript": {
"schema": {
"type": "string"
}
},
"application/json": {
"schema": {
"$ref": "#/components/schemas/HeaderResponse"
},
"examples": {
"argError": {
"summary": "파라미터 에러",
"description": "Argument Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 101,
"resultMessage": "Argument Error"
}
}
},
"serverError": {
"summary": "IMPS 서버 에러",
"description": "IMPS Server Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 102,
"resultMessage": "IMPS Server Error"
}
}
},
"authentication": {
"summary": "인증 실패",
"description": "Authentication Failed",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 300,
"resultMessage": "Authentication Failed"
}
}
},
"badRequest": {
"summary": "부적절한 URL",
"description": "Inappropriate URL",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 301,
"resultMessage": "Inappropriate URL"
}
}
}
}
}
}
},
"400": {
"description": "잘못된 요청",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"400": {
"summary": "잘못된 요청",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 400,
"resultMessage": "Invalid request parameter or body"
}
}
}
}
}
}
},
"404": {
"description": "API 없음",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"404": {
"summary": "API 없음",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 404,
"resultMessage": "API endpoint not found"
}
}
}
}
}
}
},
"415": {
"description": "허용되지 않는 메서드",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"415": {
"summary": "허용되지 않는 메서드",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 415,
"resultMessage": "Unsupported content type"
}
}
}
}
}
}
},
"500": {
"description": "서버 내부 오류",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"500": {
"summary": "서버 내부 오류",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 500,
"resultMessage": "Internal Server Error"
}
}
}
}
}
}
}
},
"x-order": 0
}
},
"/maps/v3.0/appkeys/{APPKEY}/static-maps": {
"get": {
"tags": [
"Static Map"
],
"summary": "Static Map",
"description": "중심 좌표와 크기를 입력 받아 정적 지도 이미지를 생성하여 제공합니다
**Sample**
",
"operationId": "getStaticMapsResult",
"parameters": [
{
"name": "APPKEY",
"in": "path",
"description": "해당 API 사용 권한이 있는 API 키",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "posX",
"in": "query",
"description": "중심 X좌표(경도)
*wgs84",
"required": true,
"schema": {
"type": "string",
"description": "중심 X좌표(경도)
*wgs84",
"example": 127.11075
},
"example": 127.11075
},
{
"name": "posY",
"in": "query",
"description": "중심 Y좌표(위도)
*wgs84",
"required": true,
"schema": {
"type": "string",
"description": "중심 Y좌표(위도)
*wgs84",
"example": 37.402159
},
"example": 37.402159
},
{
"name": "zoom",
"in": "query",
"description": "지도 확대 레벨",
"required": false,
"schema": {
"maximum": 20,
"minimum": 0,
"type": "string",
"description": "지도 확대 레벨",
"example": 14,
"default": "14"
},
"example": 14
},
{
"name": "pitch",
"in": "query",
"description": "지도 기울기 각도(tilt)
*단위는 도(degree)이며 0은 수직 보기(top view)
*0~60",
"required": false,
"schema": {
"maximum": 60,
"minimum": 0,
"type": "string",
"description": "지도 기울기 각도(tilt)
*단위는 도(degree)이며 0은 수직 보기(top view)
*0~60",
"example": 0,
"default": "0"
},
"example": 0
},
{
"name": "bearing",
"in": "query",
"description": "지도 회전 각도
*북쪽을 기준으로 시계 방향(degree)
*0~360",
"required": false,
"schema": {
"maximum": 360,
"minimum": 0,
"type": "string",
"description": "지도 회전 각도
*북쪽을 기준으로 시계 방향(degree)
*0~360",
"example": 0,
"default": "0"
},
"example": 0
},
{
"name": "width",
"in": "query",
"description": "생성할 이미지의 가로 크기(pixel)",
"required": false,
"schema": {
"type": "string",
"description": "생성할 이미지의 가로 크기(pixel)",
"example": 400,
"default": "400"
},
"example": 400
},
{
"name": "height",
"in": "query",
"description": "생성할 이미지의 세로 크기(pixel)",
"required": false,
"schema": {
"type": "string",
"description": "생성할 이미지의 세로 크기(pixel)",
"example": 400,
"default": "400"
},
"example": 400
},
{
"name": "scale",
"in": "query",
"description": "이미지의 고해상도 여부",
"required": false,
"schema": {
"type": "string",
"description": "이미지의 고해상도 여부",
"example": false,
"default": "false",
"enum": [
"false",
"true"
],
"x-enum-descriptions": {
"false": "일반",
"true": "고해상도"
}
},
"example": false,
"x-enum-descriptions": {
"false": "일반",
"true": "고해상도"
}
},
{
"name": "markerX",
"in": "query",
"description": "마커 X좌표(경도)
*지정 시 지도 위에 마커 표시",
"required": false,
"schema": {
"type": "string",
"description": "마커 X좌표(경도)
*지정 시 지도 위에 마커 표시",
"example": 127.11075
},
"example": 127.11075
},
{
"name": "markerY",
"in": "query",
"description": "마커 Y좌표(위도)
*지정 시 지도 위에 마커 표시",
"required": false,
"schema": {
"type": "string",
"description": "마커 Y좌표(위도)
*지정 시 지도 위에 마커 표시",
"example": 37.402159
},
"example": 37.402159
},
{
"name": "markerUrl",
"in": "query",
"description": "사용자 정의 마커 이미지 URL
*지정 시 기본 마커 대신 사용",
"required": false,
"schema": {
"type": "string",
"description": "사용자 정의 마커 이미지 URL
*지정 시 기본 마커 대신 사용"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"image/png": {
"schema": {
"type": "string",
"format": "binary"
}
},
"application/json": {
"schema": {
"$ref": "#/components/schemas/HeaderResponse"
},
"examples": {
"argError": {
"summary": "파라미터 에러",
"description": "Argument Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 101,
"resultMessage": "Argument Error"
}
}
},
"serverError": {
"summary": "IMPS 서버 에러",
"description": "IMPS Server Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 102,
"resultMessage": "IMPS Server Error"
}
}
},
"authentication": {
"summary": "인증 실패",
"description": "Authentication Failed",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 300,
"resultMessage": "Authentication Failed"
}
}
},
"badRequest": {
"summary": "부적절한 URL",
"description": "Inappropriate URL",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 301,
"resultMessage": "Inappropriate URL"
}
}
}
}
}
}
},
"400": {
"description": "잘못된 요청",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"400": {
"summary": "잘못된 요청",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 400,
"resultMessage": "Invalid request parameter or body"
}
}
}
}
}
}
},
"404": {
"description": "API 없음",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"404": {
"summary": "API 없음",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 404,
"resultMessage": "API endpoint not found"
}
}
}
}
}
}
},
"415": {
"description": "허용되지 않는 메서드",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"415": {
"summary": "허용되지 않는 메서드",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 415,
"resultMessage": "Unsupported content type"
}
}
}
}
}
}
},
"500": {
"description": "서버 내부 오류",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"500": {
"summary": "서버 내부 오류",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 500,
"resultMessage": "Internal Server Error"
}
}
}
}
}
}
}
},
"x-order": 100
}
},
"/maps/v3.0/appkeys/{APPKEY}/searches": {
"get": {
"tags": [
"장소/주소 검색"
],
"summary": "통합 검색",
"description": "상호명, 건물명, 업종명, 초성, 주소(지번·도로명), 전화번호 등 다양한 형태의 키워드를 입력하여
관심지점(POI) 및 주소 정보를 통합 검색합니다
검색 결과에 따라 POI 또는 주소 항목이 반환될 수 있습니다",
"operationId": "getSearchesResult",
"parameters": [
{
"name": "APPKEY",
"in": "path",
"description": "해당 API 사용 권한이 있는 API 키",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "query",
"in": "query",
"description": "검색 키워드",
"required": true,
"schema": {
"type": "string",
"description": "검색 키워드",
"example": "아이나비시스템즈"
},
"example": "아이나비시스템즈"
},
{
"name": "coordtype",
"in": "query",
"description": "좌표 체계",
"required": false,
"schema": {
"maximum": 1,
"minimum": 0,
"type": "string",
"description": "좌표 체계",
"default": "1",
"enum": [
"0",
"1"
],
"x-enum-descriptions": {
"0": "TW 좌표",
"1": "WGS84 좌표"
}
},
"x-enum-descriptions": {
"0": "TW 좌표",
"1": "WGS84 좌표"
}
},
{
"name": "startposition",
"in": "query",
"description": "검색 시작 위치
*0은 첫 번째 위치를 의미",
"required": false,
"schema": {
"type": "string",
"description": "검색 시작 위치
*0은 첫 번째 위치를 의미",
"default": "0"
}
},
{
"name": "reqcount",
"in": "query",
"description": "요청 개수
*0~9999",
"required": false,
"schema": {
"maximum": 9999,
"minimum": 0,
"type": "string",
"description": "요청 개수
*0~9999",
"default": "100"
}
},
{
"name": "admcode",
"in": "query",
"description": "행정구역 코드",
"required": false,
"schema": {
"type": "string",
"description": "행정구역 코드"
}
},
{
"name": "spopt",
"in": "query",
"description": "공간 검색 옵션",
"required": false,
"schema": {
"maximum": 2,
"minimum": 0,
"type": "string",
"description": "공간 검색 옵션",
"default": "0",
"enum": [
"0",
"1",
"2"
],
"x-enum-descriptions": {
"0": "전체 검색",
"1": "공간 검색",
"2": "반경 검색"
}
},
"x-enum-descriptions": {
"0": "전체 검색",
"1": "공간 검색",
"2": "반경 검색"
}
},
{
"name": "radius",
"in": "query",
"description": "검색 반경(m)
*반경 검색일 경우 사용",
"required": false,
"schema": {
"type": "string",
"description": "검색 반경(m)
*반경 검색일 경우 사용"
}
},
{
"name": "x1",
"in": "query",
"description": "X1 좌표값
*전체 검색인 경우 기준점 X좌표(경도)
*공간 검색인 경우 Extent 좌상단 X좌표(경도)
*반경 검색인 경우 중심 X좌표(경도)",
"required": false,
"schema": {
"type": "string",
"description": "X1 좌표값
*전체 검색인 경우 기준점 X좌표(경도)
*공간 검색인 경우 Extent 좌상단 X좌표(경도)
*반경 검색인 경우 중심 X좌표(경도)"
}
},
{
"name": "y1",
"in": "query",
"description": "Y1 좌표값
*전체 검색인 경우 기준점 Y좌표(위도)
*공간 검색인 경우 Extent 좌상단 Y좌표(위도)
*반경 검색인 경우 중심 Y좌표(위도)",
"required": false,
"schema": {
"type": "string",
"description": "Y1 좌표값
*전체 검색인 경우 기준점 Y좌표(위도)
*공간 검색인 경우 Extent 좌상단 Y좌표(위도)
*반경 검색인 경우 중심 Y좌표(위도)"
}
},
{
"name": "x2",
"in": "query",
"description": "X2 좌표값
*공간 검색인 경우 Extent 우하단 X좌표(경도)",
"required": false,
"schema": {
"type": "string",
"description": "X2 좌표값
*공간 검색인 경우 Extent 우하단 X좌표(경도)"
}
},
{
"name": "y2",
"in": "query",
"description": "Y2 좌표값
*공간 검색인 경우 Extent 우하단 Y좌표(위도)",
"required": false,
"schema": {
"type": "string",
"description": "Y2 좌표값
*공간 검색인 경우 Extent 우하단 Y좌표(위도)"
}
},
{
"name": "sortopt",
"in": "query",
"description": "검색 결과 정렬 옵션",
"required": false,
"schema": {
"maximum": 5,
"minimum": 1,
"type": "string",
"description": "검색 결과 정렬 옵션",
"default": "4",
"enum": [
"1",
"2",
"3",
"4",
"5"
],
"x-enum-descriptions": {
"1": "명칭순",
"2": "거리순",
"3": "명칭→거리순",
"4": "추천→인기순",
"5": "추천순"
}
},
"x-enum-descriptions": {
"1": "명칭순",
"2": "거리순",
"3": "명칭→거리순",
"4": "추천→인기순",
"5": "추천순"
}
},
{
"name": "depth",
"in": "query",
"description": "하위 시설물 포함 수준",
"required": false,
"schema": {
"maximum": 3,
"minimum": 0,
"type": "string",
"description": "하위 시설물 포함 수준",
"default": "0",
"enum": [
"0",
"1",
"2",
"3"
],
"x-enum-descriptions": {
"0": "사용 안함",
"1": "일반 시설물 포함",
"2": "하위 시설물 포함",
"3": "최하위 시설물 포함"
}
},
"x-enum-descriptions": {
"0": "사용 안함",
"1": "일반 시설물 포함",
"2": "하위 시설물 포함",
"3": "최하위 시설물 포함"
}
},
{
"name": "catecode",
"in": "query",
"description": "검색 대상 카테고리 코드",
"required": false,
"schema": {
"type": "string",
"description": "검색 대상 카테고리 코드"
}
},
{
"name": "addrext",
"in": "query",
"description": "주소 지번/건물번호 확장 검색 옵션",
"required": false,
"schema": {
"maximum": 2,
"minimum": 0,
"type": "string",
"description": "주소 지번/건물번호 확장 검색 옵션",
"default": "0",
"enum": [
"0",
"1",
"2"
],
"x-enum-descriptions": {
"0": "지번/건물번호 확장 검색",
"1": "부번호 확장 검색",
"2": "본번호 확장 검색"
}
},
"x-enum-descriptions": {
"0": "지번/건물번호 확장 검색",
"1": "부번호 확장 검색",
"2": "본번호 확장 검색"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SearchSearchesResponse"
},
"examples": {
"success": {
"summary": "성공",
"value": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"search": {
"result": true,
"type": 0,
"totalcount": 2,
"count": 2,
"poitotalcount": 2,
"poicount": 2,
"admtotalcount": 0,
"admcount": 0,
"poi": [
{
"poiid": 8827198,
"depth": "0",
"dpx": "127.110762",
"dpy": "37.402184",
"rpx": "127.110862",
"rpy": "37.402334",
"routepoints": [
{
"rpx": "127.110862",
"rpy": "37.402334"
}
],
"entrypoint": {
"px": "127.109987",
"py": "37.401942"
},
"name1": "아이나비시스템즈",
"name2": "INAVISYSTEMS",
"name3": "아이나비시스템즈판교캠퍼스",
"name4": "아이나비판교캠퍼스",
"admcode": "4113510900",
"haengcode": "4113565500",
"address": "경기도 성남시 분당구 삼평동",
"address_haeng": "삼평동",
"jibun": "678",
"roadname": "경기도 성남시 분당구 판교역로",
"roadjibun": "240",
"detailaddress": "삼환하이펙스 A동 8층",
"catecode": "130602",
"catename": "팅크웨어",
"dp_catecode": "000",
"distance": 21713,
"tel": "02-589-9610",
"hasoildata": false,
"hasdetailinfo": true,
"hassubpoi": false,
"islandmark": true,
"updateTS": "2023-08-17",
"subpoi": {
"count": 0,
"poi": []
},
"externallink": [
{
"Site": "PLOG",
"ID": "http://m.fivepin.co.kr/MyStory/Plog?pid=8827198",
"ExtraInfo1": "단골 많은 팅크웨어(재방문54%)",
"ExtraInfo2": "재방문54%기업"
}
],
"popularity": false,
"pop_tv": false,
"pop_sns": false,
"pop_hot": false,
"pop_hit": false,
"pop_top": "경기_1,분당구_1"
}
],
"adm": [
{
"type": 2,
"posx": "127.11065",
"posy": "37.402109",
"admcode": "4113510900",
"address": "경기도 성남시 분당구 삼평동",
"address_sido": "경기도",
"address_gu": "성남시 분당구",
"address_dong": "삼평동",
"address_haeng": "삼평동",
"legalcode": "4113510900",
"haengcode": "4113565500",
"jibun": "678",
"roadname": "경기도 성남시 분당구 판교역로",
"roadjibun": "240",
"postcode": "13493",
"buildname": "삼환하이펙스A동",
"accuracy": 0,
"distance": 21715
}
]
}
}
},
"argError": {
"summary": "파라미터 에러",
"description": "Argument Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 101,
"resultMessage": "Argument Error"
}
}
},
"serverError": {
"summary": "IMPS 서버 에러",
"description": "IMPS Server Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 102,
"resultMessage": "IMPS Server Error"
}
}
},
"authentication": {
"summary": "인증 실패",
"description": "Authentication Failed",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 300,
"resultMessage": "Authentication Failed"
}
}
},
"badRequest": {
"summary": "부적절한 URL",
"description": "Inappropriate URL",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 301,
"resultMessage": "Inappropriate URL"
}
}
}
}
}
}
},
"400": {
"description": "잘못된 요청",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"400": {
"summary": "잘못된 요청",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 400,
"resultMessage": "Invalid request parameter or body"
}
}
}
}
}
}
},
"404": {
"description": "API 없음",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"404": {
"summary": "API 없음",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 404,
"resultMessage": "API endpoint not found"
}
}
}
}
}
}
},
"415": {
"description": "허용되지 않는 메서드",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"415": {
"summary": "허용되지 않는 메서드",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 415,
"resultMessage": "Unsupported content type"
}
}
}
}
}
}
},
"500": {
"description": "서버 내부 오류",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"500": {
"summary": "서버 내부 오류",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 500,
"resultMessage": "Internal Server Error"
}
}
}
}
}
}
}
},
"x-order": 200
}
},
"/maps/v3.0/appkeys/{APPKEY}/g-searches": {
"get": {
"tags": [
"장소/주소 검색"
],
"summary": "다국어 통합 검색",
"description": "언어를 선택하여 상호명, 건물명, 업종명, 초성, 주소(지번·도로명), 전화번호 등 다양한 형태의 키워드를 입력하여
관심지점(POI) 및 주소 정보를 통합 검색합니다
검색 결과에 따라 POI 또는 주소 항목이 반환될 수 있습니다",
"operationId": "getGlobalSearchesResult",
"parameters": [
{
"name": "APPKEY",
"in": "path",
"description": "해당 API 사용 권한이 있는 API 키",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "query",
"in": "query",
"description": "검색 키워드",
"required": true,
"schema": {
"type": "string",
"description": "검색 키워드",
"example": "inavisystems"
},
"example": "inavisystems"
},
{
"name": "lang",
"in": "query",
"description": "검색 결과 반환 언어",
"required": true,
"schema": {
"pattern": "^(ko|KO|en|EN|ja|Ja|zh|ZH)$",
"type": "string",
"description": "검색 결과 반환 언어",
"example": "en",
"enum": [
"ko",
"en",
"ja",
"zh"
],
"x-enum-descriptions": {
"ko": "국문",
"ja": "일문",
"en": "영문",
"zh": "중문(간체)"
}
},
"example": "en",
"x-enum-descriptions": {
"ko": "국문",
"ja": "일문",
"en": "영문",
"zh": "중문(간체)"
}
},
{
"name": "coordtype",
"in": "query",
"description": "좌표 체계",
"required": false,
"schema": {
"maximum": 1,
"minimum": 0,
"type": "string",
"description": "좌표 체계",
"default": "1",
"enum": [
"0",
"1"
],
"x-enum-descriptions": {
"0": "TW 좌표",
"1": "WGS84 좌표"
}
},
"x-enum-descriptions": {
"0": "TW 좌표",
"1": "WGS84 좌표"
}
},
{
"name": "startposition",
"in": "query",
"description": "검색 시작 위치
*0은 첫 번째 위치를 의미",
"required": false,
"schema": {
"type": "string",
"description": "검색 시작 위치
*0은 첫 번째 위치를 의미",
"default": "0"
}
},
{
"name": "reqcount",
"in": "query",
"description": "요청 개수
*0~9999",
"required": false,
"schema": {
"maximum": 9999,
"minimum": 0,
"type": "string",
"description": "요청 개수
*0~9999",
"default": "100"
}
},
{
"name": "admcode",
"in": "query",
"description": "행정구역 코드",
"required": false,
"schema": {
"type": "string",
"description": "행정구역 코드"
}
},
{
"name": "spopt",
"in": "query",
"description": "공간 검색 옵션",
"required": false,
"schema": {
"type": "string",
"description": "공간 검색 옵션",
"default": "0",
"enum": [
"0",
"1",
"2"
],
"x-enum-descriptions": {
"0": "전체 검색",
"1": "공간 검색",
"2": "반경 검색"
}
},
"x-enum-descriptions": {
"0": "전체 검색",
"1": "공간 검색",
"2": "반경 검색"
}
},
{
"name": "radius",
"in": "query",
"description": "검색 반경(m)
*반경 검색일 경우 사용",
"required": false,
"schema": {
"type": "string",
"description": "검색 반경(m)
*반경 검색일 경우 사용"
}
},
{
"name": "x1",
"in": "query",
"description": "X1 좌표값
*전체 검색인 경우 기준점 X좌표(경도)
*공간 검색인 경우 Extent 좌상단 X좌표(경도)
*반경 검색인 경우 중심 X좌표(경도)",
"required": false,
"schema": {
"type": "string",
"description": "X1 좌표값
*전체 검색인 경우 기준점 X좌표(경도)
*공간 검색인 경우 Extent 좌상단 X좌표(경도)
*반경 검색인 경우 중심 X좌표(경도)"
}
},
{
"name": "y1",
"in": "query",
"description": "Y1 좌표값
*전체 검색인 경우 기준점 Y좌표(위도)
*공간 검색인 경우 Extent 좌상단 Y좌표(위도)
*반경 검색인 경우 중심 Y좌표(위도)",
"required": false,
"schema": {
"type": "string",
"description": "Y1 좌표값
*전체 검색인 경우 기준점 Y좌표(위도)
*공간 검색인 경우 Extent 좌상단 Y좌표(위도)
*반경 검색인 경우 중심 Y좌표(위도)"
}
},
{
"name": "x2",
"in": "query",
"description": "X2 좌표값
*공간 검색인 경우 Extent 우하단 X좌표(경도)",
"required": false,
"schema": {
"type": "string",
"description": "X2 좌표값
*공간 검색인 경우 Extent 우하단 X좌표(경도)"
}
},
{
"name": "y2",
"in": "query",
"description": "Y2 좌표값
*공간 검색인 경우 Extent 우하단 Y좌표(위도)",
"required": false,
"schema": {
"type": "string",
"description": "Y2 좌표값
*공간 검색인 경우 Extent 우하단 Y좌표(위도)"
}
},
{
"name": "sortopt",
"in": "query",
"description": "검색 결과 정렬 옵션",
"required": false,
"schema": {
"type": "string",
"description": "검색 결과 정렬 옵션",
"default": "4",
"enum": [
"1",
"2",
"3",
"4",
"5"
],
"x-enum-descriptions": {
"1": "명칭순",
"2": "거리순",
"3": "명칭→거리순",
"4": "추천→인기순",
"5": "추천순"
}
},
"x-enum-descriptions": {
"1": "명칭순",
"2": "거리순",
"3": "명칭→거리순",
"4": "추천→인기순",
"5": "추천순"
}
},
{
"name": "depth",
"in": "query",
"description": "하위 시설물 포함 수준",
"required": false,
"schema": {
"type": "string",
"description": "하위 시설물 포함 수준",
"default": "0",
"enum": [
"0",
"1",
"2",
"3"
],
"x-enum-descriptions": {
"0": "사용 안함",
"1": "일반 시설물 포함",
"2": "하위 시설물 포함",
"3": "최하위 시설물 포함"
}
},
"x-enum-descriptions": {
"0": "사용 안함",
"1": "일반 시설물 포함",
"2": "하위 시설물 포함",
"3": "최하위 시설물 포함"
}
},
{
"name": "catecode",
"in": "query",
"description": "검색 대상 카테고리 코드",
"required": false,
"schema": {
"type": "string",
"description": "검색 대상 카테고리 코드"
}
},
{
"name": "addrext",
"in": "query",
"description": "주소 지번/건물번호 확장 검색 옵션",
"required": false,
"schema": {
"type": "string",
"description": "주소 지번/건물번호 확장 검색 옵션",
"default": "0",
"enum": [
"0",
"1",
"2"
],
"x-enum-descriptions": {
"0": "지번/건물번호 확장 검색",
"1": "부번호 확장 검색",
"2": "본번호 확장 검색"
}
},
"x-enum-descriptions": {
"0": "지번/건물번호 확장 검색",
"1": "부번호 확장 검색",
"2": "본번호 확장 검색"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SearchGlobalSearchesResponse"
},
"examples": {
"success": {
"summary": "성공",
"value": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"search": {
"result": true,
"lang": "en",
"totalcount": 1,
"count": 1,
"poitotalcount": 1,
"poicount": 1,
"admtotalcount": 0,
"admcount": 0,
"poi": [
{
"poiid": 8827198,
"depth": "0",
"dpx": "127.110762",
"dpy": "37.402184",
"rpx": "127.110862",
"rpy": "37.402334",
"routepoints": [
{
"rpx": "127.110862",
"rpy": "37.402334"
}
],
"entrypoint": {
"px": "127.109987",
"py": "37.401942"
},
"name1": "INavi Systems",
"name1_ko": "아이나비시스템즈",
"name2": "",
"name2_ko": "",
"name3": "",
"name3_ko": "",
"name4": "",
"name4_ko": "",
"admcode": "4113510900",
"address": "Gyeonggi-do Seongnam-si Bundang-gu Sampyeong-dong",
"address_ko": "경기도 성남시 분당구 삼평동",
"jibun": "678",
"jibun_ko": "678",
"roadname": "Gyeonggi-do Seongnam-si Bundang-gu Pangyoyeok-ro",
"roadname_ko": "경기도 성남시 분당구 판교역로",
"roadjibun": "240",
"roadjibun_ko": "240",
"detailaddress": "",
"detailaddress_ko": "삼환하이펙스 A동 8층",
"catecode": "130602",
"catename": "Thinkware",
"catename_ko": "팅크웨어",
"dp_catecode": "000",
"distance": 0,
"tel": "02-589-9610",
"hasoildata": false,
"hasdetailinfo": true,
"hassubpoi": false,
"islandmark": true,
"updateTS": "2023-08-17",
"subpoi": {
"count": 0,
"poi": []
},
"popularity": false,
"pop_tv": false,
"pop_sns": false,
"pop_hot": false,
"pop_hit": false,
"pop_top": ""
}
],
"adm": [
{
"type": 3,
"posx": "127.11065",
"posy": "37.402109",
"admcode": "4113510900",
"address": "Gyeonggi-do Seongnam-si Bundang-gu Sampyeong-dong",
"address_ko": "경기도 성남시 분당구 삼평동",
"jibun": "678",
"jibun_ko": "678",
"roadname": "Gyeonggi-do Seongnam-si Bundang-gu Pangyoyeok-ro",
"roadname_ko": "경기도 성남시 분당구 판교역로",
"roadjibun": "240",
"roadjibun_ko": "240",
"postcode": "13493",
"buildname": "",
"buildname_ko": "삼환하이펙스A동",
"accuracy": 0,
"distance": 0
}
]
}
}
},
"argError": {
"summary": "파라미터 에러",
"description": "Argument Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 101,
"resultMessage": "Argument Error"
}
}
},
"serverError": {
"summary": "IMPS 서버 에러",
"description": "IMPS Server Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 102,
"resultMessage": "IMPS Server Error"
}
}
},
"authentication": {
"summary": "인증 실패",
"description": "Authentication Failed",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 300,
"resultMessage": "Authentication Failed"
}
}
},
"badRequest": {
"summary": "부적절한 URL",
"description": "Inappropriate URL",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 301,
"resultMessage": "Inappropriate URL"
}
}
}
}
}
}
},
"400": {
"description": "잘못된 요청",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"400": {
"summary": "잘못된 요청",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 400,
"resultMessage": "Invalid request parameter or body"
}
}
}
}
}
}
},
"404": {
"description": "API 없음",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"404": {
"summary": "API 없음",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 404,
"resultMessage": "API endpoint not found"
}
}
}
}
}
}
},
"415": {
"description": "허용되지 않는 메서드",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"415": {
"summary": "허용되지 않는 메서드",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 415,
"resultMessage": "Unsupported content type"
}
}
}
}
}
}
},
"500": {
"description": "서버 내부 오류",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"500": {
"summary": "서버 내부 오류",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 500,
"resultMessage": "Internal Server Error"
}
}
}
}
}
}
}
},
"x-order": 201
}
},
"/maps/v3.0/appkeys/{APPKEY}/pois": {
"get": {
"tags": [
"장소/주소 검색"
],
"summary": "장소 상세 조회",
"description": "POIID를 입력하여 해당 POI의 상세 정보를 조회합니다
POI의 명칭, 주소, 좌표, 카테고리 등 관련 정보를 반환합니다",
"operationId": "getPoisResult",
"parameters": [
{
"name": "APPKEY",
"in": "path",
"description": "해당 API 사용 권한이 있는 API 키",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "poiid",
"in": "query",
"description": "POI 고유 ID
*구분자(\",\") 와 함께 입력 가능
*예: 123,1234,234",
"required": true,
"schema": {
"pattern": "^[0-9]+(\\s*,\\s*[0-9]+)*$",
"type": "string",
"description": "POI 고유 ID
*구분자(\",\") 와 함께 입력 가능
*예: 123,1234,234",
"example": 8827198
},
"example": 8827198
},
{
"name": "coordtype",
"in": "query",
"description": "좌표 체계",
"required": false,
"schema": {
"maximum": 1,
"minimum": 0,
"type": "string",
"description": "좌표 체계",
"default": "1",
"enum": [
"0",
"1"
],
"x-enum-descriptions": {
"0": "TW 좌표",
"1": "WGS84 좌표"
}
},
"x-enum-descriptions": {
"0": "TW 좌표",
"1": "WGS84 좌표"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SearchPoisResponse"
},
"examples": {
"success": {
"summary": "성공",
"value": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"poi": {
"result": true,
"totalcount": 1,
"count": 1,
"poiinfo": [
{
"poiid": 8827198,
"dpx": "127.110762",
"dpy": "37.402184",
"rpx": "127.110862",
"rpy": "37.402334",
"routepoints": [
{
"rpx": "127.110862",
"rpy": "37.402334"
}
],
"entrypoint": {
"px": "127.109987",
"py": "37.401942"
},
"name1": "아이나비시스템즈",
"name2": "INAVISYSTEMS",
"name3": "아이나비시스템즈판교캠퍼스",
"name4": "아이나비판교캠퍼스",
"admcode": "4113510900",
"address": "경기도 성남시 분당구 삼평동",
"jibun": "678",
"roadname": "경기도 성남시 분당구 판교역로",
"roadjibun": "240",
"detailaddress": "삼환하이펙스 A동 8층",
"catecode": "130602",
"catename": "팅크웨어",
"fulladdress": "경기도 성남시 분당구 삼평동 678 삼환하이펙스 A동 8층",
"zip": "13493",
"homepage": "https://www.inavisys.com",
"email": "",
"howtogo": "",
"tel1": "02-589-9610",
"tel2": "",
"fax1": "02-2107-7470",
"fax2": "",
"detail_count": 0,
"etc_count": 0,
"detailinfo": [],
"etcinfo": [],
"hasoildata": false,
"externallink": [
{
"Site": "PLOG",
"ID": "http://m.fivepin.co.kr/MyStory/Plog?pid=8827198",
"ExtraInfo1": "단골 많은 팅크웨어(재방문53%)",
"ExtraInfo2": "재방문53%기업"
}
],
"popularity": false,
"pop_tv": false,
"pop_sns": false,
"pop_hot": false,
"pop_hit": false,
"pop_top": "경기_1,분당구_1"
}
]
}
}
},
"argError": {
"summary": "파라미터 에러",
"description": "Argument Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 101,
"resultMessage": "Argument Error"
}
}
},
"serverError": {
"summary": "IMPS 서버 에러",
"description": "IMPS Server Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 102,
"resultMessage": "IMPS Server Error"
}
}
},
"authentication": {
"summary": "인증 실패",
"description": "Authentication Failed",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 300,
"resultMessage": "Authentication Failed"
}
}
},
"badRequest": {
"summary": "부적절한 URL",
"description": "Inappropriate URL",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 301,
"resultMessage": "Inappropriate URL"
}
}
}
}
}
}
},
"400": {
"description": "잘못된 요청",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"400": {
"summary": "잘못된 요청",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 400,
"resultMessage": "Invalid request parameter or body"
}
}
}
}
}
}
},
"404": {
"description": "API 없음",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"404": {
"summary": "API 없음",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 404,
"resultMessage": "API endpoint not found"
}
}
}
}
}
}
},
"415": {
"description": "허용되지 않는 메서드",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"415": {
"summary": "허용되지 않는 메서드",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 415,
"resultMessage": "Unsupported content type"
}
}
}
}
}
}
},
"500": {
"description": "서버 내부 오류",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"500": {
"summary": "서버 내부 오류",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 500,
"resultMessage": "Internal Server Error"
}
}
}
}
}
}
}
},
"x-order": 202
}
},
"/maps/v3.0/appkeys/{APPKEY}/sub-pois": {
"get": {
"tags": [
"장소/주소 검색"
],
"summary": "시설물 정보 조회",
"description": "POIID를 입력하여 해당 POI의 하위 시설물 정보를 조회합니다
하위 시설물의 명칭, 주소, 좌표, 카테고리 등 관련 정보를 반환합니다",
"operationId": "getSubPoisResult",
"parameters": [
{
"name": "APPKEY",
"in": "path",
"description": "해당 API 사용 권한이 있는 API 키",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "poiid",
"in": "query",
"description": "POI 고유 ID",
"required": true,
"schema": {
"type": "string",
"description": "POI 고유 ID",
"example": 8827198
},
"example": 8827198
},
{
"name": "coordtype",
"in": "query",
"description": "좌표 체계",
"required": false,
"schema": {
"maximum": 1,
"minimum": 0,
"type": "string",
"description": "좌표 체계",
"default": "1",
"enum": [
"0",
"1"
],
"x-enum-descriptions": {
"0": "TW 좌표",
"1": "WGS84 좌표"
}
},
"x-enum-descriptions": {
"0": "TW 좌표",
"1": "WGS84 좌표"
}
},
{
"name": "x",
"in": "query",
"description": "X좌표(경도)
*입력 시 좌표를 기준으로 거리 값 출력",
"required": false,
"schema": {
"type": "string",
"description": "X좌표(경도)
*입력 시 좌표를 기준으로 거리 값 출력",
"example": 126.978145
},
"example": 126.978145
},
{
"name": "y",
"in": "query",
"description": "Y좌표(위도)
*입력 시 좌표를 기준으로 거리 값 출력",
"required": false,
"schema": {
"type": "string",
"description": "Y좌표(위도)
*입력 시 좌표를 기준으로 거리 값 출력",
"example": 37.566671
},
"example": 37.566671
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SearchSubPoisResponse"
},
"examples": {
"success": {
"summary": "성공",
"value": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"subpoi": {
"result": true,
"totalcount": 1,
"count": 1,
"poi": [
{
"poiid": 1415980,
"subflag": "1",
"dpx": "127.110862",
"dpy": "37.402334",
"rpx": "127.110862",
"rpy": "37.402334",
"routepoints": [
{
"rpx": "127.110862",
"rpy": "37.402334"
}
],
"name1": "입구",
"name2": "팅크웨어정문",
"name3": "",
"name4": "",
"admcode": "4113510900",
"address": "경기도 성남시 분당구 삼평동",
"jibun": "",
"roadname": "",
"roadjibun": "",
"detailaddress": "",
"catecode": "181104",
"catename": "도로시설",
"dp_catecode": "000",
"distance": 0,
"tel": "",
"hasoildata": false,
"islandmark": false,
"updateTS": "2023-08-17",
"externallink": [],
"popularity": false,
"pop_tv": false,
"pop_sns": false,
"pop_hot": false,
"pop_hit": false,
"pop_top": ""
}
]
}
}
},
"argError": {
"summary": "파라미터 에러",
"description": "Argument Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 101,
"resultMessage": "Argument Error"
}
}
},
"serverError": {
"summary": "IMPS 서버 에러",
"description": "IMPS Server Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 102,
"resultMessage": "IMPS Server Error"
}
}
},
"authentication": {
"summary": "인증 실패",
"description": "Authentication Failed",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 300,
"resultMessage": "Authentication Failed"
}
}
},
"badRequest": {
"summary": "부적절한 URL",
"description": "Inappropriate URL",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 301,
"resultMessage": "Inappropriate URL"
}
}
}
}
}
}
},
"400": {
"description": "잘못된 요청",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"400": {
"summary": "잘못된 요청",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 400,
"resultMessage": "Invalid request parameter or body"
}
}
}
}
}
}
},
"404": {
"description": "API 없음",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"404": {
"summary": "API 없음",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 404,
"resultMessage": "API endpoint not found"
}
}
}
}
}
}
},
"415": {
"description": "허용되지 않는 메서드",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"415": {
"summary": "허용되지 않는 메서드",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 415,
"resultMessage": "Unsupported content type"
}
}
}
}
}
}
},
"500": {
"description": "서버 내부 오류",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"500": {
"summary": "서버 내부 오류",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 500,
"resultMessage": "Internal Server Error"
}
}
}
}
}
}
}
},
"x-order": 203
}
},
"/maps/v3.0/appkeys/{APPKEY}/proposers": {
"get": {
"tags": [
"장소/주소 검색"
],
"summary": "검색어 추천",
"description": "입력한 키워드를 기반으로 연관 검색어 및 추천 검색어 목록을 제공합니다",
"operationId": "getProposerResult",
"parameters": [
{
"name": "APPKEY",
"in": "path",
"description": "해당 API 사용 권한이 있는 API 키",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "query",
"in": "query",
"description": "검색 키워드",
"required": true,
"schema": {
"type": "string",
"description": "검색 키워드",
"example": "아이나비"
},
"example": "아이나비"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SearchProposerResponse"
},
"examples": {
"success": {
"summary": "성공",
"value": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"proposer": {
"result": true,
"count": 10,
"keyword": [
{
"keyword": "아이나비시스템즈",
"frequency": 10230
},
{
"keyword": "아이나비시스템즈서현캠퍼스",
"frequency": 6
},
{
"keyword": "아이나비프리미엄스토어인천점",
"frequency": 6
},
{
"keyword": "아이나비프리미엄스토어",
"frequency": 6
},
{
"keyword": "아이나비프리미엄스토어경기점",
"frequency": 5
},
{
"keyword": "아이나비공식대리점강릉점",
"frequency": 4
},
{
"keyword": "아이나비공식대리점거창점",
"frequency": 4
},
{
"keyword": "아이나비공식대리점광주양산점",
"frequency": 4
},
{
"keyword": "아이나비공식대리점광주하남점",
"frequency": 4
},
{
"keyword": "아이나비공식대리점군산시청점",
"frequency": 4
}
]
}
}
},
"argError": {
"summary": "파라미터 에러",
"description": "Argument Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 101,
"resultMessage": "Argument Error"
}
}
},
"serverError": {
"summary": "IMPS 서버 에러",
"description": "IMPS Server Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 102,
"resultMessage": "IMPS Server Error"
}
}
},
"authentication": {
"summary": "인증 실패",
"description": "Authentication Failed",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 300,
"resultMessage": "Authentication Failed"
}
}
},
"badRequest": {
"summary": "부적절한 URL",
"description": "Inappropriate URL",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 301,
"resultMessage": "Inappropriate URL"
}
}
}
}
}
}
},
"400": {
"description": "잘못된 요청",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"400": {
"summary": "잘못된 요청",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 400,
"resultMessage": "Invalid request parameter or body"
}
}
}
}
}
}
},
"404": {
"description": "API 없음",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"404": {
"summary": "API 없음",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 404,
"resultMessage": "API endpoint not found"
}
}
}
}
}
}
},
"415": {
"description": "허용되지 않는 메서드",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"415": {
"summary": "허용되지 않는 메서드",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 415,
"resultMessage": "Unsupported content type"
}
}
}
}
}
}
},
"500": {
"description": "서버 내부 오류",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"500": {
"summary": "서버 내부 오류",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 500,
"resultMessage": "Internal Server Error"
}
}
}
}
}
}
}
},
"x-order": 204
}
},
"/maps/v3.0/appkeys/{APPKEY}/nearby-category-searches": {
"get": {
"tags": [
"장소/주소 검색"
],
"summary": "주변 카테고리 검색",
"description": "중심 좌표와 반경을 기준으로 한 반경 검색과, 좌상단(x1,y1) 및 우하단(x2,y2) 좌표로 지정한 사각형 영역 내에서 검색하는 공간 검색을 지원합니다
지정한 범위와 카테고리 코드에 해당하는 관심지점(POI)을 조회합니다",
"operationId": "getNearbyCategorySearchesResult",
"parameters": [
{
"name": "APPKEY",
"in": "path",
"description": "해당 API 사용 권한이 있는 API 키",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "catecode",
"in": "query",
"description": "검색 대상 카테고리 코드",
"required": true,
"schema": {
"type": "string",
"description": "검색 대상 카테고리 코드",
"example": 130602
},
"example": 130602
},
{
"name": "spopt",
"in": "query",
"description": "공간 검색 옵션",
"required": true,
"schema": {
"maximum": 2,
"minimum": 1,
"type": "string",
"description": "공간 검색 옵션",
"example": 1,
"enum": [
"1",
"2"
],
"x-enum-descriptions": {
"1": "공간 검색",
"2": "반경 검색"
}
},
"example": 1,
"x-enum-descriptions": {
"1": "공간 검색",
"2": "반경 검색"
}
},
{
"name": "x1",
"in": "query",
"description": "X1 좌표값
*전체 검색인 경우 기준점 X좌표(경도)
*공간 검색인 경우 Extent 좌상단 X좌표(경도)
*반경 검색인 경우 중심 X좌표(경도)",
"required": true,
"schema": {
"type": "string",
"description": "X1 좌표값
*전체 검색인 경우 기준점 X좌표(경도)
*공간 검색인 경우 Extent 좌상단 X좌표(경도)
*반경 검색인 경우 중심 X좌표(경도)",
"example": 127.11075
},
"example": 127.11075
},
{
"name": "y1",
"in": "query",
"description": "Y1 좌표값
*전체 검색인 경우 기준점 Y좌표(위도)
*공간 검색인 경우 Extent 좌상단 Y좌표(위도)
*반경 검색인 경우 중심 Y좌표(위도)",
"required": true,
"schema": {
"type": "string",
"description": "Y1 좌표값
*전체 검색인 경우 기준점 Y좌표(위도)
*공간 검색인 경우 Extent 좌상단 Y좌표(위도)
*반경 검색인 경우 중심 Y좌표(위도)",
"example": 37.402159
},
"example": 37.402159
},
{
"name": "x2",
"in": "query",
"description": "X2 좌표값
*공간 검색인 경우 Extent 우하단 X좌표(경도)",
"required": false,
"schema": {
"type": "string",
"description": "X2 좌표값
*공간 검색인 경우 Extent 우하단 X좌표(경도)"
}
},
{
"name": "y2",
"in": "query",
"description": "Y2 좌표값
*공간 검색인 경우 Extent 우하단 Y좌표(위도)",
"required": false,
"schema": {
"type": "string",
"description": "Y2 좌표값
*공간 검색인 경우 Extent 우하단 Y좌표(위도)"
}
},
{
"name": "coordtype",
"in": "query",
"description": "좌표 체계",
"required": false,
"schema": {
"maximum": 1,
"minimum": 0,
"type": "string",
"description": "좌표 체계",
"default": "1",
"enum": [
"0",
"1"
],
"x-enum-descriptions": {
"0": "TW 좌표",
"1": "WGS84 좌표"
}
},
"x-enum-descriptions": {
"0": "TW 좌표",
"1": "WGS84 좌표"
}
},
{
"name": "startposition",
"in": "query",
"description": "검색 시작 위치
*0은 첫 번째 위치를 의미",
"required": false,
"schema": {
"type": "string",
"description": "검색 시작 위치
*0은 첫 번째 위치를 의미",
"default": "0"
}
},
{
"name": "reqcount",
"in": "query",
"description": "요청 개수
*0~9999",
"required": false,
"schema": {
"maximum": 9999,
"minimum": 0,
"type": "string",
"description": "요청 개수
*0~9999",
"default": "100"
}
},
{
"name": "sortopt",
"in": "query",
"description": "검색 결과 정렬 옵션",
"required": false,
"schema": {
"maximum": 2,
"minimum": 1,
"type": "string",
"description": "검색 결과 정렬 옵션",
"default": "1",
"enum": [
"1",
"2"
],
"x-enum-descriptions": {
"1": "거리순",
"2": "명칭순"
}
},
"x-enum-descriptions": {
"1": "거리순",
"2": "명칭순"
}
},
{
"name": "radius",
"in": "query",
"description": "검색 반경(m)
*반경 검색일 경우 사용",
"required": false,
"schema": {
"type": "string",
"description": "검색 반경(m)
*반경 검색일 경우 사용"
}
},
{
"name": "depth",
"in": "query",
"description": "하위 시설물 포함 수준",
"required": false,
"schema": {
"maximum": 3,
"minimum": 0,
"type": "string",
"description": "하위 시설물 포함 수준",
"default": "0",
"enum": [
"0",
"1",
"2",
"3"
],
"x-enum-descriptions": {
"0": "사용 안함",
"1": "일반 시설물 포함",
"2": "하위 시설물 포함",
"3": "최하위 시설물 포함"
}
},
"x-enum-descriptions": {
"0": "사용 안함",
"1": "일반 시설물 포함",
"2": "하위 시설물 포함",
"3": "최하위 시설물 포함"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SearchNearbyCategoryResponse"
},
"examples": {
"success": {
"summary": "성공",
"value": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"cate": {
"result": true,
"totalcount": 1,
"count": 1,
"poi": [
{
"poiid": 8827198,
"depth": "0",
"dpx": "127.110762",
"dpy": "37.402184",
"rpx": "127.110862",
"rpy": "37.402334",
"routepoints": [
{
"rpx": "127.110862",
"rpy": "37.402334"
}
],
"entrypoint": {
"px": "127.109987",
"py": "37.401942"
},
"name1": "아이나비시스템즈",
"name2": "INAVISYSTEMS",
"name3": "아이나비시스템즈판교캠퍼스",
"name4": "아이나비판교캠퍼스",
"admcode": "4113510900",
"haengcode": "4113565500",
"address": "경기도 성남시 분당구 삼평동",
"address_haeng": "삼평동",
"jibun": "678",
"roadname": "경기도 성남시 분당구 판교역로",
"roadjibun": "240",
"detailaddress": "삼환하이펙스 A동 8층",
"catecode": "130602",
"catename": "팅크웨어",
"dp_catecode": "000",
"distance": 21713,
"tel": "02-589-9610",
"hasoildata": false,
"hasdetailinfo": true,
"hassubpoi": false,
"islandmark": true,
"updateTS": "2023-08-17",
"subpoi": {
"count": 0,
"poi": []
},
"externallink": [
{
"Site": "PLOG",
"ID": "http://m.fivepin.co.kr/MyStory/Plog?pid=8827198",
"ExtraInfo1": "단골 많은 팅크웨어(재방문54%)",
"ExtraInfo2": "재방문54%기업"
}
],
"popularity": false,
"pop_tv": false,
"pop_sns": false,
"pop_hot": false,
"pop_hit": false,
"pop_top": "경기_1,분당구_1"
}
]
}
}
},
"argError": {
"summary": "파라미터 에러",
"description": "Argument Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 101,
"resultMessage": "Argument Error"
}
}
},
"serverError": {
"summary": "IMPS 서버 에러",
"description": "IMPS Server Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 102,
"resultMessage": "IMPS Server Error"
}
}
},
"authentication": {
"summary": "인증 실패",
"description": "Authentication Failed",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 300,
"resultMessage": "Authentication Failed"
}
}
},
"badRequest": {
"summary": "부적절한 URL",
"description": "Inappropriate URL",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 301,
"resultMessage": "Inappropriate URL"
}
}
}
}
}
}
},
"400": {
"description": "잘못된 요청",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"400": {
"summary": "잘못된 요청",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 400,
"resultMessage": "Invalid request parameter or body"
}
}
}
}
}
}
},
"404": {
"description": "API 없음",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"404": {
"summary": "API 없음",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 404,
"resultMessage": "API endpoint not found"
}
}
}
}
}
}
},
"415": {
"description": "허용되지 않는 메서드",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"415": {
"summary": "허용되지 않는 메서드",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 415,
"resultMessage": "Unsupported content type"
}
}
}
}
}
}
},
"500": {
"description": "서버 내부 오류",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"500": {
"summary": "서버 내부 오류",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 500,
"resultMessage": "Internal Server Error"
}
}
}
}
}
}
}
},
"x-order": 205
}
},
"/maps/v3.0/appkeys/{APPKEY}/optimal-position-searches": {
"get": {
"tags": [
"장소/주소 검색"
],
"summary": "최적 지점 검색",
"description": "입력한 위치를 기준으로 실제 도로 네트워크에 매칭된 최적 진출입 지점을 탐색합니다
건물/단지/차량 진입 가능 지점 등 목적에 맞는 위치를 반환하며,
각 지점의 좌표, 속성 유형(type), 도로 매칭 각도(angle) 정보를 제공합니다",
"operationId": "getOptimalPositionSearchesResult",
"parameters": [
{
"name": "APPKEY",
"in": "path",
"description": "해당 API 사용 권한이 있는 API 키",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "posX",
"in": "query",
"description": "해당 지점의 X좌표(경도)",
"required": true,
"schema": {
"type": "string",
"description": "해당 지점의 X좌표(경도)",
"example": 127.11075
},
"example": 127.11075
},
{
"name": "posY",
"in": "query",
"description": "해당 지점의 Y좌표(위도)",
"required": true,
"schema": {
"type": "string",
"description": "해당 지점의 Y좌표(위도)",
"example": 37.402159
},
"example": 37.402159
},
{
"name": "type",
"in": "query",
"description": "최적 지점 속성",
"required": false,
"schema": {
"maximum": 3,
"minimum": 0,
"type": "string",
"description": "최적 지점 속성",
"default": "0",
"enum": [
"0",
"1",
"2",
"3"
],
"x-enum-descriptions": {
"0": "전체",
"1": "차량 입구점",
"2": "택시 승하차 지점(건물)",
"3": "택시 승하차 지점(단지)"
}
},
"x-enum-descriptions": {
"0": "전체",
"1": "차량 입구점",
"2": "택시 승하차 지점(건물)",
"3": "택시 승하차 지점(단지)"
}
},
{
"name": "count",
"in": "query",
"description": "최대 결과 요청 수",
"required": false,
"schema": {
"type": "string",
"description": "최대 결과 요청 수"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SearchOptimalPositionResponse"
},
"examples": {
"success": {
"summary": "성공",
"value": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"data": {
"result": true,
"count": 4,
"entrypoints": [
{
"x": "127.110876",
"y": "37.402324",
"type": 1,
"angle": 180
},
{
"x": "127.110839",
"y": "37.40234",
"type": 1,
"angle": 180
},
{
"x": "127.110876",
"y": "37.40234",
"type": 1,
"angle": 180
},
{
"x": "127.110002",
"y": "37.401949",
"type": 2,
"angle": 0
}
]
}
}
},
"argError": {
"summary": "파라미터 에러",
"description": "Argument Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 101,
"resultMessage": "Argument Error"
}
}
},
"serverError": {
"summary": "IMPS 서버 에러",
"description": "IMPS Server Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 102,
"resultMessage": "IMPS Server Error"
}
}
},
"authentication": {
"summary": "인증 실패",
"description": "Authentication Failed",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 300,
"resultMessage": "Authentication Failed"
}
}
},
"badRequest": {
"summary": "부적절한 URL",
"description": "Inappropriate URL",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 301,
"resultMessage": "Inappropriate URL"
}
}
}
}
}
}
},
"400": {
"description": "잘못된 요청",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"400": {
"summary": "잘못된 요청",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 400,
"resultMessage": "Invalid request parameter or body"
}
}
}
}
}
}
},
"404": {
"description": "API 없음",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"404": {
"summary": "API 없음",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 404,
"resultMessage": "API endpoint not found"
}
}
}
}
}
}
},
"415": {
"description": "허용되지 않는 메서드",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"415": {
"summary": "허용되지 않는 메서드",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 415,
"resultMessage": "Unsupported content type"
}
}
}
}
}
}
},
"500": {
"description": "서버 내부 오류",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"500": {
"summary": "서버 내부 오류",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 500,
"resultMessage": "Internal Server Error"
}
}
}
}
}
}
}
},
"x-order": 206
}
},
"/maps/v3.0/appkeys/{APPKEY}/coordinates": {
"get": {
"tags": [
"지오코딩"
],
"summary": "지오코딩",
"description": "입력한 주소 문자열을 기반으로 좌표 정보를 검색합니다
부분 주소 또는 키워드 형태의 입력도 허용되며,
검색 결과에 따라 하나 이상의 후보 좌표를 반환합니다",
"operationId": "getCoordinateResult",
"parameters": [
{
"name": "APPKEY",
"in": "path",
"description": "해당 API 사용 권한이 있는 API 키",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "query",
"in": "query",
"description": "검색 키워드",
"required": true,
"schema": {
"type": "string",
"description": "검색 키워드",
"example": "경기도 성남시 분당구 판교역로 240"
},
"example": "경기도 성남시 분당구 판교역로 240"
},
{
"name": "coordtype",
"in": "query",
"description": "좌표 체계",
"required": false,
"schema": {
"maximum": 1,
"minimum": 0,
"type": "string",
"description": "좌표 체계",
"default": "1",
"enum": [
"0",
"1"
],
"x-enum-descriptions": {
"0": "TW 좌표",
"1": "WGS84 좌표"
}
},
"x-enum-descriptions": {
"0": "TW 좌표",
"1": "WGS84 좌표"
}
},
{
"name": "startposition",
"in": "query",
"description": "검색 시작 위치
*0은 첫 번째 위치를 의미",
"required": false,
"schema": {
"type": "string",
"description": "검색 시작 위치
*0은 첫 번째 위치를 의미",
"default": "0"
}
},
{
"name": "reqcount",
"in": "query",
"description": "요청 개수
*0~9999",
"required": false,
"schema": {
"maximum": 9999,
"minimum": 0,
"type": "string",
"description": "요청 개수
*0~9999",
"default": "100"
}
},
{
"name": "admcode",
"in": "query",
"description": "행정구역 코드",
"required": false,
"schema": {
"type": "string",
"description": "행정구역 코드"
}
},
{
"name": "posX",
"in": "query",
"description": "X좌표(경도)
*입력 시 좌표를 기준으로 거리 값 출력",
"required": false,
"schema": {
"type": "string",
"description": "X좌표(경도)
*입력 시 좌표를 기준으로 거리 값 출력",
"example": 127.11075
},
"example": 127.11075
},
{
"name": "posY",
"in": "query",
"description": "Y좌표(위도)
*입력 시 좌표를 기준으로 거리 값 출력",
"required": false,
"schema": {
"type": "string",
"description": "Y좌표(위도)
*입력 시 좌표를 기준으로 거리 값 출력",
"example": 37.402159
},
"example": 37.402159
},
{
"name": "addrext",
"in": "query",
"description": "주소 지번/건물번호 확장 검색 옵션",
"required": false,
"schema": {
"maximum": 2,
"minimum": 0,
"type": "string",
"description": "주소 지번/건물번호 확장 검색 옵션",
"default": "0",
"enum": [
"0",
"1",
"2"
],
"x-enum-descriptions": {
"0": "지번/건물번호 확장 검색",
"1": "부번호 확장 검색",
"2": "본번호 확장 검색"
}
},
"x-enum-descriptions": {
"0": "지번/건물번호 확장 검색",
"1": "부번호 확장 검색",
"2": "본번호 확장 검색"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SearchCoordinatesResponse"
},
"examples": {
"success": {
"summary": "성공",
"value": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"address": {
"result": true,
"totalcount": 1,
"admtotalcount": 1,
"admcount": 1,
"adm": [
{
"type": 3,
"posx": "127.11065",
"posy": "37.402109",
"admcode": "4113510900",
"address": "경기도 성남시 분당구 삼평동",
"address_sido": "경기도",
"address_gu": "성남시 분당구",
"address_dong": "삼평동",
"address_haeng": "삼평동",
"legalcode": "4113510900",
"haengcode": "4113565500",
"jibun": "678",
"roadname": "경기도 성남시 분당구 판교역로",
"roadjibun": "240",
"postcode": "13493",
"buildname": "",
"accuracy": 0,
"distance": 0
}
]
}
}
},
"argError": {
"summary": "파라미터 에러",
"description": "Argument Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 101,
"resultMessage": "Argument Error"
}
}
},
"serverError": {
"summary": "IMPS 서버 에러",
"description": "IMPS Server Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 102,
"resultMessage": "IMPS Server Error"
}
}
},
"authentication": {
"summary": "인증 실패",
"description": "Authentication Failed",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 300,
"resultMessage": "Authentication Failed"
}
}
},
"badRequest": {
"summary": "부적절한 URL",
"description": "Inappropriate URL",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 301,
"resultMessage": "Inappropriate URL"
}
}
}
}
}
}
},
"400": {
"description": "잘못된 요청",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"400": {
"summary": "잘못된 요청",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 400,
"resultMessage": "Invalid request parameter or body"
}
}
}
}
}
}
},
"404": {
"description": "API 없음",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"404": {
"summary": "API 없음",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 404,
"resultMessage": "API endpoint not found"
}
}
}
}
}
}
},
"415": {
"description": "허용되지 않는 메서드",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"415": {
"summary": "허용되지 않는 메서드",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 415,
"resultMessage": "Unsupported content type"
}
}
}
}
}
}
},
"500": {
"description": "서버 내부 오류",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"500": {
"summary": "서버 내부 오류",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 500,
"resultMessage": "Internal Server Error"
}
}
}
}
}
}
}
},
"x-order": 300
}
},
"/maps/v3.0/appkeys/{APPKEY}/addresses": {
"get": {
"tags": [
"지오코딩"
],
"summary": "리버스 지오코딩",
"description": "입력한 좌표(경도, 위도)를 기준으로 해당 위치의 주소 정보를 조회합니다
도로명 주소는 좌표와 가장 가까운 건물 기준으로 반환됩니다",
"operationId": "getAddressesResult",
"parameters": [
{
"name": "APPKEY",
"in": "path",
"description": "해당 API 사용 권한이 있는 API 키",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "posX",
"in": "query",
"description": "해당 지점의 X좌표(경도)",
"required": true,
"schema": {
"type": "string",
"description": "해당 지점의 X좌표(경도)",
"example": 127.11075
},
"example": 127.11075
},
{
"name": "posY",
"in": "query",
"description": "해당 지점의 Y좌표(위도)",
"required": true,
"schema": {
"type": "string",
"description": "해당 지점의 Y좌표(위도)",
"example": 37.402159
},
"example": 37.402159
},
{
"name": "coordtype",
"in": "query",
"description": "좌표 체계",
"required": false,
"schema": {
"maximum": 1,
"minimum": 0,
"type": "string",
"description": "좌표 체계",
"default": "1",
"enum": [
"0",
"1"
],
"x-enum-descriptions": {
"0": "TW 좌표",
"1": "WGS84 좌표"
}
},
"x-enum-descriptions": {
"0": "TW 좌표",
"1": "WGS84 좌표"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SearchAddressesResponse"
},
"examples": {
"success": {
"summary": "성공",
"value": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"location": {
"result": true,
"hasAdmAddress": true,
"adm": {
"posx": "127.110450",
"posy": "37.402125",
"address": "경기도 성남시 분당구 삼평동",
"jibun": "678",
"roadname": "경기도 성남시 분당구 판교역로",
"roadjibun": "240",
"admcode": "4113510900",
"postcode": "13493",
"bldname": "삼환하이펙스A동",
"bldnum": ""
},
"adm_address": {
"address": "경기도 성남시 분당구 삼평동",
"jibun": "678",
"cut_address": "경기 성남시 분당구 삼평동",
"admcode": "4113565500",
"address_category1": "경기도",
"address_category2": "성남시 분당구",
"address_category3": "삼평동",
"address_category4": ""
},
"legal_address": {
"address": "경기도 성남시 분당구 삼평동",
"jibun": "678",
"cut_address": "경기 성남시 분당구 삼평동",
"admcode": "4113510900",
"address_category1": "경기도",
"address_category2": "성남시 분당구",
"address_category3": "삼평동",
"address_category4": ""
}
}
}
},
"argError": {
"summary": "파라미터 에러",
"description": "Argument Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 101,
"resultMessage": "Argument Error"
}
}
},
"serverError": {
"summary": "IMPS 서버 에러",
"description": "IMPS Server Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 102,
"resultMessage": "IMPS Server Error"
}
}
},
"authentication": {
"summary": "인증 실패",
"description": "Authentication Failed",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 300,
"resultMessage": "Authentication Failed"
}
}
},
"badRequest": {
"summary": "부적절한 URL",
"description": "Inappropriate URL",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 301,
"resultMessage": "Inappropriate URL"
}
}
}
}
}
}
},
"400": {
"description": "잘못된 요청",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"400": {
"summary": "잘못된 요청",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 400,
"resultMessage": "Invalid request parameter or body"
}
}
}
}
}
}
},
"404": {
"description": "API 없음",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"404": {
"summary": "API 없음",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 404,
"resultMessage": "API endpoint not found"
}
}
}
}
}
}
},
"415": {
"description": "허용되지 않는 메서드",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"415": {
"summary": "허용되지 않는 메서드",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 415,
"resultMessage": "Unsupported content type"
}
}
}
}
}
}
},
"500": {
"description": "서버 내부 오류",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"500": {
"summary": "서버 내부 오류",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 500,
"resultMessage": "Internal Server Error"
}
}
}
}
}
}
}
},
"x-order": 301
}
},
"/maps/v3.0/appkeys/{APPKEY}/adminToPolygon": {
"get": {
"tags": [
"공간 검색"
],
"summary": "공간 검색",
"description": "지정한 행정구역에 대한 공간(Polygon) 정보를 조회합니다
행정구역 코드 또는 명칭을 기준으로 해당 구역의 공간 좌표 목록을 반환합니다",
"operationId": "getAdminToPolygonResult",
"parameters": [
{
"name": "APPKEY",
"in": "path",
"description": "해당 API 사용 권한이 있는 API 키",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "query",
"in": "query",
"description": "검색 할 행정구역 코드 및 행정 명칭",
"required": true,
"schema": {
"type": "string",
"description": "검색 할 행정구역 코드 및 행정 명칭",
"example": 4113510900
},
"example": 4113510900
},
{
"name": "mode",
"in": "query",
"description": "검색 구역 범위",
"required": true,
"schema": {
"maximum": 4,
"minimum": 1,
"type": "string",
"description": "검색 구역 범위",
"example": 3,
"enum": [
"1",
"2",
"3",
"4"
],
"x-enum-descriptions": {
"1": "광역시도",
"2": "시군구",
"3": "읍면동",
"4": "리"
}
},
"example": 3,
"x-enum-descriptions": {
"1": "광역시도",
"2": "시군구",
"3": "읍면동",
"4": "리"
}
},
{
"name": "coordtype",
"in": "query",
"description": "좌표 체계",
"required": false,
"schema": {
"maximum": 1,
"minimum": 0,
"type": "string",
"description": "좌표 체계",
"default": "1",
"enum": [
"0",
"1"
],
"x-enum-descriptions": {
"0": "TW 좌표",
"1": "WGS84 좌표"
}
},
"x-enum-descriptions": {
"0": "TW 좌표",
"1": "WGS84 좌표"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SearchAdminToPolygonResponse"
},
"examples": {
"success": {
"summary": "성공",
"value": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"polygon": {
"result": true,
"count": 1,
"polygondata": [
{
"admincode": "41135109",
"count": 1,
"polygonlist": [
{
"count": 392,
"polygon": [
{
"x": 127.118274,
"y": 37.410508
},
{
"x": 127.118299,
"y": 37.410191
},
{
"x": 127.118362,
"y": 37.409591
},
{
"x": 127.118412,
"y": 37.40905
},
{
"x": 127.118474,
"y": 37.408416
},
{
"x": 127.118499,
"y": 37.408183
},
{
"x": 127.118549,
"y": 37.407783
},
{
"x": 127.118612,
"y": 37.407392
},
{
"x": 127.118724,
"y": 37.406558
},
{
"x": 127.118837,
"y": 37.405683
},
{
"x": 127.118862,
"y": 37.405517
},
{
"x": 127.118874,
"y": 37.40545
},
{
"x": 127.118912,
"y": 37.405184
},
{
"x": 127.119024,
"y": 37.404375
},
{
"x": 127.119099,
"y": 37.403867
},
{
"x": 127.119124,
"y": 37.403684
},
{
"x": 127.119149,
"y": 37.403559
},
{
"x": 127.119162,
"y": 37.403434
},
{
"x": 127.119162,
"y": 37.403242
},
{
"x": 127.119199,
"y": 37.402984
},
{
"x": 127.119237,
"y": 37.402725
},
{
"x": 127.119312,
"y": 37.402342
},
{
"x": 127.119412,
"y": 37.401701
},
{
"x": 127.119462,
"y": 37.401384
},
{
"x": 127.119499,
"y": 37.401076
},
{
"x": 127.119587,
"y": 37.400759
},
{
"x": 127.119599,
"y": 37.400592
},
{
"x": 127.119662,
"y": 37.400226
},
{
"x": 127.119674,
"y": 37.400134
},
{
"x": 127.119699,
"y": 37.399892
},
{
"x": 127.119737,
"y": 37.399701
},
{
"x": 127.119737,
"y": 37.399642
},
{
"x": 127.119749,
"y": 37.399551
},
{
"x": 127.119787,
"y": 37.399301
},
{
"x": 127.119799,
"y": 37.399234
},
{
"x": 127.119812,
"y": 37.399151
},
{
"x": 127.119824,
"y": 37.399026
},
{
"x": 127.119862,
"y": 37.398726
},
{
"x": 127.119874,
"y": 37.398659
},
{
"x": 127.119887,
"y": 37.398593
},
{
"x": 127.119899,
"y": 37.398484
},
{
"x": 127.119912,
"y": 37.398343
},
{
"x": 127.119937,
"y": 37.397968
},
{
"x": 127.119987,
"y": 37.397601
},
{
"x": 127.119999,
"y": 37.397543
},
{
"x": 127.120024,
"y": 37.397334
},
{
"x": 127.120024,
"y": 37.397284
},
{
"x": 127.120037,
"y": 37.397176
},
{
"x": 127.120049,
"y": 37.397068
},
{
"x": 127.120062,
"y": 37.396984
},
{
"x": 127.120074,
"y": 37.396901
},
{
"x": 127.120137,
"y": 37.396468
},
{
"x": 127.120162,
"y": 37.396335
},
{
"x": 127.120199,
"y": 37.395993
},
{
"x": 127.120212,
"y": 37.395918
},
{
"x": 127.120237,
"y": 37.39576
},
{
"x": 127.120287,
"y": 37.394901
},
{
"x": 127.118337,
"y": 37.39491
},
{
"x": 127.118337,
"y": 37.394993
},
{
"x": 127.118337,
"y": 37.395185
},
{
"x": 127.118112,
"y": 37.395185
},
{
"x": 127.11665,
"y": 37.395185
},
{
"x": 127.116612,
"y": 37.39491
},
{
"x": 127.1127,
"y": 37.394918
},
{
"x": 127.1127,
"y": 37.394976
},
{
"x": 127.1127,
"y": 37.396001
},
{
"x": 127.112625,
"y": 37.396059
},
{
"x": 127.112412,
"y": 37.396059
},
{
"x": 127.112025,
"y": 37.396059
},
{
"x": 127.112012,
"y": 37.396059
},
{
"x": 127.111988,
"y": 37.396051
},
{
"x": 127.111975,
"y": 37.396043
},
{
"x": 127.11195,
"y": 37.396026
},
{
"x": 127.11195,
"y": 37.396009
},
{
"x": 127.111938,
"y": 37.395993
},
{
"x": 127.111925,
"y": 37.395976
},
{
"x": 127.111913,
"y": 37.395959
},
{
"x": 127.1119,
"y": 37.395951
},
{
"x": 127.111875,
"y": 37.395934
},
{
"x": 127.111863,
"y": 37.395926
},
{
"x": 127.111838,
"y": 37.395918
},
{
"x": 127.111813,
"y": 37.395909
},
{
"x": 127.1118,
"y": 37.395909
},
{
"x": 127.111775,
"y": 37.395909
},
{
"x": 127.110663,
"y": 37.395909
},
{
"x": 127.110638,
"y": 37.395909
},
{
"x": 127.110613,
"y": 37.395918
},
{
"x": 127.1106,
"y": 37.395918
},
{
"x": 127.110575,
"y": 37.395926
},
{
"x": 127.11055,
"y": 37.395943
},
{
"x": 127.110538,
"y": 37.395951
},
{
"x": 127.110525,
"y": 37.395968
},
{
"x": 127.110513,
"y": 37.395984
},
{
"x": 127.1105,
"y": 37.395993
},
{
"x": 127.110488,
"y": 37.396009
},
{
"x": 127.110488,
"y": 37.396026
},
{
"x": 127.110463,
"y": 37.396043
},
{
"x": 127.11045,
"y": 37.396051
},
{
"x": 127.110425,
"y": 37.396059
},
{
"x": 127.1104,
"y": 37.396059
},
{
"x": 127.110188,
"y": 37.396059
},
{
"x": 127.109938,
"y": 37.396059
},
{
"x": 127.10935,
"y": 37.396034
},
{
"x": 127.10905,
"y": 37.396034
},
{
"x": 127.108913,
"y": 37.396068
},
{
"x": 127.107913,
"y": 37.396068
},
{
"x": 127.107775,
"y": 37.396034
},
{
"x": 127.107213,
"y": 37.396043
},
{
"x": 127.107063,
"y": 37.395943
},
{
"x": 127.107,
"y": 37.395768
},
{
"x": 127.106975,
"y": 37.395693
},
{
"x": 127.106888,
"y": 37.395601
},
{
"x": 127.106863,
"y": 37.395543
},
{
"x": 127.106825,
"y": 37.395476
},
{
"x": 127.106788,
"y": 37.395393
},
{
"x": 127.106651,
"y": 37.395143
},
{
"x": 127.106426,
"y": 37.394818
},
{
"x": 127.106351,
"y": 37.394726
},
{
"x": 127.106263,
"y": 37.394626
},
{
"x": 127.106201,
"y": 37.394543
},
{
"x": 127.106063,
"y": 37.394401
},
{
"x": 127.106013,
"y": 37.394351
},
{
"x": 127.106051,
"y": 37.394318
},
{
"x": 127.106063,
"y": 37.394293
},
{
"x": 127.106101,
"y": 37.394251
},
{
"x": 127.105776,
"y": 37.394468
},
{
"x": 127.105538,
"y": 37.394626
},
{
"x": 127.104738,
"y": 37.395059
},
{
"x": 127.104663,
"y": 37.394968
},
{
"x": 127.104313,
"y": 37.394559
},
{
"x": 127.104251,
"y": 37.394601
},
{
"x": 127.104076,
"y": 37.394668
},
{
"x": 127.104001,
"y": 37.394676
},
{
"x": 127.103938,
"y": 37.394684
},
{
"x": 127.103876,
"y": 37.394684
},
{
"x": 127.103851,
"y": 37.394693
},
{
"x": 127.103676,
"y": 37.394734
},
{
"x": 127.103488,
"y": 37.394768
},
{
"x": 127.103338,
"y": 37.394801
},
{
"x": 127.102576,
"y": 37.395218
},
{
"x": 127.102413,
"y": 37.395293
},
{
"x": 127.102338,
"y": 37.395326
},
{
"x": 127.102251,
"y": 37.395351
},
{
"x": 127.102176,
"y": 37.395368
},
{
"x": 127.102113,
"y": 37.395368
},
{
"x": 127.102076,
"y": 37.395376
},
{
"x": 127.102026,
"y": 37.395368
},
{
"x": 127.101988,
"y": 37.395368
},
{
"x": 127.101976,
"y": 37.395359
},
{
"x": 127.101938,
"y": 37.395351
},
{
"x": 127.101876,
"y": 37.395334
},
{
"x": 127.101851,
"y": 37.395359
},
{
"x": 127.101801,
"y": 37.395334
},
{
"x": 127.101763,
"y": 37.395309
},
{
"x": 127.101688,
"y": 37.395259
},
{
"x": 127.101776,
"y": 37.395143
},
{
"x": 127.101776,
"y": 37.395068
},
{
"x": 127.101726,
"y": 37.395009
},
{
"x": 127.101526,
"y": 37.394868
},
{
"x": 127.101538,
"y": 37.394718
},
{
"x": 127.101451,
"y": 37.394584
},
{
"x": 127.101014,
"y": 37.393968
},
{
"x": 127.100989,
"y": 37.393951
},
{
"x": 127.100964,
"y": 37.393968
},
{
"x": 127.100939,
"y": 37.394118
},
{
"x": 127.100989,
"y": 37.394159
},
{
"x": 127.100939,
"y": 37.394359
},
{
"x": 127.100901,
"y": 37.394326
},
{
"x": 127.100901,
"y": 37.394326
},
{
"x": 127.100901,
"y": 37.394334
},
{
"x": 127.100864,
"y": 37.394551
},
{
"x": 127.100826,
"y": 37.394659
},
{
"x": 127.100751,
"y": 37.394976
},
{
"x": 127.100676,
"y": 37.395276
},
{
"x": 127.100589,
"y": 37.395559
},
{
"x": 127.100489,
"y": 37.395826
},
{
"x": 127.100276,
"y": 37.396259
},
{
"x": 127.100139,
"y": 37.396484
},
{
"x": 127.100001,
"y": 37.396701
},
{
"x": 127.099839,
"y": 37.396926
},
{
"x": 127.099664,
"y": 37.397159
},
{
"x": 127.099539,
"y": 37.397334
},
{
"x": 127.099464,
"y": 37.397467
},
{
"x": 127.099426,
"y": 37.397534
},
{
"x": 127.099351,
"y": 37.397676
},
{
"x": 127.099301,
"y": 37.397826
},
{
"x": 127.099276,
"y": 37.397901
},
{
"x": 127.099251,
"y": 37.397959
},
{
"x": 127.099226,
"y": 37.398042
},
{
"x": 127.099201,
"y": 37.398142
},
{
"x": 127.099189,
"y": 37.398201
},
{
"x": 127.099176,
"y": 37.398276
},
{
"x": 127.099164,
"y": 37.398351
},
{
"x": 127.099164,
"y": 37.398426
},
{
"x": 127.099151,
"y": 37.398501
},
{
"x": 127.099151,
"y": 37.398576
},
{
"x": 127.099151,
"y": 37.398651
},
{
"x": 127.099151,
"y": 37.398734
},
{
"x": 127.099164,
"y": 37.398809
},
{
"x": 127.099176,
"y": 37.398884
},
{
"x": 127.099239,
"y": 37.399251
},
{
"x": 127.099239,
"y": 37.399292
},
{
"x": 127.099251,
"y": 37.399342
},
{
"x": 127.099251,
"y": 37.399392
},
{
"x": 127.099251,
"y": 37.399442
},
{
"x": 127.099251,
"y": 37.399492
},
{
"x": 127.099251,
"y": 37.399534
},
{
"x": 127.099251,
"y": 37.399584
},
{
"x": 127.099251,
"y": 37.399634
},
{
"x": 127.099251,
"y": 37.399684
},
{
"x": 127.099251,
"y": 37.399734
},
{
"x": 127.099251,
"y": 37.399784
},
{
"x": 127.099239,
"y": 37.399875
},
{
"x": 127.099201,
"y": 37.400075
},
{
"x": 127.099101,
"y": 37.400384
},
{
"x": 127.099114,
"y": 37.400467
},
{
"x": 127.099064,
"y": 37.400492
},
{
"x": 127.099051,
"y": 37.400525
},
{
"x": 127.099039,
"y": 37.400567
},
{
"x": 127.099014,
"y": 37.400609
},
{
"x": 127.099001,
"y": 37.400625
},
{
"x": 127.098989,
"y": 37.400642
},
{
"x": 127.099039,
"y": 37.400642
},
{
"x": 127.099026,
"y": 37.40065
},
{
"x": 127.098989,
"y": 37.400667
},
{
"x": 127.098989,
"y": 37.400667
},
{
"x": 127.098976,
"y": 37.400692
},
{
"x": 127.098964,
"y": 37.400717
},
{
"x": 127.098939,
"y": 37.40075
},
{
"x": 127.098914,
"y": 37.4008
},
{
"x": 127.098889,
"y": 37.40085
},
{
"x": 127.098864,
"y": 37.400892
},
{
"x": 127.098826,
"y": 37.400942
},
{
"x": 127.098801,
"y": 37.400984
},
{
"x": 127.098764,
"y": 37.401034
},
{
"x": 127.098739,
"y": 37.401075
},
{
"x": 127.098701,
"y": 37.401117
},
{
"x": 127.098676,
"y": 37.401159
},
{
"x": 127.098639,
"y": 37.4012
},
{
"x": 127.098601,
"y": 37.40125
},
{
"x": 127.098526,
"y": 37.401334
},
{
"x": 127.098451,
"y": 37.401409
},
{
"x": 127.098326,
"y": 37.401542
},
{
"x": 127.098101,
"y": 37.401759
},
{
"x": 127.097576,
"y": 37.402267
},
{
"x": 127.097614,
"y": 37.402258
},
{
"x": 127.097514,
"y": 37.402358
},
{
"x": 127.097401,
"y": 37.402425
},
{
"x": 127.097189,
"y": 37.402633
},
{
"x": 127.097076,
"y": 37.402733
},
{
"x": 127.097014,
"y": 37.4028
},
{
"x": 127.096939,
"y": 37.402858
},
{
"x": 127.096864,
"y": 37.402917
},
{
"x": 127.096814,
"y": 37.402958
},
{
"x": 127.096726,
"y": 37.403017
},
{
"x": 127.096651,
"y": 37.403058
},
{
"x": 127.096564,
"y": 37.403108
},
{
"x": 127.096476,
"y": 37.403158
},
{
"x": 127.096376,
"y": 37.403208
},
{
"x": 127.096289,
"y": 37.403242
},
{
"x": 127.096201,
"y": 37.403283
},
{
"x": 127.096126,
"y": 37.403308
},
{
"x": 127.096064,
"y": 37.403325
},
{
"x": 127.095989,
"y": 37.40335
},
{
"x": 127.095864,
"y": 37.403375
},
{
"x": 127.095751,
"y": 37.4034
},
{
"x": 127.095626,
"y": 37.403408
},
{
"x": 127.095501,
"y": 37.403417
},
{
"x": 127.095376,
"y": 37.403408
},
{
"x": 127.095026,
"y": 37.403383
},
{
"x": 127.094801,
"y": 37.403375
},
{
"x": 127.094651,
"y": 37.403375
},
{
"x": 127.094489,
"y": 37.403383
},
{
"x": 127.094239,
"y": 37.403425
},
{
"x": 127.093989,
"y": 37.403475
},
{
"x": 127.093864,
"y": 37.403517
},
{
"x": 127.093776,
"y": 37.40355
},
{
"x": 127.093614,
"y": 37.403608
},
{
"x": 127.093451,
"y": 37.403675
},
{
"x": 127.093301,
"y": 37.403742
},
{
"x": 127.093076,
"y": 37.403842
},
{
"x": 127.092927,
"y": 37.403917
},
{
"x": 127.092764,
"y": 37.403992
},
{
"x": 127.092677,
"y": 37.404025
},
{
"x": 127.092589,
"y": 37.40405
},
{
"x": 127.092552,
"y": 37.404066
},
{
"x": 127.092452,
"y": 37.404091
},
{
"x": 127.092627,
"y": 37.404291
},
{
"x": 127.092677,
"y": 37.404566
},
{
"x": 127.092677,
"y": 37.404575
},
{
"x": 127.092664,
"y": 37.404616
},
{
"x": 127.092677,
"y": 37.404625
},
{
"x": 127.092789,
"y": 37.404783
},
{
"x": 127.092826,
"y": 37.404833
},
{
"x": 127.092914,
"y": 37.404966
},
{
"x": 127.093001,
"y": 37.4051
},
{
"x": 127.092926,
"y": 37.405116
},
{
"x": 127.092676,
"y": 37.40515
},
{
"x": 127.092452,
"y": 37.405291
},
{
"x": 127.092626,
"y": 37.405358
},
{
"x": 127.092701,
"y": 37.405383
},
{
"x": 127.092901,
"y": 37.405633
},
{
"x": 127.093426,
"y": 37.406016
},
{
"x": 127.093676,
"y": 37.406191
},
{
"x": 127.093876,
"y": 37.406291
},
{
"x": 127.094151,
"y": 37.406491
},
{
"x": 127.094226,
"y": 37.406566
},
{
"x": 127.094451,
"y": 37.4068
},
{
"x": 127.094489,
"y": 37.406841
},
{
"x": 127.094776,
"y": 37.406966
},
{
"x": 127.094964,
"y": 37.406966
},
{
"x": 127.095201,
"y": 37.406925
},
{
"x": 127.095401,
"y": 37.406941
},
{
"x": 127.095489,
"y": 37.406983
},
{
"x": 127.095576,
"y": 37.407016
},
{
"x": 127.095639,
"y": 37.40705
},
{
"x": 127.095826,
"y": 37.407075
},
{
"x": 127.095964,
"y": 37.407091
},
{
"x": 127.096126,
"y": 37.407116
},
{
"x": 127.096501,
"y": 37.406991
},
{
"x": 127.096764,
"y": 37.406858
},
{
"x": 127.096839,
"y": 37.406616
},
{
"x": 127.097089,
"y": 37.406566
},
{
"x": 127.097214,
"y": 37.406541
},
{
"x": 127.097701,
"y": 37.406558
},
{
"x": 127.098013,
"y": 37.406575
},
{
"x": 127.098776,
"y": 37.406783
},
{
"x": 127.099501,
"y": 37.406958
},
{
"x": 127.099638,
"y": 37.406908
},
{
"x": 127.099838,
"y": 37.4069
},
{
"x": 127.099888,
"y": 37.40695
},
{
"x": 127.099976,
"y": 37.406983
},
{
"x": 127.099988,
"y": 37.407058
},
{
"x": 127.100013,
"y": 37.407175
},
{
"x": 127.100076,
"y": 37.407291
},
{
"x": 127.099913,
"y": 37.407683
},
{
"x": 127.099851,
"y": 37.407883
},
{
"x": 127.099863,
"y": 37.407941
},
{
"x": 127.099926,
"y": 37.408008
},
{
"x": 127.100013,
"y": 37.408083
},
{
"x": 127.100013,
"y": 37.408166
},
{
"x": 127.100113,
"y": 37.408233
},
{
"x": 127.100163,
"y": 37.408441
},
{
"x": 127.100226,
"y": 37.408674
},
{
"x": 127.100251,
"y": 37.408799
},
{
"x": 127.101226,
"y": 37.409174
},
{
"x": 127.101638,
"y": 37.409241
},
{
"x": 127.102001,
"y": 37.409299
},
{
"x": 127.102425,
"y": 37.409716
},
{
"x": 127.102675,
"y": 37.409533
},
{
"x": 127.102775,
"y": 37.409491
},
{
"x": 127.10295,
"y": 37.409324
},
{
"x": 127.10315,
"y": 37.409141
},
{
"x": 127.103588,
"y": 37.408758
},
{
"x": 127.10375,
"y": 37.408608
},
{
"x": 127.104075,
"y": 37.408691
},
{
"x": 127.104575,
"y": 37.408566
},
{
"x": 127.104825,
"y": 37.408583
},
{
"x": 127.104925,
"y": 37.40845
},
{
"x": 127.105313,
"y": 37.408441
},
{
"x": 127.105525,
"y": 37.4083
},
{
"x": 127.105613,
"y": 37.4082
},
{
"x": 127.105713,
"y": 37.408083
},
{
"x": 127.106375,
"y": 37.407716
},
{
"x": 127.106463,
"y": 37.407675
},
{
"x": 127.106663,
"y": 37.407716
},
{
"x": 127.1069,
"y": 37.407408
},
{
"x": 127.107025,
"y": 37.407225
},
{
"x": 127.107075,
"y": 37.40715
},
{
"x": 127.107125,
"y": 37.40705
},
{
"x": 127.10735,
"y": 37.40715
},
{
"x": 127.107588,
"y": 37.407066
},
{
"x": 127.108962,
"y": 37.407325
},
{
"x": 127.111062,
"y": 37.407358
},
{
"x": 127.111925,
"y": 37.407525
},
{
"x": 127.112112,
"y": 37.407458
},
{
"x": 127.11315,
"y": 37.407725
},
{
"x": 127.114612,
"y": 37.408125
},
{
"x": 127.115112,
"y": 37.408358
},
{
"x": 127.115099,
"y": 37.408416
},
{
"x": 127.115912,
"y": 37.408641
},
{
"x": 127.116074,
"y": 37.408841
},
{
"x": 127.116399,
"y": 37.408991
},
{
"x": 127.116662,
"y": 37.409041
},
{
"x": 127.116874,
"y": 37.409233
},
{
"x": 127.117137,
"y": 37.409575
},
{
"x": 127.117287,
"y": 37.40965
},
{
"x": 127.117337,
"y": 37.409816
},
{
"x": 127.117612,
"y": 37.410075
},
{
"x": 127.118162,
"y": 37.410408
},
{
"x": 127.118249,
"y": 37.410383
},
{
"x": 127.118249,
"y": 37.410458
}
]
}
]
}
]
}
}
},
"argError": {
"summary": "파라미터 에러",
"description": "Argument Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 101,
"resultMessage": "Argument Error"
}
}
},
"serverError": {
"summary": "IMPS 서버 에러",
"description": "IMPS Server Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 102,
"resultMessage": "IMPS Server Error"
}
}
},
"authentication": {
"summary": "인증 실패",
"description": "Authentication Failed",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 300,
"resultMessage": "Authentication Failed"
}
}
},
"badRequest": {
"summary": "부적절한 URL",
"description": "Inappropriate URL",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 301,
"resultMessage": "Inappropriate URL"
}
}
}
}
}
}
},
"400": {
"description": "잘못된 요청",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"400": {
"summary": "잘못된 요청",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 400,
"resultMessage": "Invalid request parameter or body"
}
}
}
}
}
}
},
"404": {
"description": "API 없음",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"404": {
"summary": "API 없음",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 404,
"resultMessage": "API endpoint not found"
}
}
}
}
}
}
},
"415": {
"description": "허용되지 않는 메서드",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"415": {
"summary": "허용되지 않는 메서드",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 415,
"resultMessage": "Unsupported content type"
}
}
}
}
}
}
},
"500": {
"description": "서버 내부 오류",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"500": {
"summary": "서버 내부 오류",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 500,
"resultMessage": "Internal Server Error"
}
}
}
}
}
}
}
},
"x-order": 400
},
"post": {
"tags": [
"공간 검색"
],
"summary": "공간 검색",
"description": "지정한 행정구역에 대한 공간(Polygon) 정보를 조회합니다
행정구역 코드 또는 명칭을 기준으로 해당 구역의 공간 좌표 목록을 반환합니다",
"operationId": "postAdminToPolygonResult",
"parameters": [
{
"name": "APPKEY",
"in": "path",
"description": "해당 API 사용 권한이 있는 API 키",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"description": "공간 검색 조건",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SearchAdminToPolygonRequest"
},
"example": {
"query": "4113510600",
"mode": 3
}
}
},
"required": true
},
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SearchAdminToPolygonResponse"
},
"examples": {
"success": {
"summary": "성공",
"value": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"polygon": {
"result": true,
"count": 1,
"polygondata": [
{
"admincode": "41135109",
"count": 1,
"polygonlist": [
{
"count": 392,
"polygon": [
{
"x": 127.118274,
"y": 37.410508
},
{
"x": 127.118299,
"y": 37.410191
},
{
"x": 127.118362,
"y": 37.409591
},
{
"x": 127.118412,
"y": 37.40905
},
{
"x": 127.118474,
"y": 37.408416
},
{
"x": 127.118499,
"y": 37.408183
},
{
"x": 127.118549,
"y": 37.407783
},
{
"x": 127.118612,
"y": 37.407392
},
{
"x": 127.118724,
"y": 37.406558
},
{
"x": 127.118837,
"y": 37.405683
},
{
"x": 127.118862,
"y": 37.405517
},
{
"x": 127.118874,
"y": 37.40545
},
{
"x": 127.118912,
"y": 37.405184
},
{
"x": 127.119024,
"y": 37.404375
},
{
"x": 127.119099,
"y": 37.403867
},
{
"x": 127.119124,
"y": 37.403684
},
{
"x": 127.119149,
"y": 37.403559
},
{
"x": 127.119162,
"y": 37.403434
},
{
"x": 127.119162,
"y": 37.403242
},
{
"x": 127.119199,
"y": 37.402984
},
{
"x": 127.119237,
"y": 37.402725
},
{
"x": 127.119312,
"y": 37.402342
},
{
"x": 127.119412,
"y": 37.401701
},
{
"x": 127.119462,
"y": 37.401384
},
{
"x": 127.119499,
"y": 37.401076
},
{
"x": 127.119587,
"y": 37.400759
},
{
"x": 127.119599,
"y": 37.400592
},
{
"x": 127.119662,
"y": 37.400226
},
{
"x": 127.119674,
"y": 37.400134
},
{
"x": 127.119699,
"y": 37.399892
},
{
"x": 127.119737,
"y": 37.399701
},
{
"x": 127.119737,
"y": 37.399642
},
{
"x": 127.119749,
"y": 37.399551
},
{
"x": 127.119787,
"y": 37.399301
},
{
"x": 127.119799,
"y": 37.399234
},
{
"x": 127.119812,
"y": 37.399151
},
{
"x": 127.119824,
"y": 37.399026
},
{
"x": 127.119862,
"y": 37.398726
},
{
"x": 127.119874,
"y": 37.398659
},
{
"x": 127.119887,
"y": 37.398593
},
{
"x": 127.119899,
"y": 37.398484
},
{
"x": 127.119912,
"y": 37.398343
},
{
"x": 127.119937,
"y": 37.397968
},
{
"x": 127.119987,
"y": 37.397601
},
{
"x": 127.119999,
"y": 37.397543
},
{
"x": 127.120024,
"y": 37.397334
},
{
"x": 127.120024,
"y": 37.397284
},
{
"x": 127.120037,
"y": 37.397176
},
{
"x": 127.120049,
"y": 37.397068
},
{
"x": 127.120062,
"y": 37.396984
},
{
"x": 127.120074,
"y": 37.396901
},
{
"x": 127.120137,
"y": 37.396468
},
{
"x": 127.120162,
"y": 37.396335
},
{
"x": 127.120199,
"y": 37.395993
},
{
"x": 127.120212,
"y": 37.395918
},
{
"x": 127.120237,
"y": 37.39576
},
{
"x": 127.120287,
"y": 37.394901
},
{
"x": 127.118337,
"y": 37.39491
},
{
"x": 127.118337,
"y": 37.394993
},
{
"x": 127.118337,
"y": 37.395185
},
{
"x": 127.118112,
"y": 37.395185
},
{
"x": 127.11665,
"y": 37.395185
},
{
"x": 127.116612,
"y": 37.39491
},
{
"x": 127.1127,
"y": 37.394918
},
{
"x": 127.1127,
"y": 37.394976
},
{
"x": 127.1127,
"y": 37.396001
},
{
"x": 127.112625,
"y": 37.396059
},
{
"x": 127.112412,
"y": 37.396059
},
{
"x": 127.112025,
"y": 37.396059
},
{
"x": 127.112012,
"y": 37.396059
},
{
"x": 127.111988,
"y": 37.396051
},
{
"x": 127.111975,
"y": 37.396043
},
{
"x": 127.11195,
"y": 37.396026
},
{
"x": 127.11195,
"y": 37.396009
},
{
"x": 127.111938,
"y": 37.395993
},
{
"x": 127.111925,
"y": 37.395976
},
{
"x": 127.111913,
"y": 37.395959
},
{
"x": 127.1119,
"y": 37.395951
},
{
"x": 127.111875,
"y": 37.395934
},
{
"x": 127.111863,
"y": 37.395926
},
{
"x": 127.111838,
"y": 37.395918
},
{
"x": 127.111813,
"y": 37.395909
},
{
"x": 127.1118,
"y": 37.395909
},
{
"x": 127.111775,
"y": 37.395909
},
{
"x": 127.110663,
"y": 37.395909
},
{
"x": 127.110638,
"y": 37.395909
},
{
"x": 127.110613,
"y": 37.395918
},
{
"x": 127.1106,
"y": 37.395918
},
{
"x": 127.110575,
"y": 37.395926
},
{
"x": 127.11055,
"y": 37.395943
},
{
"x": 127.110538,
"y": 37.395951
},
{
"x": 127.110525,
"y": 37.395968
},
{
"x": 127.110513,
"y": 37.395984
},
{
"x": 127.1105,
"y": 37.395993
},
{
"x": 127.110488,
"y": 37.396009
},
{
"x": 127.110488,
"y": 37.396026
},
{
"x": 127.110463,
"y": 37.396043
},
{
"x": 127.11045,
"y": 37.396051
},
{
"x": 127.110425,
"y": 37.396059
},
{
"x": 127.1104,
"y": 37.396059
},
{
"x": 127.110188,
"y": 37.396059
},
{
"x": 127.109938,
"y": 37.396059
},
{
"x": 127.10935,
"y": 37.396034
},
{
"x": 127.10905,
"y": 37.396034
},
{
"x": 127.108913,
"y": 37.396068
},
{
"x": 127.107913,
"y": 37.396068
},
{
"x": 127.107775,
"y": 37.396034
},
{
"x": 127.107213,
"y": 37.396043
},
{
"x": 127.107063,
"y": 37.395943
},
{
"x": 127.107,
"y": 37.395768
},
{
"x": 127.106975,
"y": 37.395693
},
{
"x": 127.106888,
"y": 37.395601
},
{
"x": 127.106863,
"y": 37.395543
},
{
"x": 127.106825,
"y": 37.395476
},
{
"x": 127.106788,
"y": 37.395393
},
{
"x": 127.106651,
"y": 37.395143
},
{
"x": 127.106426,
"y": 37.394818
},
{
"x": 127.106351,
"y": 37.394726
},
{
"x": 127.106263,
"y": 37.394626
},
{
"x": 127.106201,
"y": 37.394543
},
{
"x": 127.106063,
"y": 37.394401
},
{
"x": 127.106013,
"y": 37.394351
},
{
"x": 127.106051,
"y": 37.394318
},
{
"x": 127.106063,
"y": 37.394293
},
{
"x": 127.106101,
"y": 37.394251
},
{
"x": 127.105776,
"y": 37.394468
},
{
"x": 127.105538,
"y": 37.394626
},
{
"x": 127.104738,
"y": 37.395059
},
{
"x": 127.104663,
"y": 37.394968
},
{
"x": 127.104313,
"y": 37.394559
},
{
"x": 127.104251,
"y": 37.394601
},
{
"x": 127.104076,
"y": 37.394668
},
{
"x": 127.104001,
"y": 37.394676
},
{
"x": 127.103938,
"y": 37.394684
},
{
"x": 127.103876,
"y": 37.394684
},
{
"x": 127.103851,
"y": 37.394693
},
{
"x": 127.103676,
"y": 37.394734
},
{
"x": 127.103488,
"y": 37.394768
},
{
"x": 127.103338,
"y": 37.394801
},
{
"x": 127.102576,
"y": 37.395218
},
{
"x": 127.102413,
"y": 37.395293
},
{
"x": 127.102338,
"y": 37.395326
},
{
"x": 127.102251,
"y": 37.395351
},
{
"x": 127.102176,
"y": 37.395368
},
{
"x": 127.102113,
"y": 37.395368
},
{
"x": 127.102076,
"y": 37.395376
},
{
"x": 127.102026,
"y": 37.395368
},
{
"x": 127.101988,
"y": 37.395368
},
{
"x": 127.101976,
"y": 37.395359
},
{
"x": 127.101938,
"y": 37.395351
},
{
"x": 127.101876,
"y": 37.395334
},
{
"x": 127.101851,
"y": 37.395359
},
{
"x": 127.101801,
"y": 37.395334
},
{
"x": 127.101763,
"y": 37.395309
},
{
"x": 127.101688,
"y": 37.395259
},
{
"x": 127.101776,
"y": 37.395143
},
{
"x": 127.101776,
"y": 37.395068
},
{
"x": 127.101726,
"y": 37.395009
},
{
"x": 127.101526,
"y": 37.394868
},
{
"x": 127.101538,
"y": 37.394718
},
{
"x": 127.101451,
"y": 37.394584
},
{
"x": 127.101014,
"y": 37.393968
},
{
"x": 127.100989,
"y": 37.393951
},
{
"x": 127.100964,
"y": 37.393968
},
{
"x": 127.100939,
"y": 37.394118
},
{
"x": 127.100989,
"y": 37.394159
},
{
"x": 127.100939,
"y": 37.394359
},
{
"x": 127.100901,
"y": 37.394326
},
{
"x": 127.100901,
"y": 37.394326
},
{
"x": 127.100901,
"y": 37.394334
},
{
"x": 127.100864,
"y": 37.394551
},
{
"x": 127.100826,
"y": 37.394659
},
{
"x": 127.100751,
"y": 37.394976
},
{
"x": 127.100676,
"y": 37.395276
},
{
"x": 127.100589,
"y": 37.395559
},
{
"x": 127.100489,
"y": 37.395826
},
{
"x": 127.100276,
"y": 37.396259
},
{
"x": 127.100139,
"y": 37.396484
},
{
"x": 127.100001,
"y": 37.396701
},
{
"x": 127.099839,
"y": 37.396926
},
{
"x": 127.099664,
"y": 37.397159
},
{
"x": 127.099539,
"y": 37.397334
},
{
"x": 127.099464,
"y": 37.397467
},
{
"x": 127.099426,
"y": 37.397534
},
{
"x": 127.099351,
"y": 37.397676
},
{
"x": 127.099301,
"y": 37.397826
},
{
"x": 127.099276,
"y": 37.397901
},
{
"x": 127.099251,
"y": 37.397959
},
{
"x": 127.099226,
"y": 37.398042
},
{
"x": 127.099201,
"y": 37.398142
},
{
"x": 127.099189,
"y": 37.398201
},
{
"x": 127.099176,
"y": 37.398276
},
{
"x": 127.099164,
"y": 37.398351
},
{
"x": 127.099164,
"y": 37.398426
},
{
"x": 127.099151,
"y": 37.398501
},
{
"x": 127.099151,
"y": 37.398576
},
{
"x": 127.099151,
"y": 37.398651
},
{
"x": 127.099151,
"y": 37.398734
},
{
"x": 127.099164,
"y": 37.398809
},
{
"x": 127.099176,
"y": 37.398884
},
{
"x": 127.099239,
"y": 37.399251
},
{
"x": 127.099239,
"y": 37.399292
},
{
"x": 127.099251,
"y": 37.399342
},
{
"x": 127.099251,
"y": 37.399392
},
{
"x": 127.099251,
"y": 37.399442
},
{
"x": 127.099251,
"y": 37.399492
},
{
"x": 127.099251,
"y": 37.399534
},
{
"x": 127.099251,
"y": 37.399584
},
{
"x": 127.099251,
"y": 37.399634
},
{
"x": 127.099251,
"y": 37.399684
},
{
"x": 127.099251,
"y": 37.399734
},
{
"x": 127.099251,
"y": 37.399784
},
{
"x": 127.099239,
"y": 37.399875
},
{
"x": 127.099201,
"y": 37.400075
},
{
"x": 127.099101,
"y": 37.400384
},
{
"x": 127.099114,
"y": 37.400467
},
{
"x": 127.099064,
"y": 37.400492
},
{
"x": 127.099051,
"y": 37.400525
},
{
"x": 127.099039,
"y": 37.400567
},
{
"x": 127.099014,
"y": 37.400609
},
{
"x": 127.099001,
"y": 37.400625
},
{
"x": 127.098989,
"y": 37.400642
},
{
"x": 127.099039,
"y": 37.400642
},
{
"x": 127.099026,
"y": 37.40065
},
{
"x": 127.098989,
"y": 37.400667
},
{
"x": 127.098989,
"y": 37.400667
},
{
"x": 127.098976,
"y": 37.400692
},
{
"x": 127.098964,
"y": 37.400717
},
{
"x": 127.098939,
"y": 37.40075
},
{
"x": 127.098914,
"y": 37.4008
},
{
"x": 127.098889,
"y": 37.40085
},
{
"x": 127.098864,
"y": 37.400892
},
{
"x": 127.098826,
"y": 37.400942
},
{
"x": 127.098801,
"y": 37.400984
},
{
"x": 127.098764,
"y": 37.401034
},
{
"x": 127.098739,
"y": 37.401075
},
{
"x": 127.098701,
"y": 37.401117
},
{
"x": 127.098676,
"y": 37.401159
},
{
"x": 127.098639,
"y": 37.4012
},
{
"x": 127.098601,
"y": 37.40125
},
{
"x": 127.098526,
"y": 37.401334
},
{
"x": 127.098451,
"y": 37.401409
},
{
"x": 127.098326,
"y": 37.401542
},
{
"x": 127.098101,
"y": 37.401759
},
{
"x": 127.097576,
"y": 37.402267
},
{
"x": 127.097614,
"y": 37.402258
},
{
"x": 127.097514,
"y": 37.402358
},
{
"x": 127.097401,
"y": 37.402425
},
{
"x": 127.097189,
"y": 37.402633
},
{
"x": 127.097076,
"y": 37.402733
},
{
"x": 127.097014,
"y": 37.4028
},
{
"x": 127.096939,
"y": 37.402858
},
{
"x": 127.096864,
"y": 37.402917
},
{
"x": 127.096814,
"y": 37.402958
},
{
"x": 127.096726,
"y": 37.403017
},
{
"x": 127.096651,
"y": 37.403058
},
{
"x": 127.096564,
"y": 37.403108
},
{
"x": 127.096476,
"y": 37.403158
},
{
"x": 127.096376,
"y": 37.403208
},
{
"x": 127.096289,
"y": 37.403242
},
{
"x": 127.096201,
"y": 37.403283
},
{
"x": 127.096126,
"y": 37.403308
},
{
"x": 127.096064,
"y": 37.403325
},
{
"x": 127.095989,
"y": 37.40335
},
{
"x": 127.095864,
"y": 37.403375
},
{
"x": 127.095751,
"y": 37.4034
},
{
"x": 127.095626,
"y": 37.403408
},
{
"x": 127.095501,
"y": 37.403417
},
{
"x": 127.095376,
"y": 37.403408
},
{
"x": 127.095026,
"y": 37.403383
},
{
"x": 127.094801,
"y": 37.403375
},
{
"x": 127.094651,
"y": 37.403375
},
{
"x": 127.094489,
"y": 37.403383
},
{
"x": 127.094239,
"y": 37.403425
},
{
"x": 127.093989,
"y": 37.403475
},
{
"x": 127.093864,
"y": 37.403517
},
{
"x": 127.093776,
"y": 37.40355
},
{
"x": 127.093614,
"y": 37.403608
},
{
"x": 127.093451,
"y": 37.403675
},
{
"x": 127.093301,
"y": 37.403742
},
{
"x": 127.093076,
"y": 37.403842
},
{
"x": 127.092927,
"y": 37.403917
},
{
"x": 127.092764,
"y": 37.403992
},
{
"x": 127.092677,
"y": 37.404025
},
{
"x": 127.092589,
"y": 37.40405
},
{
"x": 127.092552,
"y": 37.404066
},
{
"x": 127.092452,
"y": 37.404091
},
{
"x": 127.092627,
"y": 37.404291
},
{
"x": 127.092677,
"y": 37.404566
},
{
"x": 127.092677,
"y": 37.404575
},
{
"x": 127.092664,
"y": 37.404616
},
{
"x": 127.092677,
"y": 37.404625
},
{
"x": 127.092789,
"y": 37.404783
},
{
"x": 127.092826,
"y": 37.404833
},
{
"x": 127.092914,
"y": 37.404966
},
{
"x": 127.093001,
"y": 37.4051
},
{
"x": 127.092926,
"y": 37.405116
},
{
"x": 127.092676,
"y": 37.40515
},
{
"x": 127.092452,
"y": 37.405291
},
{
"x": 127.092626,
"y": 37.405358
},
{
"x": 127.092701,
"y": 37.405383
},
{
"x": 127.092901,
"y": 37.405633
},
{
"x": 127.093426,
"y": 37.406016
},
{
"x": 127.093676,
"y": 37.406191
},
{
"x": 127.093876,
"y": 37.406291
},
{
"x": 127.094151,
"y": 37.406491
},
{
"x": 127.094226,
"y": 37.406566
},
{
"x": 127.094451,
"y": 37.4068
},
{
"x": 127.094489,
"y": 37.406841
},
{
"x": 127.094776,
"y": 37.406966
},
{
"x": 127.094964,
"y": 37.406966
},
{
"x": 127.095201,
"y": 37.406925
},
{
"x": 127.095401,
"y": 37.406941
},
{
"x": 127.095489,
"y": 37.406983
},
{
"x": 127.095576,
"y": 37.407016
},
{
"x": 127.095639,
"y": 37.40705
},
{
"x": 127.095826,
"y": 37.407075
},
{
"x": 127.095964,
"y": 37.407091
},
{
"x": 127.096126,
"y": 37.407116
},
{
"x": 127.096501,
"y": 37.406991
},
{
"x": 127.096764,
"y": 37.406858
},
{
"x": 127.096839,
"y": 37.406616
},
{
"x": 127.097089,
"y": 37.406566
},
{
"x": 127.097214,
"y": 37.406541
},
{
"x": 127.097701,
"y": 37.406558
},
{
"x": 127.098013,
"y": 37.406575
},
{
"x": 127.098776,
"y": 37.406783
},
{
"x": 127.099501,
"y": 37.406958
},
{
"x": 127.099638,
"y": 37.406908
},
{
"x": 127.099838,
"y": 37.4069
},
{
"x": 127.099888,
"y": 37.40695
},
{
"x": 127.099976,
"y": 37.406983
},
{
"x": 127.099988,
"y": 37.407058
},
{
"x": 127.100013,
"y": 37.407175
},
{
"x": 127.100076,
"y": 37.407291
},
{
"x": 127.099913,
"y": 37.407683
},
{
"x": 127.099851,
"y": 37.407883
},
{
"x": 127.099863,
"y": 37.407941
},
{
"x": 127.099926,
"y": 37.408008
},
{
"x": 127.100013,
"y": 37.408083
},
{
"x": 127.100013,
"y": 37.408166
},
{
"x": 127.100113,
"y": 37.408233
},
{
"x": 127.100163,
"y": 37.408441
},
{
"x": 127.100226,
"y": 37.408674
},
{
"x": 127.100251,
"y": 37.408799
},
{
"x": 127.101226,
"y": 37.409174
},
{
"x": 127.101638,
"y": 37.409241
},
{
"x": 127.102001,
"y": 37.409299
},
{
"x": 127.102425,
"y": 37.409716
},
{
"x": 127.102675,
"y": 37.409533
},
{
"x": 127.102775,
"y": 37.409491
},
{
"x": 127.10295,
"y": 37.409324
},
{
"x": 127.10315,
"y": 37.409141
},
{
"x": 127.103588,
"y": 37.408758
},
{
"x": 127.10375,
"y": 37.408608
},
{
"x": 127.104075,
"y": 37.408691
},
{
"x": 127.104575,
"y": 37.408566
},
{
"x": 127.104825,
"y": 37.408583
},
{
"x": 127.104925,
"y": 37.40845
},
{
"x": 127.105313,
"y": 37.408441
},
{
"x": 127.105525,
"y": 37.4083
},
{
"x": 127.105613,
"y": 37.4082
},
{
"x": 127.105713,
"y": 37.408083
},
{
"x": 127.106375,
"y": 37.407716
},
{
"x": 127.106463,
"y": 37.407675
},
{
"x": 127.106663,
"y": 37.407716
},
{
"x": 127.1069,
"y": 37.407408
},
{
"x": 127.107025,
"y": 37.407225
},
{
"x": 127.107075,
"y": 37.40715
},
{
"x": 127.107125,
"y": 37.40705
},
{
"x": 127.10735,
"y": 37.40715
},
{
"x": 127.107588,
"y": 37.407066
},
{
"x": 127.108962,
"y": 37.407325
},
{
"x": 127.111062,
"y": 37.407358
},
{
"x": 127.111925,
"y": 37.407525
},
{
"x": 127.112112,
"y": 37.407458
},
{
"x": 127.11315,
"y": 37.407725
},
{
"x": 127.114612,
"y": 37.408125
},
{
"x": 127.115112,
"y": 37.408358
},
{
"x": 127.115099,
"y": 37.408416
},
{
"x": 127.115912,
"y": 37.408641
},
{
"x": 127.116074,
"y": 37.408841
},
{
"x": 127.116399,
"y": 37.408991
},
{
"x": 127.116662,
"y": 37.409041
},
{
"x": 127.116874,
"y": 37.409233
},
{
"x": 127.117137,
"y": 37.409575
},
{
"x": 127.117287,
"y": 37.40965
},
{
"x": 127.117337,
"y": 37.409816
},
{
"x": 127.117612,
"y": 37.410075
},
{
"x": 127.118162,
"y": 37.410408
},
{
"x": 127.118249,
"y": 37.410383
},
{
"x": 127.118249,
"y": 37.410458
}
]
}
]
}
]
}
}
},
"argError": {
"summary": "파라미터 에러",
"description": "Argument Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 101,
"resultMessage": "Argument Error"
}
}
},
"serverError": {
"summary": "IMPS 서버 에러",
"description": "IMPS Server Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 102,
"resultMessage": "IMPS Server Error"
}
}
},
"authentication": {
"summary": "인증 실패",
"description": "Authentication Failed",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 300,
"resultMessage": "Authentication Failed"
}
}
},
"badRequest": {
"summary": "부적절한 URL",
"description": "Inappropriate URL",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 301,
"resultMessage": "Inappropriate URL"
}
}
}
}
}
}
},
"400": {
"description": "잘못된 요청",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"400": {
"summary": "잘못된 요청",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 400,
"resultMessage": "Invalid request parameter or body"
}
}
}
}
}
}
},
"404": {
"description": "API 없음",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"404": {
"summary": "API 없음",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 404,
"resultMessage": "API endpoint not found"
}
}
}
}
}
}
},
"415": {
"description": "허용되지 않는 메서드",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"415": {
"summary": "허용되지 않는 메서드",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 415,
"resultMessage": "Unsupported content type"
}
}
}
}
}
}
},
"500": {
"description": "서버 내부 오류",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"500": {
"summary": "서버 내부 오류",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 500,
"resultMessage": "Internal Server Error"
}
}
}
}
}
}
}
},
"x-order": 401
}
},
"/maps/v3.0/appkeys/{APPKEY}/polygonToAdmin": {
"post": {
"tags": [
"공간 검색"
],
"summary": "행정/법정동 영역 검색",
"description": "입력한 좌표(경도, 위도)를 기준으로 해당 위치가 포함되는 행정구역 정보를 조회합니다
행정동 및 법정동 등의 행정구역 정보를 반환합니다",
"operationId": "postPolygonToAdminResult",
"parameters": [
{
"name": "APPKEY",
"in": "path",
"description": "해당 API 사용 권한이 있는 API 키",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"description": "행정/법정동 영역 검색 조건",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SearchPolygonToAdminRequest"
},
"example": {
"polygon": [
{
"x": "127.112576",
"y": "37.403078"
},
{
"x": "127.108285",
"y": "37.403078"
},
{
"x": "127.110685",
"y": "37.400726"
}
]
}
}
},
"required": true
},
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SearchPolygonToAdminResponse"
},
"examples": {
"success": {
"summary": "성공",
"value": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"adm": {
"result": true,
"admincodes": {
"count": 2,
"admincodelist": [
{
"adminCode": "4113510900",
"address": "경기도 성남시 분당구 삼평동"
},
{
"adminCode": "4113565500",
"address": "경기도 성남시 분당구 삼평동"
}
]
}
}
}
},
"argError": {
"summary": "파라미터 에러",
"description": "Argument Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 101,
"resultMessage": "Argument Error"
}
}
},
"serverError": {
"summary": "IMPS 서버 에러",
"description": "IMPS Server Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 102,
"resultMessage": "IMPS Server Error"
}
}
},
"authentication": {
"summary": "인증 실패",
"description": "Authentication Failed",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 300,
"resultMessage": "Authentication Failed"
}
}
},
"badRequest": {
"summary": "부적절한 URL",
"description": "Inappropriate URL",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 301,
"resultMessage": "Inappropriate URL"
}
}
}
}
}
}
},
"400": {
"description": "잘못된 요청",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"400": {
"summary": "잘못된 요청",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 400,
"resultMessage": "Invalid request parameter or body"
}
}
}
}
}
}
},
"404": {
"description": "API 없음",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"404": {
"summary": "API 없음",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 404,
"resultMessage": "API endpoint not found"
}
}
}
}
}
}
},
"415": {
"description": "허용되지 않는 메서드",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"415": {
"summary": "허용되지 않는 메서드",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 415,
"resultMessage": "Unsupported content type"
}
}
}
}
}
}
},
"500": {
"description": "서버 내부 오류",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"500": {
"summary": "서버 내부 오류",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 500,
"resultMessage": "Internal Server Error"
}
}
}
}
}
}
}
},
"x-order": 402
}
},
"/maps/v3.0/appkeys/{APPKEY}/trans-coordinates": {
"get": {
"tags": [
"공간 검색"
],
"summary": "좌표(계) 변환",
"description": "입력한 좌표를 지정한 좌표계로 변환합니다
좌표 변환 방식에 따라 WGS84, TM, TW, BESSEL 간 상호 변환을 지원합니다",
"operationId": "getTransCoordinatesResult",
"parameters": [
{
"name": "APPKEY",
"in": "path",
"description": "해당 API 사용 권한이 있는 API 키",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "posX",
"in": "query",
"description": "X좌표(경도)
*입력 좌표계에 따라 경도(Longitude) 또는 Easting",
"required": true,
"schema": {
"type": "string",
"description": "X좌표(경도)
*입력 좌표계에 따라 경도(Longitude) 또는 Easting",
"example": 127.11075
},
"example": 127.11075
},
{
"name": "posY",
"in": "query",
"description": "Y좌표(위도)
*입력 좌표계에 따라 위도(Latitude) 또는 Northing",
"required": true,
"schema": {
"type": "string",
"description": "Y좌표(위도)
*입력 좌표계에 따라 위도(Latitude) 또는 Northing",
"example": 37.402159
},
"example": 37.402159
},
{
"name": "coordtype",
"in": "query",
"description": "좌표 변환 방식 코드",
"required": true,
"schema": {
"maximum": 5,
"minimum": 0,
"pattern": "^([0-5]{1})$",
"type": "string",
"description": "좌표 변환 방식 코드",
"example": 0,
"enum": [
"0",
"1",
"2",
"3",
"4",
"5"
],
"x-enum-descriptions": {
"0": "WGS84→TM",
"1": "TM→WGS84",
"2": "WGS84→TW",
"3": "TW→WGS84",
"4": "WGS84→BESSEL",
"5": "BESSEL→WGS84"
}
},
"example": 0,
"x-enum-descriptions": {
"0": "WGS84→TM",
"1": "TM→WGS84",
"2": "WGS84→TW",
"3": "TW→WGS84",
"4": "WGS84→BESSEL",
"5": "BESSEL→WGS84"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SearchTransCoordinatesResponse"
},
"examples": {
"success": {
"summary": "성공",
"value": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"coordinate": {
"x": "209991.93",
"y": "433345.71",
"coordtype": "TM"
}
}
},
"argError": {
"summary": "파라미터 에러",
"description": "Argument Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 101,
"resultMessage": "Argument Error"
}
}
},
"serverError": {
"summary": "IMPS 서버 에러",
"description": "IMPS Server Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 102,
"resultMessage": "IMPS Server Error"
}
}
},
"authentication": {
"summary": "인증 실패",
"description": "Authentication Failed",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 300,
"resultMessage": "Authentication Failed"
}
}
},
"badRequest": {
"summary": "부적절한 URL",
"description": "Inappropriate URL",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 301,
"resultMessage": "Inappropriate URL"
}
}
}
}
}
}
},
"400": {
"description": "잘못된 요청",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"400": {
"summary": "잘못된 요청",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 400,
"resultMessage": "Invalid request parameter or body"
}
}
}
}
}
}
},
"404": {
"description": "API 없음",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"404": {
"summary": "API 없음",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 404,
"resultMessage": "API endpoint not found"
}
}
}
}
}
}
},
"415": {
"description": "허용되지 않는 메서드",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"415": {
"summary": "허용되지 않는 메서드",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 415,
"resultMessage": "Unsupported content type"
}
}
}
}
}
}
},
"500": {
"description": "서버 내부 오류",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"500": {
"summary": "서버 내부 오류",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 500,
"resultMessage": "Internal Server Error"
}
}
}
}
}
}
}
},
"x-order": 403
}
},
"/maps/v3.0/appkeys/{APPKEY}/w3w-proposers": {
"get": {
"tags": [
"W3W"
],
"summary": "W3W 검색어 추천",
"description": "W3W 검색어 추천 결과에 대한 상세 정보를 제공합니다",
"operationId": "getW3WProposersResult",
"parameters": [
{
"name": "APPKEY",
"in": "path",
"description": "해당 API 사용 권한이 있는 API 키",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "query",
"in": "query",
"description": "w3w(what3words)키워드
*what3words 양식 대로 2단어 입력 후 초성 및 단어 입력 필수
*예: 서명.증감.ㅇ / 외치다.효자.소",
"required": true,
"schema": {
"pattern": "^(([가-힣]+\\.){2}[ㄱ-ㅎ가-힣]+|([a-zA-Z]+\\.){2}[a-zA-Z]+)$",
"type": "string",
"description": "w3w(what3words)키워드
*what3words 양식 대로 2단어 입력 후 초성 및 단어 입력 필수
*예: 서명.증감.ㅇ / 외치다.효자.소",
"example": "외치다.효자.소"
},
"example": "외치다.효자.소"
},
{
"name": "posX",
"in": "query",
"description": "해당 지점의 X좌표(경도)",
"required": false,
"schema": {
"type": "string",
"description": "해당 지점의 X좌표(경도)",
"example": 127.11075
},
"example": 127.11075
},
{
"name": "posY",
"in": "query",
"description": "해당 지점의 Y좌표(위도)",
"required": false,
"schema": {
"type": "string",
"description": "해당 지점의 Y좌표(위도)",
"example": 37.402159
},
"example": 37.402159
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SearchW3WProposerResponse"
},
"examples": {
"success": {
"summary": "성공",
"value": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"proposer": {
"result": true,
"keyword": [
{
"keyword": "외치다.효자.소포",
"address": "경기도 성남시",
"distance": 9
},
{
"keyword": "외치다.효도.소포",
"address": "경기도 성남시",
"distance": 4
},
{
"keyword": "외치다.겨자.소수",
"address": "경기도 수원시",
"distance": 13
}
]
}
}
},
"argError": {
"summary": "파라미터 에러",
"description": "Argument Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 101,
"resultMessage": "Argument Error"
}
}
},
"serverError": {
"summary": "IMPS 서버 에러",
"description": "IMPS Server Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 102,
"resultMessage": "IMPS Server Error"
}
}
},
"authentication": {
"summary": "인증 실패",
"description": "Authentication Failed",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 300,
"resultMessage": "Authentication Failed"
}
}
},
"badRequest": {
"summary": "부적절한 URL",
"description": "Inappropriate URL",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 301,
"resultMessage": "Inappropriate URL"
}
}
}
}
}
}
},
"400": {
"description": "잘못된 요청",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"400": {
"summary": "잘못된 요청",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 400,
"resultMessage": "Invalid request parameter or body"
}
}
}
}
}
}
},
"404": {
"description": "API 없음",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"404": {
"summary": "API 없음",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 404,
"resultMessage": "API endpoint not found"
}
}
}
}
}
}
},
"415": {
"description": "허용되지 않는 메서드",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"415": {
"summary": "허용되지 않는 메서드",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 415,
"resultMessage": "Unsupported content type"
}
}
}
}
}
}
},
"500": {
"description": "서버 내부 오류",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"500": {
"summary": "서버 내부 오류",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 500,
"resultMessage": "Internal Server Error"
}
}
}
}
}
}
}
},
"x-order": 500
}
},
"/maps/v3.0/appkeys/{APPKEY}/w3w-addresses": {
"get": {
"tags": [
"W3W"
],
"summary": "W3W 리버스 지오코딩",
"description": "W3W 리버스 지오코딩 결과에 대한 상세 정보를 제공합니다",
"operationId": "getW3WAddressesResult",
"parameters": [
{
"name": "APPKEY",
"in": "path",
"description": "해당 API 사용 권한이 있는 API 키",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "posX",
"in": "query",
"description": "해당 지점의 X좌표(경도)
*wgs84",
"required": true,
"schema": {
"type": "string",
"description": "해당 지점의 X좌표(경도)
*wgs84",
"example": 127.11075
},
"example": 127.11075
},
{
"name": "posY",
"in": "query",
"description": "해당 지점의 Y좌표(위도)
*wgs84",
"required": true,
"schema": {
"type": "string",
"description": "해당 지점의 Y좌표(위도)
*wgs84",
"example": 37.402159
},
"example": 37.402159
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SearchW3WAddressesResponse"
},
"examples": {
"success": {
"summary": "성공",
"value": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"address": {
"result": true,
"adm": {
"keyword": "승차.수영.왼발",
"posX": "127.110766",
"posY": "37.402153",
"address": "경기도 성남시 분당구 삼평동 678",
"roadname": "경기도 성남시 분당구 판교역로 240"
}
}
}
},
"argError": {
"summary": "파라미터 에러",
"description": "Argument Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 101,
"resultMessage": "Argument Error"
}
}
},
"serverError": {
"summary": "IMPS 서버 에러",
"description": "IMPS Server Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 102,
"resultMessage": "IMPS Server Error"
}
}
},
"authentication": {
"summary": "인증 실패",
"description": "Authentication Failed",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 300,
"resultMessage": "Authentication Failed"
}
}
},
"badRequest": {
"summary": "부적절한 URL",
"description": "Inappropriate URL",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 301,
"resultMessage": "Inappropriate URL"
}
}
}
}
}
}
},
"400": {
"description": "잘못된 요청",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"400": {
"summary": "잘못된 요청",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 400,
"resultMessage": "Invalid request parameter or body"
}
}
}
}
}
}
},
"404": {
"description": "API 없음",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"404": {
"summary": "API 없음",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 404,
"resultMessage": "API endpoint not found"
}
}
}
}
}
}
},
"415": {
"description": "허용되지 않는 메서드",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"415": {
"summary": "허용되지 않는 메서드",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 415,
"resultMessage": "Unsupported content type"
}
}
}
}
}
}
},
"500": {
"description": "서버 내부 오류",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"500": {
"summary": "서버 내부 오류",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 500,
"resultMessage": "Internal Server Error"
}
}
}
}
}
}
}
},
"x-order": 501
}
},
"/maps/v3.0/appkeys/{APPKEY}/w3w-optimal-position-searches": {
"get": {
"tags": [
"W3W"
],
"summary": "W3W 최적 지점 검색",
"description": "W3W 최적 지점 검색 결과에 대한 상세 정보를 제공합니다",
"operationId": "getW3WOptimalPositionSearchesResult",
"parameters": [
{
"name": "APPKEY",
"in": "path",
"description": "해당 API 사용 권한이 있는 API 키",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "query",
"in": "query",
"description": "w3w(what3words)키워드
*what3words 양식 대로 3단어 입력 필수
*예: 승차.수영.왼발",
"required": true,
"schema": {
"pattern": "^(([가-힣]+\\.){2}[ㄱ-ㅎ가-힣]+|([a-zA-Z]+\\.){2}[a-zA-Z]+)$",
"type": "string",
"description": "w3w(what3words)키워드
*what3words 양식 대로 3단어 입력 필수
*예: 승차.수영.왼발",
"example": "승차.수영.왼발"
},
"example": "승차.수영.왼발"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SearchW3WOptimalPositionResponse"
},
"examples": {
"success": {
"summary": "성공",
"value": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"data": {
"result": true,
"entrypoint": {
"keyword": "승차.수영.왼발",
"posX": 127.110876,
"posY": 37.402324,
"address": "경기도 성남시 분당구 삼평동 678",
"roadname": "경기도 성남시 분당구 판교역로 240"
}
}
}
},
"argError": {
"summary": "파라미터 에러",
"description": "Argument Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 101,
"resultMessage": "Argument Error"
}
}
},
"serverError": {
"summary": "IMPS 서버 에러",
"description": "IMPS Server Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 102,
"resultMessage": "IMPS Server Error"
}
}
},
"authentication": {
"summary": "인증 실패",
"description": "Authentication Failed",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 300,
"resultMessage": "Authentication Failed"
}
}
},
"badRequest": {
"summary": "부적절한 URL",
"description": "Inappropriate URL",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 301,
"resultMessage": "Inappropriate URL"
}
}
}
}
}
}
},
"400": {
"description": "잘못된 요청",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"400": {
"summary": "잘못된 요청",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 400,
"resultMessage": "Invalid request parameter or body"
}
}
}
}
}
}
},
"404": {
"description": "API 없음",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"404": {
"summary": "API 없음",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 404,
"resultMessage": "API endpoint not found"
}
}
}
}
}
}
},
"415": {
"description": "허용되지 않는 메서드",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"415": {
"summary": "허용되지 않는 메서드",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 415,
"resultMessage": "Unsupported content type"
}
}
}
}
}
}
},
"500": {
"description": "서버 내부 오류",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"500": {
"summary": "서버 내부 오류",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 500,
"resultMessage": "Internal Server Error"
}
}
}
}
}
}
}
},
"x-order": 502
}
},
"/maps/v3.0/appkeys/{APPKEY}/route-normal": {
"get": {
"tags": [
"탐색"
],
"summary": "경로 탐색",
"description": "출발/도착지 및 최대 5개의 경유지, 기타 설정을 통해 최적화된 경로 탐색 정보를 반환합니다",
"operationId": "getRouteNormalResult",
"parameters": [
{
"name": "APPKEY",
"in": "path",
"description": "해당 API 사용 권한이 있는 API 키",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "option",
"in": "query",
"description": "경로 탐색 옵션
*하나만 선택 가능",
"required": true,
"schema": {
"pattern": "^(real_traffic|real_traffic2|real_traffic_freeroad|short_distance_priority|time_priority|motorcycle|recommendation|highway_priority)$",
"type": "string",
"description": "경로 탐색 옵션
*하나만 선택 가능",
"example": "real_traffic",
"enum": [
"real_traffic",
"real_traffic2",
"real_traffic_freeroad",
"short_distance_priority",
"time_priority",
"motorcycle",
"recommendation",
"highway_priority"
],
"x-enum-descriptions": {
"motorcycle": "이륜차 경로",
"highway_priority": "고속 도로",
"short_distance_priority": "최단 거리",
"time_priority": "최소 시간",
"real_traffic": "실시간 경로",
"recommendation": "추천 경로",
"real_traffic_freeroad": "무료 도로",
"real_traffic2": "대안 경로"
}
},
"example": "real_traffic",
"x-enum-descriptions": {
"motorcycle": "이륜차 경로",
"highway_priority": "고속 도로",
"short_distance_priority": "최단 거리",
"time_priority": "최소 시간",
"real_traffic": "실시간 경로",
"recommendation": "추천 경로",
"real_traffic_freeroad": "무료 도로",
"real_traffic2": "대안 경로"
}
},
{
"name": "startX",
"in": "query",
"description": "시작 지점(출발지)에 대한 X좌표(경도)",
"required": true,
"schema": {
"type": "string",
"description": "시작 지점(출발지)에 대한 X좌표(경도)",
"example": 127.110762
},
"example": 127.110762
},
{
"name": "startY",
"in": "query",
"description": "시작 지점(출발지)에 대한 Y좌표(위도)",
"required": true,
"schema": {
"type": "string",
"description": "시작 지점(출발지)에 대한 Y좌표(위도)",
"example": 37.402184
},
"example": 37.402184
},
{
"name": "endX",
"in": "query",
"description": "끝 지점(도착지)에 대한 X좌표(경도)",
"required": true,
"schema": {
"type": "string",
"description": "끝 지점(도착지)에 대한 X좌표(경도)",
"example": 127.105399
},
"example": 127.105399
},
{
"name": "endY",
"in": "query",
"description": "끝 지점(도착지)에 대한 Y좌표(위도)",
"required": true,
"schema": {
"type": "string",
"description": "끝 지점(도착지)에 대한 Y좌표(위도)",
"example": 37.5124518
},
"example": 37.5124518
},
{
"name": "coordType",
"in": "query",
"description": "좌표 체계
*'wgs84'는 국제 표준 좌표계, 'tw'는 팅크웨어 좌표계를 의미",
"required": false,
"schema": {
"pattern": "^(tw|wgs84|TW|WGS84)$",
"type": "string",
"description": "좌표 체계
*'wgs84'는 국제 표준 좌표계, 'tw'는 팅크웨어 좌표계를 의미",
"default": "wgs84",
"enum": [
"wgs84",
"tw"
]
}
},
{
"name": "via1X",
"in": "query",
"description": "1 번째 경유지에 대한 X좌표(경도)",
"required": false,
"schema": {
"type": "string",
"description": "1 번째 경유지에 대한 X좌표(경도)"
}
},
{
"name": "via1Y",
"in": "query",
"description": "1 번째 경유지에 대한 Y좌표(위도)",
"required": false,
"schema": {
"type": "string",
"description": "1 번째 경유지에 대한 Y좌표(위도)"
}
},
{
"name": "via2X",
"in": "query",
"description": "2 번째 경유지에 대한 X좌표(경도)",
"required": false,
"schema": {
"type": "string",
"description": "2 번째 경유지에 대한 X좌표(경도)"
}
},
{
"name": "via2Y",
"in": "query",
"description": "2 번째 경유지에 대한 Y좌표(위도)",
"required": false,
"schema": {
"type": "string",
"description": "2 번째 경유지에 대한 Y좌표(위도)"
}
},
{
"name": "via3X",
"in": "query",
"description": "3 번째 경유지에 대한 X좌표(경도)",
"required": false,
"schema": {
"type": "string",
"description": "3 번째 경유지에 대한 X좌표(경도)"
}
},
{
"name": "via3Y",
"in": "query",
"description": "3 번째 경유지에 대한 Y좌표(위도)",
"required": false,
"schema": {
"type": "string",
"description": "3 번째 경유지에 대한 Y좌표(위도)"
}
},
{
"name": "via4X",
"in": "query",
"description": "4 번째 경유지에 대한 X좌표(경도)",
"required": false,
"schema": {
"type": "string",
"description": "4 번째 경유지에 대한 X좌표(경도)"
}
},
{
"name": "via4Y",
"in": "query",
"description": "4 번째 경유지에 대한 Y좌표(위도)",
"required": false,
"schema": {
"type": "string",
"description": "4 번째 경유지에 대한 Y좌표(위도)"
}
},
{
"name": "via5X",
"in": "query",
"description": "5 번째 경유지에 대한 X좌표(경도)",
"required": false,
"schema": {
"type": "string",
"description": "5 번째 경유지에 대한 X좌표(경도)"
}
},
{
"name": "via5Y",
"in": "query",
"description": "5 번째 경유지에 대한 Y좌표(위도)",
"required": false,
"schema": {
"type": "string",
"description": "5 번째 경유지에 대한 Y좌표(위도)"
}
},
{
"name": "carType",
"in": "query",
"description": "차량 종류",
"required": false,
"schema": {
"maximum": 6,
"minimum": 1,
"type": "string",
"description": "차량 종류",
"example": 1,
"default": "1",
"enum": [
"1",
"2",
"3",
"4",
"5",
"6"
],
"x-enum-descriptions": {
"1": "소형차",
"2": "중형차",
"3": "대형차",
"4": "대형화물차",
"5": "특수화물차",
"6": "경차"
}
},
"example": 1,
"x-enum-descriptions": {
"1": "소형차",
"2": "중형차",
"3": "대형차",
"4": "대형화물차",
"5": "특수화물차",
"6": "경차"
}
},
{
"name": "carHeight",
"in": "query",
"description": "차량의 높이(cm)",
"required": false,
"schema": {
"type": "string",
"description": "차량의 높이(cm)",
"example": 150
},
"example": 150
},
{
"name": "carWeight",
"in": "query",
"description": "차량의 총 중량(kg)",
"required": false,
"schema": {
"type": "string",
"description": "차량의 총 중량(kg)",
"example": 4000
},
"example": 4000
},
{
"name": "groupByTrafficColor",
"in": "query",
"description": "경로의 교통 상황 색상 그룹화 여부",
"required": false,
"schema": {
"type": "string",
"description": "경로의 교통 상황 색상 그룹화 여부",
"default": "false",
"enum": [
"false",
"true"
],
"x-enum-descriptions": {
"false": "교통 상황 색상 비그룹화",
"true": "교통 상황 색상 그룹화"
}
},
"x-enum-descriptions": {
"false": "교통 상황 색상 비그룹화",
"true": "교통 상황 색상 그룹화"
}
},
{
"name": "useAngle",
"in": "query",
"description": "출발 지점의 주행 각도 설정 여부",
"required": false,
"schema": {
"type": "string",
"description": "출발 지점의 주행 각도 설정 여부",
"default": "false",
"enum": [
"false",
"true"
],
"x-enum-descriptions": {
"false": "주행 방향 비우선",
"true": "주행 방향 우선"
}
},
"x-enum-descriptions": {
"false": "주행 방향 비우선",
"true": "주행 방향 우선"
}
},
{
"name": "angle",
"in": "query",
"description": "주행 각도
*정북 방향을 0으로 하여 시계 방향으로 0~359도
*'useAngle'이 true일 때 적용",
"required": false,
"schema": {
"maximum": 359,
"minimum": 0,
"type": "string",
"description": "주행 각도
*정북 방향을 0으로 하여 시계 방향으로 0~359도
*'useAngle'이 true일 때 적용"
}
},
{
"name": "useStartDirection",
"in": "query",
"description": "출발지 좌표 기준 주행 방향 지정 여부
*차량 주행방향을 알 수 없을 때 활용",
"required": false,
"schema": {
"type": "string",
"description": "출발지 좌표 기준 주행 방향 지정 여부
*차량 주행방향을 알 수 없을 때 활용",
"default": "false",
"enum": [
"false",
"true"
],
"x-enum-descriptions": {
"false": "출발지 좌표 기준 주행 방향 미지정",
"true": "출발지 좌표 기준 주행 방향 지정"
}
},
"x-enum-descriptions": {
"false": "출발지 좌표 기준 주행 방향 미지정",
"true": "출발지 좌표 기준 주행 방향 지정"
}
},
{
"name": "searchByAddress",
"in": "query",
"description": "주소 기반 경로 탐색 여부",
"required": false,
"schema": {
"type": "string",
"description": "주소 기반 경로 탐색 여부",
"default": "false",
"enum": [
"false",
"true"
],
"x-enum-descriptions": {
"false": "일반 경로 탐색",
"true": "주소 기반 경로 탐색"
}
},
"x-enum-descriptions": {
"false": "일반 경로 탐색",
"true": "주소 기반 경로 탐색"
}
},
{
"name": "usageType",
"in": "query",
"description": "사용 용도",
"required": false,
"schema": {
"maximum": 1,
"minimum": 0,
"type": "string",
"description": "사용 용도",
"default": "0",
"enum": [
"0",
"1"
],
"x-enum-descriptions": {
"0": "일반",
"1": "택시"
}
},
"x-enum-descriptions": {
"0": "일반",
"1": "택시"
}
},
{
"name": "avoidWaterSourceArea",
"in": "query",
"description": "상수원 보호 구역 회피 탐색 여부",
"required": false,
"schema": {
"type": "string",
"description": "상수원 보호 구역 회피 탐색 여부",
"default": "false",
"enum": [
"false",
"true"
],
"x-enum-descriptions": {
"false": "일반 탐색",
"true": "상수원 보호 구역 회피 탐색"
}
},
"x-enum-descriptions": {
"false": "일반 탐색",
"true": "상수원 보호 구역 회피 탐색"
}
},
{
"name": "avoidNarrowRoad",
"in": "query",
"description": "좁은 길(이면도로) 회피 차선 정보
*0~16
*값은 왕복 차선의 개수
*예: 값이 6일 경우, 왕복 6차선 도로에서 차종에 관계 없이 모두 회피",
"required": false,
"schema": {
"maximum": 16,
"minimum": 0,
"type": "string",
"description": "좁은 길(이면도로) 회피 차선 정보
*0~16
*값은 왕복 차선의 개수
*예: 값이 6일 경우, 왕복 6차선 도로에서 차종에 관계 없이 모두 회피",
"default": "0"
}
},
{
"name": "avoidUTurn",
"in": "query",
"description": "U턴 회피 차선 정보
*0~16
*값은 왕복 차선의 개수
*예: 값이 6 일 경우, 왕복 6차선 이하 도로에서 U턴 회피",
"required": false,
"schema": {
"maximum": 16,
"minimum": 0,
"type": "string",
"description": "U턴 회피 차선 정보
*0~16
*값은 왕복 차선의 개수
*예: 값이 6 일 경우, 왕복 6차선 이하 도로에서 U턴 회피",
"default": "0"
}
},
{
"name": "useTaxifare",
"in": "query",
"description": "예상 택시 요금 조회 여부",
"required": false,
"schema": {
"type": "string",
"description": "예상 택시 요금 조회 여부",
"default": "0",
"enum": [
"0",
"1",
"2",
"3"
],
"x-enum-descriptions": {
"0": "미사용",
"1": "일반 택시",
"2": "모범 택시",
"3": "일반 및 모범 택시"
}
},
"x-enum-descriptions": {
"0": "미사용",
"1": "일반 택시",
"2": "모범 택시",
"3": "일반 및 모범 택시"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RouteNormalResponse"
},
"examples": {
"success": {
"summary": "성공",
"value": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"route": {
"data": {
"option": "real_traffic",
"toll_fee": 3400,
"taxiFare": 45000,
"totalTaxiFare": "7000",
"spend_time": 3720,
"distance": 72183,
"isHighWay": true,
"paths": [
{
"coords": [
{
"x": "127.110762",
"y": "37.402184"
}
],
"speed": 85,
"distance": 120,
"spend_time": 2800,
"road_code": 1,
"traffic_color": "#fb3a76",
"point_type": "S"
}
]
}
}
}
},
"argError": {
"summary": "파라미터 에러",
"description": "Argument Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 101,
"resultMessage": "Argument Error"
}
}
},
"serverError": {
"summary": "IMPS 서버 에러",
"description": "IMPS Server Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 102,
"resultMessage": "IMPS Server Error"
}
}
},
"authentication": {
"summary": "인증 실패",
"description": "Authentication Failed",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 300,
"resultMessage": "Authentication Failed"
}
}
},
"badRequest": {
"summary": "부적절한 URL",
"description": "Inappropriate URL",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 301,
"resultMessage": "Inappropriate URL"
}
}
}
}
}
}
},
"400": {
"description": "잘못된 요청",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"400": {
"summary": "잘못된 요청",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 400,
"resultMessage": "Invalid request parameter or body"
}
}
}
}
}
}
},
"404": {
"description": "API 없음",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"404": {
"summary": "API 없음",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 404,
"resultMessage": "API endpoint not found"
}
}
}
}
}
}
},
"415": {
"description": "허용되지 않는 메서드",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"415": {
"summary": "허용되지 않는 메서드",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 415,
"resultMessage": "Unsupported content type"
}
}
}
}
}
}
},
"500": {
"description": "서버 내부 오류",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"500": {
"summary": "서버 내부 오류",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 500,
"resultMessage": "Internal Server Error"
}
}
}
}
}
}
}
},
"x-order": 600
},
"post": {
"tags": [
"탐색"
],
"summary": "경로 탐색",
"description": "출발/도착지 및 최대 5개의 경유지, 기타 설정을 통해 최적화된 경로 탐색 정보를 반환합니다",
"operationId": "postRouteNormalResult",
"parameters": [
{
"name": "APPKEY",
"in": "path",
"description": "해당 API 사용 권한이 있는 API 키",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"description": "경로 탐색 조건",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RouteNormalRequest"
},
"example": {
"option": "real_traffic",
"coordType": "wgs84",
"startX": "127.110762",
"startY": "37.402184",
"endX": "127.111412",
"endY": "37.39476"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RouteNormalResponse"
},
"examples": {
"success": {
"summary": "성공",
"value": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"route": {
"data": {
"option": "real_traffic",
"toll_fee": 3400,
"taxiFare": 45000,
"totalTaxiFare": "7000",
"spend_time": 3720,
"distance": 72183,
"isHighWay": true,
"paths": [
{
"coords": [
{
"x": "127.110762",
"y": "37.402184"
}
],
"speed": 85,
"distance": 120,
"spend_time": 2800,
"road_code": 1,
"traffic_color": "#fb3a76",
"point_type": "S"
}
]
}
}
}
},
"argError": {
"summary": "파라미터 에러",
"description": "Argument Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 101,
"resultMessage": "Argument Error"
}
}
},
"serverError": {
"summary": "IMPS 서버 에러",
"description": "IMPS Server Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 102,
"resultMessage": "IMPS Server Error"
}
}
},
"authentication": {
"summary": "인증 실패",
"description": "Authentication Failed",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 300,
"resultMessage": "Authentication Failed"
}
}
},
"badRequest": {
"summary": "부적절한 URL",
"description": "Inappropriate URL",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 301,
"resultMessage": "Inappropriate URL"
}
}
}
}
}
}
},
"400": {
"description": "잘못된 요청",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"400": {
"summary": "잘못된 요청",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 400,
"resultMessage": "Invalid request parameter or body"
}
}
}
}
}
}
},
"404": {
"description": "API 없음",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"404": {
"summary": "API 없음",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 404,
"resultMessage": "API endpoint not found"
}
}
}
}
}
}
},
"415": {
"description": "허용되지 않는 메서드",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"415": {
"summary": "허용되지 않는 메서드",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 415,
"resultMessage": "Unsupported content type"
}
}
}
}
}
}
},
"500": {
"description": "서버 내부 오류",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"500": {
"summary": "서버 내부 오류",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 500,
"resultMessage": "Internal Server Error"
}
}
}
}
}
}
}
},
"x-order": 601
}
},
"/maps/v3.0/appkeys/{APPKEY}/route-summary": {
"get": {
"tags": [
"탐색"
],
"summary": "경로 탐색 요약",
"description": "출발/도착지 및 최대 5개의 경유지, 기타 설정을 통해 탐색된 요약 정보를 반환합니다",
"operationId": "getRouteSummaryResult",
"parameters": [
{
"name": "APPKEY",
"in": "path",
"description": "해당 API 사용 권한이 있는 API 키",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "option",
"in": "query",
"description": "경로 탐색 옵션
*다중 선택 가능",
"required": true,
"schema": {
"pattern": "^(real_traffic|real_traffic2|real_traffic_freeroad|short_distance_priority|time_priority|motorcycle|recommendation|highway_priority)(\\s*,\\s*(real_traffic|real_traffic2|real_traffic_freeroad|short_distance_priority|time_priority|motorcycle|recommendation|highway_priority))*$",
"type": "string",
"description": "경로 탐색 옵션
*다중 선택 가능",
"example": "real_traffic",
"enum": [
"real_traffic",
"real_traffic2",
"real_traffic_freeroad",
"short_distance_priority",
"time_priority",
"motorcycle",
"recommendation",
"highway_priority"
],
"x-enum-descriptions": {
"motorcycle": "이륜차 경로",
"highway_priority": "고속 도로",
"short_distance_priority": "최단 거리",
"time_priority": "최소 시간",
"real_traffic": "실시간 경로",
"recommendation": "추천 경로",
"real_traffic_freeroad": "무료 도로",
"real_traffic2": "대안 경로"
}
},
"example": "real_traffic",
"x-enum-descriptions": {
"motorcycle": "이륜차 경로",
"highway_priority": "고속 도로",
"short_distance_priority": "최단 거리",
"time_priority": "최소 시간",
"real_traffic": "실시간 경로",
"recommendation": "추천 경로",
"real_traffic_freeroad": "무료 도로",
"real_traffic2": "대안 경로"
}
},
{
"name": "startX",
"in": "query",
"description": "시작 지점(출발지)에 대한 X좌표(경도)",
"required": true,
"schema": {
"type": "string",
"description": "시작 지점(출발지)에 대한 X좌표(경도)",
"example": 127.110762
},
"example": 127.110762
},
{
"name": "startY",
"in": "query",
"description": "시작 지점(출발지)에 대한 Y좌표(위도)",
"required": true,
"schema": {
"type": "string",
"description": "시작 지점(출발지)에 대한 Y좌표(위도)",
"example": 37.402184
},
"example": 37.402184
},
{
"name": "endX",
"in": "query",
"description": "끝 지점(도착지)에 대한 X좌표(경도)",
"required": true,
"schema": {
"type": "string",
"description": "끝 지점(도착지)에 대한 X좌표(경도)",
"example": 127.105399
},
"example": 127.105399
},
{
"name": "endY",
"in": "query",
"description": "끝 지점(도착지)에 대한 Y좌표(위도)",
"required": true,
"schema": {
"type": "string",
"description": "끝 지점(도착지)에 대한 Y좌표(위도)",
"example": 37.5124518
},
"example": 37.5124518
},
{
"name": "coordType",
"in": "query",
"description": "좌표 체계
*'wgs84'는 국제 표준 좌표계, 'tw'는 팅크웨어 좌표계를 의미",
"required": false,
"schema": {
"pattern": "^(tw|wgs84|TW|WGS84)$",
"type": "string",
"description": "좌표 체계
*'wgs84'는 국제 표준 좌표계, 'tw'는 팅크웨어 좌표계를 의미",
"default": "wgs84",
"enum": [
"wgs84",
"tw"
]
}
},
{
"name": "via1X",
"in": "query",
"description": "1 번째 경유지에 대한 X좌표(경도)",
"required": false,
"schema": {
"type": "string",
"description": "1 번째 경유지에 대한 X좌표(경도)"
}
},
{
"name": "via1Y",
"in": "query",
"description": "1 번째 경유지에 대한 Y좌표(위도)",
"required": false,
"schema": {
"type": "string",
"description": "1 번째 경유지에 대한 Y좌표(위도)"
}
},
{
"name": "via2X",
"in": "query",
"description": "2 번째 경유지에 대한 X좌표(경도)",
"required": false,
"schema": {
"type": "string",
"description": "2 번째 경유지에 대한 X좌표(경도)"
}
},
{
"name": "via2Y",
"in": "query",
"description": "2 번째 경유지에 대한 Y좌표(위도)",
"required": false,
"schema": {
"type": "string",
"description": "2 번째 경유지에 대한 Y좌표(위도)"
}
},
{
"name": "via3X",
"in": "query",
"description": "3 번째 경유지에 대한 X좌표(경도)",
"required": false,
"schema": {
"type": "string",
"description": "3 번째 경유지에 대한 X좌표(경도)"
}
},
{
"name": "via3Y",
"in": "query",
"description": "3 번째 경유지에 대한 Y좌표(위도)",
"required": false,
"schema": {
"type": "string",
"description": "3 번째 경유지에 대한 Y좌표(위도)"
}
},
{
"name": "via4X",
"in": "query",
"description": "4 번째 경유지에 대한 X좌표(경도)",
"required": false,
"schema": {
"type": "string",
"description": "4 번째 경유지에 대한 X좌표(경도)"
}
},
{
"name": "via4Y",
"in": "query",
"description": "4 번째 경유지에 대한 Y좌표(위도)",
"required": false,
"schema": {
"type": "string",
"description": "4 번째 경유지에 대한 Y좌표(위도)"
}
},
{
"name": "via5X",
"in": "query",
"description": "5 번째 경유지에 대한 X좌표(경도)",
"required": false,
"schema": {
"type": "string",
"description": "5 번째 경유지에 대한 X좌표(경도)"
}
},
{
"name": "via5Y",
"in": "query",
"description": "5 번째 경유지에 대한 Y좌표(위도)",
"required": false,
"schema": {
"type": "string",
"description": "5 번째 경유지에 대한 Y좌표(위도)"
}
},
{
"name": "carType",
"in": "query",
"description": "차량 종류",
"required": false,
"schema": {
"maximum": 6,
"minimum": 1,
"type": "string",
"description": "차량 종류",
"example": 1,
"default": "1",
"enum": [
"1",
"2",
"3",
"4",
"5",
"6"
],
"x-enum-descriptions": {
"1": "소형차",
"2": "중형차",
"3": "대형차",
"4": "대형화물차",
"5": "특수화물차",
"6": "경차"
}
},
"example": 1,
"x-enum-descriptions": {
"1": "소형차",
"2": "중형차",
"3": "대형차",
"4": "대형화물차",
"5": "특수화물차",
"6": "경차"
}
},
{
"name": "carHeight",
"in": "query",
"description": "차량의 높이(cm)",
"required": false,
"schema": {
"type": "string",
"description": "차량의 높이(cm)",
"example": 150
},
"example": 150
},
{
"name": "carWeight",
"in": "query",
"description": "차량의 총 중량(kg)",
"required": false,
"schema": {
"type": "string",
"description": "차량의 총 중량(kg)",
"example": 4000
},
"example": 4000
},
{
"name": "groupByTrafficColor",
"in": "query",
"description": "경로의 교통 상황 색상 그룹화 여부",
"required": false,
"schema": {
"type": "string",
"description": "경로의 교통 상황 색상 그룹화 여부",
"default": "false",
"enum": [
"false",
"true"
],
"x-enum-descriptions": {
"false": "교통 상황 색상 비그룹화",
"true": "교통 상황 색상 그룹화"
}
},
"x-enum-descriptions": {
"false": "교통 상황 색상 비그룹화",
"true": "교통 상황 색상 그룹화"
}
},
{
"name": "useAngle",
"in": "query",
"description": "출발 지점의 주행 각도 설정 여부",
"required": false,
"schema": {
"type": "string",
"description": "출발 지점의 주행 각도 설정 여부",
"default": "false",
"enum": [
"false",
"true"
],
"x-enum-descriptions": {
"false": "주행 방향 비우선",
"true": "주행 방향 우선"
}
},
"x-enum-descriptions": {
"false": "주행 방향 비우선",
"true": "주행 방향 우선"
}
},
{
"name": "angle",
"in": "query",
"description": "주행 각도
*정북 방향을 0으로 하여 시계 방향으로 0~359도
*'useAngle'이 true일 때 적용",
"required": false,
"schema": {
"maximum": 359,
"minimum": 0,
"type": "string",
"description": "주행 각도
*정북 방향을 0으로 하여 시계 방향으로 0~359도
*'useAngle'이 true일 때 적용"
}
},
{
"name": "useStartDirection",
"in": "query",
"description": "출발지 좌표 기준 주행 방향 지정 여부
*차량 주행방향을 알 수 없을 때 활용",
"required": false,
"schema": {
"type": "string",
"description": "출발지 좌표 기준 주행 방향 지정 여부
*차량 주행방향을 알 수 없을 때 활용",
"default": "false",
"enum": [
"false",
"true"
],
"x-enum-descriptions": {
"false": "출발지 좌표 기준 주행 방향 미지정",
"true": "출발지 좌표 기준 주행 방향 지정"
}
},
"x-enum-descriptions": {
"false": "출발지 좌표 기준 주행 방향 미지정",
"true": "출발지 좌표 기준 주행 방향 지정"
}
},
{
"name": "searchByAddress",
"in": "query",
"description": "주소 기반 경로 탐색 여부",
"required": false,
"schema": {
"type": "string",
"description": "주소 기반 경로 탐색 여부",
"default": "false",
"enum": [
"false",
"true"
],
"x-enum-descriptions": {
"false": "일반 경로 탐색",
"true": "주소 기반 경로 탐색"
}
},
"x-enum-descriptions": {
"false": "일반 경로 탐색",
"true": "주소 기반 경로 탐색"
}
},
{
"name": "usageType",
"in": "query",
"description": "사용 용도",
"required": false,
"schema": {
"maximum": 1,
"minimum": 0,
"type": "string",
"description": "사용 용도",
"default": "0",
"enum": [
"0",
"1"
],
"x-enum-descriptions": {
"0": "일반",
"1": "택시"
}
},
"x-enum-descriptions": {
"0": "일반",
"1": "택시"
}
},
{
"name": "avoidWaterSourceArea",
"in": "query",
"description": "상수원 보호 구역 회피 탐색 여부",
"required": false,
"schema": {
"type": "string",
"description": "상수원 보호 구역 회피 탐색 여부",
"default": "false",
"enum": [
"false",
"true"
],
"x-enum-descriptions": {
"false": "일반 탐색",
"true": "상수원 보호 구역 회피 탐색"
}
},
"x-enum-descriptions": {
"false": "일반 탐색",
"true": "상수원 보호 구역 회피 탐색"
}
},
{
"name": "avoidNarrowRoad",
"in": "query",
"description": "좁은 길(이면도로) 회피 차선 정보
*0~16
*값은 왕복 차선의 개수
*예: 값이 6일 경우, 왕복 6차선 도로에서 차종에 관계 없이 모두 회피",
"required": false,
"schema": {
"maximum": 16,
"minimum": 0,
"type": "string",
"description": "좁은 길(이면도로) 회피 차선 정보
*0~16
*값은 왕복 차선의 개수
*예: 값이 6일 경우, 왕복 6차선 도로에서 차종에 관계 없이 모두 회피",
"default": "0"
}
},
{
"name": "avoidUTurn",
"in": "query",
"description": "U턴 회피 차선 정보
*0~16
*값은 왕복 차선의 개수
*예: 값이 6 일 경우, 왕복 6차선 이하 도로에서 U턴 회피",
"required": false,
"schema": {
"maximum": 16,
"minimum": 0,
"type": "string",
"description": "U턴 회피 차선 정보
*0~16
*값은 왕복 차선의 개수
*예: 값이 6 일 경우, 왕복 6차선 이하 도로에서 U턴 회피",
"default": "0"
}
},
{
"name": "useTaxifare",
"in": "query",
"description": "예상 택시 요금 조회 여부",
"required": false,
"schema": {
"type": "string",
"description": "예상 택시 요금 조회 여부",
"default": "0",
"enum": [
"0",
"1",
"2",
"3"
],
"x-enum-descriptions": {
"0": "미사용",
"1": "일반 택시",
"2": "모범 택시",
"3": "일반 및 모범 택시"
}
},
"x-enum-descriptions": {
"0": "미사용",
"1": "일반 택시",
"2": "모범 택시",
"3": "일반 및 모범 택시"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RouteSummaryResponse"
},
"examples": {
"success": {
"summary": "성공",
"value": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"route": {
"data": [
{
"option": "real_traffic",
"spend_time": 3720,
"distance": 72183
}
]
}
}
},
"argError": {
"summary": "파라미터 에러",
"description": "Argument Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 101,
"resultMessage": "Argument Error"
}
}
},
"serverError": {
"summary": "IMPS 서버 에러",
"description": "IMPS Server Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 102,
"resultMessage": "IMPS Server Error"
}
}
},
"authentication": {
"summary": "인증 실패",
"description": "Authentication Failed",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 300,
"resultMessage": "Authentication Failed"
}
}
},
"badRequest": {
"summary": "부적절한 URL",
"description": "Inappropriate URL",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 301,
"resultMessage": "Inappropriate URL"
}
}
}
}
}
}
},
"400": {
"description": "잘못된 요청",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"400": {
"summary": "잘못된 요청",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 400,
"resultMessage": "Invalid request parameter or body"
}
}
}
}
}
}
},
"404": {
"description": "API 없음",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"404": {
"summary": "API 없음",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 404,
"resultMessage": "API endpoint not found"
}
}
}
}
}
}
},
"415": {
"description": "허용되지 않는 메서드",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"415": {
"summary": "허용되지 않는 메서드",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 415,
"resultMessage": "Unsupported content type"
}
}
}
}
}
}
},
"500": {
"description": "서버 내부 오류",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"500": {
"summary": "서버 내부 오류",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 500,
"resultMessage": "Internal Server Error"
}
}
}
}
}
}
}
},
"x-order": 602
},
"post": {
"tags": [
"탐색"
],
"summary": "경로 탐색 요약",
"description": "출발/도착지 및 최대 5개의 경유지, 기타 설정을 통해 탐색된 요약 정보를 반환합니다",
"operationId": "postRouteSummaryResult",
"parameters": [
{
"name": "APPKEY",
"in": "path",
"description": "해당 API 사용 권한이 있는 API 키",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"description": "경로 탐색 요약 조건",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RouteSummaryRequest"
},
"example": {
"option": "real_traffic",
"coordType": "wgs84",
"startX": "127.110762",
"startY": "37.402184",
"endX": "127.111412",
"endY": "37.39476"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RouteSummaryResponse"
},
"examples": {
"success": {
"summary": "성공",
"value": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"route": {
"data": [
{
"option": "real_traffic",
"spend_time": 3720,
"distance": 72183
}
]
}
}
},
"argError": {
"summary": "파라미터 에러",
"description": "Argument Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 101,
"resultMessage": "Argument Error"
}
}
},
"serverError": {
"summary": "IMPS 서버 에러",
"description": "IMPS Server Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 102,
"resultMessage": "IMPS Server Error"
}
}
},
"authentication": {
"summary": "인증 실패",
"description": "Authentication Failed",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 300,
"resultMessage": "Authentication Failed"
}
}
},
"badRequest": {
"summary": "부적절한 URL",
"description": "Inappropriate URL",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 301,
"resultMessage": "Inappropriate URL"
}
}
}
}
}
}
},
"400": {
"description": "잘못된 요청",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"400": {
"summary": "잘못된 요청",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 400,
"resultMessage": "Invalid request parameter or body"
}
}
}
}
}
}
},
"404": {
"description": "API 없음",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"404": {
"summary": "API 없음",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 404,
"resultMessage": "API endpoint not found"
}
}
}
}
}
}
},
"415": {
"description": "허용되지 않는 메서드",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"415": {
"summary": "허용되지 않는 메서드",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 415,
"resultMessage": "Unsupported content type"
}
}
}
}
}
}
},
"500": {
"description": "서버 내부 오류",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"500": {
"summary": "서버 내부 오류",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 500,
"resultMessage": "Internal Server Error"
}
}
}
}
}
}
}
},
"x-order": 603
}
},
"/maps/v3.0/appkeys/{APPKEY}/route-time": {
"get": {
"tags": [
"탐색"
],
"summary": "경로 예측 탐색",
"description": "출발, 도착 예정시간을 기준으로 예상 도착시간 및 출발지와 목적지 (경유지 옵션) 좌표를 이용하여 탐색된 상세 정보와 경로 정보를 반환합니다",
"operationId": "getRouteTimeResult",
"parameters": [
{
"name": "option",
"in": "query",
"description": "경로 탐색 옵션
*하나만 선택 가능",
"required": true,
"schema": {
"pattern": "^(stats|stats_freeroad|stats_highway)$",
"type": "string",
"description": "경로 탐색 옵션
*하나만 선택 가능",
"default": "stats",
"enum": [
"stats",
"stats_freeroad",
"stats_highway"
],
"x-enum-descriptions": {
"stats": "통계 예측 탐색",
"stats_highway": "고속도로 우선 통계 예측 탐색",
"stats_freeroad": "무료 도로 우선 통계 예측 탐색"
}
},
"x-enum-descriptions": {
"stats": "통계 예측 탐색",
"stats_highway": "고속도로 우선 통계 예측 탐색",
"stats_freeroad": "무료 도로 우선 통계 예측 탐색"
}
},
{
"name": "type",
"in": "query",
"description": "기준 시간",
"required": true,
"schema": {
"pattern": "^(start|end)$",
"type": "string",
"description": "기준 시간",
"example": "start",
"enum": [
"start",
"end"
],
"x-enum-descriptions": {
"start": "출발 시각 기준",
"end": "도착 시각 기준"
}
},
"example": "start",
"x-enum-descriptions": {
"start": "출발 시각 기준",
"end": "도착 시각 기준"
}
},
{
"name": "startX",
"in": "query",
"description": "시작 지점(출발지)에 대한 X좌표(경도)",
"required": true,
"schema": {
"type": "string",
"description": "시작 지점(출발지)에 대한 X좌표(경도)",
"example": 127.110762
},
"example": 127.110762
},
{
"name": "startY",
"in": "query",
"description": "시작 지점(출발지)에 대한 Y좌표(위도)",
"required": true,
"schema": {
"type": "string",
"description": "시작 지점(출발지)에 대한 Y좌표(위도)",
"example": 37.402184
},
"example": 37.402184
},
{
"name": "endX",
"in": "query",
"description": "끝 지점(도착지)에 대한 X좌표(경도)",
"required": true,
"schema": {
"type": "string",
"description": "끝 지점(도착지)에 대한 X좌표(경도)",
"example": 127.105399
},
"example": 127.105399
},
{
"name": "endY",
"in": "query",
"description": "끝 지점(도착지)에 대한 Y좌표(위도)",
"required": true,
"schema": {
"type": "string",
"description": "끝 지점(도착지)에 대한 Y좌표(위도)",
"example": 37.5124518
},
"example": 37.5124518
},
{
"name": "year",
"in": "query",
"description": "경로 탐색의 기준이 되는 연도(YYYY)
*예: 2026",
"required": true,
"schema": {
"minimum": 1,
"type": "string",
"description": "경로 탐색의 기준이 되는 연도(YYYY)
*예: 2026",
"format": "YYYY",
"example": 2026
},
"example": 2026
},
{
"name": "month",
"in": "query",
"description": "경로 탐색의 기준이 되는 월
*예: 2",
"required": true,
"schema": {
"maximum": 12,
"minimum": 1,
"type": "string",
"description": "경로 탐색의 기준이 되는 월
*예: 2",
"example": 1
},
"example": 1
},
{
"name": "day",
"in": "query",
"description": "경로 탐색의 기준이 되는 일
*예: 26",
"required": true,
"schema": {
"maximum": 31,
"minimum": 1,
"type": "string",
"description": "경로 탐색의 기준이 되는 일
*예: 26",
"example": 9
},
"example": 9
},
{
"name": "hour",
"in": "query",
"description": "경로 탐색의 기준이 되는 시각(시)
*24시간 형식(0~23)으로 입력
*예: 17",
"required": true,
"schema": {
"maximum": 23,
"minimum": 0,
"type": "string",
"description": "경로 탐색의 기준이 되는 시각(시)
*24시간 형식(0~23)으로 입력
*예: 17",
"example": 13
},
"example": 13
},
{
"name": "minutes",
"in": "query",
"description": "경로 탐색의 기준이 되는 시각(분)
*예: 30",
"required": true,
"schema": {
"maximum": 59,
"minimum": 0,
"type": "string",
"description": "경로 탐색의 기준이 되는 시각(분)
*예: 30",
"example": 30
},
"example": 30
},
{
"name": "coordType",
"in": "query",
"description": "좌표 체계
*'wgs84'는 국제 표준 좌표계, 'tw'는 팅크웨어 좌표계를 의미",
"required": false,
"schema": {
"pattern": "^(tw|wgs84|TW|WGS84)$",
"type": "string",
"description": "좌표 체계
*'wgs84'는 국제 표준 좌표계, 'tw'는 팅크웨어 좌표계를 의미",
"default": "wgs84",
"enum": [
"wgs84",
"tw"
]
}
},
{
"name": "APPKEY",
"in": "path",
"description": "해당 API 사용 권한이 있는 API 키",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "beforeCount",
"in": "query",
"description": "기준 시간 이전 탐색 개수
*예: beforeCount=2
*interval=15인 경우 기준 시각 기준 15분 전, 30분 전 경로를 추가 탐색",
"required": false,
"schema": {
"type": "string",
"description": "기준 시간 이전 탐색 개수
*예: beforeCount=2
*interval=15인 경우 기준 시각 기준 15분 전, 30분 전 경로를 추가 탐색",
"example": 1,
"default": "0"
},
"example": 1
},
{
"name": "afterCount",
"in": "query",
"description": "기준 시간 이후 탐색 개수
*예: afterCount=2
*interval=15인 경우 기준 시각 기준 15분 후, 30분 후 경로를 추가 탐색",
"required": false,
"schema": {
"type": "string",
"description": "기준 시간 이후 탐색 개수
*예: afterCount=2
*interval=15인 경우 기준 시각 기준 15분 후, 30분 후 경로를 추가 탐색",
"example": 1,
"default": "0"
},
"example": 1
},
{
"name": "interval",
"in": "query",
"description": "시간 간격
*기준 시각을 중심으로 설정된 간격마다 이전/이후 시각에 대해 예상 출/도착 시간 반환",
"required": false,
"schema": {
"type": "string",
"description": "시간 간격
*기준 시각을 중심으로 설정된 간격마다 이전/이후 시각에 대해 예상 출/도착 시간 반환",
"example": 15,
"default": "15"
},
"example": 15
},
{
"name": "via1X",
"in": "query",
"description": "1 번째 경유지에 대한 X좌표(경도)",
"required": false,
"schema": {
"type": "string",
"description": "1 번째 경유지에 대한 X좌표(경도)"
}
},
{
"name": "via1Y",
"in": "query",
"description": "1 번째 경유지에 대한 Y좌표(위도)",
"required": false,
"schema": {
"type": "string",
"description": "1 번째 경유지에 대한 Y좌표(위도)"
}
},
{
"name": "via2X",
"in": "query",
"description": "2 번째 경유지에 대한 X좌표(경도)",
"required": false,
"schema": {
"type": "string",
"description": "2 번째 경유지에 대한 X좌표(경도)"
}
},
{
"name": "via2Y",
"in": "query",
"description": "2 번째 경유지에 대한 Y좌표(위도)",
"required": false,
"schema": {
"type": "string",
"description": "2 번째 경유지에 대한 Y좌표(위도)"
}
},
{
"name": "via3X",
"in": "query",
"description": "3 번째 경유지에 대한 X좌표(경도)",
"required": false,
"schema": {
"type": "string",
"description": "3 번째 경유지에 대한 X좌표(경도)"
}
},
{
"name": "via3Y",
"in": "query",
"description": "3 번째 경유지에 대한 Y좌표(위도)",
"required": false,
"schema": {
"type": "string",
"description": "3 번째 경유지에 대한 Y좌표(위도)"
}
},
{
"name": "via4X",
"in": "query",
"description": "4 번째 경유지에 대한 X좌표(경도)",
"required": false,
"schema": {
"type": "string",
"description": "4 번째 경유지에 대한 X좌표(경도)"
}
},
{
"name": "via4Y",
"in": "query",
"description": "4 번째 경유지에 대한 Y좌표(위도)",
"required": false,
"schema": {
"type": "string",
"description": "4 번째 경유지에 대한 Y좌표(위도)"
}
},
{
"name": "via5X",
"in": "query",
"description": "5 번째 경유지에 대한 X좌표(경도)",
"required": false,
"schema": {
"type": "string",
"description": "5 번째 경유지에 대한 X좌표(경도)"
}
},
{
"name": "via5Y",
"in": "query",
"description": "5 번째 경유지에 대한 Y좌표(위도)",
"required": false,
"schema": {
"type": "string",
"description": "5 번째 경유지에 대한 Y좌표(위도)"
}
},
{
"name": "carType",
"in": "query",
"description": "차량 종류",
"required": false,
"schema": {
"maximum": 6,
"minimum": 1,
"type": "string",
"description": "차량 종류",
"example": 1,
"default": "1",
"enum": [
"1",
"2",
"3",
"4",
"5",
"6"
],
"x-enum-descriptions": {
"1": "소형차",
"2": "중형차",
"3": "대형차",
"4": "대형화물차",
"5": "특수화물차",
"6": "경차"
}
},
"example": 1,
"x-enum-descriptions": {
"1": "소형차",
"2": "중형차",
"3": "대형차",
"4": "대형화물차",
"5": "특수화물차",
"6": "경차"
}
},
{
"name": "carHeight",
"in": "query",
"description": "차량의 높이(cm)",
"required": false,
"schema": {
"type": "string",
"description": "차량의 높이(cm)",
"example": 150
},
"example": 150
},
{
"name": "carWeight",
"in": "query",
"description": "차량의 총 중량(kg)",
"required": false,
"schema": {
"type": "string",
"description": "차량의 총 중량(kg)",
"example": 4000
},
"example": 4000
},
{
"name": "groupByTrafficColor",
"in": "query",
"description": "경로의 교통 상황 색상 그룹화 여부",
"required": false,
"schema": {
"type": "string",
"description": "경로의 교통 상황 색상 그룹화 여부",
"default": "false",
"enum": [
"false",
"true"
],
"x-enum-descriptions": {
"false": "교통 상황 색상 비그룹화",
"true": "교통 상황 색상 그룹화"
}
},
"x-enum-descriptions": {
"false": "교통 상황 색상 비그룹화",
"true": "교통 상황 색상 그룹화"
}
},
{
"name": "useAngle",
"in": "query",
"description": "출발 지점의 주행 각도 설정 여부",
"required": false,
"schema": {
"type": "string",
"description": "출발 지점의 주행 각도 설정 여부",
"default": "false",
"enum": [
"false",
"true"
],
"x-enum-descriptions": {
"false": "주행 방향 비우선",
"true": "주행 방향 우선"
}
},
"x-enum-descriptions": {
"false": "주행 방향 비우선",
"true": "주행 방향 우선"
}
},
{
"name": "angle",
"in": "query",
"description": "주행 각도
*정북 방향을 0으로 하여 시계 방향으로 0~359도
*'useAngle'이 true일 때 적용",
"required": false,
"schema": {
"maximum": 359,
"minimum": 0,
"type": "string",
"description": "주행 각도
*정북 방향을 0으로 하여 시계 방향으로 0~359도
*'useAngle'이 true일 때 적용"
}
},
{
"name": "useStartDirection",
"in": "query",
"description": "출발지 좌표 기준 주행 방향 지정 여부
*차량 주행방향을 알 수 없을 때 활용",
"required": false,
"schema": {
"type": "string",
"description": "출발지 좌표 기준 주행 방향 지정 여부
*차량 주행방향을 알 수 없을 때 활용",
"default": "false",
"enum": [
"false",
"true"
],
"x-enum-descriptions": {
"false": "출발지 좌표 기준 주행 방향 미지정",
"true": "출발지 좌표 기준 주행 방향 지정"
}
},
"x-enum-descriptions": {
"false": "출발지 좌표 기준 주행 방향 미지정",
"true": "출발지 좌표 기준 주행 방향 지정"
}
},
{
"name": "searchByAddress",
"in": "query",
"description": "주소 기반 경로 탐색 여부",
"required": false,
"schema": {
"type": "string",
"description": "주소 기반 경로 탐색 여부",
"default": "false",
"enum": [
"false",
"true"
],
"x-enum-descriptions": {
"false": "일반 경로 탐색",
"true": "주소 기반 경로 탐색"
}
},
"x-enum-descriptions": {
"false": "일반 경로 탐색",
"true": "주소 기반 경로 탐색"
}
},
{
"name": "usageType",
"in": "query",
"description": "사용 용도",
"required": false,
"schema": {
"maximum": 1,
"minimum": 0,
"type": "string",
"description": "사용 용도",
"default": "0",
"enum": [
"0",
"1"
],
"x-enum-descriptions": {
"0": "일반",
"1": "택시"
}
},
"x-enum-descriptions": {
"0": "일반",
"1": "택시"
}
},
{
"name": "avoidWaterSourceArea",
"in": "query",
"description": "상수원 보호 구역 회피 탐색 여부",
"required": false,
"schema": {
"type": "string",
"description": "상수원 보호 구역 회피 탐색 여부",
"default": "false",
"enum": [
"false",
"true"
],
"x-enum-descriptions": {
"false": "일반 탐색",
"true": "상수원 보호 구역 회피 탐색"
}
},
"x-enum-descriptions": {
"false": "일반 탐색",
"true": "상수원 보호 구역 회피 탐색"
}
},
{
"name": "avoidNarrowRoad",
"in": "query",
"description": "좁은 길(이면도로) 회피 차선 정보
*0~16
*값은 왕복 차선의 개수
*예: 값이 6일 경우, 왕복 6차선 도로에서 차종에 관계 없이 모두 회피",
"required": false,
"schema": {
"maximum": 16,
"minimum": 0,
"type": "string",
"description": "좁은 길(이면도로) 회피 차선 정보
*0~16
*값은 왕복 차선의 개수
*예: 값이 6일 경우, 왕복 6차선 도로에서 차종에 관계 없이 모두 회피",
"default": "0"
}
},
{
"name": "avoidUTurn",
"in": "query",
"description": "U턴 회피 차선 정보
*0~16
*값은 왕복 차선의 개수
*예: 값이 6 일 경우, 왕복 6차선 이하 도로에서 U턴 회피",
"required": false,
"schema": {
"maximum": 16,
"minimum": 0,
"type": "string",
"description": "U턴 회피 차선 정보
*0~16
*값은 왕복 차선의 개수
*예: 값이 6 일 경우, 왕복 6차선 이하 도로에서 U턴 회피",
"default": "0"
}
},
{
"name": "useTaxifare",
"in": "query",
"description": "예상 택시 요금 조회 여부",
"required": false,
"schema": {
"type": "string",
"description": "예상 택시 요금 조회 여부",
"default": "0",
"enum": [
"0",
"1",
"2",
"3"
],
"x-enum-descriptions": {
"0": "미사용",
"1": "일반 택시",
"2": "모범 택시",
"3": "일반 및 모범 택시"
}
},
"x-enum-descriptions": {
"0": "미사용",
"1": "일반 택시",
"2": "모범 택시",
"3": "일반 및 모범 택시"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RouteTimeResponse"
},
"examples": {
"success": {
"summary": "성공",
"value": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"route": {
"data": {
"option": "real_traffic",
"toll_fee": 3400,
"taxiFare": 45000,
"totalTaxiFare": "7000",
"spend_time": 3720,
"distance": 72183,
"isHighWay": true,
"times": [
{
"index": 0,
"spend_time": 3720,
"start_time": {
"year": 2019,
"month": 11,
"day": 26,
"hour": 11,
"minutes": 0
},
"end_time": {
"year": 2019,
"month": 11,
"day": 26,
"hour": 11,
"minutes": 0
}
}
],
"paths": [
{
"coords": [
{
"x": "127.110762",
"y": "37.402184"
}
],
"speed": 85,
"distance": 120,
"spend_time": 2800,
"road_code": 1,
"traffic_color": "#fb3a76",
"point_type": "S"
}
]
}
}
}
},
"argError": {
"summary": "파라미터 에러",
"description": "Argument Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 101,
"resultMessage": "Argument Error"
}
}
},
"serverError": {
"summary": "IMPS 서버 에러",
"description": "IMPS Server Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 102,
"resultMessage": "IMPS Server Error"
}
}
},
"authentication": {
"summary": "인증 실패",
"description": "Authentication Failed",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 300,
"resultMessage": "Authentication Failed"
}
}
},
"badRequest": {
"summary": "부적절한 URL",
"description": "Inappropriate URL",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 301,
"resultMessage": "Inappropriate URL"
}
}
}
}
}
}
},
"400": {
"description": "잘못된 요청",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"400": {
"summary": "잘못된 요청",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 400,
"resultMessage": "Invalid request parameter or body"
}
}
}
}
}
}
},
"404": {
"description": "API 없음",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"404": {
"summary": "API 없음",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 404,
"resultMessage": "API endpoint not found"
}
}
}
}
}
}
},
"415": {
"description": "허용되지 않는 메서드",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"415": {
"summary": "허용되지 않는 메서드",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 415,
"resultMessage": "Unsupported content type"
}
}
}
}
}
}
},
"500": {
"description": "서버 내부 오류",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"500": {
"summary": "서버 내부 오류",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 500,
"resultMessage": "Internal Server Error"
}
}
}
}
}
}
}
},
"x-order": 604
},
"post": {
"tags": [
"탐색"
],
"summary": "경로 예측 탐색",
"description": "출발, 도착 예정시간을 기준으로 예상 도착시간 및 출발지와 목적지 (경유지 옵션) 좌표를 이용하여 탐색된 상세 정보와 경로 정보를 반환합니다",
"operationId": "postRouteTimeResult",
"parameters": [
{
"name": "APPKEY",
"in": "path",
"description": "해당 API 사용 권한이 있는 API 키",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"description": "경로 예측 탐색 조건",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RouteTimeRequest"
},
"example": {
"option": "stats",
"type": "start",
"startX": "127.110762",
"startY": "37.402184",
"endX": "127.111412",
"endY": "37.39476",
"year": 2026,
"month": 1,
"day": 20,
"hour": 13,
"minutes": 30,
"coordType": "wgs84",
"beforeCount": 1,
"afterCount": 1,
"interval": 15
}
}
},
"required": true
},
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RouteTimeResponse"
},
"examples": {
"success": {
"summary": "성공",
"value": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"route": {
"data": {
"option": "real_traffic",
"toll_fee": 3400,
"taxiFare": 45000,
"totalTaxiFare": "7000",
"spend_time": 3720,
"distance": 72183,
"isHighWay": true,
"times": [
{
"index": 0,
"spend_time": 3720,
"start_time": {
"year": 2019,
"month": 11,
"day": 26,
"hour": 11,
"minutes": 0
},
"end_time": {
"year": 2019,
"month": 11,
"day": 26,
"hour": 11,
"minutes": 0
}
}
],
"paths": [
{
"coords": [
{
"x": "127.110762",
"y": "37.402184"
}
],
"speed": 85,
"distance": 120,
"spend_time": 2800,
"road_code": 1,
"traffic_color": "#fb3a76",
"point_type": "S"
}
]
}
}
}
},
"argError": {
"summary": "파라미터 에러",
"description": "Argument Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 101,
"resultMessage": "Argument Error"
}
}
},
"serverError": {
"summary": "IMPS 서버 에러",
"description": "IMPS Server Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 102,
"resultMessage": "IMPS Server Error"
}
}
},
"authentication": {
"summary": "인증 실패",
"description": "Authentication Failed",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 300,
"resultMessage": "Authentication Failed"
}
}
},
"badRequest": {
"summary": "부적절한 URL",
"description": "Inappropriate URL",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 301,
"resultMessage": "Inappropriate URL"
}
}
}
}
}
}
},
"400": {
"description": "잘못된 요청",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"400": {
"summary": "잘못된 요청",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 400,
"resultMessage": "Invalid request parameter or body"
}
}
}
}
}
}
},
"404": {
"description": "API 없음",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"404": {
"summary": "API 없음",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 404,
"resultMessage": "API endpoint not found"
}
}
}
}
}
}
},
"415": {
"description": "허용되지 않는 메서드",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"415": {
"summary": "허용되지 않는 메서드",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 415,
"resultMessage": "Unsupported content type"
}
}
}
}
}
}
},
"500": {
"description": "서버 내부 오류",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"500": {
"summary": "서버 내부 오류",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 500,
"resultMessage": "Internal Server Error"
}
}
}
}
}
}
}
},
"x-order": 605
}
},
"/maps/v3.0/appkeys/{APPKEY}/route-normal-via": {
"post": {
"tags": [
"탐색"
],
"summary": "다중 경유지 탐색 100",
"description": "출발지, 도착지 및 최대 100개의 경유지와 각종 옵션을 설정하여 최적화된 경로 탐색 결과를 반환합니다",
"operationId": "postRouteNormalViaResult",
"parameters": [
{
"name": "APPKEY",
"in": "path",
"description": "해당 API 사용 권한이 있는 API 키",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"description": "다중 경유지 탐색 100 조건",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RouteNormalViaRequest"
},
"example": {
"option": "real_traffic",
"coordType": "wgs84",
"startX": "127.110762",
"startY": "37.402184",
"endX": "127.111412",
"endY": "37.39476",
"viaList": [
{
"viaX": "127.119387",
"viaY": "37.394735"
}
]
}
}
},
"required": true
},
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RouteNormalResponse"
},
"examples": {
"success": {
"summary": "성공",
"value": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"route": {
"data": {
"option": "real_traffic",
"toll_fee": 3400,
"taxiFare": 45000,
"totalTaxiFare": "7000",
"spend_time": 3720,
"distance": 72183,
"isHighWay": true,
"paths": [
{
"coords": [
{
"x": "127.110762",
"y": "37.402184"
}
],
"speed": 85,
"distance": 120,
"spend_time": 2800,
"road_code": 1,
"traffic_color": "#fb3a76",
"point_type": "S"
}
]
}
}
}
},
"argError": {
"summary": "파라미터 에러",
"description": "Argument Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 101,
"resultMessage": "Argument Error"
}
}
},
"serverError": {
"summary": "IMPS 서버 에러",
"description": "IMPS Server Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 102,
"resultMessage": "IMPS Server Error"
}
}
},
"authentication": {
"summary": "인증 실패",
"description": "Authentication Failed",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 300,
"resultMessage": "Authentication Failed"
}
}
},
"badRequest": {
"summary": "부적절한 URL",
"description": "Inappropriate URL",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 301,
"resultMessage": "Inappropriate URL"
}
}
}
}
}
}
},
"400": {
"description": "잘못된 요청",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"400": {
"summary": "잘못된 요청",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 400,
"resultMessage": "Invalid request parameter or body"
}
}
}
}
}
}
},
"404": {
"description": "API 없음",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"404": {
"summary": "API 없음",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 404,
"resultMessage": "API endpoint not found"
}
}
}
}
}
}
},
"415": {
"description": "허용되지 않는 메서드",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"415": {
"summary": "허용되지 않는 메서드",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 415,
"resultMessage": "Unsupported content type"
}
}
}
}
}
}
},
"500": {
"description": "서버 내부 오류",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"500": {
"summary": "서버 내부 오류",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 500,
"resultMessage": "Internal Server Error"
}
}
}
}
}
}
}
},
"x-order": 606
}
},
"/maps/v3.0/appkeys/{APPKEY}/route-pedestrian": {
"post": {
"tags": [
"탐색"
],
"summary": "도보/PM 경로 탐색",
"description": "출발/도착지 및 최대 5개의 경유지, 기타 설정을 통해 최적화된 도보/PM 경로 탐색 정보를 반환합니다",
"operationId": "postRoutePedestrianResult",
"parameters": [
{
"name": "APPKEY",
"in": "path",
"description": "해당 API 사용 권한이 있는 API 키",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"description": "도보/PM 경로 탐색 조건",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RoutePedestrianRequest"
},
"example": {
"option": "1",
"startX": "127.110762",
"startY": "37.402184",
"endX": "127.111412",
"endY": "37.39476",
"viaList": [
{
"viaX": "127.119387",
"viaY": "37.394735"
}
]
}
}
},
"required": true
},
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RoutePedestrianResponse"
},
"examples": {
"success": {
"summary": "성공",
"value": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"route": {
"data": {
"option": "short_distance_priority",
"spend_time": 3720,
"distance": 72183,
"paths": [
{
"coords": [
{
"x": "127.110762",
"y": "37.402184"
}
],
"distance": 120,
"angle": 30,
"spend_time": 2800,
"point_type": "S",
"walk_type": 1,
"bicycle_type": 2,
"facility_type": 0,
"gate_type": 0
}
]
}
}
}
},
"argError": {
"summary": "파라미터 에러",
"description": "Argument Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 101,
"resultMessage": "Argument Error"
}
}
},
"serverError": {
"summary": "IMPS 서버 에러",
"description": "IMPS Server Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 102,
"resultMessage": "IMPS Server Error"
}
}
},
"authentication": {
"summary": "인증 실패",
"description": "Authentication Failed",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 300,
"resultMessage": "Authentication Failed"
}
}
},
"badRequest": {
"summary": "부적절한 URL",
"description": "Inappropriate URL",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 301,
"resultMessage": "Inappropriate URL"
}
}
}
}
}
}
},
"400": {
"description": "잘못된 요청",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"400": {
"summary": "잘못된 요청",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 400,
"resultMessage": "Invalid request parameter or body"
}
}
}
}
}
}
},
"404": {
"description": "API 없음",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"404": {
"summary": "API 없음",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 404,
"resultMessage": "API endpoint not found"
}
}
}
}
}
}
},
"415": {
"description": "허용되지 않는 메서드",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"415": {
"summary": "허용되지 않는 메서드",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 415,
"resultMessage": "Unsupported content type"
}
}
}
}
}
}
},
"500": {
"description": "서버 내부 오류",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"500": {
"summary": "서버 내부 오류",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 500,
"resultMessage": "Internal Server Error"
}
}
}
}
}
}
}
},
"x-order": 607
}
},
"/maps/v3.0/appkeys/{APPKEY}/route-optimize-points-10": {
"post": {
"tags": [
"최적화"
],
"summary": "TSP(다중 경유지 최적화) 10",
"description": "여러 경유지의 방문 순서를 최적화하여 전체 이동 거리가 최소가 되도록 계산하여 최적의 경유지 방문 순서를 제공합니다
출발지, 도착지, 경유지 포함 최소 3개 이상 요청 해야 합니다",
"operationId": "postRouteOptimizePoints10Result",
"parameters": [
{
"name": "APPKEY",
"in": "path",
"description": "해당 API 사용 권한이 있는 API 키",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"description": "TSP(다중 경유지 최적화) 조건",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RouteOptimizePoints10Request"
},
"example": {
"routeType": 2,
"startX": "127.07906170100584",
"startY": "37.4973545579455",
"endX": "127.01038360300306",
"endY": "37.4857125930867",
"viaList": [
{
"viaX": 126.99500909167297,
"viaY": 37.50977641452363
},
{
"viaX": 127.00676563040908,
"viaY": 37.47260049875861
},
{
"viaX": 127.04530205470796,
"viaY": 37.520269143865214
},
{
"viaX": 127.06837357126065,
"viaY": 37.498849546491435
},
{
"viaX": 127.04943242234208,
"viaY": 37.5048863772718
}
]
}
}
},
"required": true
},
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RouteOptimizePointsResponse"
},
"examples": {
"success": {
"summary": "성공",
"value": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"route": {
"data": {
"distance": 24153,
"spend_time": 3216,
"optimize": [
{
"index": 0,
"x": 126.99500909167297,
"y": 37.50977641452363,
"distance": 0,
"spend_time": 0
},
{
"index": 2,
"x": 127.04530205470796,
"y": 37.520269143865214,
"distance": 10236,
"spend_time": 1144
},
{
"index": 4,
"x": 127.04943242234208,
"y": 37.5048863772718,
"distance": 2850,
"spend_time": 411
},
{
"index": 3,
"x": 127.06837357126065,
"y": 37.498849546491435,
"distance": 2669,
"spend_time": 294
},
{
"index": 1,
"x": 127.00676563040908,
"y": 37.47260049875861,
"distance": 8398,
"spend_time": 1367
}
]
}
}
}
},
"argError": {
"summary": "파라미터 에러",
"description": "Argument Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 101,
"resultMessage": "Argument Error"
}
}
},
"serverError": {
"summary": "IMPS 서버 에러",
"description": "IMPS Server Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 102,
"resultMessage": "IMPS Server Error"
}
}
},
"authentication": {
"summary": "인증 실패",
"description": "Authentication Failed",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 300,
"resultMessage": "Authentication Failed"
}
}
},
"badRequest": {
"summary": "부적절한 URL",
"description": "Inappropriate URL",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 301,
"resultMessage": "Inappropriate URL"
}
}
}
}
}
}
},
"400": {
"description": "잘못된 요청",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"400": {
"summary": "잘못된 요청",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 400,
"resultMessage": "Invalid request parameter or body"
}
}
}
}
}
}
},
"404": {
"description": "API 없음",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"404": {
"summary": "API 없음",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 404,
"resultMessage": "API endpoint not found"
}
}
}
}
}
}
},
"415": {
"description": "허용되지 않는 메서드",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"415": {
"summary": "허용되지 않는 메서드",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 415,
"resultMessage": "Unsupported content type"
}
}
}
}
}
}
},
"500": {
"description": "서버 내부 오류",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"500": {
"summary": "서버 내부 오류",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 500,
"resultMessage": "Internal Server Error"
}
}
}
}
}
}
}
},
"x-order": 700
}
},
"/maps/v3.0/appkeys/{APPKEY}/route-optimize-points-30": {
"post": {
"tags": [
"최적화"
],
"summary": "TSP(다중 경유지 최적화) 30",
"description": "여러 경유지의 방문 순서를 최적화하여 전체 이동 거리가 최소가 되도록 계산하여 최적의 경유지 방문 순서를 제공합니다
출발지, 도착지, 경유지 포함 최소 3개 이상 요청 해야 합니다",
"operationId": "postRouteOptimizePoints30Result",
"parameters": [
{
"name": "APPKEY",
"in": "path",
"description": "해당 API 사용 권한이 있는 API 키",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"description": "TSP(다중 경유지 최적화) 조건",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RouteOptimizePoints30Request"
},
"example": {
"routeType": 2,
"startX": "127.07906170100584",
"startY": "37.4973545579455",
"endX": "127.01038360300306",
"endY": "37.4857125930867",
"viaList": [
{
"viaX": 126.99500909167297,
"viaY": 37.50977641452363
},
{
"viaX": 127.00676563040908,
"viaY": 37.47260049875861
},
{
"viaX": 127.04530205470796,
"viaY": 37.520269143865214
},
{
"viaX": 127.06837357126065,
"viaY": 37.498849546491435
},
{
"viaX": 127.04943242234208,
"viaY": 37.5048863772718
}
]
}
}
},
"required": true
},
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RouteOptimizePointsResponse"
},
"examples": {
"success": {
"summary": "성공",
"value": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"route": {
"data": {
"distance": 24153,
"spend_time": 3216,
"optimize": [
{
"index": 0,
"x": 126.99500909167297,
"y": 37.50977641452363,
"distance": 0,
"spend_time": 0
},
{
"index": 2,
"x": 127.04530205470796,
"y": 37.520269143865214,
"distance": 10236,
"spend_time": 1144
},
{
"index": 4,
"x": 127.04943242234208,
"y": 37.5048863772718,
"distance": 2850,
"spend_time": 411
},
{
"index": 3,
"x": 127.06837357126065,
"y": 37.498849546491435,
"distance": 2669,
"spend_time": 294
},
{
"index": 1,
"x": 127.00676563040908,
"y": 37.47260049875861,
"distance": 8398,
"spend_time": 1367
}
]
}
}
}
},
"argError": {
"summary": "파라미터 에러",
"description": "Argument Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 101,
"resultMessage": "Argument Error"
}
}
},
"serverError": {
"summary": "IMPS 서버 에러",
"description": "IMPS Server Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 102,
"resultMessage": "IMPS Server Error"
}
}
},
"authentication": {
"summary": "인증 실패",
"description": "Authentication Failed",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 300,
"resultMessage": "Authentication Failed"
}
}
},
"badRequest": {
"summary": "부적절한 URL",
"description": "Inappropriate URL",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 301,
"resultMessage": "Inappropriate URL"
}
}
}
}
}
}
},
"400": {
"description": "잘못된 요청",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"400": {
"summary": "잘못된 요청",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 400,
"resultMessage": "Invalid request parameter or body"
}
}
}
}
}
}
},
"404": {
"description": "API 없음",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"404": {
"summary": "API 없음",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 404,
"resultMessage": "API endpoint not found"
}
}
}
}
}
}
},
"415": {
"description": "허용되지 않는 메서드",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"415": {
"summary": "허용되지 않는 메서드",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 415,
"resultMessage": "Unsupported content type"
}
}
}
}
}
}
},
"500": {
"description": "서버 내부 오류",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"500": {
"summary": "서버 내부 오류",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 500,
"resultMessage": "Internal Server Error"
}
}
}
}
}
}
}
},
"x-order": 701
}
},
"/maps/v3.0/appkeys/{APPKEY}/route-optimize-points-50": {
"post": {
"tags": [
"최적화"
],
"summary": "TSP(다중 경유지 최적화) 50",
"description": "여러 경유지의 방문 순서를 최적화하여 전체 이동 거리가 최소가 되도록 계산하여 최적의 경유지 방문 순서를 제공합니다
출발지, 도착지, 경유지 포함 최소 3개 이상 요청 해야 합니다",
"operationId": "postRouteOptimizePoints50Result",
"parameters": [
{
"name": "APPKEY",
"in": "path",
"description": "해당 API 사용 권한이 있는 API 키",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"description": "TSP(다중 경유지 최적화) 조건",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RouteOptimizePoints50Request"
},
"example": {
"routeType": 2,
"startX": "127.07906170100584",
"startY": "37.4973545579455",
"endX": "127.01038360300306",
"endY": "37.4857125930867",
"viaList": [
{
"viaX": 126.99500909167297,
"viaY": 37.50977641452363
},
{
"viaX": 127.00676563040908,
"viaY": 37.47260049875861
},
{
"viaX": 127.04530205470796,
"viaY": 37.520269143865214
},
{
"viaX": 127.06837357126065,
"viaY": 37.498849546491435
},
{
"viaX": 127.04943242234208,
"viaY": 37.5048863772718
}
]
}
}
},
"required": true
},
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RouteOptimizePointsResponse"
},
"examples": {
"success": {
"summary": "성공",
"value": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"route": {
"data": {
"distance": 24153,
"spend_time": 3216,
"optimize": [
{
"index": 0,
"x": 126.99500909167297,
"y": 37.50977641452363,
"distance": 0,
"spend_time": 0
},
{
"index": 2,
"x": 127.04530205470796,
"y": 37.520269143865214,
"distance": 10236,
"spend_time": 1144
},
{
"index": 4,
"x": 127.04943242234208,
"y": 37.5048863772718,
"distance": 2850,
"spend_time": 411
},
{
"index": 3,
"x": 127.06837357126065,
"y": 37.498849546491435,
"distance": 2669,
"spend_time": 294
},
{
"index": 1,
"x": 127.00676563040908,
"y": 37.47260049875861,
"distance": 8398,
"spend_time": 1367
}
]
}
}
}
},
"argError": {
"summary": "파라미터 에러",
"description": "Argument Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 101,
"resultMessage": "Argument Error"
}
}
},
"serverError": {
"summary": "IMPS 서버 에러",
"description": "IMPS Server Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 102,
"resultMessage": "IMPS Server Error"
}
}
},
"authentication": {
"summary": "인증 실패",
"description": "Authentication Failed",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 300,
"resultMessage": "Authentication Failed"
}
}
},
"badRequest": {
"summary": "부적절한 URL",
"description": "Inappropriate URL",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 301,
"resultMessage": "Inappropriate URL"
}
}
}
}
}
}
},
"400": {
"description": "잘못된 요청",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"400": {
"summary": "잘못된 요청",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 400,
"resultMessage": "Invalid request parameter or body"
}
}
}
}
}
}
},
"404": {
"description": "API 없음",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"404": {
"summary": "API 없음",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 404,
"resultMessage": "API endpoint not found"
}
}
}
}
}
}
},
"415": {
"description": "허용되지 않는 메서드",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"415": {
"summary": "허용되지 않는 메서드",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 415,
"resultMessage": "Unsupported content type"
}
}
}
}
}
}
},
"500": {
"description": "서버 내부 오류",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"500": {
"summary": "서버 내부 오류",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 500,
"resultMessage": "Internal Server Error"
}
}
}
}
}
}
}
},
"x-order": 702
}
},
"/maps/v3.0/appkeys/{APPKEY}/route-optimize-points-100": {
"post": {
"tags": [
"최적화"
],
"summary": "TSP(다중 경유지 최적화) 100",
"description": "여러 경유지의 방문 순서를 최적화하여 전체 이동 거리가 최소가 되도록 계산하여 최적의 경유지 방문 순서를 제공합니다
출발지, 도착지, 경유지 포함 최소 3개 이상 요청 해야 합니다",
"operationId": "postRouteOptimizePoints100Result",
"parameters": [
{
"name": "APPKEY",
"in": "path",
"description": "해당 API 사용 권한이 있는 API 키",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"description": "TSP(다중 경유지 최적화) 조건",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RouteOptimizePoints100Request"
},
"example": {
"routeType": 2,
"startX": "127.07906170100584",
"startY": "37.4973545579455",
"endX": "127.01038360300306",
"endY": "37.4857125930867",
"viaList": [
{
"viaX": 126.99500909167297,
"viaY": 37.50977641452363
},
{
"viaX": 127.00676563040908,
"viaY": 37.47260049875861
},
{
"viaX": 127.04530205470796,
"viaY": 37.520269143865214
},
{
"viaX": 127.06837357126065,
"viaY": 37.498849546491435
},
{
"viaX": 127.04943242234208,
"viaY": 37.5048863772718
}
]
}
}
},
"required": true
},
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RouteOptimizePointsResponse"
},
"examples": {
"success": {
"summary": "성공",
"value": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"route": {
"data": {
"distance": 24153,
"spend_time": 3216,
"optimize": [
{
"index": 0,
"x": 126.99500909167297,
"y": 37.50977641452363,
"distance": 0,
"spend_time": 0
},
{
"index": 2,
"x": 127.04530205470796,
"y": 37.520269143865214,
"distance": 10236,
"spend_time": 1144
},
{
"index": 4,
"x": 127.04943242234208,
"y": 37.5048863772718,
"distance": 2850,
"spend_time": 411
},
{
"index": 3,
"x": 127.06837357126065,
"y": 37.498849546491435,
"distance": 2669,
"spend_time": 294
},
{
"index": 1,
"x": 127.00676563040908,
"y": 37.47260049875861,
"distance": 8398,
"spend_time": 1367
}
]
}
}
}
},
"argError": {
"summary": "파라미터 에러",
"description": "Argument Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 101,
"resultMessage": "Argument Error"
}
}
},
"serverError": {
"summary": "IMPS 서버 에러",
"description": "IMPS Server Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 102,
"resultMessage": "IMPS Server Error"
}
}
},
"authentication": {
"summary": "인증 실패",
"description": "Authentication Failed",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 300,
"resultMessage": "Authentication Failed"
}
}
},
"badRequest": {
"summary": "부적절한 URL",
"description": "Inappropriate URL",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 301,
"resultMessage": "Inappropriate URL"
}
}
}
}
}
}
},
"400": {
"description": "잘못된 요청",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"400": {
"summary": "잘못된 요청",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 400,
"resultMessage": "Invalid request parameter or body"
}
}
}
}
}
}
},
"404": {
"description": "API 없음",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"404": {
"summary": "API 없음",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 404,
"resultMessage": "API endpoint not found"
}
}
}
}
}
}
},
"415": {
"description": "허용되지 않는 메서드",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"415": {
"summary": "허용되지 않는 메서드",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 415,
"resultMessage": "Unsupported content type"
}
}
}
}
}
}
},
"500": {
"description": "서버 내부 오류",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"500": {
"summary": "서버 내부 오류",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 500,
"resultMessage": "Internal Server Error"
}
}
}
}
}
}
}
},
"x-order": 704
}
},
"/maps/v3.0/appkeys/{APPKEY}/map-match": {
"post": {
"tags": [
"복원"
],
"summary": "Special Map Matching",
"description": "차량 주행 좌표와 함께 속도, 각도, 시간 정보 목록을 입력받아
도로 네트워크에 보다 정밀하게 매칭하여 실제 주행 경로를 복원합니다",
"operationId": "postMapMatchResult",
"parameters": [
{
"name": "APPKEY",
"in": "path",
"description": "해당 API 사용 권한이 있는 API 키",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"description": "Special Map Matching 조건",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/MapMatchPlusRequest"
},
"example": {
"userId": "example",
"paths": [
{
"time": 1768795262,
"x": 128.9188406742412,
"y": 35.0911965931231,
"speed": 20,
"angle": 0
},
{
"time": 1768795264,
"x": 128.91877817651627,
"y": 35.09131324558493,
"speed": 20,
"angle": 336
},
{
"time": 1768795266,
"x": 128.9184657070997,
"y": 35.09118825385209,
"speed": 20,
"angle": 243
}
]
}
}
},
"required": true
},
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/MapMatchPlusResponse"
},
"examples": {
"success": {
"summary": "성공",
"value": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"roadMatch": {
"userId": "example",
"tollFee": 1200,
"totalDistance": 4038,
"totalPointCount": 141,
"safeDrivingScore": 71,
"safeDrivingEvents": {
"accel_events": [
{
"start_timestamp": 1669848945,
"end_timestamp": 1669848945,
"event_level": 1
}
],
"decel_events": [
{
"start_timestamp": 1669848945,
"end_timestamp": 1669848945,
"event_level": 1
}
],
"overspeed_events": [
{
"start_timestamp": 1669848945,
"end_timestamp": 1669848945,
"event_level": 1
}
]
},
"paths": [
{
"x": 128.91883308127652,
"y": 35.09120807737007,
"errorDistance": 0,
"angle": 336,
"roadAttr": 1,
"roadType": 5,
"speed": 20,
"speedLimit": 0,
"datetime": "2026-01-19 13:01:02"
},
{
"x": 128.91877728800293,
"y": 35.09130431280779,
"errorDistance": 0,
"angle": 336,
"roadAttr": 1,
"roadType": 5,
"speed": 20,
"speedLimit": 0,
"datetime": "2026-01-19 13:01:03"
},
{
"x": 128.91877728800293,
"y": 35.09130431280779,
"errorDistance": 0,
"angle": 336,
"roadAttr": 1,
"roadType": 5,
"speed": 20,
"speedLimit": 0,
"datetime": "2026-01-19 13:01:04"
},
{
"x": 128.91877728800293,
"y": 35.09130431280779,
"errorDistance": 0,
"angle": 336,
"roadAttr": 0,
"roadType": 0,
"speed": 20,
"speedLimit": 0,
"datetime": "2026-01-19 13:01:05"
},
{
"x": 128.91877728800293,
"y": 35.09130431280779,
"errorDistance": 0,
"angle": 0,
"roadAttr": 0,
"roadType": 0,
"speed": 20,
"speedLimit": 0,
"datetime": "2026-01-19 13:01:06"
}
]
}
}
},
"argError": {
"summary": "파라미터 에러",
"description": "Argument Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 101,
"resultMessage": "Argument Error"
}
}
},
"serverError": {
"summary": "IMPS 서버 에러",
"description": "IMPS Server Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 102,
"resultMessage": "IMPS Server Error"
}
}
},
"authentication": {
"summary": "인증 실패",
"description": "Authentication Failed",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 300,
"resultMessage": "Authentication Failed"
}
}
},
"badRequest": {
"summary": "부적절한 URL",
"description": "Inappropriate URL",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 301,
"resultMessage": "Inappropriate URL"
}
}
}
}
}
}
},
"400": {
"description": "잘못된 요청",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"400": {
"summary": "잘못된 요청",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 400,
"resultMessage": "Invalid request parameter or body"
}
}
}
}
}
}
},
"404": {
"description": "API 없음",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"404": {
"summary": "API 없음",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 404,
"resultMessage": "API endpoint not found"
}
}
}
}
}
}
},
"415": {
"description": "허용되지 않는 메서드",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"415": {
"summary": "허용되지 않는 메서드",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 415,
"resultMessage": "Unsupported content type"
}
}
}
}
}
}
},
"500": {
"description": "서버 내부 오류",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"500": {
"summary": "서버 내부 오류",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 500,
"resultMessage": "Internal Server Error"
}
}
}
}
}
}
}
},
"x-order": 800
}
},
"/maps/v3.0/appkeys/{APPKEY}/matchToRoads": {
"post": {
"tags": [
"복원"
],
"summary": "MTR 100",
"description": "차량 주행 좌표 목록을 도로 네트워크에 매칭하여 실제 주행 경로에 맞게 보정합니다
*최대 100개의 좌표 요청 가능",
"operationId": "postMatchToRoadsResult",
"parameters": [
{
"name": "APPKEY",
"in": "path",
"description": "해당 API 사용 권한이 있는 API 키",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"description": "MTR 100 조건",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/MapMatch100Request"
},
"example": {
"coords": "126.95042955033101,37.39952907832974|126.95100890747277,37.39935861417968|126.95184575668353,37.399171103167795|126.95238219849246,37.39836991446609|126.95221053711612,37.39727892033366|126.95343362442138,37.39680160540712|126.95515023819372,37.397790325810476|126.95680247894435,37.397994887024126|126.95695268264977,37.39847219435172|126.95695268264977,37.39956317111266|126.95645915619167,37.400790500985025|126.95703851334244,37.40133597447641|126.95800410858769,37.40179621464611|126.95937739959838,37.40169393929715|126.96064340225449,37.40106323822738|126.96074264399483,37.4001811001235|126.96189062945639,37.39907308586036|126.96211593503247,37.398126999177244|126.96302788610492,37.39865118381423"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/MapMatch100Response"
},
"examples": {
"success": {
"summary": "성공",
"value": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"roadMatch": {
"requestPointCount": 19,
"totalDistance": 1995,
"totalPointCount": 64,
"matchedLinkCount": 20,
"matchedPoints": [
{
"idxName": "185316",
"linkId": "185316003366003907",
"sourceIndex": 18,
"sourceLocation": {
"latitude": "37.39865118381423",
"longitude": "126.96302788610492"
},
"matchedLocation": {
"latitude": "37.398552722989585",
"longitude": "126.96306223005134"
},
"speed": 0,
"roadCategory": 6,
"endPoint": "Y"
}
]
}
}
},
"argError": {
"summary": "파라미터 에러",
"description": "Argument Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 101,
"resultMessage": "Argument Error"
}
}
},
"serverError": {
"summary": "IMPS 서버 에러",
"description": "IMPS Server Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 102,
"resultMessage": "IMPS Server Error"
}
}
},
"authentication": {
"summary": "인증 실패",
"description": "Authentication Failed",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 300,
"resultMessage": "Authentication Failed"
}
}
},
"badRequest": {
"summary": "부적절한 URL",
"description": "Inappropriate URL",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 301,
"resultMessage": "Inappropriate URL"
}
}
}
}
}
}
},
"400": {
"description": "잘못된 요청",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"400": {
"summary": "잘못된 요청",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 400,
"resultMessage": "Invalid request parameter or body"
}
}
}
}
}
}
},
"404": {
"description": "API 없음",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"404": {
"summary": "API 없음",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 404,
"resultMessage": "API endpoint not found"
}
}
}
}
}
}
},
"415": {
"description": "허용되지 않는 메서드",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"415": {
"summary": "허용되지 않는 메서드",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 415,
"resultMessage": "Unsupported content type"
}
}
}
}
}
}
},
"500": {
"description": "서버 내부 오류",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"500": {
"summary": "서버 내부 오류",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 500,
"resultMessage": "Internal Server Error"
}
}
}
}
}
}
}
},
"x-order": 801
}
},
"/maps/v3.0/appkeys/{APPKEY}/matchToRoads1000": {
"post": {
"tags": [
"복원"
],
"summary": "MTR 1000",
"description": "차량 주행 좌표 목록을 도로 네트워크에 매칭하여 실제 주행 경로에 맞게 보정합니다
*최대 1000개의 좌표 요청 가능",
"operationId": "postMatchToRoads1000Result",
"parameters": [
{
"name": "APPKEY",
"in": "path",
"description": "해당 API 사용 권한이 있는 API 키",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"description": "MTR 1000 조건",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/MapMatch1000Request"
},
"example": {
"coords": "126.95042955033101,37.39952907832974|126.95100890747277,37.39935861417968|126.95184575668353,37.399171103167795|126.95238219849246,37.39836991446609|126.95221053711612,37.39727892033366|126.95343362442138,37.39680160540712|126.95515023819372,37.397790325810476|126.95680247894435,37.397994887024126|126.95695268264977,37.39847219435172|126.95695268264977,37.39956317111266|126.95645915619167,37.400790500985025|126.95703851334244,37.40133597447641|126.95800410858769,37.40179621464611|126.95937739959838,37.40169393929715|126.96064340225449,37.40106323822738|126.96074264399483,37.4001811001235|126.96189062945639,37.39907308586036|126.96211593503247,37.398126999177244|126.96302788610492,37.39865118381423"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/MapMatch1000Response"
},
"examples": {
"success": {
"summary": "성공",
"value": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"roadMatch": {
"requestPointCount": 20,
"totalDistance": 2046,
"totalPointCount": 68,
"matchedLinkCount": 21,
"matchedPoints": [
{
"idxName": "185316",
"linkId": "185316003366003907",
"sourceIndex": 18,
"sourceLocation": {
"latitude": "37.39865118381423",
"longitude": "126.96302788610492"
},
"matchedLocation": {
"latitude": "37.398552722989585",
"longitude": "126.96306223005134"
},
"speed": 0,
"roadCategory": 6,
"endPoint": "Y"
}
]
}
}
},
"argError": {
"summary": "파라미터 에러",
"description": "Argument Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 101,
"resultMessage": "Argument Error"
}
}
},
"serverError": {
"summary": "IMPS 서버 에러",
"description": "IMPS Server Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 102,
"resultMessage": "IMPS Server Error"
}
}
},
"authentication": {
"summary": "인증 실패",
"description": "Authentication Failed",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 300,
"resultMessage": "Authentication Failed"
}
}
},
"badRequest": {
"summary": "부적절한 URL",
"description": "Inappropriate URL",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 301,
"resultMessage": "Inappropriate URL"
}
}
}
}
}
}
},
"400": {
"description": "잘못된 요청",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"400": {
"summary": "잘못된 요청",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 400,
"resultMessage": "Invalid request parameter or body"
}
}
}
}
}
}
},
"404": {
"description": "API 없음",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"404": {
"summary": "API 없음",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 404,
"resultMessage": "API endpoint not found"
}
}
}
}
}
}
},
"415": {
"description": "허용되지 않는 메서드",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"415": {
"summary": "허용되지 않는 메서드",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 415,
"resultMessage": "Unsupported content type"
}
}
}
}
}
}
},
"500": {
"description": "서버 내부 오류",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"500": {
"summary": "서버 내부 오류",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 500,
"resultMessage": "Internal Server Error"
}
}
}
}
}
}
}
},
"x-order": 802
}
},
"/maps/v3.0/appkeys/{APPKEY}/route-start-multi-summary": {
"post": {
"tags": [
"매트릭스"
],
"summary": "다중 출발지-단일 목적지",
"description": "여러 출발지에서 지정된 목적지까지의 탐색된 요약 정보를 한 번에 계산해 제공합니다",
"operationId": "getNormalRouteStartMultiSummaryResult",
"parameters": [
{
"name": "APPKEY",
"in": "path",
"description": "해당 API 사용 권한이 있는 API 키",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"description": "다중 출발지-단일 목적지 조건",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RouteMultiStartRequest"
},
"example": {
"data": [
{
"startIdx": "example1",
"startX": "127.111412",
"startY": "37.39476"
},
{
"startIdx": "example2",
"startX": "127.119387",
"startY": "37.394735"
}
],
"endX": "127.110762",
"endY": "37.402184"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RouteStartMultiResponse"
},
"examples": {
"success": {
"summary": "성공",
"value": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"route": {
"data": [
{
"startIdx": "example2",
"startX": "127.119387",
"startY": "37.394735",
"spend_time": 420,
"distance": 1783
},
{
"startIdx": "example1",
"startX": "127.111412",
"startY": "37.39476",
"spend_time": 300,
"distance": 1534
}
]
}
}
},
"argError": {
"summary": "파라미터 에러",
"description": "Argument Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 101,
"resultMessage": "Argument Error"
}
}
},
"serverError": {
"summary": "IMPS 서버 에러",
"description": "IMPS Server Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 102,
"resultMessage": "IMPS Server Error"
}
}
},
"authentication": {
"summary": "인증 실패",
"description": "Authentication Failed",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 300,
"resultMessage": "Authentication Failed"
}
}
},
"badRequest": {
"summary": "부적절한 URL",
"description": "Inappropriate URL",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 301,
"resultMessage": "Inappropriate URL"
}
}
}
}
}
}
},
"400": {
"description": "잘못된 요청",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"400": {
"summary": "잘못된 요청",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 400,
"resultMessage": "Invalid request parameter or body"
}
}
}
}
}
}
},
"404": {
"description": "API 없음",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"404": {
"summary": "API 없음",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 404,
"resultMessage": "API endpoint not found"
}
}
}
}
}
}
},
"415": {
"description": "허용되지 않는 메서드",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"415": {
"summary": "허용되지 않는 메서드",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 415,
"resultMessage": "Unsupported content type"
}
}
}
}
}
}
},
"500": {
"description": "서버 내부 오류",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"500": {
"summary": "서버 내부 오류",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 500,
"resultMessage": "Internal Server Error"
}
}
}
}
}
}
}
},
"x-order": 900
}
},
"/maps/v3.0/appkeys/{APPKEY}/route-end-multi-summary": {
"post": {
"tags": [
"매트릭스"
],
"summary": "단일 출발지-다중 목적지",
"description": "출발지에서 지정된 여러 도착지까지의 탐색된 요약 정보를 한 번에 계산해 제공합니다",
"operationId": "getNormalRouteMultiEndSummaryResult",
"parameters": [
{
"name": "APPKEY",
"in": "path",
"description": "해당 API 사용 권한이 있는 API 키",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"description": "단일 출발지-다중 목적지 조건",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RouteMultiEndRequest"
},
"example": {
"data": [
{
"endIdx": "example1",
"endX": "127.110762",
"endY": "37.402184"
},
{
"endIdx": "example2",
"endX": "127.119387",
"endY": "37.394735"
}
],
"startX": "127.111412",
"startY": "37.39476"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RouteEndMultiResponse"
},
"examples": {
"success": {
"summary": "성공",
"value": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"route": {
"data": [
{
"endIdx": "example2",
"endX": "127.119387",
"endY": "37.394735",
"spend_time": 600,
"distance": 1593
},
{
"endIdx": "example1",
"endX": "127.110762",
"endY": "37.402184",
"spend_time": 300,
"distance": 1534
}
]
}
}
},
"argError": {
"summary": "파라미터 에러",
"description": "Argument Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 101,
"resultMessage": "Argument Error"
}
}
},
"serverError": {
"summary": "IMPS 서버 에러",
"description": "IMPS Server Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 102,
"resultMessage": "IMPS Server Error"
}
}
},
"authentication": {
"summary": "인증 실패",
"description": "Authentication Failed",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 300,
"resultMessage": "Authentication Failed"
}
}
},
"badRequest": {
"summary": "부적절한 URL",
"description": "Inappropriate URL",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 301,
"resultMessage": "Inappropriate URL"
}
}
}
}
}
}
},
"400": {
"description": "잘못된 요청",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"400": {
"summary": "잘못된 요청",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 400,
"resultMessage": "Invalid request parameter or body"
}
}
}
}
}
}
},
"404": {
"description": "API 없음",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"404": {
"summary": "API 없음",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 404,
"resultMessage": "API endpoint not found"
}
}
}
}
}
}
},
"415": {
"description": "허용되지 않는 메서드",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"415": {
"summary": "허용되지 않는 메서드",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 415,
"resultMessage": "Unsupported content type"
}
}
}
}
}
}
},
"500": {
"description": "서버 내부 오류",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"500": {
"summary": "서버 내부 오류",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 500,
"resultMessage": "Internal Server Error"
}
}
}
}
}
}
}
},
"x-order": 901
}
},
"/maps/v3.0/appkeys/{APPKEY}/route-distance-matrix": {
"post": {
"tags": [
"매트릭스"
],
"summary": "RDM(다중 경로 행렬)",
"description": "여러 출발/도착 지점 간의 주행 가능 경로를 탐색하여 거리와 시간 정보를 행렬 형태로 반환합니다",
"operationId": "postRouteDistanceMatrixResult",
"parameters": [
{
"name": "APPKEY",
"in": "path",
"description": "해당 API 사용 권한이 있는 API 키",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"description": "RDM(다중 경로 행렬) 조건",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RouteDistanceMatrixRequest"
},
"example": {
"points": [
{
"posX": "127.110762",
"posY": "37.402184"
},
{
"posX": "127.111412",
"posY": "37.39476"
},
{
"posX": "127.119387",
"posY": "37.394735"
}
],
"dests": [
{
"posX": "126.9071869221794",
"posY": "37.53078938747262"
}
]
}
}
},
"required": true
},
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RouteDistanceMatrixResponse"
},
"examples": {
"success": {
"summary": "성공",
"value": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"mode": "tms",
"origins": [
"127.110762,37.402184",
"127.111412,37.39476",
"127.119387,37.394735"
],
"destinations": [
"126.9071869221794,37.53078938747262"
],
"rows": [
{
"elements": [
{
"distance": {
"value": 31489,
"text": "31.5 km"
},
"duration": {
"value": 1956,
"text": "32 mins"
},
"status": "OK"
}
]
},
{
"elements": [
{
"distance": {
"value": 30908,
"text": "30.9 km"
},
"duration": {
"value": 1857,
"text": "30 mins"
},
"status": "OK"
}
]
},
{
"elements": [
{
"distance": {
"value": 31861,
"text": "31.9 km"
},
"duration": {
"value": 1973,
"text": "32 mins"
},
"status": "OK"
}
]
}
]
}
},
"argError": {
"summary": "파라미터 에러",
"description": "Argument Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 101,
"resultMessage": "Argument Error"
}
}
},
"serverError": {
"summary": "IMPS 서버 에러",
"description": "IMPS Server Error",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 102,
"resultMessage": "IMPS Server Error"
}
}
},
"authentication": {
"summary": "인증 실패",
"description": "Authentication Failed",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 300,
"resultMessage": "Authentication Failed"
}
}
},
"badRequest": {
"summary": "부적절한 URL",
"description": "Inappropriate URL",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 301,
"resultMessage": "Inappropriate URL"
}
}
}
}
}
}
},
"400": {
"description": "잘못된 요청",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"400": {
"summary": "잘못된 요청",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 400,
"resultMessage": "Invalid request parameter or body"
}
}
}
}
}
}
},
"404": {
"description": "API 없음",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"404": {
"summary": "API 없음",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 404,
"resultMessage": "API endpoint not found"
}
}
}
}
}
}
},
"415": {
"description": "허용되지 않는 메서드",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"415": {
"summary": "허용되지 않는 메서드",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 415,
"resultMessage": "Unsupported content type"
}
}
}
}
}
}
},
"500": {
"description": "서버 내부 오류",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"examples": {
"500": {
"summary": "서버 내부 오류",
"value": {
"header": {
"isSuccessful": false,
"resultCode": 500,
"resultMessage": "Internal Server Error"
}
}
}
}
}
}
}
},
"x-order": 902
}
},
"/docs/category-codes": {
"get": {
"tags": [
"장소/주소 검색"
],
"summary": "카테고리 코드",
"description": "| catecode | catename | catecode | catename | catecode | catename |\n|----------|----------|----------|----------|----------|----------|\n| 000000 | 지명관련 | 000002 | 특별시 | 000003 | 광역시 |\n| 000004 | 일반시 | 000005 | 구 | 000006 | 법정동 |\n| 000007 | 행정동 | 000009 | 도 | 000010 | 군 |\n| 000011 | 읍 | 000012 | 면 | 000013 | 리 |\n| 000014 | 자연부락 | 000016 | 고개/언덕 | 000017 | 평야/들 |\n| 000018 | 산/산맥 | 000019 | 바위/변형지물 | 000020 | 유명한산 |\n| 000022 | 기념비 | 000025 | 국도 | 000026 | 고속도로 |\n| 000027 | 지방도로 | 000028 | 도시고속화도로 | 000029 | 일반도로명 |\n| 000030 | 공사완공표시명칭 | 000032 | 계곡/협곡 | 000033 | 호수/저수지 |\n| 000034 | 해양명 | 000036 | 해안선(섬) | 000037 | 만/수로 |\n| 000038 | 하천 | 000039 | 폭포 | 000040 | 일반도로명(소로) |\n| 000080 | 1자리 | 000081 | 2자리 | 000082 | 3자리 |\n| 000083 | 4자리 | 000084 | 1자리 | 000085 | 2자리 |\n| 000086 | 3자리 | 000087 | 4자리 | 000088 | 1자리 |\n| 000089 | 2자리 | 000090 | 3자리 | 000091 | 4자리 |\n| 000092 | 택지개발지구 | 000093 | 신도시 | 000094 | 예전지역명칭 |\n| 010000 | 공공기관 | 010100 | 특별시청 | 010101 | 별관 |\n| 010200 | 도청 | 010201 | 별관 | 010300 | 시청 |\n| 010301 | 별관 | 010400 | 구청 | 010401 | 별관 |\n| 010500 | 군청 | 010501 | 별관 | 010600 | 읍사무소 |\n| 010601 | 별관(출장소) | 010700 | 면사무소 | 010701 | 별관(출장소) |\n| 010800 | 동주민센터 | 010801 | 별관(출장소) | 010802 | 구명칭 |\n| 010900 | 회관 | 010901 | 시민회관 | 010902 | 구민회관 |\n| 010903 | 마을회관 | 010904 | 농업기술센터 | 010905 | 경로당 |\n| 011000 | 소방서 | 011001 | 119안전센터 | 011002 | 119지역대 |\n| 011100 | 보건소 | 011101 | 보건진료소 | 011102 | 보건지소 |\n| 011200 | 우체국 | 011201 | 우편취급국 | 011300 | 기상대/측후소 |\n| 011400 | 국세청 | 011500 | 세무서 | 011600 | 관세청 |\n| 011700 | 세관 | 011800 | 전화국 | 011801 | 전화분국 |\n| 011900 | 병무청 | 012000 | 국방부 | 012100 | 국회 |\n| 012200 | 지방의회 | 012300 | 외국기관 | 012400 | 국제기구 |\n| 012500 | 대사관 | 012600 | 영사관 | 012700 | 정부투자기관 |\n| 012800 | 공공단체(협회) | 012900 | 철도청 | 013000 | 정부기관 |\n| 013100 | 소규모정부기관 | 013200 | 사단법인 | 013300 | 광역시청 |\n| 013400 | 주민자치센터 | 013500 | 투표소 | 013600 | 리사무소 |\n| 020000 | 치안기관 | 020100 | 법원 | 020101 | 대법원 |\n| 020102 | 고등법원 | 020103 | 지방법원 | 020104 | 가정법원 |\n| 020200 | 등기소 | 020300 | 검찰청 | 020301 | 대검찰청 |\n| 020302 | 고등검찰청 | 020303 | 지방검찰청 | 020400 | 경찰청 |\n| 020500 | 경찰서 | 020600 | 파출소/지서 | 020601 | 지구대 |\n| 020602 | 치안센터 | 020603 | 방범초소 | 020800 | 소년원 |\n| 020900 | 예비군훈련장 | 021000 | 민방위교육장 | 021100 | 검문소 |\n| 030000 | 공원/산/동,식물원 | 030100 | 동물원 | 030101 | 아쿠아리움 |\n| 030200 | 식물원 | 030300 | 국립공원 | 030400 | 도립공원 |\n| 030500 | 근린공원 | 030501 | 근린공원_대 | 030502 | 근린공원_중 |\n| 030503 | 근린공원_소 | 030504 | 공원쉼터 | 030700 | 군립공원 |\n| 030800 | 기타 | 030801 | 부속시설 | 040000 | 교육기관 |\n| 040100 | 교육청 | 040200 | 도서관 | 040300 | 독서실 |\n| 040400 | 고시원 | 040500 | 종합대학 | 040501 | 부속건물 |\n| 040502 | 단과대학 | 040600 | 전문대학 | 040601 | 부속건물 |\n| 040700 | 대학원 | 040800 | 신학대학 | 040900 | 유치원/유아원 |\n| 040901 | 유아교육기관 | 040902 | 놀이방 | 040903 | 어린이집 |\n| 040904 | 유치원 | 041000 | 직업전문학교 | 041001 | 직업훈련소 |\n| 041002 | 상설직업훈련기관 | 041100 | 특수학교 | 041101 | 특수교육기관 |\n| 041102 | 대안학교 | 041103 | 외국인학교 | 041200 | 초등학교 |\n| 041201 | 폐교 | 041202 | 부속건물 | 041300 | 중학교 |\n| 041301 | 부속건물 | 041400 | 고등학교 | 041401 | 부속건물 |\n| 041500 | 고등기술학교 | 041600 | 고등공민학교 | 041700 | 체육관 |\n| 041800 | 학원 | 041803 | 고시 | 041809 | 미술 |\n| 041810 | 보습/속기 | 041813 | 외국어 | 041814 | 요리 |\n| 041815 | 웅변/화술 | 041817 | 음악 | 041818 | 미용 |\n| 041819 | 입시 | 041820 | 자동차운전 | 041821 | 자동차정비 |\n| 041824 | 컴퓨터 | 041828 | 간호학원 | 041829 | 체육 |\n| 042000 | 연구소/연구기관 | 042100 | 기능대학 | 042200 | 천문대 |\n| 042300 | 중고등학교 | 042500 | 기타 | 042501 | 폐교 |\n| 042600 | 초중학교 | 050000 | 언론기관 | 050100 | TV방송국 |\n| 050300 | 신문사 | 050301 | 지사 | 050302 | 지국 |\n| 050400 | 잡지사 | 050500 | 중계소 | 060000 | 금융기관 |\n| 060100 | 한국은행 | 060200 | 국민은행 | 060300 | 우리은행 |\n| 060400 | 스탠다드차타드은행 | 060900 | 신한은행 | 061100 | 하나은행 |\n| 061200 | 기업은행 | 061400 | 씨티은행 | 061500 | 한국산업은행 |\n| 061600 | 상호저축은행 | 061700 | 경남은행 | 061800 | 부산은행 |\n| 061900 | 대구은행 | 062000 | 전북은행 | 062100 | 광주은행 |\n| 062200 | 제주은행 | 062300 | 한국수출입은행 | 062700 | 증권사 |\n| 062701 | 대한투자신탁 | 062702 | 한국투자신탁 | 062703 | 현대투자신탁 |\n| 062704 | 제일투자신탁 | 062800 | 보험회사 | 062801 | 교보생명보험 |\n| 062802 | 동양생명보험 | 071100 | 전시관/기념관 | 042400 | 교육원/교육센터 |\n| 050200 | 라디오방송국 | 062803 | 라이나생명보험 | 062804 | 롯데손해보험 |\n| 062805 | 미래에셋생명보험 | 062806 | 삼성생명보험 | 062807 | 삼성화재해상보험 |\n| 062808 | 신한생명보험 | 062809 | 한화생명보험 | 062810 | 한화손해보험 |\n| 062811 | 현대해상화재보험 | 062812 | 흥국생명보험 | 062813 | 흥국화재해상보험 |\n| 062815 | DB손해보험 | 062816 | DGB생명보험 | 062817 | 오렌지라이프 |\n| 062818 | KB손해보험 | 062819 | KDB생명보험 | 062820 | MG손해보험 |\n| 062821 | NH농협손해보험 | 062823 | NH농협생명 | 062824 | 메트라이프생명 |\n| 062825 | 메리츠화재 | 062900 | 협동조합 | 062901 | 농협 |\n| 062902 | 수협 | 062903 | 임협 | 062904 | 신협 |\n| 062905 | 축협 | 063000 | 카드사 | 063100 | 캐피탈 |\n| 063200 | 종금사 | 063300 | 새마을금고 | 063400 | 현금인출기 |\n| 070000 | 문화/종교/예술 | 070100 | 종교시설 | 070101 | 교회 |\n| 070102 | 절 | 070103 | 성당 | 070104 | 원불교 |\n| 070105 | 천도교 | 070106 | 기도원 | 070107 | 수녀원 |\n| 070108 | 수도원 | 070800 | 미술관 | 070900 | 박물관 |\n| 071000 | 과학관 | 071101 | 대규모전시장 | 071200 | 영화관 |\n| 071201 | 자동차극장 | 071202 | CGV | 071203 | 롯데시네마 |\n| 071204 | 메가박스 | 071300 | 문화예술시설 | 071301 | 소극장 |\n| 071302 | 문화회관 | 071303 | 대규모공연시설 | 071304 | 공연장 |\n| 071400 | 문화원/문화센터 | 080000 | 관광/숙박 | 080100 | 능묘 |\n| 080101 | 능묘_대 | 080102 | 능묘_중 | 080103 | 능묘_소 |\n| 080200 | 명승고적/유적지 | 080201 | 유명명승고적 | 080202 | 국보/보물 |\n| 080300 | 성 | 080500 | 온천 | 080600 | 문화재보호구역 |\n| 080800 | 유원지 | 080900 | 놀이동산 | 080901 | 대규모 |\n| 081000 | 산림욕장/자연휴양림 | 081100 | 독립수 | 081200 | 호텔 |\n| 081201 | 특급호텔 | 081202 | 관광호텔 | 081203 | 일반호텔(가족/국민호텔) |\n| 081204 | 롯데호텔 | 081205 | 신라호텔 | 081206 | 롯데호텔(비지니스) |\n| 081207 | 신라호텔(비지니스) | 081300 | 여관/모텔 | 081400 | 콘도미니엄 |\n| 081401 | 부속건물 | 081500 | 유스호스텔 | 081600 | 민박 |\n| 081700 | 관광농원 | 081800 | 철새도래지 | 081900 | 관광사찰 |\n| 082000 | 유명약수터 | 082100 | 전국문화축제 | 082200 | 관광안내소 |\n| 082300 | 펜션 | 082400 | 콘도형민박 | 082500 | 매표소 |\n| 082600 | 촬영장소 | 082601 | 영화 | 082602 | 드라마 |\n| 082603 | CF | 082700 | 드라이브코스 | 082701 | 명소 |\n| 082702 | 낭만가도 | 082800 | 체험여행 | 082801 | 밤줍기 |\n| 111106 | 의류 | 082802 | 해병대체험 | 082803 | 체험학습 |\n| 082900 | 테마거리 | 082901 | 먹자거리 | 082902 | 문화거리 |\n| 082903 | 패션거리 | 082904 | 까페거리 | 082905 | 단풍길낙엽길 |\n| 083000 | 케이블카 | 083100 | 대피소 | 083101 | 지진옥외대피소 |\n| 083200 | 산장 | 083300 | 게스트하우스 | 090000 | 레져/스포츠 |\n| 090100 | 골프장 | 090101 | 회원제골프장 | 090102 | 퍼블릭골프장 |\n| 090103 | 군골프장 | 090104 | 파3골프장 | 090105 | 골프장홀 |\n| 090106 | 클럽하우스 | 090200 | 골프연습장 | 090201 | 실내골프연습장 |\n| 090202 | 실외골프연습장 | 090300 | 볼링장 | 090400 | 스포츠센터 |\n| 090401 | 종합스포츠센터 | 090402 | 구민체육센터 | 090403 | 스쿼시 |\n| 090404 | 에어로빅 | 090405 | 헬스 | 090500 | 해수욕장 |\n| 090600 | 수영장 | 090601 | 실외수영장 | 090602 | 실내수영장 |\n| 090800 | 스키장 | 090900 | 낚시터 | 090901 | 민물낚시 |\n| 090902 | 바다낚시 | 090903 | 실내낚시 | 091000 | 캠프장 |\n| 091100 | 오토캠프장 | 091200 | 테니스장 | 091300 | 야구장 |\n| 091301 | 아마추어 | 091400 | 경기장/운동장 | 091500 | 종합운동장 |\n| 091600 | 아이스링크 | 091700 | 요트장 | 091800 | 경마장 |\n| 091900 | 경륜장 | 092000 | 카레이싱장 | 092100 | 어린이놀이터 |\n| 092200 | 수련장/연수원 | 092300 | 레져타운(리조트포함) | 092301 | 소노호텔&리조트 |\n| 092302 | 한화리조트 | 092303 | 켄싱턴리조트 | 092304 | 롯데리조트 |\n| 092305 | 금호리조트 | 110106 | 갤러리아백화점 | 110200 | 할인매장 |\n| 092306 | 소노문 | 092307 | 소노벨 | 092308 | 소노펠리체 |\n| 092309 | 소노캄 | 092310 | 쏠비치 | 092400 | 눈썰매장 |\n| 092500 | 축구장(전용구장) | 092501 | 인조잔디 | 092600 | 승마장 |\n| 092700 | 롤러스케이트장 | 092800 | 카지노 | 092900 | 수상/해상레포츠 |\n| 093000 | 육상/항공레포츠 | 093001 | 마라톤 | 093002 | 월드컵응원장소 |\n| 093201 | 초급 | 093202 | 중급 | 093203 | 중상급 |\n| 093204 | 상급 | 093205 | 최상급 | 093206 | 기타 |\n| 093300 | 탐방로 | 093301 | 등산코스 | 093302 | 올레길 |\n| 093303 | 둘레길 | 094000 | 여가스포츠 | 094001 | 동호회 |\n| 100000 | 음식점 | 100100 | 한식 | 100101 | 고기전문점 |\n| 100102 | 전통음식점 | 100103 | 별미전문점 | 100104 | 횟집 |\n| 100105 | 한정식 | 100106 | 본죽 | 100200 | 중식 |\n| 100300 | 양식 | 100301 | 해외별미 | 100302 | 스파게티 |\n| 100303 | 피자 | 100304 | 쌀국수 | 100400 | 일식 |\n| 100401 | 우동전문점 | 100402 | 돈까스전문점 | 100500 | 뷔페 |\n| 100501 | 쿠우쿠우 | 100600 | 카페 | 100601 | 전통찻집 |\n| 100602 | 커피전문점 | 100603 | 스타벅스 | 100604 | 스타벅스DT |\n| 111104 | 통신기기 | 111105 | 가구 | 100605 | 스타벅스리저브 |\n| 100606 | 만화카페 | 100607 | 테마카페 | 100608 | 키즈카페 |\n| 100609 | 동물카페 | 100610 | 스터디카페 | 100611 | 모임공간대여 |\n| 100700 | 분식 | 100800 | 패밀리레스토랑 | 100804 | 시즐러 |\n| 100805 | TGI프라이데이 | 100806 | 베니건스 | 100808 | 아웃백스테이크 |\n| 100809 | 마르쉐 | 100811 | 빕스 | 100818 | 씨푸드레스토랑 |\n| 100900 | 패스트푸드 | 100901 | 맥도날드 | 100902 | 롯데리아 |\n| 100904 | 버거킹 | 100907 | 파파이스 | 100911 | 맥도날드DT |\n| 100912 | 롯데리아DT | 100913 | KFCDT | 100914 | 버거킹DT |\n| 100917 | 파파이스DT | 100918 | 샌드위치 | 100919 | 맘스터치 |\n| 101000 | 제과점 | 101001 | 고려당 | 101002 | 뉴욕제과 |\n| 101003 | 뚜레쥬르 | 101005 | 신라명과 | 101006 | 크라운베이커리 |\n| 101007 | 파리바게뜨 | 101008 | 파리크라상 | 101009 | 빵굼터 |\n| 101010 | 던킨도너츠 | 101100 | 아이스크림전문점 | 101101 | 배스킨라빈스 |\n| 101300 | 유흥업소 | 101301 | 청담이상 | 101302 | 이태원천상 |\n| 101303 | 일반주점 | 101304 | 유흥주점 | 101400 | 치킨전문점 |\n| 110000 | 쇼핑/편의 | 110100 | 백화점 | 110101 | 롯데백화점 |\n| 110102 | 현대백화점 | 110103 | 신세계백화점 | 110104 | NC백화점 |\n| 110105 | AK플라자 | 100903 | KFC | 110202 | 킴스클럽 |\n| 110203 | 롯데몰 | 110204 | 코스트코홀세일 | 110205 | 2001아울렛 |\n| 110207 | 메가마트 | 110209 | 홈플러스 | 110210 | 농협하나로클럽 |\n| 110212 | 하이마트 | 110213 | 롯데마트 | 110215 | 세이브존 |\n| 110217 | 전자랜드 | 110219 | VIC마켓 | 110221 | LG전자베스트샵 |\n| 110222 | 노브랜드 | 110223 | 롯데아울렛 | 110224 | 신세계아울렛 |\n| 110225 | 현대아울렛 | 110226 | 스타필드 | 110227 | 엔터식스 |\n| 110228 | 이케아 | 110300 | 시장 | 110301 | 야시장 |\n| 110400 | 종합상가 | 110500 | 민속장날 | 110600 | 농축수산물판매 |\n| 110601 | 농축수산물도매시장 | 110602 | 공판장/직판장 | 110603 | 정육점 |\n| 110604 | 농수산청과판매점 | 110700 | 편의점 | 110701 | GS25 |\n| 110702 | 세븐일레븐 | 110703 | 베스토아 | 110704 | CU |\n| 110705 | 미니스톱 | 110706 | 바이더웨이 | 110707 | CSPACE |\n| 110709 | 우리들 | 110711 | 조이마트 | 110712 | OK마트 |\n| 110713 | 이마트24 | 110800 | 예식장 | 110900 | 웨딩홀뷔페 |\n| 111100 | 전문상가 | 111101 | 주요상가단지 | 111102 | 가전제품 |\n| 111103 | 컴퓨터 | 110220 | 삼성디지털프라자 | 111107 | 미샤 |\n| 111108 | 화장품 | 111109 | 유기농식품 | 111110 | 자전거 |\n| 111112 | 서점 | 111113 | 로또복권 | 111114 | 안경 |\n| 111115 | 삼성전자서비스센터 | 111116 | 삼성전자서비스휴대폰센터 | 111117 | LG전자서비스센터 |\n| 111118 | ABC마트 | 111119 | 리바트 | 111120 | 노루페인트 |\n| 111121 | 대유위니아대리점 | 111122 | 블랙야크 | 111123 | 네파 |\n| 111124 | 경동나비엔 | 111125 | 에뛰드 | 111126 | 휠라 |\n| 111127 | 아디다스 | 111128 | 하나투어 | 111129 | 한국야쿠르트 |\n| 111130 | 올리브영 | 111131 | 이니스프리 | 111132 | 코웨이 |\n| 111133 | 더페이스샵 | 111134 | 다이소 | 111135 | 교보문고 |\n| 111136 | 영풍문고 | 111137 | 데상트 | 111138 | 대우전자 |\n| 111139 | 린나이코리아 | 111140 | 바디프랜드 | 111141 | 애터미 |\n| 111142 | 에넥스 | 111143 | 유니클로 | 111144 | 캐논코리아 |\n| 111145 | 필립스 | 111146 | 후지제록스 | 111147 | K2 |\n| 111148 | 자라 | 111149 | 소니 | 111150 | 부동산 |\n| 111151 | 수족관 | 111152 | 반려동물 | 111153 | 떡집 |\n| 111154 | 반찬가게 | 111300 | 면세점 | 111400 | 마트 |\n| 111401 | 홈플러스익스프레스 | 111402 | GS더프레시 | 111403 | 이마트에브리데이 |\n| 111404 | 롯데슈퍼 | 111405 | 하나로마트 | 111406 | 메가마트 |\n| 111500 | 꽃집/꽃배달 | 111700 | 스튜디오 | 111800 | 여행사 |\n| 112100 | 목욕탕 | 112200 | 찜질방/사우나 | 112300 | PC방 |\n| 112400 | 화장실 | 112600 | 엘리베이터 | 112700 | 에스컬레이터 |\n| 112800 | 비상구 | 112900 | DVD방/멀티방 | 113000 | 도서/DVD대여점 |\n| 113100 | 미용실/이용실 | 113200 | 에스테틱 | 113201 | 네일샵 |\n| 113202 | 피부관리 | 113203 | 체형관리 | 113204 | 마사지 |\n| 113205 | 두피관리샵 | 113300 | 세탁소 | 113400 | 연회장 |\n| 113500 | 드럭스토어 | 113600 | 여가 | 113601 | VR |\n| 113602 | 게임방 | 113603 | 인형뽑기방 | 113604 | 노래방 |\n| 120000 | 의료/복지 | 120100 | 약국 | 120101 | 공공야간약국 |\n| 120200 | 의료기구상사 | 120300 | 보건원 | 120400 | 국립의료원 |\n| 120500 | 검역소 | 120600 | 정신병원 | 120700 | 재활원 |\n| 120800 | 의료보조기관 | 120806 | 건강진단센터 | 120813 | 조산원/산후조리원 |\n| 120814 | 응급실/응급의료센터 | 120815 | 코로나19관련 | 120900 | 종합병원 |\n| 120901 | 유명종합병원 | 120902 | 부속시설 | 121000 | 일반병원 |\n| 121001 | 내과 | 121002 | 마취통증의학과 | 121003 | 영상의학과 |\n| 121004 | 비뇨기과 | 121005 | 산부인과 | 121006 | 소아청소년과 |\n| 121007 | 동물병원 | 121008 | 신경외과 | 121009 | 신경정신과 |\n| 121010 | 안과 | 121011 | 외과 | 121012 | 이비인후과 |\n| 121013 | 임상병리과 | 121014 | 재활의학과 | 121015 | 정형외과 |\n| 121016 | 치과 | 121017 | 피부과 | 121018 | 피부비뇨기과 |\n| 121019 | 성형외과 | 121020 | 신경내과 | 121021 | 가정의학과 |\n| 121100 | 군병원 | 121200 | 한방병원 | 121300 | 한의원 |\n| 121400 | 사회복지시설 | 121401 | 사회복지단체 | 121402 | 청소년복지시설 |\n| 121403 | 아동복지시설 | 121404 | 노인복지시설 | 121405 | 장애인복지시설 |\n| 121406 | 여성복지시설 | 121500 | 장례식장 | 121501 | 반려동물장례식장 |\n| 121600 | 납골당 | 121700 | 화장터 | 121800 | 장의사 |\n| 121900 | 공원묘지 | 122000 | 공동묘지 | 122200 | 국립묘지 |\n| 122201 | 현충원 | 122300 | 헌혈의집 | 122500 | 한약방/한약국 |\n| 130000 | 기업 | 130100 | 주요기업 | 130200 | 사옥 |\n| 130300 | 빌딩 | 130301 | 대규모 | 130302 | 중규모 |\n| 130303 | 소규모 | 130400 | 회사기숙사 | 130500 | 일반기업 |\n| 130600 | 팅크웨어 | 130601 | 대리점 | 130602 | 협력사 |\n| 130603 | 서비스센터 | 130604 | 업글대행점넥센타이어 | 130605 | 업글대행점한국타이어 |\n| 130606 | 대리점(커넥티드이벤트) | 122400 | 요양병원 | 130607 | 서비스센터(커넥티드이벤트) |\n| 130608 | 대리점(커넥티드보상이벤트) | 130609 | 서비스센터(커넥티드보상이벤트) | 130610 | 대리점(커넥티드이벤트/보상) |\n| 130611 | 서비스센터(커넥티드이벤트/보상) | 130612 | 아이나비스포츠대리점 | 130700 | SK관련 |\n| 130701 | SK주요건물 | 130702 | SK연구소 | 130703 | SK증권 |\n| 130704 | SK생명 | 130705 | SK대리점 | 130706 | SK고객센터 |\n| 130707 | SK기지국 | 130708 | SK정비소 | 130709 | SK물류센터 |\n| 130710 | SK저유소 | 130711 | SK직영점 | 130712 | SK브로드밴드 |\n| 130800 | 홈플러스기업 | 130801 | 홈플러스본사 | 130802 | e파란재단 |\n| 130900 | KT관련 | 130901 | KT본사 | 130902 | KT계열사 |\n| 130903 | KT대리점 | 130904 | 올레KT지점 | 130905 | 올레스마트워킹센터 |\n| 131000 | LG관련 | 131001 | LG유플러스본사 | 131002 | LG유플러스계열사 |\n| 131003 | LG유플러스대리점 | 140000 | 농공시설 | 140100 | 공장 |\n| 140400 | 공업단지 | 140500 | 농장 | 140600 | 목장(축산) |\n| 140700 | 과수원 | 140800 | 광산 | 141000 | 양어장 |\n| 141100 | 염전 | 141200 | 농공단지 | 141300 | 정미소(미곡처리장) |\n| 141400 | 양수장/배수장 | 141500 | 부속건물 | 150000 | 자동차관련 |\n| 150100 | 업체별정비 | 150101 | 쉐보레정비 | 150400 | 렌트카회사 |\n| 150401 | 롯데렌터카 | 150102 | 기아정비 | 150104 | 현대정비 |\n| 150106 | 수입차정비 | 150107 | MINI정비 | 150108 | 혼다정비 |\n| 150109 | BMW정비 | 150110 | 토요타정비 | 150111 | 닛산정비 |\n| 150112 | 벤츠정비 | 150114 | 아우디정비 | 161600 | 휴게소 |\n| 150115 | 재규어랜드로버정비 | 150116 | 폭스바겐정비 | 150117 | 포드정비 |\n| 150118 | 볼보트럭정비 | 150119 | 테슬라 | 150120 | 마세라티 |\n| 150200 | 일반정비소(1급/보험) | 150300 | 자동차영업소 | 150301 | 쉐보레 |\n| 150302 | 기아 | 150402 | AJ렌터카 | 150403 | 쏘카존 |\n| 150304 | 현대자동차 | 150306 | 수입차 | 150307 | MINI |\n| 150308 | 혼다자동차 | 150309 | BMW | 150310 | 토요타 |\n| 150311 | 타타대우 | 150312 | 벤츠 | 150321 | 볼보트럭 |\n| 150322 | 테슬라 | 150404 | 그린존 | 150500 | 카센터 |\n| 150600 | 세차장 | 150501 | 르노코리아협력 | 150313 | 닛산 |\n| 150314 | 스카니아 | 150316 | 아우디 | 150317 | 재규어랜드로버 |\n| 150318 | 폭스바겐 | 150319 | 포드 | 150320 | 포르쉐 |\n| 150323 | 마세라티 | 150601 | 노터치세차장 | 150602 | 셀프세차장 |\n| 150700 | 폐차장 | 150800 | 견인차보관소 | 150900 | 자동차검사소 |\n| 151000 | 면허시험장 | 151100 | 주유소 | 151101 | SK주유소 |\n| 151104 | GS주유소 | 151105 | EX-OIL주유소 | 151107 | 농협주유소 |\n| 151108 | 알뜰주유소 | 151110 | 셀프주유소 | 151111 | SK셀프 |\n| 151114 | GS셀프 | 151117 | 농협셀프 | 151118 | 알뜰셀프 |\n| 151119 | EX-OIL셀프 | 151200 | LPG충전소 | 151201 | SKLPG |\n| 151202 | SOiLLPG | 151204 | E1LPG | 151205 | GSLPG |\n| 151300 | 부품대리점 | 151301 | 쉐보레부품 | 151302 | 기아부품 |\n| 151304 | 현대부품 | 151102 | SOiL주유소 | 151103 | 현대주유소 |\n| 151303 | 르노코리아부품 | 151113 | 현대셀프 | 151203 | 현대LPG |\n| 151306 | 한국타이어 | 151307 | 넥센타이어 | 151308 | 티스테이션(한국타이어) |\n| 151309 | 타이어타운(한국타이어) | 151310 | TBX(한국타이어) | 151311 | 금호타이어 |\n| 151312 | 타이어뱅크 | 151400 | 자동차매매 | 151500 | 자동차용품 |\n| 151600 | 차량등록사업소 | 151700 | LNG충전소 | 151800 | 오토바이판매정비 |\n| 151801 | 전문 | 151802 | 복합 | 151900 | 오토바이렌트 |\n| 152000 | 오토바이용품 | 152100 | 전기차충전소 | 152101 | 이륜차충전소 |\n| 152102 | 이륜차주차장 | 152103 | 테슬라 | 152200 | 차고지 |\n| 152300 | 외형복원 | 152400 | 선팅전문 | 152500 | 수소충전소 |\n| 160000 | 교통시설 | 160100 | 기차역 | 160101 | 고속철도 |\n| 160102 | 일반철도 | 160103 | 폐역사 | 160104 | 기타 |\n| 160200 | 버스터미널 | 160201 | 종합버스터미널 | 160202 | 고속버스터미널 |\n| 160203 | 시외버스터미널 | 160204 | 시내버스터미널 | 160206 | 광역환승센터 |\n| 160400 | 창고및물류센터 | 160407 | 저유소 | 160408 | 농산물창고 |\n| 160500 | 운수화물 | 160510 | 택배 | 160511 | 이사짐센터 |\n| 160512 | 퀵서비스 | 160514 | DHL | 160515 | FeDex |\n| 160516 | CJ대한통운 | 160800 | 국내여객선터미널 | 160900 | 국제여객선터미널 |\n| 161000 | 공항 | 161100 | 공항터미널 | 161200 | 항만 |\n| 161201 | 부두 | 161202 | 항구 | 161203 | 포구 |\n| 161204 | 선착장 | 161205 | 등대 | 161206 | 기타 |\n| 161300 | 도로요금소 | 161400 | 훼리항로 | 161500 | 도로교통안전협회 |\n| 161603 | 졸음쉼터 | 161700 | 주차장 | 161701 | 유료주차장 |\n| 161702 | 무료주차장 | 161703 | 주차빌딩 | 161704 | 부속주차장 |\n| 161705 | 아파트주차장 | 161706 | 시간제주차장 | 161800 | 헬기장 |\n| 161900 | 항공사 | 162000 | 화물터미널 | 173000 | 출구번호 |\n| 180000 | 도로시설 | 180100 | 고가도로 | 180200 | 지하차도 |\n| 180300 | IC명 | 180301 | 고속 | 180302 | 일반 |\n| 180400 | 교차점명 | 180500 | 톨게이트 | 180700 | 분기점 |\n| 180701 | 고속 | 180702 | 지방/국 | 180800 | 다리시설 |\n| 180801 | 대교 | 180802 | 소교 | 180803 | 철교 |\n| 180804 | 한강대교 | 180805 | 육교 | 180900 | 터널 |\n| 181000 | 철도 | 181001 | 특수철도 | 181002 | 일반철도 |\n| 181100 | 입구점 | 181101 | 차량진입 | 181102 | 차량진출 |\n| 181103 | 사람 | 181104 | 차량진출입 | 181105 | IC/JC입구 |\n| 181106 | 택시승하차전용 | 181300 | 방면 | 181301 | IC |\n| 181302 | 분기점 | 161602 | 국도/지방도 | 161601 | 고속도로 |\n| 172400 | 공항철도 | 174800 | 김포골드라인 | 174100 | 의정부경전철 |\n| 171500 | 대구1호선 | 174500 | 동해선 | 171300 | 부산1호선 |\n| 171400 | 부산2호선 | 172100 | 부산3호선 | 171700 | 인천1호선 |\n| 170000 | 지하철 | 174300 | 인천자기부상 | 174600 | 우이신설경전철 |\n| 172900 | 신분당선 | 174900 | 수인분당선 | 174700 | 서해선 |\n| 171200 | 서울9호선 | 171000 | 서울8호선 | 170800 | 서울6호선 |\n| 170700 | 서울5호선 | 170600 | 서울4호선 | 170500 | 서울3호선 |\n| 170100 | 서울1호선 | 171600 | 대구2호선 | 171900 | 광주1호선 |\n| 170300 | 경의중앙선 | 174400 | 경강선 | 181303 | 대교 |\n| 181400 | 씨씨티비 | 181401 | CCTV | 181500 | VMS |\n| 181501 | V-VMS | 190000 | 주택관련 | 190100 | 아파트 |\n| 190101 | 동번호 | 190102 | 경남아너스빌 | 190103 | 꿈에그린 |\n| 190104 | 더샵 | 190105 | 두산위브 | 190106 | 래미안 |\n| 190107 | 롯데캐슬 | 190108 | 센트레빌 | 190109 | 쌍용예가 |\n| 190110 | 아이파크 | 190111 | 어울림 | 190112 | 자이 |\n| 190113 | LH | 190114 | 푸르지오 | 190115 | 힐스테이트 |\n| 190116 | e편한세상 | 190117 | SKVIEW | 190118 | 군인아파트 |\n| 190119 | 호반베르디움 | 190200 | 연립주택 | 190201 | 동번호 |\n| 190300 | 오피스텔 | 190301 | 동번호 | 190400 | 주상복합 |\n| 199900 | 기타 | 199901 | 모델하우스 | 199902 | 관리사무소 |\n| 200000 | 공사중명칭 | 200100 | 서비스 | 300000 | 가상POI |\n| 301000 | 아파트 | 302000 | 유명관광지 | 303000 | 평창올림픽 |\n| 800000 | 기타 | 800100 | 열량계 | 161604 | 일반휴게소 |\n| 050101 | 일반TV | 050102 | CATV | 080700 | 관광지/관광단지 |\n| 120811 | 요양원 | 172600 | 경춘선 | 093106 | 입구 |\n| 151112 | SOiL셀프 | 162100 | 택시승강장 | 161606 | 기타휴게시설 |\n| 161605 | 기사쉼터 | 150103 | 르노코리아정비 | 150303 | 르노코리아 |\n| 101011 | 한스케익 | 150105 | KG정비 | 150305 | KG모빌리티 |\n| 171800 | 인천2호선 | 172500 | 에버라인 | 175000 | 신림선 |\n| 170900 | 서울7호선 | 170400 | 서울2호선 | 172800 | 부산김해경전철 |\n| 172700 | 부산4호선 | 172000 | 대전1호선 | 174200 | 대구3호선 |\n| 160205 | 버스정류장 | 101500 | 딜리버리 | 151305 | KG부품 |\n| 110201 | 이마트 | 110218 | 이마트트레이더스 | 150121 | 렉서스정비 |\n| 150324 | 렉서스 | | | | |\n",
"operationId": "CategoryCodes",
"servers": []
}
},
"/docs/error-codes/webjs": {
"get": {
"tags": [
"WEB(JS)"
],
"summary": "에러 코드",
"description": "| resultCode | message |\n|-----------:|---------|\n| 100 | Result Not Found |\n| 101 | Argument Error |\n| 102 | IMPS Server Error |\n| 300 | Authentication Failed |\n| 301 | Inappropriate URL |\n| 302 | Limit Exceeded |\n| 303 | Unknown Error |\n| 304 | Unknown Error |\n| 305 | Unknown Error |\n| 306 | Unknown Error |\n| 307 | Unknown Error |\n| 308 | Unknown Error |\n| 309 | Unknown Error |\n| 310 | Unknown Error |\n| 311 | Unknown Error |\n| 312 | Unknown Error |\n| 313 | Unknown Error |\n| 314 | Unknown Error |\n| 315 | Unknown Error |\n| 316 | Unknown Error |\n| 317 | Unknown Error |\n| 318 | Unknown Error |\n| 319 | Unknown Error |\n| 320 | Unknown Error |\n| 321 | Unknown Error |\n| 322 | Unknown Error |\n| 323 | Unknown Error |\n| 324 | Unknown Error |\n| 325 | Unknown Error |\n| 326 | Unknown Error |\n| 327 | Unknown Error |\n| 328 | Unknown Error |\n| 329 | Unknown Error |\n| 330 | Unknown Error |\n| 331 | Unknown Error |\n| 332 | Unknown Error |\n| 333 | Unknown Error |\n| 334 | Unknown Error |\n| 335 | Unknown Error |\n| 336 | Unknown Error |\n| 337 | Unknown Error |\n| 338 | Unknown Error |\n| 339 | Unknown Error |\n| 340 | Unknown Error |\n| 341 | Unknown Error |\n| 342 | Unknown Error |\n| 343 | Unknown Error |\n| 344 | Unknown Error |\n| 345 | Unknown Error |\n| 346 | Unknown Error |\n| 347 | Unknown Error |\n| 348 | Unknown Error |\n| 349 | Unknown Error |\n| 350 | Unknown Error |\n| 351 | Unknown Error |\n| 352 | Unknown Error |\n| 353 | Unknown Error |\n| 354 | Unknown Error |\n| 355 | Unknown Error |\n| 356 | Unknown Error |\n| 357 | Unknown Error |\n| 358 | Unknown Error |\n| 359 | Unknown Error |\n| 360 | Unknown Error |\n| 361 | Unknown Error |\n| 362 | Unknown Error |\n| 363 | Unknown Error |\n| 364 | Unknown Error |\n| 365 | Unknown Error |\n| 366 | Unknown Error |\n| 367 | Unknown Error |\n| 368 | Unknown Error |\n| 369 | Unknown Error |\n| 370 | Unknown Error |\n| 371 | Unknown Error |\n| 372 | Unknown Error |\n| 373 | Unknown Error |\n| 374 | Unknown Error |\n| 375 | Unknown Error |\n| 376 | Unknown Error |\n| 377 | Unknown Error |\n| 378 | Unknown Error |\n| 379 | Unknown Error |\n| 380 | Unknown Error |\n| 381 | Unknown Error |\n| 382 | Unknown Error |\n| 383 | Unknown Error |\n| 384 | Unknown Error |\n| 385 | Unknown Error |\n| 386 | Unknown Error |\n| 387 | Unknown Error |\n| 388 | Unknown Error |\n| 389 | Unknown Error |\n| 390 | Unknown Error |\n| 391 | Unknown Error |\n| 392 | Unknown Error |\n| 393 | Unknown Error |\n| 394 | Unknown Error |\n| 395 | Unknown Error |\n| 396 | Unknown Error |\n| 397 | Unknown Error |\n| 398 | Unknown Error |\n| 399 | Unknown Error |\n| 400 | Invalid request parameter or body |\n| 401 | Authentication required |\n| 402 | Unknown Error |\n| 403 | Access denied |\n| 404 | API endpoint not found |\n| 405 | HTTP method not allowed |\n| 406 | Not acceptable response type |\n| 407 | Unknown Error |\n| 408 | Unknown Error |\n| 409 | Request conflict |\n| 410 | Unknown Error |\n| 411 | Unknown Error |\n| 412 | Unknown Error |\n| 413 | Unknown Error |\n| 414 | Unknown Error |\n| 415 | Unsupported content type |\n| 416 | Unknown Error |\n| 417 | Unknown Error |\n| 418 | Unknown Error |\n| 419 | Unknown Error |\n| 420 | Unknown Error |\n| 421 | Unknown Error |\n| 422 | Unknown Error |\n| 423 | Unknown Error |\n| 424 | Unknown Error |\n| 425 | Unknown Error |\n| 426 | Unknown Error |\n| 427 | Unknown Error |\n| 428 | Unknown Error |\n| 429 | Unknown Error |\n| 430 | Unknown Error |\n| 431 | Unknown Error |\n| 432 | Unknown Error |\n| 433 | Unknown Error |\n| 434 | Unknown Error |\n| 435 | Unknown Error |\n| 436 | Unknown Error |\n| 437 | Unknown Error |\n| 438 | Unknown Error |\n| 439 | Unknown Error |\n| 440 | Unknown Error |\n| 441 | Unknown Error |\n| 442 | Unknown Error |\n| 443 | Unknown Error |\n| 444 | Unknown Error |\n| 445 | Unknown Error |\n| 446 | Unknown Error |\n| 447 | Unknown Error |\n| 448 | Unknown Error |\n| 449 | Unknown Error |\n| 450 | Unknown Error |\n| 451 | Unknown Error |\n| 452 | Unknown Error |\n| 453 | Unknown Error |\n| 454 | Unknown Error |\n| 455 | Unknown Error |\n| 456 | Unknown Error |\n| 457 | Unknown Error |\n| 458 | Unknown Error |\n| 459 | Unknown Error |\n| 460 | Unknown Error |\n| 461 | Unknown Error |\n| 462 | Unknown Error |\n| 463 | Unknown Error |\n| 464 | Unknown Error |\n| 465 | Unknown Error |\n| 466 | Unknown Error |\n| 467 | Unknown Error |\n| 468 | Unknown Error |\n| 469 | Unknown Error |\n| 470 | Unknown Error |\n| 471 | Unknown Error |\n| 472 | Unknown Error |\n| 473 | Unknown Error |\n| 474 | Unknown Error |\n| 475 | Unknown Error |\n| 476 | Unknown Error |\n| 477 | Unknown Error |\n| 478 | Unknown Error |\n| 479 | Unknown Error |\n| 480 | Unknown Error |\n| 481 | Unknown Error |\n| 482 | Unknown Error |\n| 483 | Unknown Error |\n| 484 | Unknown Error |\n| 485 | Unknown Error |\n| 486 | Unknown Error |\n| 487 | Unknown Error |\n| 488 | Unknown Error |\n| 489 | Unknown Error |\n| 490 | Unknown Error |\n| 491 | Unknown Error |\n| 492 | Unknown Error |\n| 493 | Unknown Error |\n| 494 | Unknown Error |\n| 495 | Unknown Error |\n| 496 | Unknown Error |\n| 497 | Unknown Error |\n| 498 | Unknown Error |\n| 499 | Unknown Error |\n| 500 | Internal Server Error |\n",
"operationId": "getWebjsErrorCodes",
"servers": []
}
},
"/docs/error-codes/static-map": {
"get": {
"tags": [
"Static Map"
],
"summary": "에러 코드",
"description": "| resultCode | message |\n|-----------:|---------|\n| 100 | Result Not Found |\n| 101 | Argument Error |\n| 102 | IMPS Server Error |\n| 300 | Authentication Failed |\n| 301 | Inappropriate URL |\n| 302 | Limit Exceeded |\n| 303 | Unknown Error |\n| 304 | Unknown Error |\n| 305 | Unknown Error |\n| 306 | Unknown Error |\n| 307 | Unknown Error |\n| 308 | Unknown Error |\n| 309 | Unknown Error |\n| 310 | Unknown Error |\n| 311 | Unknown Error |\n| 312 | Unknown Error |\n| 313 | Unknown Error |\n| 314 | Unknown Error |\n| 315 | Unknown Error |\n| 316 | Unknown Error |\n| 317 | Unknown Error |\n| 318 | Unknown Error |\n| 319 | Unknown Error |\n| 320 | Unknown Error |\n| 321 | Unknown Error |\n| 322 | Unknown Error |\n| 323 | Unknown Error |\n| 324 | Unknown Error |\n| 325 | Unknown Error |\n| 326 | Unknown Error |\n| 327 | Unknown Error |\n| 328 | Unknown Error |\n| 329 | Unknown Error |\n| 330 | Unknown Error |\n| 331 | Unknown Error |\n| 332 | Unknown Error |\n| 333 | Unknown Error |\n| 334 | Unknown Error |\n| 335 | Unknown Error |\n| 336 | Unknown Error |\n| 337 | Unknown Error |\n| 338 | Unknown Error |\n| 339 | Unknown Error |\n| 340 | Unknown Error |\n| 341 | Unknown Error |\n| 342 | Unknown Error |\n| 343 | Unknown Error |\n| 344 | Unknown Error |\n| 345 | Unknown Error |\n| 346 | Unknown Error |\n| 347 | Unknown Error |\n| 348 | Unknown Error |\n| 349 | Unknown Error |\n| 350 | Unknown Error |\n| 351 | Unknown Error |\n| 352 | Unknown Error |\n| 353 | Unknown Error |\n| 354 | Unknown Error |\n| 355 | Unknown Error |\n| 356 | Unknown Error |\n| 357 | Unknown Error |\n| 358 | Unknown Error |\n| 359 | Unknown Error |\n| 360 | Unknown Error |\n| 361 | Unknown Error |\n| 362 | Unknown Error |\n| 363 | Unknown Error |\n| 364 | Unknown Error |\n| 365 | Unknown Error |\n| 366 | Unknown Error |\n| 367 | Unknown Error |\n| 368 | Unknown Error |\n| 369 | Unknown Error |\n| 370 | Unknown Error |\n| 371 | Unknown Error |\n| 372 | Unknown Error |\n| 373 | Unknown Error |\n| 374 | Unknown Error |\n| 375 | Unknown Error |\n| 376 | Unknown Error |\n| 377 | Unknown Error |\n| 378 | Unknown Error |\n| 379 | Unknown Error |\n| 380 | Unknown Error |\n| 381 | Unknown Error |\n| 382 | Unknown Error |\n| 383 | Unknown Error |\n| 384 | Unknown Error |\n| 385 | Unknown Error |\n| 386 | Unknown Error |\n| 387 | Unknown Error |\n| 388 | Unknown Error |\n| 389 | Unknown Error |\n| 390 | Unknown Error |\n| 391 | Unknown Error |\n| 392 | Unknown Error |\n| 393 | Unknown Error |\n| 394 | Unknown Error |\n| 395 | Unknown Error |\n| 396 | Unknown Error |\n| 397 | Unknown Error |\n| 398 | Unknown Error |\n| 399 | Unknown Error |\n| 400 | Invalid request parameter or body |\n| 401 | Authentication required |\n| 402 | Unknown Error |\n| 403 | Access denied |\n| 404 | API endpoint not found |\n| 405 | HTTP method not allowed |\n| 406 | Not acceptable response type |\n| 407 | Unknown Error |\n| 408 | Unknown Error |\n| 409 | Request conflict |\n| 410 | Unknown Error |\n| 411 | Unknown Error |\n| 412 | Unknown Error |\n| 413 | Unknown Error |\n| 414 | Unknown Error |\n| 415 | Unsupported content type |\n| 416 | Unknown Error |\n| 417 | Unknown Error |\n| 418 | Unknown Error |\n| 419 | Unknown Error |\n| 420 | Unknown Error |\n| 421 | Unknown Error |\n| 422 | Unknown Error |\n| 423 | Unknown Error |\n| 424 | Unknown Error |\n| 425 | Unknown Error |\n| 426 | Unknown Error |\n| 427 | Unknown Error |\n| 428 | Unknown Error |\n| 429 | Unknown Error |\n| 430 | Unknown Error |\n| 431 | Unknown Error |\n| 432 | Unknown Error |\n| 433 | Unknown Error |\n| 434 | Unknown Error |\n| 435 | Unknown Error |\n| 436 | Unknown Error |\n| 437 | Unknown Error |\n| 438 | Unknown Error |\n| 439 | Unknown Error |\n| 440 | Unknown Error |\n| 441 | Unknown Error |\n| 442 | Unknown Error |\n| 443 | Unknown Error |\n| 444 | Unknown Error |\n| 445 | Unknown Error |\n| 446 | Unknown Error |\n| 447 | Unknown Error |\n| 448 | Unknown Error |\n| 449 | Unknown Error |\n| 450 | Unknown Error |\n| 451 | Unknown Error |\n| 452 | Unknown Error |\n| 453 | Unknown Error |\n| 454 | Unknown Error |\n| 455 | Unknown Error |\n| 456 | Unknown Error |\n| 457 | Unknown Error |\n| 458 | Unknown Error |\n| 459 | Unknown Error |\n| 460 | Unknown Error |\n| 461 | Unknown Error |\n| 462 | Unknown Error |\n| 463 | Unknown Error |\n| 464 | Unknown Error |\n| 465 | Unknown Error |\n| 466 | Unknown Error |\n| 467 | Unknown Error |\n| 468 | Unknown Error |\n| 469 | Unknown Error |\n| 470 | Unknown Error |\n| 471 | Unknown Error |\n| 472 | Unknown Error |\n| 473 | Unknown Error |\n| 474 | Unknown Error |\n| 475 | Unknown Error |\n| 476 | Unknown Error |\n| 477 | Unknown Error |\n| 478 | Unknown Error |\n| 479 | Unknown Error |\n| 480 | Unknown Error |\n| 481 | Unknown Error |\n| 482 | Unknown Error |\n| 483 | Unknown Error |\n| 484 | Unknown Error |\n| 485 | Unknown Error |\n| 486 | Unknown Error |\n| 487 | Unknown Error |\n| 488 | Unknown Error |\n| 489 | Unknown Error |\n| 490 | Unknown Error |\n| 491 | Unknown Error |\n| 492 | Unknown Error |\n| 493 | Unknown Error |\n| 494 | Unknown Error |\n| 495 | Unknown Error |\n| 496 | Unknown Error |\n| 497 | Unknown Error |\n| 498 | Unknown Error |\n| 499 | Unknown Error |\n| 500 | Internal Server Error |\n",
"operationId": "getStaticMapErrorCodes",
"servers": []
}
},
"/docs/error-codes/place-address": {
"get": {
"tags": [
"장소/주소 검색"
],
"summary": "에러 코드",
"description": "| resultCode | message |\n|-----------:|---------|\n| 100 | Result Not Found |\n| 101 | Argument Error |\n| 102 | IMPS Server Error |\n| 200 | Unknown Error |\n| 201 | Searching for Security POI |\n| 202 | Longitude/Latitude |\n| 203 | Mobile Phone Number |\n| 204 | Invalid Query |\n| 205 | POI not in given Admin |\n| 206 | POI not in given Area |\n| 207 | POI not in given Category |\n| 208 | Neighbor Search Only |\n| 209 | Unknown Error |\n| 210 | Error handling for simulated driving queries |\n| 211 | Unknown Error |\n| 212 | Unknown Error |\n| 213 | Unknown Error |\n| 214 | Unknown Error |\n| 215 | Unknown Error |\n| 216 | Unknown Error |\n| 217 | Unknown Error |\n| 218 | Unknown Error |\n| 219 | Unknown Error |\n| 300 | Authentication Failed |\n| 301 | Inappropriate URL |\n| 302 | Limit Exceeded |\n| 303 | Unknown Error |\n| 304 | Unknown Error |\n| 305 | Unknown Error |\n| 306 | Unknown Error |\n| 307 | Unknown Error |\n| 308 | Unknown Error |\n| 309 | Unknown Error |\n| 310 | Unknown Error |\n| 311 | Unknown Error |\n| 312 | Unknown Error |\n| 313 | Unknown Error |\n| 314 | Unknown Error |\n| 315 | Unknown Error |\n| 316 | Unknown Error |\n| 317 | Unknown Error |\n| 318 | Unknown Error |\n| 319 | Unknown Error |\n| 320 | Unknown Error |\n| 321 | Unknown Error |\n| 322 | Unknown Error |\n| 323 | Unknown Error |\n| 324 | Unknown Error |\n| 325 | Unknown Error |\n| 326 | Unknown Error |\n| 327 | Unknown Error |\n| 328 | Unknown Error |\n| 329 | Unknown Error |\n| 330 | Unknown Error |\n| 331 | Unknown Error |\n| 332 | Unknown Error |\n| 333 | Unknown Error |\n| 334 | Unknown Error |\n| 335 | Unknown Error |\n| 336 | Unknown Error |\n| 337 | Unknown Error |\n| 338 | Unknown Error |\n| 339 | Unknown Error |\n| 340 | Unknown Error |\n| 341 | Unknown Error |\n| 342 | Unknown Error |\n| 343 | Unknown Error |\n| 344 | Unknown Error |\n| 345 | Unknown Error |\n| 346 | Unknown Error |\n| 347 | Unknown Error |\n| 348 | Unknown Error |\n| 349 | Unknown Error |\n| 350 | Unknown Error |\n| 351 | Unknown Error |\n| 352 | Unknown Error |\n| 353 | Unknown Error |\n| 354 | Unknown Error |\n| 355 | Unknown Error |\n| 356 | Unknown Error |\n| 357 | Unknown Error |\n| 358 | Unknown Error |\n| 359 | Unknown Error |\n| 360 | Unknown Error |\n| 361 | Unknown Error |\n| 362 | Unknown Error |\n| 363 | Unknown Error |\n| 364 | Unknown Error |\n| 365 | Unknown Error |\n| 366 | Unknown Error |\n| 367 | Unknown Error |\n| 368 | Unknown Error |\n| 369 | Unknown Error |\n| 370 | Unknown Error |\n| 371 | Unknown Error |\n| 372 | Unknown Error |\n| 373 | Unknown Error |\n| 374 | Unknown Error |\n| 375 | Unknown Error |\n| 376 | Unknown Error |\n| 377 | Unknown Error |\n| 378 | Unknown Error |\n| 379 | Unknown Error |\n| 380 | Unknown Error |\n| 381 | Unknown Error |\n| 382 | Unknown Error |\n| 383 | Unknown Error |\n| 384 | Unknown Error |\n| 385 | Unknown Error |\n| 386 | Unknown Error |\n| 387 | Unknown Error |\n| 388 | Unknown Error |\n| 389 | Unknown Error |\n| 390 | Unknown Error |\n| 391 | Unknown Error |\n| 392 | Unknown Error |\n| 393 | Unknown Error |\n| 394 | Unknown Error |\n| 395 | Unknown Error |\n| 396 | Unknown Error |\n| 397 | Unknown Error |\n| 398 | Unknown Error |\n| 399 | Unknown Error |\n| 400 | Invalid request parameter or body |\n| 401 | Authentication required |\n| 402 | Unknown Error |\n| 403 | Access denied |\n| 404 | API endpoint not found |\n| 405 | HTTP method not allowed |\n| 406 | Not acceptable response type |\n| 407 | Unknown Error |\n| 408 | Unknown Error |\n| 409 | Request conflict |\n| 410 | Unknown Error |\n| 411 | Unknown Error |\n| 412 | Unknown Error |\n| 413 | Unknown Error |\n| 414 | Unknown Error |\n| 415 | Unsupported content type |\n| 416 | Unknown Error |\n| 417 | Unknown Error |\n| 418 | Unknown Error |\n| 419 | Unknown Error |\n| 420 | Unknown Error |\n| 421 | Unknown Error |\n| 422 | Unknown Error |\n| 423 | Unknown Error |\n| 424 | Unknown Error |\n| 425 | Unknown Error |\n| 426 | Unknown Error |\n| 427 | Unknown Error |\n| 428 | Unknown Error |\n| 429 | Unknown Error |\n| 430 | Unknown Error |\n| 431 | Unknown Error |\n| 432 | Unknown Error |\n| 433 | Unknown Error |\n| 434 | Unknown Error |\n| 435 | Unknown Error |\n| 436 | Unknown Error |\n| 437 | Unknown Error |\n| 438 | Unknown Error |\n| 439 | Unknown Error |\n| 440 | Unknown Error |\n| 441 | Unknown Error |\n| 442 | Unknown Error |\n| 443 | Unknown Error |\n| 444 | Unknown Error |\n| 445 | Unknown Error |\n| 446 | Unknown Error |\n| 447 | Unknown Error |\n| 448 | Unknown Error |\n| 449 | Unknown Error |\n| 450 | Unknown Error |\n| 451 | Unknown Error |\n| 452 | Unknown Error |\n| 453 | Unknown Error |\n| 454 | Unknown Error |\n| 455 | Unknown Error |\n| 456 | Unknown Error |\n| 457 | Unknown Error |\n| 458 | Unknown Error |\n| 459 | Unknown Error |\n| 460 | Unknown Error |\n| 461 | Unknown Error |\n| 462 | Unknown Error |\n| 463 | Unknown Error |\n| 464 | Unknown Error |\n| 465 | Unknown Error |\n| 466 | Unknown Error |\n| 467 | Unknown Error |\n| 468 | Unknown Error |\n| 469 | Unknown Error |\n| 470 | Unknown Error |\n| 471 | Unknown Error |\n| 472 | Unknown Error |\n| 473 | Unknown Error |\n| 474 | Unknown Error |\n| 475 | Unknown Error |\n| 476 | Unknown Error |\n| 477 | Unknown Error |\n| 478 | Unknown Error |\n| 479 | Unknown Error |\n| 480 | Unknown Error |\n| 481 | Unknown Error |\n| 482 | Unknown Error |\n| 483 | Unknown Error |\n| 484 | Unknown Error |\n| 485 | Unknown Error |\n| 486 | Unknown Error |\n| 487 | Unknown Error |\n| 488 | Unknown Error |\n| 489 | Unknown Error |\n| 490 | Unknown Error |\n| 491 | Unknown Error |\n| 492 | Unknown Error |\n| 493 | Unknown Error |\n| 494 | Unknown Error |\n| 495 | Unknown Error |\n| 496 | Unknown Error |\n| 497 | Unknown Error |\n| 498 | Unknown Error |\n| 499 | Unknown Error |\n| 500 | Internal Server Error |\n",
"operationId": "getPlaceAddressErrorCodes",
"servers": []
}
},
"/docs/error-codes/geocoding": {
"get": {
"tags": [
"지오코딩"
],
"summary": "에러 코드",
"description": "| resultCode | message |\n|-----------:|---------|\n| 100 | Result Not Found |\n| 101 | Argument Error |\n| 102 | IMPS Server Error |\n| 200 | Unknown Error |\n| 201 | Searching for Security POI |\n| 202 | Longitude/Latitude |\n| 203 | Mobile Phone Number |\n| 204 | Invalid Query |\n| 205 | POI not in given Admin |\n| 206 | POI not in given Area |\n| 207 | POI not in given Category |\n| 208 | Neighbor Search Only |\n| 209 | Unknown Error |\n| 210 | Error handling for simulated driving queries |\n| 211 | Unknown Error |\n| 212 | Unknown Error |\n| 213 | Unknown Error |\n| 214 | Unknown Error |\n| 215 | Unknown Error |\n| 216 | Unknown Error |\n| 217 | Unknown Error |\n| 218 | Unknown Error |\n| 219 | Unknown Error |\n| 300 | Authentication Failed |\n| 301 | Inappropriate URL |\n| 302 | Limit Exceeded |\n| 303 | Unknown Error |\n| 304 | Unknown Error |\n| 305 | Unknown Error |\n| 306 | Unknown Error |\n| 307 | Unknown Error |\n| 308 | Unknown Error |\n| 309 | Unknown Error |\n| 310 | Unknown Error |\n| 311 | Unknown Error |\n| 312 | Unknown Error |\n| 313 | Unknown Error |\n| 314 | Unknown Error |\n| 315 | Unknown Error |\n| 316 | Unknown Error |\n| 317 | Unknown Error |\n| 318 | Unknown Error |\n| 319 | Unknown Error |\n| 320 | Unknown Error |\n| 321 | Unknown Error |\n| 322 | Unknown Error |\n| 323 | Unknown Error |\n| 324 | Unknown Error |\n| 325 | Unknown Error |\n| 326 | Unknown Error |\n| 327 | Unknown Error |\n| 328 | Unknown Error |\n| 329 | Unknown Error |\n| 330 | Unknown Error |\n| 331 | Unknown Error |\n| 332 | Unknown Error |\n| 333 | Unknown Error |\n| 334 | Unknown Error |\n| 335 | Unknown Error |\n| 336 | Unknown Error |\n| 337 | Unknown Error |\n| 338 | Unknown Error |\n| 339 | Unknown Error |\n| 340 | Unknown Error |\n| 341 | Unknown Error |\n| 342 | Unknown Error |\n| 343 | Unknown Error |\n| 344 | Unknown Error |\n| 345 | Unknown Error |\n| 346 | Unknown Error |\n| 347 | Unknown Error |\n| 348 | Unknown Error |\n| 349 | Unknown Error |\n| 350 | Unknown Error |\n| 351 | Unknown Error |\n| 352 | Unknown Error |\n| 353 | Unknown Error |\n| 354 | Unknown Error |\n| 355 | Unknown Error |\n| 356 | Unknown Error |\n| 357 | Unknown Error |\n| 358 | Unknown Error |\n| 359 | Unknown Error |\n| 360 | Unknown Error |\n| 361 | Unknown Error |\n| 362 | Unknown Error |\n| 363 | Unknown Error |\n| 364 | Unknown Error |\n| 365 | Unknown Error |\n| 366 | Unknown Error |\n| 367 | Unknown Error |\n| 368 | Unknown Error |\n| 369 | Unknown Error |\n| 370 | Unknown Error |\n| 371 | Unknown Error |\n| 372 | Unknown Error |\n| 373 | Unknown Error |\n| 374 | Unknown Error |\n| 375 | Unknown Error |\n| 376 | Unknown Error |\n| 377 | Unknown Error |\n| 378 | Unknown Error |\n| 379 | Unknown Error |\n| 380 | Unknown Error |\n| 381 | Unknown Error |\n| 382 | Unknown Error |\n| 383 | Unknown Error |\n| 384 | Unknown Error |\n| 385 | Unknown Error |\n| 386 | Unknown Error |\n| 387 | Unknown Error |\n| 388 | Unknown Error |\n| 389 | Unknown Error |\n| 390 | Unknown Error |\n| 391 | Unknown Error |\n| 392 | Unknown Error |\n| 393 | Unknown Error |\n| 394 | Unknown Error |\n| 395 | Unknown Error |\n| 396 | Unknown Error |\n| 397 | Unknown Error |\n| 398 | Unknown Error |\n| 399 | Unknown Error |\n| 400 | Invalid request parameter or body |\n| 401 | Authentication required |\n| 402 | Unknown Error |\n| 403 | Access denied |\n| 404 | API endpoint not found |\n| 405 | HTTP method not allowed |\n| 406 | Not acceptable response type |\n| 407 | Unknown Error |\n| 408 | Unknown Error |\n| 409 | Request conflict |\n| 410 | Unknown Error |\n| 411 | Unknown Error |\n| 412 | Unknown Error |\n| 413 | Unknown Error |\n| 414 | Unknown Error |\n| 415 | Unsupported content type |\n| 416 | Unknown Error |\n| 417 | Unknown Error |\n| 418 | Unknown Error |\n| 419 | Unknown Error |\n| 420 | Unknown Error |\n| 421 | Unknown Error |\n| 422 | Unknown Error |\n| 423 | Unknown Error |\n| 424 | Unknown Error |\n| 425 | Unknown Error |\n| 426 | Unknown Error |\n| 427 | Unknown Error |\n| 428 | Unknown Error |\n| 429 | Unknown Error |\n| 430 | Unknown Error |\n| 431 | Unknown Error |\n| 432 | Unknown Error |\n| 433 | Unknown Error |\n| 434 | Unknown Error |\n| 435 | Unknown Error |\n| 436 | Unknown Error |\n| 437 | Unknown Error |\n| 438 | Unknown Error |\n| 439 | Unknown Error |\n| 440 | Unknown Error |\n| 441 | Unknown Error |\n| 442 | Unknown Error |\n| 443 | Unknown Error |\n| 444 | Unknown Error |\n| 445 | Unknown Error |\n| 446 | Unknown Error |\n| 447 | Unknown Error |\n| 448 | Unknown Error |\n| 449 | Unknown Error |\n| 450 | Unknown Error |\n| 451 | Unknown Error |\n| 452 | Unknown Error |\n| 453 | Unknown Error |\n| 454 | Unknown Error |\n| 455 | Unknown Error |\n| 456 | Unknown Error |\n| 457 | Unknown Error |\n| 458 | Unknown Error |\n| 459 | Unknown Error |\n| 460 | Unknown Error |\n| 461 | Unknown Error |\n| 462 | Unknown Error |\n| 463 | Unknown Error |\n| 464 | Unknown Error |\n| 465 | Unknown Error |\n| 466 | Unknown Error |\n| 467 | Unknown Error |\n| 468 | Unknown Error |\n| 469 | Unknown Error |\n| 470 | Unknown Error |\n| 471 | Unknown Error |\n| 472 | Unknown Error |\n| 473 | Unknown Error |\n| 474 | Unknown Error |\n| 475 | Unknown Error |\n| 476 | Unknown Error |\n| 477 | Unknown Error |\n| 478 | Unknown Error |\n| 479 | Unknown Error |\n| 480 | Unknown Error |\n| 481 | Unknown Error |\n| 482 | Unknown Error |\n| 483 | Unknown Error |\n| 484 | Unknown Error |\n| 485 | Unknown Error |\n| 486 | Unknown Error |\n| 487 | Unknown Error |\n| 488 | Unknown Error |\n| 489 | Unknown Error |\n| 490 | Unknown Error |\n| 491 | Unknown Error |\n| 492 | Unknown Error |\n| 493 | Unknown Error |\n| 494 | Unknown Error |\n| 495 | Unknown Error |\n| 496 | Unknown Error |\n| 497 | Unknown Error |\n| 498 | Unknown Error |\n| 499 | Unknown Error |\n| 500 | Internal Server Error |\n",
"operationId": "getGeocodingErrorCodes",
"servers": []
}
},
"/docs/error-codes/geo": {
"get": {
"tags": [
"공간 검색"
],
"summary": "에러 코드",
"description": "| resultCode | message |\n|-----------:|---------|\n| 100 | Result Not Found |\n| 101 | Argument Error |\n| 102 | IMPS Server Error |\n| 200 | Unknown Error |\n| 201 | Searching for Security POI |\n| 202 | Longitude/Latitude |\n| 203 | Mobile Phone Number |\n| 204 | Invalid Query |\n| 205 | POI not in given Admin |\n| 206 | POI not in given Area |\n| 207 | POI not in given Category |\n| 208 | Neighbor Search Only |\n| 209 | Unknown Error |\n| 210 | Error handling for simulated driving queries |\n| 211 | Unknown Error |\n| 212 | Unknown Error |\n| 213 | Unknown Error |\n| 214 | Unknown Error |\n| 215 | Unknown Error |\n| 216 | Unknown Error |\n| 217 | Unknown Error |\n| 218 | Unknown Error |\n| 219 | Unknown Error |\n| 300 | Authentication Failed |\n| 301 | Inappropriate URL |\n| 302 | Limit Exceeded |\n| 303 | Unknown Error |\n| 304 | Unknown Error |\n| 305 | Unknown Error |\n| 306 | Unknown Error |\n| 307 | Unknown Error |\n| 308 | Unknown Error |\n| 309 | Unknown Error |\n| 310 | Unknown Error |\n| 311 | Unknown Error |\n| 312 | Unknown Error |\n| 313 | Unknown Error |\n| 314 | Unknown Error |\n| 315 | Unknown Error |\n| 316 | Unknown Error |\n| 317 | Unknown Error |\n| 318 | Unknown Error |\n| 319 | Unknown Error |\n| 320 | Unknown Error |\n| 321 | Unknown Error |\n| 322 | Unknown Error |\n| 323 | Unknown Error |\n| 324 | Unknown Error |\n| 325 | Unknown Error |\n| 326 | Unknown Error |\n| 327 | Unknown Error |\n| 328 | Unknown Error |\n| 329 | Unknown Error |\n| 330 | Unknown Error |\n| 331 | Unknown Error |\n| 332 | Unknown Error |\n| 333 | Unknown Error |\n| 334 | Unknown Error |\n| 335 | Unknown Error |\n| 336 | Unknown Error |\n| 337 | Unknown Error |\n| 338 | Unknown Error |\n| 339 | Unknown Error |\n| 340 | Unknown Error |\n| 341 | Unknown Error |\n| 342 | Unknown Error |\n| 343 | Unknown Error |\n| 344 | Unknown Error |\n| 345 | Unknown Error |\n| 346 | Unknown Error |\n| 347 | Unknown Error |\n| 348 | Unknown Error |\n| 349 | Unknown Error |\n| 350 | Unknown Error |\n| 351 | Unknown Error |\n| 352 | Unknown Error |\n| 353 | Unknown Error |\n| 354 | Unknown Error |\n| 355 | Unknown Error |\n| 356 | Unknown Error |\n| 357 | Unknown Error |\n| 358 | Unknown Error |\n| 359 | Unknown Error |\n| 360 | Unknown Error |\n| 361 | Unknown Error |\n| 362 | Unknown Error |\n| 363 | Unknown Error |\n| 364 | Unknown Error |\n| 365 | Unknown Error |\n| 366 | Unknown Error |\n| 367 | Unknown Error |\n| 368 | Unknown Error |\n| 369 | Unknown Error |\n| 370 | Unknown Error |\n| 371 | Unknown Error |\n| 372 | Unknown Error |\n| 373 | Unknown Error |\n| 374 | Unknown Error |\n| 375 | Unknown Error |\n| 376 | Unknown Error |\n| 377 | Unknown Error |\n| 378 | Unknown Error |\n| 379 | Unknown Error |\n| 380 | Unknown Error |\n| 381 | Unknown Error |\n| 382 | Unknown Error |\n| 383 | Unknown Error |\n| 384 | Unknown Error |\n| 385 | Unknown Error |\n| 386 | Unknown Error |\n| 387 | Unknown Error |\n| 388 | Unknown Error |\n| 389 | Unknown Error |\n| 390 | Unknown Error |\n| 391 | Unknown Error |\n| 392 | Unknown Error |\n| 393 | Unknown Error |\n| 394 | Unknown Error |\n| 395 | Unknown Error |\n| 396 | Unknown Error |\n| 397 | Unknown Error |\n| 398 | Unknown Error |\n| 399 | Unknown Error |\n| 400 | Invalid request parameter or body |\n| 401 | Authentication required |\n| 402 | Unknown Error |\n| 403 | Access denied |\n| 404 | API endpoint not found |\n| 405 | HTTP method not allowed |\n| 406 | Not acceptable response type |\n| 407 | Unknown Error |\n| 408 | Unknown Error |\n| 409 | Request conflict |\n| 410 | Unknown Error |\n| 411 | Unknown Error |\n| 412 | Unknown Error |\n| 413 | Unknown Error |\n| 414 | Unknown Error |\n| 415 | Unsupported content type |\n| 416 | Unknown Error |\n| 417 | Unknown Error |\n| 418 | Unknown Error |\n| 419 | Unknown Error |\n| 420 | Unknown Error |\n| 421 | Unknown Error |\n| 422 | Unknown Error |\n| 423 | Unknown Error |\n| 424 | Unknown Error |\n| 425 | Unknown Error |\n| 426 | Unknown Error |\n| 427 | Unknown Error |\n| 428 | Unknown Error |\n| 429 | Unknown Error |\n| 430 | Unknown Error |\n| 431 | Unknown Error |\n| 432 | Unknown Error |\n| 433 | Unknown Error |\n| 434 | Unknown Error |\n| 435 | Unknown Error |\n| 436 | Unknown Error |\n| 437 | Unknown Error |\n| 438 | Unknown Error |\n| 439 | Unknown Error |\n| 440 | Unknown Error |\n| 441 | Unknown Error |\n| 442 | Unknown Error |\n| 443 | Unknown Error |\n| 444 | Unknown Error |\n| 445 | Unknown Error |\n| 446 | Unknown Error |\n| 447 | Unknown Error |\n| 448 | Unknown Error |\n| 449 | Unknown Error |\n| 450 | Unknown Error |\n| 451 | Unknown Error |\n| 452 | Unknown Error |\n| 453 | Unknown Error |\n| 454 | Unknown Error |\n| 455 | Unknown Error |\n| 456 | Unknown Error |\n| 457 | Unknown Error |\n| 458 | Unknown Error |\n| 459 | Unknown Error |\n| 460 | Unknown Error |\n| 461 | Unknown Error |\n| 462 | Unknown Error |\n| 463 | Unknown Error |\n| 464 | Unknown Error |\n| 465 | Unknown Error |\n| 466 | Unknown Error |\n| 467 | Unknown Error |\n| 468 | Unknown Error |\n| 469 | Unknown Error |\n| 470 | Unknown Error |\n| 471 | Unknown Error |\n| 472 | Unknown Error |\n| 473 | Unknown Error |\n| 474 | Unknown Error |\n| 475 | Unknown Error |\n| 476 | Unknown Error |\n| 477 | Unknown Error |\n| 478 | Unknown Error |\n| 479 | Unknown Error |\n| 480 | Unknown Error |\n| 481 | Unknown Error |\n| 482 | Unknown Error |\n| 483 | Unknown Error |\n| 484 | Unknown Error |\n| 485 | Unknown Error |\n| 486 | Unknown Error |\n| 487 | Unknown Error |\n| 488 | Unknown Error |\n| 489 | Unknown Error |\n| 490 | Unknown Error |\n| 491 | Unknown Error |\n| 492 | Unknown Error |\n| 493 | Unknown Error |\n| 494 | Unknown Error |\n| 495 | Unknown Error |\n| 496 | Unknown Error |\n| 497 | Unknown Error |\n| 498 | Unknown Error |\n| 499 | Unknown Error |\n| 500 | Internal Server Error |\n",
"operationId": "getGeoErrorCodes",
"servers": []
}
},
"/docs/error-codes/w3w": {
"get": {
"tags": [
"W3W"
],
"summary": "에러 코드",
"description": "| resultCode | message |\n|-----------:|---------|\n| 100 | Result Not Found |\n| 101 | Argument Error |\n| 102 | IMPS Server Error |\n| 220 | Invalid or non-existent 3 word address |\n| 221 | Non-existent 3 word suggestions |\n| 222 | What 3 words API Error |\n| 223 | Unknown Error |\n| 224 | Unknown Error |\n| 225 | Unknown Error |\n| 226 | Unknown Error |\n| 227 | Unknown Error |\n| 228 | Unknown Error |\n| 229 | Unknown Error |\n| 300 | Authentication Failed |\n| 301 | Inappropriate URL |\n| 302 | Limit Exceeded |\n| 303 | Unknown Error |\n| 304 | Unknown Error |\n| 305 | Unknown Error |\n| 306 | Unknown Error |\n| 307 | Unknown Error |\n| 308 | Unknown Error |\n| 309 | Unknown Error |\n| 310 | Unknown Error |\n| 311 | Unknown Error |\n| 312 | Unknown Error |\n| 313 | Unknown Error |\n| 314 | Unknown Error |\n| 315 | Unknown Error |\n| 316 | Unknown Error |\n| 317 | Unknown Error |\n| 318 | Unknown Error |\n| 319 | Unknown Error |\n| 320 | Unknown Error |\n| 321 | Unknown Error |\n| 322 | Unknown Error |\n| 323 | Unknown Error |\n| 324 | Unknown Error |\n| 325 | Unknown Error |\n| 326 | Unknown Error |\n| 327 | Unknown Error |\n| 328 | Unknown Error |\n| 329 | Unknown Error |\n| 330 | Unknown Error |\n| 331 | Unknown Error |\n| 332 | Unknown Error |\n| 333 | Unknown Error |\n| 334 | Unknown Error |\n| 335 | Unknown Error |\n| 336 | Unknown Error |\n| 337 | Unknown Error |\n| 338 | Unknown Error |\n| 339 | Unknown Error |\n| 340 | Unknown Error |\n| 341 | Unknown Error |\n| 342 | Unknown Error |\n| 343 | Unknown Error |\n| 344 | Unknown Error |\n| 345 | Unknown Error |\n| 346 | Unknown Error |\n| 347 | Unknown Error |\n| 348 | Unknown Error |\n| 349 | Unknown Error |\n| 350 | Unknown Error |\n| 351 | Unknown Error |\n| 352 | Unknown Error |\n| 353 | Unknown Error |\n| 354 | Unknown Error |\n| 355 | Unknown Error |\n| 356 | Unknown Error |\n| 357 | Unknown Error |\n| 358 | Unknown Error |\n| 359 | Unknown Error |\n| 360 | Unknown Error |\n| 361 | Unknown Error |\n| 362 | Unknown Error |\n| 363 | Unknown Error |\n| 364 | Unknown Error |\n| 365 | Unknown Error |\n| 366 | Unknown Error |\n| 367 | Unknown Error |\n| 368 | Unknown Error |\n| 369 | Unknown Error |\n| 370 | Unknown Error |\n| 371 | Unknown Error |\n| 372 | Unknown Error |\n| 373 | Unknown Error |\n| 374 | Unknown Error |\n| 375 | Unknown Error |\n| 376 | Unknown Error |\n| 377 | Unknown Error |\n| 378 | Unknown Error |\n| 379 | Unknown Error |\n| 380 | Unknown Error |\n| 381 | Unknown Error |\n| 382 | Unknown Error |\n| 383 | Unknown Error |\n| 384 | Unknown Error |\n| 385 | Unknown Error |\n| 386 | Unknown Error |\n| 387 | Unknown Error |\n| 388 | Unknown Error |\n| 389 | Unknown Error |\n| 390 | Unknown Error |\n| 391 | Unknown Error |\n| 392 | Unknown Error |\n| 393 | Unknown Error |\n| 394 | Unknown Error |\n| 395 | Unknown Error |\n| 396 | Unknown Error |\n| 397 | Unknown Error |\n| 398 | Unknown Error |\n| 399 | Unknown Error |\n| 400 | Invalid request parameter or body |\n| 401 | Authentication required |\n| 402 | Unknown Error |\n| 403 | Access denied |\n| 404 | API endpoint not found |\n| 405 | HTTP method not allowed |\n| 406 | Not acceptable response type |\n| 407 | Unknown Error |\n| 408 | Unknown Error |\n| 409 | Request conflict |\n| 410 | Unknown Error |\n| 411 | Unknown Error |\n| 412 | Unknown Error |\n| 413 | Unknown Error |\n| 414 | Unknown Error |\n| 415 | Unsupported content type |\n| 416 | Unknown Error |\n| 417 | Unknown Error |\n| 418 | Unknown Error |\n| 419 | Unknown Error |\n| 420 | Unknown Error |\n| 421 | Unknown Error |\n| 422 | Unknown Error |\n| 423 | Unknown Error |\n| 424 | Unknown Error |\n| 425 | Unknown Error |\n| 426 | Unknown Error |\n| 427 | Unknown Error |\n| 428 | Unknown Error |\n| 429 | Unknown Error |\n| 430 | Unknown Error |\n| 431 | Unknown Error |\n| 432 | Unknown Error |\n| 433 | Unknown Error |\n| 434 | Unknown Error |\n| 435 | Unknown Error |\n| 436 | Unknown Error |\n| 437 | Unknown Error |\n| 438 | Unknown Error |\n| 439 | Unknown Error |\n| 440 | Unknown Error |\n| 441 | Unknown Error |\n| 442 | Unknown Error |\n| 443 | Unknown Error |\n| 444 | Unknown Error |\n| 445 | Unknown Error |\n| 446 | Unknown Error |\n| 447 | Unknown Error |\n| 448 | Unknown Error |\n| 449 | Unknown Error |\n| 450 | Unknown Error |\n| 451 | Unknown Error |\n| 452 | Unknown Error |\n| 453 | Unknown Error |\n| 454 | Unknown Error |\n| 455 | Unknown Error |\n| 456 | Unknown Error |\n| 457 | Unknown Error |\n| 458 | Unknown Error |\n| 459 | Unknown Error |\n| 460 | Unknown Error |\n| 461 | Unknown Error |\n| 462 | Unknown Error |\n| 463 | Unknown Error |\n| 464 | Unknown Error |\n| 465 | Unknown Error |\n| 466 | Unknown Error |\n| 467 | Unknown Error |\n| 468 | Unknown Error |\n| 469 | Unknown Error |\n| 470 | Unknown Error |\n| 471 | Unknown Error |\n| 472 | Unknown Error |\n| 473 | Unknown Error |\n| 474 | Unknown Error |\n| 475 | Unknown Error |\n| 476 | Unknown Error |\n| 477 | Unknown Error |\n| 478 | Unknown Error |\n| 479 | Unknown Error |\n| 480 | Unknown Error |\n| 481 | Unknown Error |\n| 482 | Unknown Error |\n| 483 | Unknown Error |\n| 484 | Unknown Error |\n| 485 | Unknown Error |\n| 486 | Unknown Error |\n| 487 | Unknown Error |\n| 488 | Unknown Error |\n| 489 | Unknown Error |\n| 490 | Unknown Error |\n| 491 | Unknown Error |\n| 492 | Unknown Error |\n| 493 | Unknown Error |\n| 494 | Unknown Error |\n| 495 | Unknown Error |\n| 496 | Unknown Error |\n| 497 | Unknown Error |\n| 498 | Unknown Error |\n| 499 | Unknown Error |\n| 500 | Internal Server Error |\n",
"operationId": "getW3WErrorCodes",
"servers": []
}
},
"/docs/error-codes/navigation": {
"get": {
"tags": [
"탐색"
],
"summary": "에러 코드",
"description": "| resultCode | message |\n|-----------:|---------|\n| 100 | Result Not Found |\n| 101 | Argument Error |\n| 102 | IMPS Server Error |\n| 300 | Authentication Failed |\n| 301 | Inappropriate URL |\n| 302 | Limit Exceeded |\n| 303 | Unknown Error |\n| 304 | Unknown Error |\n| 305 | Unknown Error |\n| 306 | Unknown Error |\n| 307 | Unknown Error |\n| 308 | Unknown Error |\n| 309 | Unknown Error |\n| 310 | Unknown Error |\n| 311 | Unknown Error |\n| 312 | Unknown Error |\n| 313 | Unknown Error |\n| 314 | Unknown Error |\n| 315 | Unknown Error |\n| 316 | Unknown Error |\n| 317 | Unknown Error |\n| 318 | Unknown Error |\n| 319 | Unknown Error |\n| 320 | Unknown Error |\n| 321 | Unknown Error |\n| 322 | Unknown Error |\n| 323 | Unknown Error |\n| 324 | Unknown Error |\n| 325 | Unknown Error |\n| 326 | Unknown Error |\n| 327 | Unknown Error |\n| 328 | Unknown Error |\n| 329 | Unknown Error |\n| 330 | Unknown Error |\n| 331 | Unknown Error |\n| 332 | Unknown Error |\n| 333 | Unknown Error |\n| 334 | Unknown Error |\n| 335 | Unknown Error |\n| 336 | Unknown Error |\n| 337 | Unknown Error |\n| 338 | Unknown Error |\n| 339 | Unknown Error |\n| 340 | Unknown Error |\n| 341 | Unknown Error |\n| 342 | Unknown Error |\n| 343 | Unknown Error |\n| 344 | Unknown Error |\n| 345 | Unknown Error |\n| 346 | Unknown Error |\n| 347 | Unknown Error |\n| 348 | Unknown Error |\n| 349 | Unknown Error |\n| 350 | Unknown Error |\n| 351 | Unknown Error |\n| 352 | Unknown Error |\n| 353 | Unknown Error |\n| 354 | Unknown Error |\n| 355 | Unknown Error |\n| 356 | Unknown Error |\n| 357 | Unknown Error |\n| 358 | Unknown Error |\n| 359 | Unknown Error |\n| 360 | Unknown Error |\n| 361 | Unknown Error |\n| 362 | Unknown Error |\n| 363 | Unknown Error |\n| 364 | Unknown Error |\n| 365 | Unknown Error |\n| 366 | Unknown Error |\n| 367 | Unknown Error |\n| 368 | Unknown Error |\n| 369 | Unknown Error |\n| 370 | Unknown Error |\n| 371 | Unknown Error |\n| 372 | Unknown Error |\n| 373 | Unknown Error |\n| 374 | Unknown Error |\n| 375 | Unknown Error |\n| 376 | Unknown Error |\n| 377 | Unknown Error |\n| 378 | Unknown Error |\n| 379 | Unknown Error |\n| 380 | Unknown Error |\n| 381 | Unknown Error |\n| 382 | Unknown Error |\n| 383 | Unknown Error |\n| 384 | Unknown Error |\n| 385 | Unknown Error |\n| 386 | Unknown Error |\n| 387 | Unknown Error |\n| 388 | Unknown Error |\n| 389 | Unknown Error |\n| 390 | Unknown Error |\n| 391 | Unknown Error |\n| 392 | Unknown Error |\n| 393 | Unknown Error |\n| 394 | Unknown Error |\n| 395 | Unknown Error |\n| 396 | Unknown Error |\n| 397 | Unknown Error |\n| 398 | Unknown Error |\n| 399 | Unknown Error |\n| 400 | Invalid request parameter or body |\n| 401 | Authentication required |\n| 402 | Unknown Error |\n| 403 | Access denied |\n| 404 | API endpoint not found |\n| 405 | HTTP method not allowed |\n| 406 | Not acceptable response type |\n| 407 | Unknown Error |\n| 408 | Unknown Error |\n| 409 | Request conflict |\n| 410 | Unknown Error |\n| 411 | Unknown Error |\n| 412 | Unknown Error |\n| 413 | Unknown Error |\n| 414 | Unknown Error |\n| 415 | Unsupported content type |\n| 416 | Unknown Error |\n| 417 | Unknown Error |\n| 418 | Unknown Error |\n| 419 | Unknown Error |\n| 420 | Unknown Error |\n| 421 | Unknown Error |\n| 422 | Unknown Error |\n| 423 | Unknown Error |\n| 424 | Unknown Error |\n| 425 | Unknown Error |\n| 426 | Unknown Error |\n| 427 | Unknown Error |\n| 428 | Unknown Error |\n| 429 | Unknown Error |\n| 430 | Unknown Error |\n| 431 | Unknown Error |\n| 432 | Unknown Error |\n| 433 | Unknown Error |\n| 434 | Unknown Error |\n| 435 | Unknown Error |\n| 436 | Unknown Error |\n| 437 | Unknown Error |\n| 438 | Unknown Error |\n| 439 | Unknown Error |\n| 440 | Unknown Error |\n| 441 | Unknown Error |\n| 442 | Unknown Error |\n| 443 | Unknown Error |\n| 444 | Unknown Error |\n| 445 | Unknown Error |\n| 446 | Unknown Error |\n| 447 | Unknown Error |\n| 448 | Unknown Error |\n| 449 | Unknown Error |\n| 450 | Unknown Error |\n| 451 | Unknown Error |\n| 452 | Unknown Error |\n| 453 | Unknown Error |\n| 454 | Unknown Error |\n| 455 | Unknown Error |\n| 456 | Unknown Error |\n| 457 | Unknown Error |\n| 458 | Unknown Error |\n| 459 | Unknown Error |\n| 460 | Unknown Error |\n| 461 | Unknown Error |\n| 462 | Unknown Error |\n| 463 | Unknown Error |\n| 464 | Unknown Error |\n| 465 | Unknown Error |\n| 466 | Unknown Error |\n| 467 | Unknown Error |\n| 468 | Unknown Error |\n| 469 | Unknown Error |\n| 470 | Unknown Error |\n| 471 | Unknown Error |\n| 472 | Unknown Error |\n| 473 | Unknown Error |\n| 474 | Unknown Error |\n| 475 | Unknown Error |\n| 476 | Unknown Error |\n| 477 | Unknown Error |\n| 478 | Unknown Error |\n| 479 | Unknown Error |\n| 480 | Unknown Error |\n| 481 | Unknown Error |\n| 482 | Unknown Error |\n| 483 | Unknown Error |\n| 484 | Unknown Error |\n| 485 | Unknown Error |\n| 486 | Unknown Error |\n| 487 | Unknown Error |\n| 488 | Unknown Error |\n| 489 | Unknown Error |\n| 490 | Unknown Error |\n| 491 | Unknown Error |\n| 492 | Unknown Error |\n| 493 | Unknown Error |\n| 494 | Unknown Error |\n| 495 | Unknown Error |\n| 496 | Unknown Error |\n| 497 | Unknown Error |\n| 498 | Unknown Error |\n| 499 | Unknown Error |\n| 500 | Internal Server Error |\n| 501 | Navigation Fail |\n| 502 | Apply Smart Re-navigation |\n| 503 | Canceled navigation by user |\n| 504 | Error due to Checksum |\n| 505 | Navigation fails for all routes |\n| 506 | Unknown Error |\n| 507 | Unknown Error |\n| 508 | Unknown Error |\n| 509 | Unknown Error |\n| 510 | Wrong Parameter |\n| 511 | Unknown Error |\n| 512 | Unknown Error |\n| 513 | Unknown Error |\n| 514 | Unknown Error |\n| 515 | Unknown Error |\n| 516 | Unknown Error |\n| 517 | Memory allocation failure |\n| 518 | File open failure |\n| 519 | File read failure |\n| 520 | File write failure |\n| 521 | Socket connection failure |\n| 522 | Unknown Error |\n| 523 | Unknown Error |\n| 524 | Unknown Error |\n| 525 | Unknown Error |\n| 526 | Unknown Error |\n| 527 | Unknown Error |\n| 528 | Unknown Error |\n| 529 | Unknown Error |\n| 530 | Unknown Error |\n| 531 | Unknown Error |\n| 532 | Request parameter is invalid |\n| 533 | The starting point is not selected, or the wrong starting point |\n| 534 | Destination is not selected or wrong destination |\n| 535 | Wrong stopover |\n| 536 | Link Projection failure |\n| 537 | Exceeding the navigational distance (1000km, walking navigation: 20km) |\n| 538 | Exceeds the number of expandable nodes |\n| 539 | Expansion failure |\n| 540 | Expansion failure due to inactivity or traffic control |\n| 541 | Expansion failure due to vehicle height/weight restrictions near the starting point |\n| 542 | Expansion failed due to a part-time curfew near the departure point |\n| 543 | The destination is a physical island road, and there are no established ferry routes |\n| 544 | The departure or destination is a logical (transportation) island, and there are more than one destination |\n| 545 | Unknown Error |\n| 546 | Unknown Error |\n| 547 | Unknown Error |\n| 548 | node Heap Size is Max |\n| 549 | node does not exist (Search FW) |\n| 550 | node does not exist (Search FW in Main Loop RoutePlanL) |\n| 551 | node does not exist (Search BW) |\n| 552 | node does not exist (Search BW in Main Loop RoutePlanL) |\n| 553 | node does not exist (searchOnedirection) |\n| 554 | node does not exist (searchOnedirection in Main Loop) |\n| 555 | In check_force_restriction_fw, when there is no restriction on the progress direction && Not direction search && HP_NOPASSING |\n| 556 | When check_force_restriction_fw passes entry/exit restriction |\n| 557 | In check_force_restriction_bw, the forward direction is backwards, the disadvantage of the bidirectional link is U-turn, when the entry/exit restriction is passed. |\n| 558 | node does not exist (Search FW in Main Loop RoutePlanU) |\n| 559 | node does not exist (Search BW in Main Loop RoutePlanU) |\n| 560 | Unknown Error |\n| 561 | Unknown Error |\n| 562 | Unknown Error |\n| 563 | Unknown Error |\n| 564 | Unknown Error |\n| 565 | Unknown Error |\n| 566 | Unknown Error |\n| 567 | Unknown Error |\n| 568 | Unknown Error |\n| 569 | Unknown Error |\n| 570 | Unknown Error |\n| 571 | Unknown Error |\n| 572 | Unknown Error |\n| 573 | Unknown Error |\n| 574 | Unknown Error |\n| 575 | Unknown Error |\n| 576 | Unknown Error |\n| 577 | Unknown Error |\n| 578 | Unknown Error |\n| 579 | Unknown Error |\n| 580 | Unknown Error |\n| 581 | Unknown Error |\n| 582 | Unknown Error |\n| 583 | Unknown Error |\n| 584 | Unknown Error |\n| 585 | Unknown Error |\n| 586 | Unknown Error |\n| 587 | Unknown Error |\n| 588 | Unknown Error |\n| 589 | Unknown Error |\n| 590 | Unknown Error |\n| 591 | Unknown Error |\n| 592 | Unknown Error |\n| 593 | Unknown Error |\n| 594 | Unknown Error |\n| 595 | Unknown Error |\n| 596 | Unknown Error |\n| 597 | Unknown Error |\n| 598 | Unknown Error |\n| 599 | Unknown Error |\n",
"operationId": "getNavigationErrorCodes",
"servers": []
}
},
"/docs/error-codes/optimize": {
"get": {
"tags": [
"최적화"
],
"summary": "에러 코드",
"description": "| resultCode | message |\n|-----------:|---------|\n| 100 | Result Not Found |\n| 101 | Argument Error |\n| 102 | IMPS Server Error |\n| 300 | Authentication Failed |\n| 301 | Inappropriate URL |\n| 302 | Limit Exceeded |\n| 303 | Unknown Error |\n| 304 | Unknown Error |\n| 305 | Unknown Error |\n| 306 | Unknown Error |\n| 307 | Unknown Error |\n| 308 | Unknown Error |\n| 309 | Unknown Error |\n| 310 | Unknown Error |\n| 311 | Unknown Error |\n| 312 | Unknown Error |\n| 313 | Unknown Error |\n| 314 | Unknown Error |\n| 315 | Unknown Error |\n| 316 | Unknown Error |\n| 317 | Unknown Error |\n| 318 | Unknown Error |\n| 319 | Unknown Error |\n| 320 | Unknown Error |\n| 321 | Unknown Error |\n| 322 | Unknown Error |\n| 323 | Unknown Error |\n| 324 | Unknown Error |\n| 325 | Unknown Error |\n| 326 | Unknown Error |\n| 327 | Unknown Error |\n| 328 | Unknown Error |\n| 329 | Unknown Error |\n| 330 | Unknown Error |\n| 331 | Unknown Error |\n| 332 | Unknown Error |\n| 333 | Unknown Error |\n| 334 | Unknown Error |\n| 335 | Unknown Error |\n| 336 | Unknown Error |\n| 337 | Unknown Error |\n| 338 | Unknown Error |\n| 339 | Unknown Error |\n| 340 | Unknown Error |\n| 341 | Unknown Error |\n| 342 | Unknown Error |\n| 343 | Unknown Error |\n| 344 | Unknown Error |\n| 345 | Unknown Error |\n| 346 | Unknown Error |\n| 347 | Unknown Error |\n| 348 | Unknown Error |\n| 349 | Unknown Error |\n| 350 | Unknown Error |\n| 351 | Unknown Error |\n| 352 | Unknown Error |\n| 353 | Unknown Error |\n| 354 | Unknown Error |\n| 355 | Unknown Error |\n| 356 | Unknown Error |\n| 357 | Unknown Error |\n| 358 | Unknown Error |\n| 359 | Unknown Error |\n| 360 | Unknown Error |\n| 361 | Unknown Error |\n| 362 | Unknown Error |\n| 363 | Unknown Error |\n| 364 | Unknown Error |\n| 365 | Unknown Error |\n| 366 | Unknown Error |\n| 367 | Unknown Error |\n| 368 | Unknown Error |\n| 369 | Unknown Error |\n| 370 | Unknown Error |\n| 371 | Unknown Error |\n| 372 | Unknown Error |\n| 373 | Unknown Error |\n| 374 | Unknown Error |\n| 375 | Unknown Error |\n| 376 | Unknown Error |\n| 377 | Unknown Error |\n| 378 | Unknown Error |\n| 379 | Unknown Error |\n| 380 | Unknown Error |\n| 381 | Unknown Error |\n| 382 | Unknown Error |\n| 383 | Unknown Error |\n| 384 | Unknown Error |\n| 385 | Unknown Error |\n| 386 | Unknown Error |\n| 387 | Unknown Error |\n| 388 | Unknown Error |\n| 389 | Unknown Error |\n| 390 | Unknown Error |\n| 391 | Unknown Error |\n| 392 | Unknown Error |\n| 393 | Unknown Error |\n| 394 | Unknown Error |\n| 395 | Unknown Error |\n| 396 | Unknown Error |\n| 397 | Unknown Error |\n| 398 | Unknown Error |\n| 399 | Unknown Error |\n| 400 | Invalid request parameter or body |\n| 401 | Authentication required |\n| 402 | Unknown Error |\n| 403 | Access denied |\n| 404 | API endpoint not found |\n| 405 | HTTP method not allowed |\n| 406 | Not acceptable response type |\n| 407 | Unknown Error |\n| 408 | Unknown Error |\n| 409 | Request conflict |\n| 410 | Unknown Error |\n| 411 | Unknown Error |\n| 412 | Unknown Error |\n| 413 | Unknown Error |\n| 414 | Unknown Error |\n| 415 | Unsupported content type |\n| 416 | Unknown Error |\n| 417 | Unknown Error |\n| 418 | Unknown Error |\n| 419 | Unknown Error |\n| 420 | Unknown Error |\n| 421 | Unknown Error |\n| 422 | Unknown Error |\n| 423 | Unknown Error |\n| 424 | Unknown Error |\n| 425 | Unknown Error |\n| 426 | Unknown Error |\n| 427 | Unknown Error |\n| 428 | Unknown Error |\n| 429 | Unknown Error |\n| 430 | Unknown Error |\n| 431 | Unknown Error |\n| 432 | Unknown Error |\n| 433 | Unknown Error |\n| 434 | Unknown Error |\n| 435 | Unknown Error |\n| 436 | Unknown Error |\n| 437 | Unknown Error |\n| 438 | Unknown Error |\n| 439 | Unknown Error |\n| 440 | Unknown Error |\n| 441 | Unknown Error |\n| 442 | Unknown Error |\n| 443 | Unknown Error |\n| 444 | Unknown Error |\n| 445 | Unknown Error |\n| 446 | Unknown Error |\n| 447 | Unknown Error |\n| 448 | Unknown Error |\n| 449 | Unknown Error |\n| 450 | Unknown Error |\n| 451 | Unknown Error |\n| 452 | Unknown Error |\n| 453 | Unknown Error |\n| 454 | Unknown Error |\n| 455 | Unknown Error |\n| 456 | Unknown Error |\n| 457 | Unknown Error |\n| 458 | Unknown Error |\n| 459 | Unknown Error |\n| 460 | Unknown Error |\n| 461 | Unknown Error |\n| 462 | Unknown Error |\n| 463 | Unknown Error |\n| 464 | Unknown Error |\n| 465 | Unknown Error |\n| 466 | Unknown Error |\n| 467 | Unknown Error |\n| 468 | Unknown Error |\n| 469 | Unknown Error |\n| 470 | Unknown Error |\n| 471 | Unknown Error |\n| 472 | Unknown Error |\n| 473 | Unknown Error |\n| 474 | Unknown Error |\n| 475 | Unknown Error |\n| 476 | Unknown Error |\n| 477 | Unknown Error |\n| 478 | Unknown Error |\n| 479 | Unknown Error |\n| 480 | Unknown Error |\n| 481 | Unknown Error |\n| 482 | Unknown Error |\n| 483 | Unknown Error |\n| 484 | Unknown Error |\n| 485 | Unknown Error |\n| 486 | Unknown Error |\n| 487 | Unknown Error |\n| 488 | Unknown Error |\n| 489 | Unknown Error |\n| 490 | Unknown Error |\n| 491 | Unknown Error |\n| 492 | Unknown Error |\n| 493 | Unknown Error |\n| 494 | Unknown Error |\n| 495 | Unknown Error |\n| 496 | Unknown Error |\n| 497 | Unknown Error |\n| 498 | Unknown Error |\n| 499 | Unknown Error |\n| 500 | Internal Server Error |\n| 600 | Unknown Error |\n| 601 | Unknown Error |\n| 602 | Unknown Error |\n| 603 | Unknown Error |\n| 604 | Unknown Error |\n| 605 | Unknown Error |\n| 606 | Unknown Error |\n| 607 | Unknown Error |\n| 608 | Unknown Error |\n| 609 | Unknown Error |\n| 610 | Unknown Error |\n| 611 | Unknown Error |\n| 612 | Unknown Error |\n| 613 | Unknown Error |\n| 614 | Unknown Error |\n| 615 | Unknown Error |\n| 616 | Unknown Error |\n| 617 | Unknown Error |\n| 618 | Unknown Error |\n| 619 | Unknown Error |\n| 620 | Unknown Error |\n| 621 | Unknown Error |\n| 622 | Unknown Error |\n| 623 | Unknown Error |\n| 624 | Unknown Error |\n| 625 | Unknown Error |\n| 626 | Unknown Error |\n| 627 | Unknown Error |\n| 628 | Unknown Error |\n| 629 | Unknown Error |\n| 630 | Unknown Error |\n| 631 | Unknown Error |\n| 632 | Unknown Error |\n| 633 | Unknown Error |\n| 634 | Unknown Error |\n| 635 | Unknown Error |\n| 636 | Unknown Error |\n| 637 | Unknown Error |\n| 638 | Unknown Error |\n| 639 | Unknown Error |\n| 640 | Unknown Error |\n| 641 | Unknown Error |\n| 642 | Unknown Error |\n| 643 | Unknown Error |\n| 644 | Unknown Error |\n| 645 | Unknown Error |\n| 646 | Unknown Error |\n| 647 | Unknown Error |\n| 648 | Unknown Error |\n| 649 | Unknown Error |\n| 650 | Memory allocation errors related to navigation extensions |\n| 651 | Failure to read navigation-related data (maps, options, etc.) files |\n| 652 | Unknown Error |\n| 653 | Unknown Error |\n| 654 | Unknown Error |\n| 655 | Unknown Error |\n| 656 | Unknown Error |\n| 657 | Unknown Error |\n| 658 | Unknown Error |\n| 659 | Unknown Error |\n| 660 | Unknown Error |\n| 661 | Unknown Error |\n| 662 | Unknown Error |\n| 663 | Unknown Error |\n| 664 | Unknown Error |\n| 665 | Unknown Error |\n| 666 | Unknown Error |\n| 667 | Unknown Error |\n| 668 | Unknown Error |\n| 669 | Unknown Error |\n| 670 | The starting point is not projected or the starting point is incorrect |\n| 671 | The destination is not projected or the destination is incorrect |\n| 672 | The waypoint is not projected or the waypoint is incorrect |\n| 673 | Unknown Error |\n| 674 | Unknown Error |\n| 675 | Unknown Error |\n| 676 | Unknown Error |\n| 677 | Unknown Error |\n| 678 | Unknown Error |\n| 679 | Unknown Error |\n| 680 | Unknown Error |\n| 681 | Unknown Error |\n| 682 | Unknown Error |\n| 683 | Unknown Error |\n| 684 | Unknown Error |\n| 685 | Unknown Error |\n| 686 | Unknown Error |\n| 687 | Unknown Error |\n| 688 | Unknown Error |\n| 689 | Unknown Error |\n| 690 | Navigation range exceeded |\n| 691 | Navigation timeout |\n| 692 | Exceeded number of expandable nodes |\n| 693 | Expansion failed |\n| 694 | Unknown Error |\n| 695 | Unknown Error |\n| 696 | Unknown Error |\n| 697 | Unknown Error |\n| 698 | Unknown Error |\n| 699 | Unknown Error |\n| 700 | Clustering failed |\n| 701 | Allocation recalculation limit exceeded |\n| 702 | Allocation failed within the specified quantity |\n| 703 | Allocation failed within the specified deviation |\n| 704 | Data has expired |\n| 705 | Unknown Error |\n| 706 | Unknown Error |\n| 707 | Unknown Error |\n| 708 | Unknown Error |\n| 709 | Unknown Error |\n| 710 | Unknown Error |\n| 711 | Unknown Error |\n| 712 | Unknown Error |\n| 713 | Unknown Error |\n| 714 | Unknown Error |\n| 715 | Unknown Error |\n| 716 | Unknown Error |\n| 717 | Unknown Error |\n| 718 | Unknown Error |\n| 719 | Unknown Error |\n| 720 | Unknown Error |\n| 721 | Unknown Error |\n| 722 | Unknown Error |\n| 723 | Unknown Error |\n| 724 | Unknown Error |\n| 725 | Unknown Error |\n| 726 | Unknown Error |\n| 727 | Unknown Error |\n| 728 | Unknown Error |\n| 729 | Unknown Error |\n| 730 | Unknown Error |\n| 731 | Unknown Error |\n| 732 | Unknown Error |\n| 733 | Unknown Error |\n| 734 | Unknown Error |\n| 735 | Unknown Error |\n| 736 | Unknown Error |\n| 737 | Unknown Error |\n| 738 | Unknown Error |\n| 739 | Unknown Error |\n| 740 | Unknown Error |\n| 741 | Unknown Error |\n| 742 | Unknown Error |\n| 743 | Unknown Error |\n| 744 | Unknown Error |\n| 745 | Unknown Error |\n| 746 | Unknown Error |\n| 747 | Unknown Error |\n| 748 | Unknown Error |\n| 749 | Unknown Error |\n| 750 | Unknown Error |\n| 751 | Unknown Error |\n| 752 | Unknown Error |\n| 753 | Unknown Error |\n| 754 | Unknown Error |\n| 755 | Unknown Error |\n| 756 | Unknown Error |\n| 757 | Unknown Error |\n| 758 | Unknown Error |\n| 759 | Unknown Error |\n| 760 | Unknown Error |\n| 761 | Unknown Error |\n| 762 | Unknown Error |\n| 763 | Unknown Error |\n| 764 | Unknown Error |\n| 765 | Unknown Error |\n| 766 | Unknown Error |\n| 767 | Unknown Error |\n| 768 | Unknown Error |\n| 769 | Unknown Error |\n| 770 | Unknown Error |\n| 771 | Unknown Error |\n| 772 | Unknown Error |\n| 773 | Unknown Error |\n| 774 | Unknown Error |\n| 775 | Unknown Error |\n| 776 | Unknown Error |\n| 777 | Unknown Error |\n| 778 | Unknown Error |\n| 779 | Unknown Error |\n| 780 | Unknown Error |\n| 781 | Unknown Error |\n| 782 | Unknown Error |\n| 783 | Unknown Error |\n| 784 | Unknown Error |\n| 785 | Unknown Error |\n| 786 | Unknown Error |\n| 787 | Unknown Error |\n| 788 | Unknown Error |\n| 789 | Unknown Error |\n| 790 | Unknown Error |\n| 791 | Unknown Error |\n| 792 | Unknown Error |\n| 793 | Unknown Error |\n| 794 | Unknown Error |\n| 795 | Unknown Error |\n| 796 | Unknown Error |\n| 797 | Unknown Error |\n| 798 | Unknown Error |\n| 799 | Unknown Error |\n",
"operationId": "getOptimizeErrorCodes",
"servers": []
}
},
"/docs/error-codes/map-match": {
"get": {
"tags": [
"복원"
],
"summary": "에러 코드",
"description": "| resultCode | message |\n|-----------:|---------|\n| 100 | Result Not Found |\n| 101 | Argument Error |\n| 102 | IMPS Server Error |\n| 300 | Authentication Failed |\n| 301 | Inappropriate URL |\n| 302 | Limit Exceeded |\n| 303 | Unknown Error |\n| 304 | Unknown Error |\n| 305 | Unknown Error |\n| 306 | Unknown Error |\n| 307 | Unknown Error |\n| 308 | Unknown Error |\n| 309 | Unknown Error |\n| 310 | Unknown Error |\n| 311 | Unknown Error |\n| 312 | Unknown Error |\n| 313 | Unknown Error |\n| 314 | Unknown Error |\n| 315 | Unknown Error |\n| 316 | Unknown Error |\n| 317 | Unknown Error |\n| 318 | Unknown Error |\n| 319 | Unknown Error |\n| 320 | Unknown Error |\n| 321 | Unknown Error |\n| 322 | Unknown Error |\n| 323 | Unknown Error |\n| 324 | Unknown Error |\n| 325 | Unknown Error |\n| 326 | Unknown Error |\n| 327 | Unknown Error |\n| 328 | Unknown Error |\n| 329 | Unknown Error |\n| 330 | Unknown Error |\n| 331 | Unknown Error |\n| 332 | Unknown Error |\n| 333 | Unknown Error |\n| 334 | Unknown Error |\n| 335 | Unknown Error |\n| 336 | Unknown Error |\n| 337 | Unknown Error |\n| 338 | Unknown Error |\n| 339 | Unknown Error |\n| 340 | Unknown Error |\n| 341 | Unknown Error |\n| 342 | Unknown Error |\n| 343 | Unknown Error |\n| 344 | Unknown Error |\n| 345 | Unknown Error |\n| 346 | Unknown Error |\n| 347 | Unknown Error |\n| 348 | Unknown Error |\n| 349 | Unknown Error |\n| 350 | Unknown Error |\n| 351 | Unknown Error |\n| 352 | Unknown Error |\n| 353 | Unknown Error |\n| 354 | Unknown Error |\n| 355 | Unknown Error |\n| 356 | Unknown Error |\n| 357 | Unknown Error |\n| 358 | Unknown Error |\n| 359 | Unknown Error |\n| 360 | Unknown Error |\n| 361 | Unknown Error |\n| 362 | Unknown Error |\n| 363 | Unknown Error |\n| 364 | Unknown Error |\n| 365 | Unknown Error |\n| 366 | Unknown Error |\n| 367 | Unknown Error |\n| 368 | Unknown Error |\n| 369 | Unknown Error |\n| 370 | Unknown Error |\n| 371 | Unknown Error |\n| 372 | Unknown Error |\n| 373 | Unknown Error |\n| 374 | Unknown Error |\n| 375 | Unknown Error |\n| 376 | Unknown Error |\n| 377 | Unknown Error |\n| 378 | Unknown Error |\n| 379 | Unknown Error |\n| 380 | Unknown Error |\n| 381 | Unknown Error |\n| 382 | Unknown Error |\n| 383 | Unknown Error |\n| 384 | Unknown Error |\n| 385 | Unknown Error |\n| 386 | Unknown Error |\n| 387 | Unknown Error |\n| 388 | Unknown Error |\n| 389 | Unknown Error |\n| 390 | Unknown Error |\n| 391 | Unknown Error |\n| 392 | Unknown Error |\n| 393 | Unknown Error |\n| 394 | Unknown Error |\n| 395 | Unknown Error |\n| 396 | Unknown Error |\n| 397 | Unknown Error |\n| 398 | Unknown Error |\n| 399 | Unknown Error |\n| 400 | Invalid request parameter or body |\n| 401 | Authentication required |\n| 402 | Unknown Error |\n| 403 | Access denied |\n| 404 | API endpoint not found |\n| 405 | HTTP method not allowed |\n| 406 | Not acceptable response type |\n| 407 | Unknown Error |\n| 408 | Unknown Error |\n| 409 | Request conflict |\n| 410 | Unknown Error |\n| 411 | Unknown Error |\n| 412 | Unknown Error |\n| 413 | Unknown Error |\n| 414 | Unknown Error |\n| 415 | Unsupported content type |\n| 416 | Unknown Error |\n| 417 | Unknown Error |\n| 418 | Unknown Error |\n| 419 | Unknown Error |\n| 420 | Unknown Error |\n| 421 | Unknown Error |\n| 422 | Unknown Error |\n| 423 | Unknown Error |\n| 424 | Unknown Error |\n| 425 | Unknown Error |\n| 426 | Unknown Error |\n| 427 | Unknown Error |\n| 428 | Unknown Error |\n| 429 | Unknown Error |\n| 430 | Unknown Error |\n| 431 | Unknown Error |\n| 432 | Unknown Error |\n| 433 | Unknown Error |\n| 434 | Unknown Error |\n| 435 | Unknown Error |\n| 436 | Unknown Error |\n| 437 | Unknown Error |\n| 438 | Unknown Error |\n| 439 | Unknown Error |\n| 440 | Unknown Error |\n| 441 | Unknown Error |\n| 442 | Unknown Error |\n| 443 | Unknown Error |\n| 444 | Unknown Error |\n| 445 | Unknown Error |\n| 446 | Unknown Error |\n| 447 | Unknown Error |\n| 448 | Unknown Error |\n| 449 | Unknown Error |\n| 450 | Unknown Error |\n| 451 | Unknown Error |\n| 452 | Unknown Error |\n| 453 | Unknown Error |\n| 454 | Unknown Error |\n| 455 | Unknown Error |\n| 456 | Unknown Error |\n| 457 | Unknown Error |\n| 458 | Unknown Error |\n| 459 | Unknown Error |\n| 460 | Unknown Error |\n| 461 | Unknown Error |\n| 462 | Unknown Error |\n| 463 | Unknown Error |\n| 464 | Unknown Error |\n| 465 | Unknown Error |\n| 466 | Unknown Error |\n| 467 | Unknown Error |\n| 468 | Unknown Error |\n| 469 | Unknown Error |\n| 470 | Unknown Error |\n| 471 | Unknown Error |\n| 472 | Unknown Error |\n| 473 | Unknown Error |\n| 474 | Unknown Error |\n| 475 | Unknown Error |\n| 476 | Unknown Error |\n| 477 | Unknown Error |\n| 478 | Unknown Error |\n| 479 | Unknown Error |\n| 480 | Unknown Error |\n| 481 | Unknown Error |\n| 482 | Unknown Error |\n| 483 | Unknown Error |\n| 484 | Unknown Error |\n| 485 | Unknown Error |\n| 486 | Unknown Error |\n| 487 | Unknown Error |\n| 488 | Unknown Error |\n| 489 | Unknown Error |\n| 490 | Unknown Error |\n| 491 | Unknown Error |\n| 492 | Unknown Error |\n| 493 | Unknown Error |\n| 494 | Unknown Error |\n| 495 | Unknown Error |\n| 496 | Unknown Error |\n| 497 | Unknown Error |\n| 498 | Unknown Error |\n| 499 | Unknown Error |\n| 500 | Internal Server Error |\n| 800 | Unknown Error |\n| 801 | Unknown Error |\n| 802 | Unknown Error |\n| 803 | Unknown Error |\n| 804 | Unknown Error |\n| 805 | Unknown Error |\n| 806 | Unknown Error |\n| 807 | Unknown Error |\n| 808 | Unknown Error |\n| 809 | Unknown Error |\n| 810 | Map-Matching Argument Error |\n| 811 | Unknown Error |\n| 812 | Unknown Error |\n| 813 | Unknown Error |\n| 814 | Unknown Error |\n| 815 | Unknown Error |\n| 816 | Unknown Error |\n| 817 | Unknown Error |\n| 818 | Unknown Error |\n| 819 | Unknown Error |\n| 820 | Unknown Error |\n| 821 | Unknown Error |\n| 822 | Unknown Error |\n| 823 | Unknown Error |\n| 824 | Unknown Error |\n| 825 | Unknown Error |\n| 826 | Unknown Error |\n| 827 | Unknown Error |\n| 828 | Unknown Error |\n| 829 | Unknown Error |\n| 830 | Map-Matching Error |\n| 831 | No Valid GPS |\n| 832 | Unknown Error |\n| 833 | Unknown Error |\n| 834 | Unknown Error |\n| 835 | Unknown Error |\n| 836 | Unknown Error |\n| 837 | Unknown Error |\n| 838 | Unknown Error |\n| 839 | Unknown Error |\n| 840 | Unknown Error |\n| 841 | Unknown Error |\n| 842 | Unknown Error |\n| 843 | Unknown Error |\n| 844 | Unknown Error |\n| 845 | Unknown Error |\n| 846 | Unknown Error |\n| 847 | Unknown Error |\n| 848 | Unknown Error |\n| 849 | Unknown Error |\n| 850 | Internal module error |\n| 851 | Unknown Error |\n| 852 | Unknown Error |\n| 853 | Unknown Error |\n| 854 | Unknown Error |\n| 855 | Unknown Error |\n| 856 | Unknown Error |\n| 857 | Unknown Error |\n| 858 | Unknown Error |\n| 859 | Unknown Error |\n| 860 | Unknown Error |\n| 861 | Unknown Error |\n| 862 | Unknown Error |\n| 863 | Unknown Error |\n| 864 | Unknown Error |\n| 865 | Unknown Error |\n| 866 | Unknown Error |\n| 867 | Unknown Error |\n| 868 | Unknown Error |\n| 869 | Unknown Error |\n| 870 | Unknown Error |\n| 871 | Unknown Error |\n| 872 | Unknown Error |\n| 873 | Unknown Error |\n| 874 | Unknown Error |\n| 875 | Unknown Error |\n| 876 | Unknown Error |\n| 877 | Unknown Error |\n| 878 | Unknown Error |\n| 879 | Unknown Error |\n| 880 | Unknown Error |\n| 881 | Unknown Error |\n| 882 | Unknown Error |\n| 883 | Unknown Error |\n| 884 | Unknown Error |\n| 885 | Unknown Error |\n| 886 | Unknown Error |\n| 887 | Unknown Error |\n| 888 | Unknown Error |\n| 889 | Unknown Error |\n| 890 | Unknown Error |\n| 891 | Unknown Error |\n| 892 | Unknown Error |\n| 893 | Unknown Error |\n| 894 | Unknown Error |\n| 895 | Unknown Error |\n| 896 | Unknown Error |\n| 897 | Unknown Error |\n| 898 | Unknown Error |\n| 899 | Due to high number of requests |\n",
"operationId": "getMapMatchErrorCodes",
"servers": []
}
},
"/docs/error-codes/matrix": {
"get": {
"tags": [
"매트릭스"
],
"summary": "에러 코드",
"description": "| resultCode | message |\n|-----------:|---------|\n| 100 | Result Not Found |\n| 101 | Argument Error |\n| 102 | IMPS Server Error |\n| 300 | Authentication Failed |\n| 301 | Inappropriate URL |\n| 302 | Limit Exceeded |\n| 303 | Unknown Error |\n| 304 | Unknown Error |\n| 305 | Unknown Error |\n| 306 | Unknown Error |\n| 307 | Unknown Error |\n| 308 | Unknown Error |\n| 309 | Unknown Error |\n| 310 | Unknown Error |\n| 311 | Unknown Error |\n| 312 | Unknown Error |\n| 313 | Unknown Error |\n| 314 | Unknown Error |\n| 315 | Unknown Error |\n| 316 | Unknown Error |\n| 317 | Unknown Error |\n| 318 | Unknown Error |\n| 319 | Unknown Error |\n| 320 | Unknown Error |\n| 321 | Unknown Error |\n| 322 | Unknown Error |\n| 323 | Unknown Error |\n| 324 | Unknown Error |\n| 325 | Unknown Error |\n| 326 | Unknown Error |\n| 327 | Unknown Error |\n| 328 | Unknown Error |\n| 329 | Unknown Error |\n| 330 | Unknown Error |\n| 331 | Unknown Error |\n| 332 | Unknown Error |\n| 333 | Unknown Error |\n| 334 | Unknown Error |\n| 335 | Unknown Error |\n| 336 | Unknown Error |\n| 337 | Unknown Error |\n| 338 | Unknown Error |\n| 339 | Unknown Error |\n| 340 | Unknown Error |\n| 341 | Unknown Error |\n| 342 | Unknown Error |\n| 343 | Unknown Error |\n| 344 | Unknown Error |\n| 345 | Unknown Error |\n| 346 | Unknown Error |\n| 347 | Unknown Error |\n| 348 | Unknown Error |\n| 349 | Unknown Error |\n| 350 | Unknown Error |\n| 351 | Unknown Error |\n| 352 | Unknown Error |\n| 353 | Unknown Error |\n| 354 | Unknown Error |\n| 355 | Unknown Error |\n| 356 | Unknown Error |\n| 357 | Unknown Error |\n| 358 | Unknown Error |\n| 359 | Unknown Error |\n| 360 | Unknown Error |\n| 361 | Unknown Error |\n| 362 | Unknown Error |\n| 363 | Unknown Error |\n| 364 | Unknown Error |\n| 365 | Unknown Error |\n| 366 | Unknown Error |\n| 367 | Unknown Error |\n| 368 | Unknown Error |\n| 369 | Unknown Error |\n| 370 | Unknown Error |\n| 371 | Unknown Error |\n| 372 | Unknown Error |\n| 373 | Unknown Error |\n| 374 | Unknown Error |\n| 375 | Unknown Error |\n| 376 | Unknown Error |\n| 377 | Unknown Error |\n| 378 | Unknown Error |\n| 379 | Unknown Error |\n| 380 | Unknown Error |\n| 381 | Unknown Error |\n| 382 | Unknown Error |\n| 383 | Unknown Error |\n| 384 | Unknown Error |\n| 385 | Unknown Error |\n| 386 | Unknown Error |\n| 387 | Unknown Error |\n| 388 | Unknown Error |\n| 389 | Unknown Error |\n| 390 | Unknown Error |\n| 391 | Unknown Error |\n| 392 | Unknown Error |\n| 393 | Unknown Error |\n| 394 | Unknown Error |\n| 395 | Unknown Error |\n| 396 | Unknown Error |\n| 397 | Unknown Error |\n| 398 | Unknown Error |\n| 399 | Unknown Error |\n| 400 | Invalid request parameter or body |\n| 401 | Authentication required |\n| 402 | Unknown Error |\n| 403 | Access denied |\n| 404 | API endpoint not found |\n| 405 | HTTP method not allowed |\n| 406 | Not acceptable response type |\n| 407 | Unknown Error |\n| 408 | Unknown Error |\n| 409 | Request conflict |\n| 410 | Unknown Error |\n| 411 | Unknown Error |\n| 412 | Unknown Error |\n| 413 | Unknown Error |\n| 414 | Unknown Error |\n| 415 | Unsupported content type |\n| 416 | Unknown Error |\n| 417 | Unknown Error |\n| 418 | Unknown Error |\n| 419 | Unknown Error |\n| 420 | Unknown Error |\n| 421 | Unknown Error |\n| 422 | Unknown Error |\n| 423 | Unknown Error |\n| 424 | Unknown Error |\n| 425 | Unknown Error |\n| 426 | Unknown Error |\n| 427 | Unknown Error |\n| 428 | Unknown Error |\n| 429 | Unknown Error |\n| 430 | Unknown Error |\n| 431 | Unknown Error |\n| 432 | Unknown Error |\n| 433 | Unknown Error |\n| 434 | Unknown Error |\n| 435 | Unknown Error |\n| 436 | Unknown Error |\n| 437 | Unknown Error |\n| 438 | Unknown Error |\n| 439 | Unknown Error |\n| 440 | Unknown Error |\n| 441 | Unknown Error |\n| 442 | Unknown Error |\n| 443 | Unknown Error |\n| 444 | Unknown Error |\n| 445 | Unknown Error |\n| 446 | Unknown Error |\n| 447 | Unknown Error |\n| 448 | Unknown Error |\n| 449 | Unknown Error |\n| 450 | Unknown Error |\n| 451 | Unknown Error |\n| 452 | Unknown Error |\n| 453 | Unknown Error |\n| 454 | Unknown Error |\n| 455 | Unknown Error |\n| 456 | Unknown Error |\n| 457 | Unknown Error |\n| 458 | Unknown Error |\n| 459 | Unknown Error |\n| 460 | Unknown Error |\n| 461 | Unknown Error |\n| 462 | Unknown Error |\n| 463 | Unknown Error |\n| 464 | Unknown Error |\n| 465 | Unknown Error |\n| 466 | Unknown Error |\n| 467 | Unknown Error |\n| 468 | Unknown Error |\n| 469 | Unknown Error |\n| 470 | Unknown Error |\n| 471 | Unknown Error |\n| 472 | Unknown Error |\n| 473 | Unknown Error |\n| 474 | Unknown Error |\n| 475 | Unknown Error |\n| 476 | Unknown Error |\n| 477 | Unknown Error |\n| 478 | Unknown Error |\n| 479 | Unknown Error |\n| 480 | Unknown Error |\n| 481 | Unknown Error |\n| 482 | Unknown Error |\n| 483 | Unknown Error |\n| 484 | Unknown Error |\n| 485 | Unknown Error |\n| 486 | Unknown Error |\n| 487 | Unknown Error |\n| 488 | Unknown Error |\n| 489 | Unknown Error |\n| 490 | Unknown Error |\n| 491 | Unknown Error |\n| 492 | Unknown Error |\n| 493 | Unknown Error |\n| 494 | Unknown Error |\n| 495 | Unknown Error |\n| 496 | Unknown Error |\n| 497 | Unknown Error |\n| 498 | Unknown Error |\n| 499 | Unknown Error |\n| 500 | Internal Server Error |\n| 600 | Unknown Error |\n| 601 | Unknown Error |\n| 602 | Unknown Error |\n| 603 | Unknown Error |\n| 604 | Unknown Error |\n| 605 | Unknown Error |\n| 606 | Unknown Error |\n| 607 | Unknown Error |\n| 608 | Unknown Error |\n| 609 | Unknown Error |\n| 610 | Unknown Error |\n| 611 | Unknown Error |\n| 612 | Unknown Error |\n| 613 | Unknown Error |\n| 614 | Unknown Error |\n| 615 | Unknown Error |\n| 616 | Unknown Error |\n| 617 | Unknown Error |\n| 618 | Unknown Error |\n| 619 | Unknown Error |\n| 620 | Unknown Error |\n| 621 | Unknown Error |\n| 622 | Unknown Error |\n| 623 | Unknown Error |\n| 624 | Unknown Error |\n| 625 | Unknown Error |\n| 626 | Unknown Error |\n| 627 | Unknown Error |\n| 628 | Unknown Error |\n| 629 | Unknown Error |\n| 630 | Unknown Error |\n| 631 | Unknown Error |\n| 632 | Unknown Error |\n| 633 | Unknown Error |\n| 634 | Unknown Error |\n| 635 | Unknown Error |\n| 636 | Unknown Error |\n| 637 | Unknown Error |\n| 638 | Unknown Error |\n| 639 | Unknown Error |\n| 640 | Unknown Error |\n| 641 | Unknown Error |\n| 642 | Unknown Error |\n| 643 | Unknown Error |\n| 644 | Unknown Error |\n| 645 | Unknown Error |\n| 646 | Unknown Error |\n| 647 | Unknown Error |\n| 648 | Unknown Error |\n| 649 | Unknown Error |\n| 650 | Memory allocation errors related to navigation extensions |\n| 651 | Failure to read navigation-related data (maps, options, etc.) files |\n| 652 | Unknown Error |\n| 653 | Unknown Error |\n| 654 | Unknown Error |\n| 655 | Unknown Error |\n| 656 | Unknown Error |\n| 657 | Unknown Error |\n| 658 | Unknown Error |\n| 659 | Unknown Error |\n| 660 | Unknown Error |\n| 661 | Unknown Error |\n| 662 | Unknown Error |\n| 663 | Unknown Error |\n| 664 | Unknown Error |\n| 665 | Unknown Error |\n| 666 | Unknown Error |\n| 667 | Unknown Error |\n| 668 | Unknown Error |\n| 669 | Unknown Error |\n| 670 | The starting point is not projected or the starting point is incorrect |\n| 671 | The destination is not projected or the destination is incorrect |\n| 672 | The waypoint is not projected or the waypoint is incorrect |\n| 673 | Unknown Error |\n| 674 | Unknown Error |\n| 675 | Unknown Error |\n| 676 | Unknown Error |\n| 677 | Unknown Error |\n| 678 | Unknown Error |\n| 679 | Unknown Error |\n| 680 | Unknown Error |\n| 681 | Unknown Error |\n| 682 | Unknown Error |\n| 683 | Unknown Error |\n| 684 | Unknown Error |\n| 685 | Unknown Error |\n| 686 | Unknown Error |\n| 687 | Unknown Error |\n| 688 | Unknown Error |\n| 689 | Unknown Error |\n| 690 | Navigation range exceeded |\n| 691 | Navigation timeout |\n| 692 | Exceeded number of expandable nodes |\n| 693 | Expansion failed |\n| 694 | Unknown Error |\n| 695 | Unknown Error |\n| 696 | Unknown Error |\n| 697 | Unknown Error |\n| 698 | Unknown Error |\n| 699 | Unknown Error |\n",
"operationId": "getMatrixErrorCodes",
"servers": []
}
}
},
"components": {
"schemas": {
"RouteTimeRequest": {
"required": [
"day",
"endX",
"endY",
"hour",
"minutes",
"month",
"option",
"startX",
"startY",
"type",
"year"
],
"type": "object",
"properties": {
"option": {
"pattern": "^(stats|stats_freeroad|stats_highway)$",
"type": "string",
"description": "경로 탐색 옵션
*하나만 선택 가능",
"default": "stats",
"enum": [
"stats",
"stats_freeroad",
"stats_highway"
],
"x-enum-descriptions": {
"stats": "통계 예측 탐색",
"stats_highway": "고속도로 우선 통계 예측 탐색",
"stats_freeroad": "무료 도로 우선 통계 예측 탐색"
}
},
"type": {
"pattern": "^(start|end)$",
"type": "string",
"description": "기준 시간",
"example": "start",
"enum": [
"start",
"end"
],
"x-enum-descriptions": {
"start": "출발 시각 기준",
"end": "도착 시각 기준"
}
},
"startX": {
"type": "string",
"description": "시작 지점(출발지)에 대한 X좌표(경도)",
"example": "127.110762"
},
"startY": {
"type": "string",
"description": "시작 지점(출발지)에 대한 Y좌표(위도)",
"example": "37.402184"
},
"endX": {
"type": "string",
"description": "끝 지점(도착지)에 대한 X좌표(경도)",
"example": "127.105399"
},
"endY": {
"type": "string",
"description": "끝 지점(도착지)에 대한 Y좌표(위도)",
"example": "37.5124518"
},
"year": {
"minimum": 1,
"type": "integer",
"description": "경로 탐색의 기준이 되는 연도(YYYY)
*예: 2026",
"format": "int32",
"example": 2026
},
"month": {
"maximum": 12,
"minimum": 1,
"type": "integer",
"description": "경로 탐색의 기준이 되는 월
*예: 2",
"format": "int32",
"example": 1
},
"day": {
"maximum": 31,
"minimum": 1,
"type": "integer",
"description": "경로 탐색의 기준이 되는 일
*예: 26",
"format": "int32",
"example": 9
},
"hour": {
"maximum": 23,
"minimum": 0,
"type": "integer",
"description": "경로 탐색의 기준이 되는 시각(시)
*24시간 형식(0~23)으로 입력
*예: 17",
"format": "int32",
"example": 13
},
"minutes": {
"maximum": 59,
"minimum": 0,
"type": "integer",
"description": "경로 탐색의 기준이 되는 시각(분)
*예: 30",
"format": "int32",
"example": 30
},
"coordType": {
"pattern": "^(tw|wgs84|TW|WGS84)$",
"type": "string",
"description": "좌표 체계
*'wgs84'는 국제 표준 좌표계, 'tw'는 팅크웨어 좌표계를 의미",
"default": "wgs84",
"enum": [
"wgs84",
"tw"
]
},
"via1X": {
"type": "string",
"description": "1 번째 경유지에 대한 X좌표(경도)"
},
"via1Y": {
"type": "string",
"description": "1 번째 경유지에 대한 Y좌표(위도)"
},
"via2X": {
"type": "string",
"description": "2 번째 경유지에 대한 X좌표(경도)"
},
"via2Y": {
"type": "string",
"description": "2 번째 경유지에 대한 Y좌표(위도)"
},
"via3X": {
"type": "string",
"description": "3 번째 경유지에 대한 X좌표(경도)"
},
"via3Y": {
"type": "string",
"description": "3 번째 경유지에 대한 Y좌표(위도)"
},
"via4X": {
"type": "string",
"description": "4 번째 경유지에 대한 X좌표(경도)"
},
"via4Y": {
"type": "string",
"description": "4 번째 경유지에 대한 Y좌표(위도)"
},
"via5X": {
"type": "string",
"description": "5 번째 경유지에 대한 X좌표(경도)"
},
"via5Y": {
"type": "string",
"description": "5 번째 경유지에 대한 Y좌표(위도)"
},
"carType": {
"maximum": 6,
"minimum": 1,
"type": "integer",
"description": "차량 종류",
"format": "int32",
"example": 1,
"default": 1,
"enum": [
1,
2,
3,
4,
5,
6
],
"x-enum-descriptions": {
"1": "소형차",
"2": "중형차",
"3": "대형차",
"4": "대형화물차",
"5": "특수화물차",
"6": "경차"
}
},
"carHeight": {
"type": "integer",
"description": "차량의 높이(cm)",
"format": "int32",
"example": 150
},
"carWeight": {
"type": "integer",
"description": "차량의 총 중량(kg)",
"format": "int32",
"example": 4000
},
"groupByTrafficColor": {
"type": "boolean",
"description": "경로의 교통 상황 색상 그룹화 여부",
"default": false,
"enum": [
false,
true
],
"x-enum-descriptions": {
"false": "교통 상황 색상 비그룹화",
"true": "교통 상황 색상 그룹화"
}
},
"useAngle": {
"type": "boolean",
"description": "출발 지점의 주행 각도 설정 여부",
"default": false,
"enum": [
false,
true
],
"x-enum-descriptions": {
"false": "주행 방향 비우선",
"true": "주행 방향 우선"
}
},
"angle": {
"maximum": 359,
"minimum": 0,
"type": "integer",
"description": "주행 각도
*정북 방향을 0으로 하여 시계 방향으로 0~359도
*'useAngle'이 true일 때 적용",
"format": "int32"
},
"useStartDirection": {
"type": "boolean",
"description": "출발지 좌표 기준 주행 방향 지정 여부
*차량 주행방향을 알 수 없을 때 활용",
"default": false,
"enum": [
false,
true
],
"x-enum-descriptions": {
"false": "출발지 좌표 기준 주행 방향 미지정",
"true": "출발지 좌표 기준 주행 방향 지정"
}
},
"searchByAddress": {
"type": "boolean",
"description": "주소 기반 경로 탐색 여부",
"default": false,
"enum": [
false,
true
],
"x-enum-descriptions": {
"false": "일반 경로 탐색",
"true": "주소 기반 경로 탐색"
}
},
"usageType": {
"maximum": 1,
"minimum": 0,
"type": "integer",
"description": "사용 용도",
"format": "int32",
"default": 0,
"enum": [
0,
1
],
"x-enum-descriptions": {
"0": "일반",
"1": "택시"
}
},
"avoidWaterSourceArea": {
"type": "boolean",
"description": "상수원 보호 구역 회피 탐색 여부",
"default": false,
"enum": [
false,
true
],
"x-enum-descriptions": {
"false": "일반 탐색",
"true": "상수원 보호 구역 회피 탐색"
}
},
"avoidNarrowRoad": {
"maximum": 16,
"minimum": 0,
"type": "integer",
"description": "좁은 길(이면도로) 회피 차선 정보
*0~16
*값은 왕복 차선의 개수
*예: 값이 6일 경우, 왕복 6차선 도로에서 차종에 관계 없이 모두 회피",
"format": "int32",
"default": 0
},
"avoidUTurn": {
"maximum": 16,
"minimum": 0,
"type": "integer",
"description": "U턴 회피 차선 정보
*0~16
*값은 왕복 차선의 개수
*예: 값이 6 일 경우, 왕복 6차선 이하 도로에서 U턴 회피",
"format": "int32",
"default": 0
},
"useTaxifare": {
"type": "string",
"description": "예상 택시 요금 조회 여부",
"default": "0",
"enum": [
"0",
"1",
"2",
"3"
],
"x-enum-descriptions": {
"0": "미사용",
"1": "일반 택시",
"2": "모범 택시",
"3": "일반 및 모범 택시"
}
},
"beforeCount": {
"type": "integer",
"description": "기준 시간 이전 탐색 개수
*예: beforeCount=2
*interval=15인 경우 기준 시각 기준 15분 전, 30분 전 경로를 추가 탐색",
"format": "int32",
"example": 1,
"default": 0
},
"afterCount": {
"type": "integer",
"description": "기준 시간 이후 탐색 개수
*예: afterCount=2
*interval=15인 경우 기준 시각 기준 15분 후, 30분 후 경로를 추가 탐색",
"format": "int32",
"example": 1,
"default": 0
},
"interval": {
"type": "integer",
"description": "시간 간격
*기준 시각을 중심으로 설정된 간격마다 이전/이후 시각에 대해 예상 출/도착 시간 반환",
"format": "int32",
"example": 15,
"default": 15
}
},
"description": "경로 예측 시간 탐색을 위한 요청 파라미터 집합 출발지, 도착지, 시간, 차종 등 다양한 조건을 설정하여 예상 소요 시간을 예측합니다"
},
"Header": {
"type": "object",
"properties": {
"isSuccessful": {
"type": "boolean",
"description": "API 요청 성공 여부",
"example": true
},
"resultCode": {
"type": "integer",
"description": "API 응답 결과 코드",
"format": "int32",
"example": 0
},
"resultMessage": {
"type": "string",
"description": "API 응답 결과 문구",
"example": "Success"
}
},
"description": "API 응답 결과"
},
"NumberVertex": {
"type": "object",
"properties": {
"x": {
"type": "number",
"description": "해당 지점의 X좌표(경도)",
"example": 127.110762
},
"y": {
"type": "number",
"description": "해당 지점의 Y좌표(위도)",
"example": 37.402184
}
},
"description": "검색 할 좌표를 담는 목록(배열)
*최소 3개 이상 입력"
},
"RoutePath": {
"type": "object",
"properties": {
"coords": {
"type": "array",
"description": "해당 구간을 구성하는 좌표 지점들의 목록(배열)",
"items": {
"$ref": "#/components/schemas/NumberVertex"
}
},
"speed": {
"type": "integer",
"description": "해당 구간의 평균 속도(km/h)",
"format": "int32",
"example": 85
},
"distance": {
"type": "integer",
"description": "해당 구간의 거리(m)",
"format": "int32",
"example": 120
},
"spend_time": {
"type": "integer",
"description": "해당 구간의 예상 소요 시간(초)",
"format": "int32",
"example": 2800
},
"road_code": {
"type": "integer",
"description": "도로의 종류를 구분하는 코드",
"format": "int32",
"example": 1,
"enum": [
0,
1,
2,
3,
4,
5
],
"x-enum-descriptions": {
"0": "페리항로",
"1": "고속도로",
"2": "도시 고속도로",
"3": "국도",
"4": "지방도",
"5": "일반도로"
}
},
"traffic_color": {
"type": "string",
"description": "해당 구간의 교통 상황을 나타내는 색상 코드",
"example": "#fb3a76"
},
"point_type": {
"type": "string",
"description": "해당 구간의 속성",
"example": "S",
"enum": [
"S",
"V",
"E",
"N"
],
"x-enum-descriptions": {
"S": "출발지",
"E": "도착지",
"V": "경유지",
"N": "일반"
}
}
},
"description": "경로를 구성하는 각 세부 구간에 대한 정보 목록(배열)"
},
"RouteTime": {
"type": "object",
"properties": {
"option": {
"type": "string",
"description": "경로 탐색 옵션
*하나만 선택 가능",
"default": "stats",
"enum": [
"stats",
"stats_freeroad",
"stats_highway"
],
"x-enum-descriptions": {
"stats": "통계 예측 탐색",
"stats_highway": "고속도로 우선 통계 예측 탐색",
"stats_freeroad": "무료 도로 우선 통계 예측 탐색"
}
},
"toll_fee": {
"type": "integer",
"description": "경로 상에서 발생하는 총 톨게이트 통행 요금",
"format": "int32",
"example": 3400
},
"taxiFare": {
"type": "integer",
"description": "예상 택시 요금 정보
*요청 시 'useTaxifare' 값이 1(일반) 또는 2(모범)일 때만 값이 반환",
"format": "int32",
"example": 45000
},
"totalTaxiFare": {
"type": "string",
"description": "예상 택시 요금 정보
*요금 정보가 문자열 형태로 반환
*예: \"6500\" or \"6500,11500\"",
"example": "7000"
},
"spend_time": {
"type": "integer",
"description": "경로 전체의 총 예상 소요 시간(초)",
"format": "int32",
"example": 3720
},
"distance": {
"type": "integer",
"description": "경로 전체의 총 거리(m)",
"format": "int32",
"example": 72183
},
"isHighWay": {
"type": "boolean",
"description": "해당 경로의 고속도로 포함 여부",
"example": false
},
"times": {
"type": "array",
"description": "각 시간대별 경로 요약 정보의 목록(배열)
둘 다 값이 0인 경우 빈 배열 반환",
"items": {
"$ref": "#/components/schemas/RouteTimeInterval"
}
},
"paths": {
"type": "array",
"description": "경로를 구성하는 각 세부 구간에 대한 정보 목록(배열)",
"items": {
"$ref": "#/components/schemas/RoutePath"
}
}
},
"description": "경로 예측 탐색 결과 데이터"
},
"RouteTimeData": {
"type": "object",
"properties": {
"data": {
"$ref": "#/components/schemas/RouteTime"
}
},
"description": "경로 예측 탐색 결과"
},
"RouteTimeInterval": {
"type": "object",
"properties": {
"index": {
"type": "integer",
"description": "탐색된 시간대의 순번
'0'은 요청 시 설정한 기준 시간을 의미
index의 값이 클 수록 interval에 따른 기준 시간이 증가",
"format": "int32",
"example": 0
},
"spend_time": {
"type": "integer",
"description": "경로 전체의 총 예상 소요 시간(초)",
"format": "int32",
"example": 3720
},
"startTime": {
"$ref": "#/components/schemas/startTime"
},
"endTime": {
"$ref": "#/components/schemas/endTime"
}
},
"description": "각 시간대별 경로 요약 정보의 목록(배열)
둘 다 값이 0인 경우 빈 배열 반환"
},
"RouteTimeResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"route": {
"$ref": "#/components/schemas/RouteTimeData"
}
},
"description": "경로 예측 탐색 API의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"route": {
"data": {
"option": "real_traffic",
"toll_fee": 3400,
"taxiFare": 45000,
"totalTaxiFare": "7000",
"spend_time": 3720,
"distance": 72183,
"isHighWay": true,
"times": [
{
"index": 0,
"spend_time": 3720,
"start_time": {
"year": 2019,
"month": 11,
"day": 26,
"hour": 11,
"minutes": 0
},
"end_time": {
"year": 2019,
"month": 11,
"day": 26,
"hour": 11,
"minutes": 0
}
}
],
"paths": [
{
"coords": [
{
"x": "127.110762",
"y": "37.402184"
}
],
"speed": 85,
"distance": 120,
"spend_time": 2800,
"road_code": 1,
"traffic_color": "#fb3a76",
"point_type": "S"
}
]
}
}
}
},
"endTime": {
"type": "object",
"properties": {
"year": {
"type": "integer",
"description": "연도(YYYY) 정보",
"format": "int32",
"example": 2019
},
"month": {
"type": "integer",
"description": "월(1-12) 정보",
"format": "int32",
"example": 11
},
"day": {
"type": "integer",
"description": "일(1-31) 정보",
"format": "int32",
"example": 26
},
"hour": {
"type": "integer",
"description": "시(0-23) 정보",
"format": "int32",
"example": 11
},
"minutes": {
"type": "integer",
"description": "분(0-59) 정보",
"format": "int32",
"example": 0
}
},
"description": "해당 경로 탐색의 예상 도착 시간을 나타내는 객체"
},
"startTime": {
"type": "object",
"properties": {
"year": {
"type": "integer",
"description": "연도(YYYY) 정보",
"format": "int32",
"example": 2019
},
"month": {
"type": "integer",
"description": "월(1-12) 정보",
"format": "int32",
"example": 11
},
"day": {
"type": "integer",
"description": "일(1-31) 정보",
"format": "int32",
"example": 26
},
"hour": {
"type": "integer",
"description": "시(0-23) 정보",
"format": "int32",
"example": 11
},
"minutes": {
"type": "integer",
"description": "분(0-59) 정보",
"format": "int32",
"example": 0
}
},
"description": "해당 경로 탐색의 실제 출발 시간을 나타내는 객체"
},
"RouteTimeSummaryRequest": {
"required": [
"day",
"endX",
"endY",
"hour",
"minutes",
"month",
"option",
"startX",
"startY",
"type",
"year"
],
"type": "object",
"properties": {
"option": {
"pattern": "^(stats|stats_freeroad|stats_highway)$",
"type": "string",
"description": "경로 탐색 옵션
*하나만 선택 가능",
"default": "stats",
"enum": [
"stats",
"stats_freeroad",
"stats_highway"
],
"x-enum-descriptions": {
"stats": "통계 예측 탐색",
"stats_highway": "고속도로 우선 통계 예측 탐색",
"stats_freeroad": "무료 도로 우선 통계 예측 탐색"
}
},
"type": {
"pattern": "^(start|end)$",
"type": "string",
"description": "기준 시간",
"example": "start",
"enum": [
"start",
"end"
]
},
"startX": {
"type": "string",
"description": "시작 지점(출발지)에 대한 X좌표(경도)",
"example": "127.110762"
},
"startY": {
"type": "string",
"description": "시작 지점(출발지)에 대한 Y좌표(위도)",
"example": "37.402184"
},
"endX": {
"type": "string",
"description": "끝 지점(도착지)에 대한 X좌표(경도)",
"example": "127.105399"
},
"endY": {
"type": "string",
"description": "끝 지점(도착지)에 대한 Y좌표(위도)",
"example": "37.5124518"
},
"year": {
"minimum": 1,
"type": "integer",
"description": "경로 탐색의 기준이 되는 연도(YYYY)
*예: 2026",
"format": "int32",
"example": 2026
},
"month": {
"maximum": 12,
"minimum": 1,
"type": "integer",
"description": "경로 탐색의 기준이 되는 월
*예: 2",
"format": "int32",
"example": 1
},
"day": {
"maximum": 31,
"minimum": 1,
"type": "integer",
"description": "경로 탐색의 기준이 되는 일
*예: 26",
"format": "int32",
"example": 9
},
"hour": {
"maximum": 23,
"minimum": 0,
"type": "integer",
"description": "경로 탐색의 기준이 되는 시각(시)
*24시간 형식(0~23)으로 입력
*예: 17",
"format": "int32",
"example": 13
},
"minutes": {
"maximum": 59,
"minimum": 0,
"type": "integer",
"description": "경로 탐색의 기준이 되는 시각(분)
*예: 30",
"format": "int32",
"example": 30
},
"coordType": {
"pattern": "^(tw|wgs84|TW|WGS84)$",
"type": "string",
"description": "좌표 체계
*'wgs84'는 국제 표준 좌표계, 'tw'는 팅크웨어 좌표계를 의미",
"default": "wgs84",
"enum": [
"wgs84",
"tw"
]
},
"via1X": {
"type": "string",
"description": "1 번째 경유지에 대한 X좌표(경도)"
},
"via1Y": {
"type": "string",
"description": "1 번째 경유지에 대한 Y좌표(위도)"
},
"via2X": {
"type": "string",
"description": "2 번째 경유지에 대한 X좌표(경도)"
},
"via2Y": {
"type": "string",
"description": "2 번째 경유지에 대한 Y좌표(위도)"
},
"via3X": {
"type": "string",
"description": "3 번째 경유지에 대한 X좌표(경도)"
},
"via3Y": {
"type": "string",
"description": "3 번째 경유지에 대한 Y좌표(위도)"
},
"via4X": {
"type": "string",
"description": "4 번째 경유지에 대한 X좌표(경도)"
},
"via4Y": {
"type": "string",
"description": "4 번째 경유지에 대한 Y좌표(위도)"
},
"via5X": {
"type": "string",
"description": "5 번째 경유지에 대한 X좌표(경도)"
},
"via5Y": {
"type": "string",
"description": "5 번째 경유지에 대한 Y좌표(위도)"
},
"carType": {
"maximum": 6,
"minimum": 1,
"type": "integer",
"description": "차량 종류",
"format": "int32",
"example": 1,
"default": 1,
"enum": [
1,
2,
3,
4,
5,
6
],
"x-enum-descriptions": {
"1": "소형차",
"2": "중형차",
"3": "대형차",
"4": "대형화물차",
"5": "특수화물차",
"6": "경차"
}
},
"carHeight": {
"type": "integer",
"description": "차량의 높이(cm)",
"format": "int32",
"example": 150
},
"carWeight": {
"type": "integer",
"description": "차량의 총 중량(kg)",
"format": "int32",
"example": 4000
},
"groupByTrafficColor": {
"type": "boolean",
"description": "경로의 교통 상황 색상 그룹화 여부",
"default": false,
"enum": [
false,
true
],
"x-enum-descriptions": {
"false": "교통 상황 색상 비그룹화",
"true": "교통 상황 색상 그룹화"
}
},
"useAngle": {
"type": "boolean",
"description": "출발 지점의 주행 각도 설정 여부",
"default": false,
"enum": [
false,
true
],
"x-enum-descriptions": {
"false": "주행 방향 비우선",
"true": "주행 방향 우선"
}
},
"angle": {
"maximum": 359,
"minimum": 0,
"type": "integer",
"description": "주행 각도
*정북 방향을 0으로 하여 시계 방향으로 0~359도
*'useAngle'이 true일 때 적용",
"format": "int32"
},
"useStartDirection": {
"type": "boolean",
"description": "출발지 좌표 기준 주행 방향 지정 여부
*차량 주행방향을 알 수 없을 때 활용",
"default": false,
"enum": [
false,
true
],
"x-enum-descriptions": {
"false": "출발지 좌표 기준 주행 방향 미지정",
"true": "출발지 좌표 기준 주행 방향 지정"
}
},
"searchByAddress": {
"type": "boolean",
"description": "주소 기반 경로 탐색 여부",
"default": false,
"enum": [
false,
true
],
"x-enum-descriptions": {
"false": "일반 경로 탐색",
"true": "주소 기반 경로 탐색"
}
},
"usageType": {
"maximum": 1,
"minimum": 0,
"type": "integer",
"description": "사용 용도",
"format": "int32",
"default": 0,
"enum": [
0,
1
],
"x-enum-descriptions": {
"0": "일반",
"1": "택시"
}
},
"avoidWaterSourceArea": {
"type": "boolean",
"description": "상수원 보호 구역 회피 탐색 여부",
"default": false,
"enum": [
false,
true
],
"x-enum-descriptions": {
"false": "일반 탐색",
"true": "상수원 보호 구역 회피 탐색"
}
},
"avoidNarrowRoad": {
"maximum": 16,
"minimum": 0,
"type": "integer",
"description": "좁은 길(이면도로) 회피 차선 정보
*0~16
*값은 왕복 차선의 개수
*예: 값이 6일 경우, 왕복 6차선 도로에서 차종에 관계 없이 모두 회피",
"format": "int32",
"default": 0
},
"avoidUTurn": {
"maximum": 16,
"minimum": 0,
"type": "integer",
"description": "U턴 회피 차선 정보
*0~16
*값은 왕복 차선의 개수
*예: 값이 6 일 경우, 왕복 6차선 이하 도로에서 U턴 회피",
"format": "int32",
"default": 0
},
"useTaxifare": {
"type": "string",
"description": "예상 택시 요금 조회 여부",
"default": "0",
"enum": [
"0",
"1",
"2",
"3"
],
"x-enum-descriptions": {
"0": "미사용",
"1": "일반 택시",
"2": "모범 택시",
"3": "일반 및 모범 택시"
}
}
},
"description": "경로 예측 시간 탐색을 위한 요청 파라미터 집합
출발지, 도착지, 시간, 차종 등 다양한 조건을 설정하여 예상 소요 시간을 예측합니다"
},
"RouteTimeSummaryData": {
"type": "object",
"properties": {
"data": {
"$ref": "#/components/schemas/Summary"
}
},
"description": "경로 예측 탐색 요약 결과"
},
"RouteTimeSummaryResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"route": {
"$ref": "#/components/schemas/RouteTimeSummaryData"
}
},
"description": "경로 예측 탐색 API의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"route": {
"data": {
"spend_time": 1920,
"distance": 15019
}
}
}
},
"Summary": {
"type": "object",
"properties": {
"option": {
"type": "string",
"description": "경로 탐색 시 사용된 옵션",
"example": "real_traffic",
"enum": [
"real_traffic",
"real_traffic2",
"real_traffic_freeroad",
"short_distance_priority",
"time_priority",
"motorcycle",
"recommendation",
"highway_priority"
],
"x-enum-descriptions": {
"motorcycle": "이륜차 경로",
"highway_priority": "고속 도로",
"short_distance_priority": "최단 거리",
"time_priority": "최소 시간",
"real_traffic": "실시간 경로",
"recommendation": "추천 경로",
"real_traffic_freeroad": "무료 도로",
"real_traffic2": "대안 경로"
}
},
"spend_time": {
"type": "integer",
"description": "경로 전체의 총 예상 소요 시간(초)",
"format": "int32",
"example": 3720
},
"distance": {
"type": "integer",
"description": "경로 전체의 총 거리(m)",
"format": "int32",
"example": 72183
}
},
"description": "경로 예측 탐색 요약 결과 데이터"
},
"RouteSummaryRequest": {
"required": [
"endX",
"endY",
"option",
"startX",
"startY"
],
"type": "object",
"properties": {
"option": {
"pattern": "^(real_traffic|real_traffic2|real_traffic_freeroad|short_distance_priority|time_priority|motorcycle|recommendation|highway_priority)(\\s*,\\s*(real_traffic|real_traffic2|real_traffic_freeroad|short_distance_priority|time_priority|motorcycle|recommendation|highway_priority))*$",
"type": "string",
"description": "경로 탐색 옵션
*다중 선택 가능",
"example": "real_traffic",
"enum": [
"real_traffic",
"real_traffic2",
"real_traffic_freeroad",
"short_distance_priority",
"time_priority",
"motorcycle",
"recommendation",
"highway_priority"
],
"x-enum-descriptions": {
"motorcycle": "이륜차 경로",
"highway_priority": "고속 도로",
"short_distance_priority": "최단 거리",
"time_priority": "최소 시간",
"real_traffic": "실시간 경로",
"recommendation": "추천 경로",
"real_traffic_freeroad": "무료 도로",
"real_traffic2": "대안 경로"
}
},
"startX": {
"type": "string",
"description": "시작 지점(출발지)에 대한 X좌표(경도)",
"example": "127.110762"
},
"startY": {
"type": "string",
"description": "시작 지점(출발지)에 대한 Y좌표(위도)",
"example": "37.402184"
},
"endX": {
"type": "string",
"description": "끝 지점(도착지)에 대한 X좌표(경도)",
"example": "127.105399"
},
"endY": {
"type": "string",
"description": "끝 지점(도착지)에 대한 Y좌표(위도)",
"example": "37.5124518"
},
"coordType": {
"pattern": "^(tw|wgs84|TW|WGS84)$",
"type": "string",
"description": "좌표 체계
*'wgs84'는 국제 표준 좌표계, 'tw'는 팅크웨어 좌표계를 의미",
"default": "wgs84",
"enum": [
"wgs84",
"tw"
]
},
"via1X": {
"type": "string",
"description": "1 번째 경유지에 대한 X좌표(경도)"
},
"via1Y": {
"type": "string",
"description": "1 번째 경유지에 대한 Y좌표(위도)"
},
"via2X": {
"type": "string",
"description": "2 번째 경유지에 대한 X좌표(경도)"
},
"via2Y": {
"type": "string",
"description": "2 번째 경유지에 대한 Y좌표(위도)"
},
"via3X": {
"type": "string",
"description": "3 번째 경유지에 대한 X좌표(경도)"
},
"via3Y": {
"type": "string",
"description": "3 번째 경유지에 대한 Y좌표(위도)"
},
"via4X": {
"type": "string",
"description": "4 번째 경유지에 대한 X좌표(경도)"
},
"via4Y": {
"type": "string",
"description": "4 번째 경유지에 대한 Y좌표(위도)"
},
"via5X": {
"type": "string",
"description": "5 번째 경유지에 대한 X좌표(경도)"
},
"via5Y": {
"type": "string",
"description": "5 번째 경유지에 대한 Y좌표(위도)"
},
"carType": {
"maximum": 6,
"minimum": 1,
"type": "integer",
"description": "차량 종류",
"format": "int32",
"example": 1,
"default": 1,
"enum": [
1,
2,
3,
4,
5,
6
],
"x-enum-descriptions": {
"1": "소형차",
"2": "중형차",
"3": "대형차",
"4": "대형화물차",
"5": "특수화물차",
"6": "경차"
}
},
"carHeight": {
"type": "integer",
"description": "차량의 높이(cm)",
"format": "int32",
"example": 150
},
"carWeight": {
"type": "integer",
"description": "차량의 총 중량(kg)",
"format": "int32",
"example": 4000
},
"groupByTrafficColor": {
"type": "boolean",
"description": "경로의 교통 상황 색상 그룹화 여부",
"default": false,
"enum": [
false,
true
],
"x-enum-descriptions": {
"false": "교통 상황 색상 비그룹화",
"true": "교통 상황 색상 그룹화"
}
},
"useAngle": {
"type": "boolean",
"description": "출발 지점의 주행 각도 설정 여부",
"default": false,
"enum": [
false,
true
],
"x-enum-descriptions": {
"false": "주행 방향 비우선",
"true": "주행 방향 우선"
}
},
"angle": {
"maximum": 359,
"minimum": 0,
"type": "integer",
"description": "주행 각도
*정북 방향을 0으로 하여 시계 방향으로 0~359도
*'useAngle'이 true일 때 적용",
"format": "int32"
},
"useStartDirection": {
"type": "boolean",
"description": "출발지 좌표 기준 주행 방향 지정 여부
*차량 주행방향을 알 수 없을 때 활용",
"default": false,
"enum": [
false,
true
],
"x-enum-descriptions": {
"false": "출발지 좌표 기준 주행 방향 미지정",
"true": "출발지 좌표 기준 주행 방향 지정"
}
},
"searchByAddress": {
"type": "boolean",
"description": "주소 기반 경로 탐색 여부",
"default": false,
"enum": [
false,
true
],
"x-enum-descriptions": {
"false": "일반 경로 탐색",
"true": "주소 기반 경로 탐색"
}
},
"usageType": {
"maximum": 1,
"minimum": 0,
"type": "integer",
"description": "사용 용도",
"format": "int32",
"default": 0,
"enum": [
0,
1
],
"x-enum-descriptions": {
"0": "일반",
"1": "택시"
}
},
"avoidWaterSourceArea": {
"type": "boolean",
"description": "상수원 보호 구역 회피 탐색 여부",
"default": false,
"enum": [
false,
true
],
"x-enum-descriptions": {
"false": "일반 탐색",
"true": "상수원 보호 구역 회피 탐색"
}
},
"avoidNarrowRoad": {
"maximum": 16,
"minimum": 0,
"type": "integer",
"description": "좁은 길(이면도로) 회피 차선 정보
*0~16
*값은 왕복 차선의 개수
*예: 값이 6일 경우, 왕복 6차선 도로에서 차종에 관계 없이 모두 회피",
"format": "int32",
"default": 0
},
"avoidUTurn": {
"maximum": 16,
"minimum": 0,
"type": "integer",
"description": "U턴 회피 차선 정보
*0~16
*값은 왕복 차선의 개수
*예: 값이 6 일 경우, 왕복 6차선 이하 도로에서 U턴 회피",
"format": "int32",
"default": 0
}
},
"description": "일반 경로 탐색 요약을 위한 요청 파라미터 집합 다양한 조건을 설정하여 예상 소요 시간 및 거리를 탐색합니다"
},
"RouteSummaryData": {
"type": "object",
"properties": {
"data": {
"type": "array",
"description": "경로 탐색 요약 결과 목록(배열)",
"items": {
"$ref": "#/components/schemas/Summary"
}
}
},
"description": "경로 탐색 요약 결과"
},
"RouteSummaryResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"route": {
"$ref": "#/components/schemas/RouteSummaryData"
}
},
"description": "경로 탐색 요약 API의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"route": {
"data": [
{
"option": "real_traffic",
"spend_time": 3720,
"distance": 72183
}
]
}
}
},
"RouteMultiStartRequest": {
"required": [
"data",
"endX",
"endY"
],
"type": "object",
"properties": {
"data": {
"maxItems": 100,
"minItems": 1,
"type": "array",
"description": "출발지 정보를 담는 목록(배열)
*최대 100개까지 설정 가능",
"items": {
"$ref": "#/components/schemas/Start"
}
},
"endX": {
"type": "string",
"description": "끝 지점(도착지)에 대한 X좌표(경도)",
"example": "127.105399"
},
"endY": {
"type": "string",
"description": "끝 지점(도착지)에 대한 Y좌표(위도)",
"example": "37.5124518"
},
"orderby": {
"maximum": 3,
"minimum": 0,
"type": "integer",
"description": "정렬 기준",
"format": "int32",
"example": 0,
"default": 0,
"enum": [
0,
1,
2,
3
],
"x-enum-descriptions": {
"0": "거리 내림차순",
"1": "거리 오름차순",
"2": "시간 내림차순",
"3": "시간 오름차순"
}
},
"useAngle": {
"type": "boolean",
"description": "출발 지점의 주행 각도 설정 여부",
"default": false,
"enum": [
false,
true
],
"x-enum-descriptions": {
"false": "주행 방향 비우선",
"true": "주행 방향 우선"
}
},
"usageType": {
"maximum": 1,
"minimum": 0,
"type": "integer",
"description": "사용 용도",
"format": "int32",
"default": 0,
"enum": [
0,
1
],
"x-enum-descriptions": {
"0": "일반",
"1": "택시"
}
},
"resultCount": {
"minimum": 0,
"type": "integer",
"description": "탐색 결과 개수
*값이 3일 경우, 모든 결과 중 상위 3개만 응답",
"format": "int32",
"example": 0,
"default": 0
}
},
"description": "다중 출발지-단일 목적지를 위한 요청 파라미터 집합
여러 출발지를 설정하여 예상 소요 시간 및 거리를 탐색합니다"
},
"Start": {
"required": [
"startIdx",
"startX",
"startY"
],
"type": "object",
"properties": {
"startIdx": {
"type": "string",
"description": "출발지를 구분하기 위한 고유 식별 ID",
"example": "1"
},
"startX": {
"type": "string",
"description": "시작 지점(출발지)에 대한 X좌표(경도)",
"example": "127.110762"
},
"startY": {
"type": "string",
"description": "시작 지점(출발지)에 대한 Y좌표(위도)",
"example": "37.402184"
},
"speed": {
"type": "integer",
"description": "차량의 이동 속도 (단위: km/h)",
"format": "int32",
"nullable": true
},
"angle": {
"maximum": 359,
"minimum": 0,
"type": "integer",
"description": "주행 각도
*정북 방향을 0으로 하여 시계 방향으로 0~359도
*'useAngle'이 true일 때 적용",
"format": "int32",
"nullable": true
}
},
"description": "출발지 정보를 담는 목록(배열)
*최대 100개까지 설정 가능"
},
"RouteStartMultiResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"route": {
"$ref": "#/components/schemas/RouteStartMultiSummaryData"
}
},
"description": "다중 출발지-단일 목적지 API의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"route": {
"data": [
{
"startIdx": "example2",
"startX": "127.119387",
"startY": "37.394735",
"spend_time": 420,
"distance": 1783
},
{
"startIdx": "example1",
"startX": "127.111412",
"startY": "37.39476",
"spend_time": 300,
"distance": 1534
}
]
}
}
},
"RouteStartMultiSummaryData": {
"type": "object",
"properties": {
"data": {
"type": "array",
"description": "다중 출발지-단일 목적지 결과 목록(배열)",
"items": {
"$ref": "#/components/schemas/StartMultiSummary"
}
}
},
"description": "다중 출발지-단일 목적지 결과"
},
"StartMultiSummary": {
"required": [
"startIdx",
"startX",
"startY"
],
"type": "object",
"properties": {
"startIdx": {
"type": "string",
"description": "출발지를 구분하기 위한 고유 식별 ID",
"example": "1"
},
"startX": {
"type": "string",
"description": "시작 지점(출발지)에 대한 X좌표(경도)",
"example": "127.110762"
},
"startY": {
"type": "string",
"description": "시작 지점(출발지)에 대한 Y좌표(위도)",
"example": "37.402184"
},
"spend_time": {
"type": "integer",
"description": "경로 전체의 총 예상 소요 시간(초)",
"format": "int32",
"example": 3720
},
"distance": {
"type": "integer",
"description": "경로 전체의 총 거리(m)",
"format": "int32",
"example": 72183
}
},
"description": "다중 출발지-단일 목적지 결과 목록(배열)"
},
"RoutePedestrianRequest": {
"required": [
"endX",
"endY",
"option",
"startX",
"startY"
],
"type": "object",
"properties": {
"option": {
"type": "string",
"description": "경로 탐색 옵션
*하나만 선택 가능",
"example": "1",
"enum": [
"0",
"1",
"2",
"3",
"4"
],
"x-enum-descriptions": {
"0": "최단 거리",
"1": "추천 경로",
"2": "편한 경로",
"3": "최소 시간",
"4": "큰길 위주"
}
},
"startX": {
"type": "string",
"description": "시작 지점(출발지)에 대한 X좌표(경도)
*wgs84",
"example": "127.110762"
},
"startY": {
"type": "string",
"description": "시작 지점(출발지)에 대한 Y좌표(위도)
*wgs84",
"example": "37.402184"
},
"endX": {
"type": "string",
"description": "끝 지점(도착지)에 대한 X좌표(경도)
*wgs84",
"example": "127.105399"
},
"endY": {
"type": "string",
"description": "끝 지점(도착지)에 대한 Y좌표(위도)
*wgs84",
"example": "37.5124518"
},
"viaList": {
"maxItems": 100,
"minItems": 0,
"type": "array",
"description": "경유지 정보를 담는 목록(배열)
*최대 100개 경유지 설정 가능",
"items": {
"$ref": "#/components/schemas/RouteVia"
}
},
"type": {
"maximum": 1,
"minimum": 0,
"type": "integer",
"description": "사용자 유형",
"format": "int32",
"example": 0,
"default": 0,
"enum": [
0,
1
],
"x-enum-descriptions": {
"0": "PM",
"1": "보행자"
}
}
},
"description": "도보/PM 경로 탐색을 위한 요청 파라미터 집합
다양한 조건을 설정하여 경로를 탐색합니다"
},
"RouteVia": {
"required": [
"viaX",
"viaY"
],
"type": "object",
"properties": {
"viaX": {
"type": "string",
"description": "해당 지점의 X좌표(경도)",
"example": "127.119387"
},
"viaY": {
"type": "string",
"description": "해당 지점의 Y좌표(위도)",
"example": "37.394735"
}
},
"description": "경유지 정보를 담는 목록(배열)
*최대 100개 경유지 설정 가능"
},
"Pedestrian": {
"type": "object",
"properties": {
"option": {
"type": "string",
"description": "경로 탐색 시 사용된 옵션",
"example": "short_distance_priority",
"enum": [
"short_distance_priority",
"recommendation",
"easy_way",
"time_priority",
"main_road"
],
"x-enum-descriptions": {
"short_distance_priority": "최단 거리",
"easy_way": "편한 경로",
"time_priority": "최소 시간",
"recommendation": "추천 경로",
"main_road": "큰길 위주"
}
},
"spend_time": {
"type": "integer",
"description": "경로 전체의 총 예상 소요 시간(초)",
"format": "int32",
"example": 3720
},
"distance": {
"type": "integer",
"description": "경로 전체의 총 거리(m)",
"format": "int32",
"example": 72183
},
"paths": {
"type": "array",
"description": "경로를 구성하는 각 세부 구간에 대한 정보 목록(배열)",
"items": {
"$ref": "#/components/schemas/RoutePedestrianPath"
}
}
},
"description": "도보/PM 경로 탐색 결과 데이터"
},
"RoutePedestrianData": {
"type": "object",
"properties": {
"data": {
"$ref": "#/components/schemas/Pedestrian"
}
},
"description": "도보/PM 경로 탐색 결과"
},
"RoutePedestrianPath": {
"type": "object",
"properties": {
"coords": {
"type": "array",
"description": "해당 구간을 구성하는 좌표 지점들의 목록(배열)",
"items": {
"$ref": "#/components/schemas/NumberVertex"
}
},
"distance": {
"type": "integer",
"description": "해당 구간의 거리(m)",
"format": "int32",
"example": 120
},
"angle": {
"type": "integer",
"description": "해당 구간의 진행 각도",
"format": "int32",
"example": 30
},
"spend_time": {
"type": "integer",
"description": "해당 구간의 예상 소요 시간(초)",
"format": "int32",
"example": 2800
},
"point_type": {
"type": "string",
"description": "해당 구간의 속성",
"example": "S",
"enum": [
"S",
"V",
"E",
"N"
],
"x-enum-descriptions": {
"S": "출발지",
"E": "도착지",
"V": "경유지",
"N": "일반"
}
},
"walk_type": {
"type": "integer",
"description": "보행자 도로 타입 코드",
"format": "int32",
"example": 1,
"x-enum-descriptions": {
"0": "미정의",
"1": "복선도로",
"2": "차량겸용도로",
"3": "자전거전용도로",
"4": "보행전용도로",
"5": "가상보행도로"
}
},
"bicycle_type": {
"type": "integer",
"description": "자전거 도로 타입 코드",
"format": "int32",
"example": 2,
"x-enum-descriptions": {
"0": "미정의",
"1": "자전거 전용 도로",
"2": "보행자·차량 겸용 자전거 도로",
"3": "보행 도로"
}
},
"facility_type": {
"type": "integer",
"description": "시설물 타입 코드",
"format": "int32",
"example": 0,
"x-enum-descriptions": {
"0": "미정의",
"1": "토끼굴",
"2": "지하보도",
"3": "육교",
"4": "고가도로",
"5": "교량",
"6": "지하철역",
"7": "철도",
"8": "중앙버스정류장",
"9": "지하상가",
"10": "건물관통도로",
"11": "단지도로_공원",
"12": "단지도로_주거시설",
"13": "지하단지도로_관광지상가",
"14": "단지도로_기타"
}
},
"gate_type": {
"type": "integer",
"description": "진입로 타입 코드",
"format": "int32",
"example": 0,
"x-enum-descriptions": {
"0": "미정의",
"1": "경사로",
"2": "계단",
"3": "에스컬레이터",
"4": "계단/에스컬레이터",
"5": "엘리베이터",
"6": "단순연결로",
"7": "횡단보도",
"8": "무빙워크",
"9": "징검다리",
"10": "의사횡단"
}
}
},
"description": "경로를 구성하는 각 세부 구간에 대한 정보 목록(배열)"
},
"RoutePedestrianResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"route": {
"$ref": "#/components/schemas/RoutePedestrianData"
}
},
"description": "도보/PM 경로 탐색 API의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"route": {
"data": {
"option": "short_distance_priority",
"spend_time": 3720,
"distance": 72183,
"paths": [
{
"coords": [
{
"x": "127.110762",
"y": "37.402184"
}
],
"distance": 120,
"angle": 30,
"spend_time": 2800,
"point_type": "S",
"walk_type": 1,
"bicycle_type": 2,
"facility_type": 0,
"gate_type": 0
}
]
}
}
}
},
"RouteOptimizePoints50Request": {
"required": [
"routeType",
"viaList"
],
"type": "object",
"properties": {
"routeType": {
"maximum": 2,
"minimum": 0,
"type": "integer",
"description": "경로 최적화 유형",
"format": "int32",
"default": 0,
"enum": [
0,
1,
2
],
"x-enum-descriptions": {
"0": "출발지 고정",
"1": "도착지 고정",
"2": "출-도착지 고정"
}
},
"viaList": {
"maxItems": 50,
"minItems": 1,
"type": "array",
"description": "경유지 좌표 목록
*출발지, 도착지, 경유지 포함 최소 3개 이상 요청
*최대 50개 경유지 설정 가능",
"items": {
"$ref": "#/components/schemas/RouteVia"
}
},
"startX": {
"type": "string",
"description": "시작 지점(출발지)에 대한 X좌표(경도)
*출발지 고정, 출-도착지 고정 시 필요
*wgs84",
"example": "127.110762"
},
"startY": {
"type": "string",
"description": "시작 지점(출발지)에 대한 Y좌표(위도)
*출발지 고정, 출-도착지 고정 시 필요
*wgs84",
"example": "37.402184"
},
"endX": {
"type": "string",
"description": "끝 지점(도착지)에 대한 X좌표(경도)
*도착지 고정, 출-도착지 고정 시 필요
*wgs84",
"example": "127.105399"
},
"endY": {
"type": "string",
"description": "끝 지점(도착지)에 대한 Y좌표(위도)
*도착지 고정, 출-도착지 고정 시 필요
*wgs84",
"example": "37.5124518"
},
"matrix": {
"type": "array",
"description": "경로 요약(거리) 행렬(M:M) 정보
*M: 출발지, 도착지, 좌표 개수의 합",
"items": {
"type": "array",
"description": "sprp.request.route-optimize-points.matrix.description",
"items": {
"type": "integer",
"description": "sprp.request.route-optimize-points.matrix.description",
"format": "int32"
}
}
}
},
"description": "TSP(다중 경유지 최적화)를 위한 요청 파라미터 집합"
},
"OptimizePoints": {
"type": "object",
"properties": {
"index": {
"type": "integer",
"description": "요청한 좌표의 최적화 전 순서",
"format": "int32",
"example": 0
},
"x": {
"type": "number",
"description": "해당 지점의 X좌표(경도)",
"example": 127.110762
},
"y": {
"type": "number",
"description": "해당 지점의 Y좌표(위도)",
"example": 37.402184
},
"distance": {
"type": "integer",
"description": "이전 경유지로 부터의 이동 거리(m)",
"format": "int32",
"example": 482
},
"spend_time": {
"type": "integer",
"description": "이전 경유지로 부터의 이동 시간(초)",
"format": "int32",
"example": 1571
}
},
"description": "다중 경유지 최적화 결과 정보 목록(배열)"
},
"RouteOptimizePoints": {
"type": "object",
"properties": {
"distance": {
"type": "integer",
"description": "경로 전체의 총 거리(m)",
"format": "int32",
"example": 4030
},
"spend_time": {
"type": "integer",
"description": "경로 전체의 총 예상 소요 시간(초)",
"format": "int32",
"example": 1020
},
"optimize": {
"type": "array",
"description": "다중 경유지 최적화 결과 정보 목록(배열)",
"items": {
"$ref": "#/components/schemas/OptimizePoints"
}
}
},
"description": "다중 경유지 최적화 결과 데이터"
},
"RouteOptimizePointsData": {
"type": "object",
"properties": {
"data": {
"$ref": "#/components/schemas/RouteOptimizePoints"
}
},
"description": "TSP(다중 경유지 최적화) 결과"
},
"RouteOptimizePointsResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"route": {
"$ref": "#/components/schemas/RouteOptimizePointsData"
}
},
"description": "TSP(다중 경유지 최적화) API 의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"route": {
"data": {
"distance": 24153,
"spend_time": 3216,
"optimize": [
{
"index": 0,
"x": 126.99500909167297,
"y": 37.50977641452363,
"distance": 0,
"spend_time": 0
},
{
"index": 2,
"x": 127.04530205470796,
"y": 37.520269143865214,
"distance": 10236,
"spend_time": 1144
},
{
"index": 4,
"x": 127.04943242234208,
"y": 37.5048863772718,
"distance": 2850,
"spend_time": 411
},
{
"index": 3,
"x": 127.06837357126065,
"y": 37.498849546491435,
"distance": 2669,
"spend_time": 294
},
{
"index": 1,
"x": 127.00676563040908,
"y": 37.47260049875861,
"distance": 8398,
"spend_time": 1367
}
]
}
}
}
},
"RouteOptimizePoints30Request": {
"required": [
"routeType",
"viaList"
],
"type": "object",
"properties": {
"routeType": {
"maximum": 2,
"minimum": 0,
"type": "integer",
"description": "경로 최적화 유형",
"format": "int32",
"default": 0,
"enum": [
0,
1,
2
],
"x-enum-descriptions": {
"0": "출발지 고정",
"1": "도착지 고정",
"2": "출-도착지 고정"
}
},
"viaList": {
"maxItems": 30,
"minItems": 1,
"type": "array",
"description": "경유지 좌표 목록
*출발지, 도착지, 경유지 포함 최소 3개 이상 요청
*최대 30개 경유지 설정 가능",
"items": {
"$ref": "#/components/schemas/RouteVia"
}
},
"startX": {
"type": "string",
"description": "시작 지점(출발지)에 대한 X좌표(경도)
*출발지 고정, 출-도착지 고정 시 필요
*wgs84",
"example": "127.110762"
},
"startY": {
"type": "string",
"description": "시작 지점(출발지)에 대한 Y좌표(위도)
*출발지 고정, 출-도착지 고정 시 필요
*wgs84",
"example": "37.402184"
},
"endX": {
"type": "string",
"description": "끝 지점(도착지)에 대한 X좌표(경도)
*도착지 고정, 출-도착지 고정 시 필요
*wgs84",
"example": "127.105399"
},
"endY": {
"type": "string",
"description": "끝 지점(도착지)에 대한 Y좌표(위도)
*도착지 고정, 출-도착지 고정 시 필요
*wgs84",
"example": "37.5124518"
},
"matrix": {
"type": "array",
"description": "경로 요약(거리) 행렬(M:M) 정보
*M: 출발지, 도착지, 좌표 개수의 합",
"items": {
"type": "array",
"description": "sprp.request.route-optimize-points.matrix.description",
"items": {
"type": "integer",
"description": "sprp.request.route-optimize-points.matrix.description",
"format": "int32"
}
}
}
},
"description": "TSP(다중 경유지 최적화)를 위한 요청 파라미터 집합"
},
"RouteOptimizePoints200Request": {
"required": [
"routeType",
"viaList"
],
"type": "object",
"properties": {
"routeType": {
"maximum": 2,
"minimum": 0,
"type": "integer",
"description": "경로 최적화 유형",
"format": "int32",
"default": 0,
"enum": [
0,
1,
2
],
"x-enum-descriptions": {
"0": "출발지 고정",
"1": "도착지 고정",
"2": "출-도착지 고정"
}
},
"viaList": {
"maxItems": 200,
"minItems": 1,
"type": "array",
"description": "경유지 좌표 목록
*출발지, 도착지, 경유지 포함 최소 3개 이상 요청
*최대 200개 경유지 설정 가능",
"items": {
"$ref": "#/components/schemas/RouteVia"
}
},
"startX": {
"type": "string",
"description": "시작 지점(출발지)에 대한 X좌표(경도)
*출발지 고정, 출-도착지 고정 시 필요
*wgs84",
"example": "127.110762"
},
"startY": {
"type": "string",
"description": "시작 지점(출발지)에 대한 Y좌표(위도)
*출발지 고정, 출-도착지 고정 시 필요
*wgs84",
"example": "37.402184"
},
"endX": {
"type": "string",
"description": "끝 지점(도착지)에 대한 X좌표(경도)
*도착지 고정, 출-도착지 고정 시 필요
*wgs84",
"example": "127.105399"
},
"endY": {
"type": "string",
"description": "끝 지점(도착지)에 대한 Y좌표(위도)
*도착지 고정, 출-도착지 고정 시 필요
*wgs84",
"example": "37.5124518"
},
"matrix": {
"type": "array",
"description": "경로 요약(거리) 행렬(M:M) 정보
*M: 출발지, 도착지, 좌표 개수의 합",
"items": {
"type": "array",
"description": "sprp.request.route-optimize-points.matrix.description",
"items": {
"type": "integer",
"description": "sprp.request.route-optimize-points.matrix.description",
"format": "int32"
}
}
}
},
"description": "TSP(다중 경유지 최적화)를 위한 요청 파라미터 집합"
},
"RouteOptimizePoints10Request": {
"required": [
"routeType",
"viaList"
],
"type": "object",
"properties": {
"routeType": {
"maximum": 2,
"minimum": 0,
"type": "integer",
"description": "경로 최적화 유형",
"format": "int32",
"default": 0,
"enum": [
0,
1,
2
],
"x-enum-descriptions": {
"0": "출발지 고정",
"1": "도착지 고정",
"2": "출-도착지 고정"
}
},
"viaList": {
"maxItems": 10,
"minItems": 1,
"type": "array",
"description": "경유지 좌표 목록
*출발지, 도착지, 경유지 포함 최소 3개 이상 요청
*최대 10개 경유지 설정 가능",
"items": {
"$ref": "#/components/schemas/RouteVia"
}
},
"startX": {
"type": "string",
"description": "시작 지점(출발지)에 대한 X좌표(경도)
*출발지 고정, 출-도착지 고정 시 필요
*wgs84",
"example": "127.110762"
},
"startY": {
"type": "string",
"description": "시작 지점(출발지)에 대한 Y좌표(위도)
*출발지 고정, 출-도착지 고정 시 필요
*wgs84",
"example": "37.402184"
},
"endX": {
"type": "string",
"description": "끝 지점(도착지)에 대한 X좌표(경도)
*도착지 고정, 출-도착지 고정 시 필요
*wgs84",
"example": "127.105399"
},
"endY": {
"type": "string",
"description": "끝 지점(도착지)에 대한 Y좌표(위도)
*도착지 고정, 출-도착지 고정 시 필요
*wgs84",
"example": "37.5124518"
},
"matrix": {
"type": "array",
"description": "경로 요약(거리) 행렬(M:M) 정보
*M: 출발지, 도착지, 좌표 개수의 합",
"items": {
"type": "array",
"description": "sprp.request.route-optimize-points.matrix.description",
"items": {
"type": "integer",
"description": "sprp.request.route-optimize-points.matrix.description",
"format": "int32"
}
}
}
},
"description": "TSP(다중 경유지 최적화)를 위한 요청 파라미터 집합"
},
"RouteOptimizePoints100Request": {
"required": [
"routeType",
"viaList"
],
"type": "object",
"properties": {
"routeType": {
"maximum": 2,
"minimum": 0,
"type": "integer",
"description": "경로 최적화 유형",
"format": "int32",
"default": 0,
"enum": [
0,
1,
2
],
"x-enum-descriptions": {
"0": "출발지 고정",
"1": "도착지 고정",
"2": "출-도착지 고정"
}
},
"viaList": {
"maxItems": 100,
"minItems": 1,
"type": "array",
"description": "경유지 좌표 목록
*출발지, 도착지, 경유지 포함 최소 3개 이상 요청
*최대 100개 경유지 설정 가능",
"items": {
"$ref": "#/components/schemas/RouteVia"
}
},
"startX": {
"type": "string",
"description": "시작 지점(출발지)에 대한 X좌표(경도)
*출발지 고정, 출-도착지 고정 시 필요
*wgs84",
"example": "127.110762"
},
"startY": {
"type": "string",
"description": "시작 지점(출발지)에 대한 Y좌표(위도)
*출발지 고정, 출-도착지 고정 시 필요
*wgs84",
"example": "37.402184"
},
"endX": {
"type": "string",
"description": "끝 지점(도착지)에 대한 X좌표(경도)
*도착지 고정, 출-도착지 고정 시 필요
*wgs84",
"example": "127.105399"
},
"endY": {
"type": "string",
"description": "끝 지점(도착지)에 대한 Y좌표(위도)
*도착지 고정, 출-도착지 고정 시 필요
*wgs84",
"example": "37.5124518"
},
"matrix": {
"type": "array",
"description": "경로 요약(거리) 행렬(M:M) 정보
*M: 출발지, 도착지, 좌표 개수의 합",
"items": {
"type": "array",
"description": "sprp.request.route-optimize-points.matrix.description",
"items": {
"type": "integer",
"description": "sprp.request.route-optimize-points.matrix.description",
"format": "int32"
}
}
}
},
"description": "TSP(다중 경유지 최적화)를 위한 요청 파라미터 집합"
},
"RouteNormalRequest": {
"required": [
"endX",
"endY",
"option",
"startX",
"startY"
],
"type": "object",
"properties": {
"option": {
"pattern": "^(real_traffic|real_traffic2|real_traffic_freeroad|short_distance_priority|time_priority|motorcycle|recommendation|highway_priority)$",
"type": "string",
"description": "경로 탐색 옵션
*하나만 선택 가능",
"example": "real_traffic",
"enum": [
"real_traffic",
"real_traffic2",
"real_traffic_freeroad",
"short_distance_priority",
"time_priority",
"motorcycle",
"recommendation",
"highway_priority"
],
"x-enum-descriptions": {
"motorcycle": "이륜차 경로",
"highway_priority": "고속 도로",
"short_distance_priority": "최단 거리",
"time_priority": "최소 시간",
"real_traffic": "실시간 경로",
"recommendation": "추천 경로",
"real_traffic_freeroad": "무료 도로",
"real_traffic2": "대안 경로"
}
},
"startX": {
"type": "string",
"description": "시작 지점(출발지)에 대한 X좌표(경도)",
"example": "127.110762"
},
"startY": {
"type": "string",
"description": "시작 지점(출발지)에 대한 Y좌표(위도)",
"example": "37.402184"
},
"endX": {
"type": "string",
"description": "끝 지점(도착지)에 대한 X좌표(경도)",
"example": "127.105399"
},
"endY": {
"type": "string",
"description": "끝 지점(도착지)에 대한 Y좌표(위도)",
"example": "37.5124518"
},
"coordType": {
"pattern": "^(tw|wgs84|TW|WGS84)$",
"type": "string",
"description": "좌표 체계
*'wgs84'는 국제 표준 좌표계, 'tw'는 팅크웨어 좌표계를 의미",
"default": "wgs84",
"enum": [
"wgs84",
"tw"
]
},
"via1X": {
"type": "string",
"description": "1 번째 경유지에 대한 X좌표(경도)"
},
"via1Y": {
"type": "string",
"description": "1 번째 경유지에 대한 Y좌표(위도)"
},
"via2X": {
"type": "string",
"description": "2 번째 경유지에 대한 X좌표(경도)"
},
"via2Y": {
"type": "string",
"description": "2 번째 경유지에 대한 Y좌표(위도)"
},
"via3X": {
"type": "string",
"description": "3 번째 경유지에 대한 X좌표(경도)"
},
"via3Y": {
"type": "string",
"description": "3 번째 경유지에 대한 Y좌표(위도)"
},
"via4X": {
"type": "string",
"description": "4 번째 경유지에 대한 X좌표(경도)"
},
"via4Y": {
"type": "string",
"description": "4 번째 경유지에 대한 Y좌표(위도)"
},
"via5X": {
"type": "string",
"description": "5 번째 경유지에 대한 X좌표(경도)"
},
"via5Y": {
"type": "string",
"description": "5 번째 경유지에 대한 Y좌표(위도)"
},
"carType": {
"maximum": 6,
"minimum": 1,
"type": "integer",
"description": "차량 종류",
"format": "int32",
"example": 1,
"default": 1,
"enum": [
1,
2,
3,
4,
5,
6
],
"x-enum-descriptions": {
"1": "소형차",
"2": "중형차",
"3": "대형차",
"4": "대형화물차",
"5": "특수화물차",
"6": "경차"
}
},
"carHeight": {
"type": "integer",
"description": "차량의 높이(cm)",
"format": "int32",
"example": 150
},
"carWeight": {
"type": "integer",
"description": "차량의 총 중량(kg)",
"format": "int32",
"example": 4000
},
"groupByTrafficColor": {
"type": "boolean",
"description": "경로의 교통 상황 색상 그룹화 여부",
"default": false,
"enum": [
false,
true
],
"x-enum-descriptions": {
"false": "교통 상황 색상 비그룹화",
"true": "교통 상황 색상 그룹화"
}
},
"useAngle": {
"type": "boolean",
"description": "출발 지점의 주행 각도 설정 여부",
"default": false,
"enum": [
false,
true
],
"x-enum-descriptions": {
"false": "주행 방향 비우선",
"true": "주행 방향 우선"
}
},
"angle": {
"maximum": 359,
"minimum": 0,
"type": "integer",
"description": "주행 각도
*정북 방향을 0으로 하여 시계 방향으로 0~359도
*'useAngle'이 true일 때 적용",
"format": "int32"
},
"useStartDirection": {
"type": "boolean",
"description": "출발지 좌표 기준 주행 방향 지정 여부
*차량 주행방향을 알 수 없을 때 활용",
"default": false,
"enum": [
false,
true
],
"x-enum-descriptions": {
"false": "출발지 좌표 기준 주행 방향 미지정",
"true": "출발지 좌표 기준 주행 방향 지정"
}
},
"searchByAddress": {
"type": "boolean",
"description": "주소 기반 경로 탐색 여부",
"default": false,
"enum": [
false,
true
],
"x-enum-descriptions": {
"false": "일반 경로 탐색",
"true": "주소 기반 경로 탐색"
}
},
"usageType": {
"maximum": 1,
"minimum": 0,
"type": "integer",
"description": "사용 용도",
"format": "int32",
"default": 0,
"enum": [
0,
1
],
"x-enum-descriptions": {
"0": "일반",
"1": "택시"
}
},
"avoidWaterSourceArea": {
"type": "boolean",
"description": "상수원 보호 구역 회피 탐색 여부",
"default": false,
"enum": [
false,
true
],
"x-enum-descriptions": {
"false": "일반 탐색",
"true": "상수원 보호 구역 회피 탐색"
}
},
"avoidNarrowRoad": {
"maximum": 16,
"minimum": 0,
"type": "integer",
"description": "좁은 길(이면도로) 회피 차선 정보
*0~16
*값은 왕복 차선의 개수
*예: 값이 6일 경우, 왕복 6차선 도로에서 차종에 관계 없이 모두 회피",
"format": "int32",
"default": 0
},
"avoidUTurn": {
"maximum": 16,
"minimum": 0,
"type": "integer",
"description": "U턴 회피 차선 정보
*0~16
*값은 왕복 차선의 개수
*예: 값이 6 일 경우, 왕복 6차선 이하 도로에서 U턴 회피",
"format": "int32",
"default": 0
},
"useTaxifare": {
"type": "string",
"description": "예상 택시 요금 조회 여부",
"default": "0",
"enum": [
"0",
"1",
"2",
"3"
],
"x-enum-descriptions": {
"0": "미사용",
"1": "일반 택시",
"2": "모범 택시",
"3": "일반 및 모범 택시"
}
}
},
"description": "일반 경로 탐색을 위한 요청 파라미터 집합
다양한 조건을 설정하여 경로를 탐색합니다"
},
"Route": {
"type": "object",
"properties": {
"option": {
"type": "string",
"description": "경로 탐색 시 사용된 옵션",
"example": "real_traffic",
"enum": [
"real_traffic",
"real_traffic2",
"real_traffic_freeroad",
"short_distance_priority",
"time_priority",
"motorcycle",
"recommendation",
"highway_priority"
],
"x-enum-descriptions": {
"motorcycle": "이륜차 경로",
"highway_priority": "고속 도로",
"short_distance_priority": "최단 거리",
"time_priority": "최소 시간",
"real_traffic": "실시간 경로",
"recommendation": "추천 경로",
"real_traffic_freeroad": "무료 도로",
"real_traffic2": "대안 경로"
}
},
"toll_fee": {
"type": "integer",
"description": "경로 상에서 발생하는 총 톨게이트 통행 요금",
"format": "int32",
"example": 3400
},
"taxiFare": {
"type": "integer",
"description": "예상 택시 요금 정보
*요청 시 'useTaxifare' 값이 1(일반) 또는 2(모범)일 때만 값이 반환",
"format": "int32",
"example": 45000
},
"totalTaxiFare": {
"type": "string",
"description": "예상 택시 요금 정보
*요금 정보가 문자열 형태로 반환
*예: \"6500\" or \"6500,11500\"",
"example": "7000"
},
"spend_time": {
"type": "integer",
"description": "경로 전체의 총 예상 소요 시간(초)",
"format": "int32",
"example": 3720
},
"distance": {
"type": "integer",
"description": "경로 전체의 총 거리(m)",
"format": "int32",
"example": 72183
},
"isHighWay": {
"type": "boolean",
"description": "해당 경로의 고속도로 포함 여부",
"example": false
},
"paths": {
"type": "array",
"description": "경로를 구성하는 각 세부 구간에 대한 정보 목록(배열)",
"items": {
"$ref": "#/components/schemas/RoutePath"
}
}
},
"description": "경로 탐색 결과 데이터"
},
"RouteNormalData": {
"type": "object",
"properties": {
"data": {
"$ref": "#/components/schemas/Route"
}
},
"description": "경로 탐색 결과"
},
"RouteNormalResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"route": {
"$ref": "#/components/schemas/RouteNormalData"
}
},
"description": "경로 탐색 API의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"route": {
"data": {
"option": "real_traffic",
"toll_fee": 3400,
"taxiFare": 45000,
"totalTaxiFare": "7000",
"spend_time": 3720,
"distance": 72183,
"isHighWay": true,
"paths": [
{
"coords": [
{
"x": "127.110762",
"y": "37.402184"
}
],
"speed": 85,
"distance": 120,
"spend_time": 2800,
"road_code": 1,
"traffic_color": "#fb3a76",
"point_type": "S"
}
]
}
}
}
},
"RouteNormalViaRequest": {
"required": [
"endX",
"endY",
"option",
"startX",
"startY"
],
"type": "object",
"properties": {
"option": {
"pattern": "^(real_traffic|real_traffic2|real_traffic_freeroad|short_distance_priority|time_priority|motorcycle|recommendation|highway_priority)$",
"type": "string",
"description": "경로 탐색 옵션
*하나만 선택 가능",
"example": "real_traffic",
"enum": [
"real_traffic",
"real_traffic2",
"real_traffic_freeroad",
"short_distance_priority",
"time_priority",
"motorcycle",
"recommendation",
"highway_priority"
],
"x-enum-descriptions": {
"motorcycle": "이륜차 경로",
"highway_priority": "고속 도로",
"short_distance_priority": "최단 거리",
"time_priority": "최소 시간",
"real_traffic": "실시간 경로",
"recommendation": "추천 경로",
"real_traffic_freeroad": "무료 도로",
"real_traffic2": "대안 경로"
}
},
"startX": {
"type": "string",
"description": "시작 지점(출발지)에 대한 X좌표(경도)",
"example": "127.110762"
},
"startY": {
"type": "string",
"description": "시작 지점(출발지)에 대한 Y좌표(위도)",
"example": "37.402184"
},
"endX": {
"type": "string",
"description": "끝 지점(도착지)에 대한 X좌표(경도)",
"example": "127.105399"
},
"endY": {
"type": "string",
"description": "끝 지점(도착지)에 대한 Y좌표(위도)",
"example": "37.5124518"
},
"coordType": {
"pattern": "^(tw|wgs84|TW|WGS84)$",
"type": "string",
"description": "좌표 체계
*'wgs84'는 국제 표준 좌표계, 'tw'는 팅크웨어 좌표계를 의미",
"default": "wgs84",
"enum": [
"wgs84",
"tw"
]
},
"viaList": {
"maxItems": 100,
"minItems": 0,
"type": "array",
"description": "경유지 정보를 담는 목록(배열)
*최대 100개 경유지 설정 가능",
"items": {
"$ref": "#/components/schemas/RouteVia"
}
},
"carType": {
"maximum": 6,
"minimum": 1,
"type": "integer",
"description": "차량 종류",
"format": "int32",
"example": 1,
"default": 1,
"enum": [
1,
2,
3,
4,
5,
6
],
"x-enum-descriptions": {
"1": "소형차",
"2": "중형차",
"3": "대형차",
"4": "대형화물차",
"5": "특수화물차",
"6": "경차"
}
},
"carHeight": {
"type": "integer",
"description": "차량의 높이(cm)",
"format": "int32",
"example": 150
},
"carWeight": {
"type": "integer",
"description": "차량의 총 중량(kg)",
"format": "int32",
"example": 4000
},
"groupByTrafficColor": {
"type": "boolean",
"description": "경로의 교통 상황 색상 그룹화 여부",
"default": false,
"enum": [
false,
true
],
"x-enum-descriptions": {
"false": "교통 상황 색상 비그룹화",
"true": "교통 상황 색상 그룹화"
}
},
"useAngle": {
"type": "boolean",
"description": "출발 지점의 주행 각도 설정 여부",
"default": false,
"enum": [
false,
true
],
"x-enum-descriptions": {
"false": "주행 방향 비우선",
"true": "주행 방향 우선"
}
},
"angle": {
"maximum": 359,
"minimum": 0,
"type": "integer",
"description": "주행 각도
*정북 방향을 0으로 하여 시계 방향으로 0~359도
*'useAngle'이 true일 때 적용",
"format": "int32"
},
"useStartDirection": {
"type": "boolean",
"description": "출발지 좌표 기준 주행 방향 지정 여부
*차량 주행방향을 알 수 없을 때 활용",
"default": false,
"enum": [
false,
true
],
"x-enum-descriptions": {
"false": "출발지 좌표 기준 주행 방향 미지정",
"true": "출발지 좌표 기준 주행 방향 지정"
}
},
"searchByAddress": {
"type": "boolean",
"description": "주소 기반 경로 탐색 여부",
"default": false,
"enum": [
false,
true
],
"x-enum-descriptions": {
"false": "일반 경로 탐색",
"true": "주소 기반 경로 탐색"
}
},
"usageType": {
"maximum": 1,
"minimum": 0,
"type": "integer",
"description": "사용 용도",
"format": "int32",
"default": 0,
"enum": [
0,
1
],
"x-enum-descriptions": {
"0": "일반",
"1": "택시"
}
},
"avoidWaterSourceArea": {
"type": "boolean",
"description": "상수원 보호 구역 회피 탐색 여부",
"default": false,
"enum": [
false,
true
],
"x-enum-descriptions": {
"false": "일반 탐색",
"true": "상수원 보호 구역 회피 탐색"
}
},
"avoidNarrowRoad": {
"maximum": 16,
"minimum": 0,
"type": "integer",
"description": "좁은 길(이면도로) 회피 차선 정보
*0~16
*값은 왕복 차선의 개수
*예: 값이 6일 경우, 왕복 6차선 도로에서 차종에 관계 없이 모두 회피",
"format": "int32",
"default": 0
},
"avoidUTurn": {
"maximum": 16,
"minimum": 0,
"type": "integer",
"description": "U턴 회피 차선 정보
*0~16
*값은 왕복 차선의 개수
*예: 값이 6 일 경우, 왕복 6차선 이하 도로에서 U턴 회피",
"format": "int32",
"default": 0
},
"useTaxifare": {
"type": "string",
"description": "예상 택시 요금 조회 여부",
"default": "0",
"enum": [
"0",
"1",
"2",
"3"
],
"x-enum-descriptions": {
"0": "미사용",
"1": "일반 택시",
"2": "모범 택시",
"3": "일반 및 모범 택시"
}
}
},
"description": "다중 경유지 탐색 100을 위한 요청 파라미터 집합
다양한 조건을 설정하여 경로를 탐색합니다"
},
"RouteNormalSummary": {
"type": "object",
"properties": {
"option": {
"type": "string",
"description": "경로 탐색 시 사용된 옵션",
"example": "real_traffic",
"enum": [
"real_traffic",
"real_traffic2",
"real_traffic_freeroad",
"short_distance_priority",
"time_priority",
"motorcycle",
"recommendation",
"highway_priority"
],
"x-enum-descriptions": {
"motorcycle": "이륜차 경로",
"highway_priority": "고속 도로",
"short_distance_priority": "최단 거리",
"time_priority": "최소 시간",
"real_traffic": "실시간 경로",
"recommendation": "추천 경로",
"real_traffic_freeroad": "무료 도로",
"real_traffic2": "대안 경로"
}
},
"toll_fee": {
"type": "integer",
"description": "경로 상에서 발생하는 총 톨게이트 통행 요금",
"format": "int32",
"example": 3400
},
"taxiFare": {
"type": "integer",
"description": "예상 택시 요금 정보
*요청 시 'useTaxifare' 값이 1(일반) 또는 2(모범)일 때만 값이 반환",
"format": "int32",
"example": 45000
},
"totalTaxiFare": {
"type": "string",
"description": "예상 택시 요금 정보
*요금 정보가 문자열 형태로 반환
*예: \"6500\" or \"6500,11500\""
},
"spend_time": {
"type": "integer",
"description": "경로 전체의 총 예상 소요 시간(초)",
"format": "int32",
"example": 3720
},
"distance": {
"type": "integer",
"description": "경로 전체의 총 거리(m)",
"format": "int32",
"example": 72183
},
"detailDistance": {
"type": "array",
"description": "경유지 간 경로 정보 요약 결과에 대한 정보 목록(배열)",
"items": {
"$ref": "#/components/schemas/Section"
}
}
},
"description": "경유지 간 경로 정보 요약 결과 데이터"
},
"RouteNormalSummaryData": {
"type": "object",
"properties": {
"data": {
"$ref": "#/components/schemas/RouteNormalSummary"
}
},
"description": "경로 탐색 결과"
},
"RouteNormalSummaryResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"route": {
"$ref": "#/components/schemas/RouteNormalSummaryData"
}
},
"description": "경로 탐색 API의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"route": {
"data": {
"option": "real_traffic",
"spend_time": 780,
"distance": 3885,
"toll_fee": 0,
"detailDistance": [
{
"position": "0|1",
"distance": 1864
},
{
"position": "1|2",
"distance": 2021
}
]
}
}
}
},
"Section": {
"type": "object",
"properties": {
"position": {
"type": "string",
"description": "요약 정보의 위치를 담는 객체
*예: 0|1 [출발지|1번째경유지]",
"example": "0|1"
},
"distance": {
"type": "integer",
"description": "경로 전체의 총 거리(m)",
"format": "int32",
"example": 2300
}
},
"description": "경유지 간 경로 정보 요약 결과에 대한 정보 목록(배열)"
},
"End": {
"required": [
"endIdx",
"endX",
"endY"
],
"type": "object",
"properties": {
"endIdx": {
"type": "string",
"description": "도착지를 구분하기 위한 고유 식별 ID",
"example": "1"
},
"endX": {
"type": "string",
"description": "끝 지점(도착지)에 대한 X좌표(경도)",
"example": "127.105399"
},
"endY": {
"type": "string",
"description": "끝 지점(도착지)에 대한 Y좌표(위도)",
"example": "37.5124518"
}
},
"description": "도착지 정보를 담는 목록(배열)
*최대 100개까지 설정 가능"
},
"RouteMultiEndRequest": {
"required": [
"data",
"startX",
"startY"
],
"type": "object",
"properties": {
"data": {
"maxItems": 100,
"minItems": 1,
"type": "array",
"description": "도착지 정보를 담는 목록(배열)
*최대 100개까지 설정 가능",
"items": {
"$ref": "#/components/schemas/End"
}
},
"startX": {
"type": "string",
"description": "시작 지점(출발지)에 대한 X좌표(경도)",
"example": "127.110762"
},
"startY": {
"type": "string",
"description": "시작 지점(출발지)에 대한 Y좌표(위도)",
"example": "37.402184"
},
"orderby": {
"maximum": 3,
"minimum": 0,
"type": "integer",
"description": "정렬 기준",
"format": "int32",
"example": 0,
"default": 0,
"enum": [
0,
1,
2,
3
],
"x-enum-descriptions": {
"0": "거리 내림차순",
"1": "거리 오름차순",
"2": "시간 내림차순",
"3": "시간 오름차순"
}
},
"useAngle": {
"type": "boolean",
"description": "출발 지점의 주행 각도 설정 여부",
"default": false,
"enum": [
false,
true
],
"x-enum-descriptions": {
"false": "주행 방향 비우선",
"true": "주행 방향 우선"
}
},
"usageType": {
"maximum": 1,
"minimum": 0,
"type": "integer",
"description": "사용 용도",
"format": "int32",
"default": 0,
"enum": [
0,
1
],
"x-enum-descriptions": {
"0": "일반",
"1": "택시"
}
},
"resultCount": {
"minimum": 0,
"type": "integer",
"description": "탐색 결과 개수
*값이 3일 경우, 모든 결과 중 상위 3개만 응답",
"format": "int32",
"example": 0,
"default": 0
}
},
"description": "단일 출발지-다중 목적지를 위한 요청 파라미터 집합
여러 출발지를 설정하여 예상 소요 시간 및 거리를 탐색합니다"
},
"EndMultiSummary": {
"required": [
"endIdx",
"endX",
"endY"
],
"type": "object",
"properties": {
"endIdx": {
"type": "string",
"description": "도착지를 구분하기 위한 고유 식별 ID",
"example": "1"
},
"endX": {
"type": "string",
"description": "시작 지점(출발지)에 대한 X좌표(경도)",
"example": "127.110762"
},
"endY": {
"type": "string",
"description": "시작 지점(출발지)에 대한 Y좌표(위도)",
"example": "37.402184"
},
"spend_time": {
"type": "integer",
"description": "경로 전체의 총 예상 소요 시간(초)",
"format": "int32",
"example": 3720
},
"distance": {
"type": "integer",
"description": "경로 전체의 총 거리(m)",
"format": "int32",
"example": 72183
}
},
"description": "단일 출발지-다중 목적지 결과 목록(배열)"
},
"RouteEndMultiResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"route": {
"$ref": "#/components/schemas/RouteEndMultiSummaryData"
}
},
"description": "단일 출발지-다중 목적지 API의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"route": {
"data": [
{
"endIdx": "example2",
"endX": "127.119387",
"endY": "37.394735",
"spend_time": 600,
"distance": 1593
},
{
"endIdx": "example1",
"endX": "127.110762",
"endY": "37.402184",
"spend_time": 300,
"distance": 1534
}
]
}
}
},
"RouteEndMultiSummaryData": {
"type": "object",
"properties": {
"data": {
"type": "array",
"description": "단일 출발지-다중 목적지 결과 목록(배열)",
"items": {
"$ref": "#/components/schemas/EndMultiSummary"
}
}
},
"description": "단일 출발지-다중 목적지 결과"
},
"PositionPoint": {
"required": [
"posX",
"posY"
],
"type": "object",
"properties": {
"posX": {
"type": "string",
"description": "해당 지점의 X좌표(경도)",
"example": "127.11075"
},
"posY": {
"type": "string",
"description": "해당 지점의 Y좌표(위도)",
"example": "37.402159"
}
},
"description": "좌표 지점들의 목록(배열)
*최대 300개 까지 가능"
},
"RouteDistanceMatrixRequest": {
"required": [
"points"
],
"type": "object",
"properties": {
"points": {
"maxItems": 100,
"minItems": 2,
"type": "array",
"description": "좌표 목록
*최소 2개에서 최대 100개의 좌표 설정 가능",
"items": {
"$ref": "#/components/schemas/PositionPoint"
}
},
"dests": {
"maxItems": 100,
"minItems": 0,
"type": "array",
"description": "목적지 좌표 목록
*최대 100개의 좌표 설정 가능",
"items": {
"$ref": "#/components/schemas/PositionPoint"
}
},
"traffic": {
"maximum": 1,
"minimum": 0,
"type": "integer",
"description": "교통 정보 유형",
"format": "int32",
"example": 0,
"default": 0,
"enum": [
0,
1
],
"x-enum-descriptions": {
"0": "미사용",
"1": "실시간"
}
},
"saveFileType": {
"maximum": 3,
"minimum": 0,
"type": "integer",
"description": "경로 정보 저장 유형
*목적지 없을 경우 동작",
"format": "int32",
"example": 0,
"default": 0,
"enum": [
0,
1,
2,
3
],
"x-enum-descriptions": {
"0": "미사용",
"1": "경로 요약 정보(RDM) 저장",
"2": "경로 선형 정보(RPM) 저장",
"3": "경로 요약 정보(RDM) 및 경로 선형 정보(RPM) 저장"
}
}
},
"description": "RDM(다중 경로 행렬)을 위한 요청 파라미터 집합
예상 소요 시간 및 거리를 탐색합니다"
},
"Distance": {
"type": "object",
"properties": {
"value": {
"type": "integer",
"description": "거리 값(m)",
"format": "int64",
"example": 19971
},
"text": {
"type": "string",
"description": "거리 값(km)",
"example": "20.0 km"
}
},
"description": "거리 정보"
},
"Duration": {
"type": "object",
"properties": {
"value": {
"type": "integer",
"description": "소요 시간 값(초)",
"format": "int64",
"example": 1437
},
"text": {
"type": "string",
"description": "소요 시간 값(분)",
"example": "23 mins"
}
},
"description": "소요 시간 정보"
},
"Element": {
"type": "object",
"properties": {
"distance": {
"$ref": "#/components/schemas/Distance"
},
"duration": {
"$ref": "#/components/schemas/Duration"
},
"status": {
"type": "string",
"description": "결과 상태 값",
"example": "OK"
}
},
"description": "경로 정보 목록
*요청 좌표 및 목적지 좌표의 순서와 동일하게 정렬"
},
"RouteDistanceMatrixResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"mode": {
"type": "string",
"description": "이동 수단",
"example": "driving"
},
"origins": {
"type": "array",
"description": "요청에 사용된 경도/위도 좌표 목록",
"example": [
127.0955,
37.417,
127.0978,
37.4113,
126.8465,
37.5683
],
"items": {
"type": "string",
"description": "sprp.response.route-distance-matrix.origins.description",
"example": "[127.0955,37.417,127.0978,37.4113,126.8465,37.5683]"
}
},
"destinations": {
"type": "array",
"description": "요청에 사용된 목적지 경도/위도 좌표 목록",
"items": {
"type": "string",
"description": "sprp.response.route-distance-matrix.destinations.description"
}
},
"rows": {
"type": "array",
"description": "RDM 결과",
"items": {
"$ref": "#/components/schemas/Row"
}
},
"rdm": {
"$ref": "#/components/schemas/rdm"
},
"rpm": {
"$ref": "#/components/schemas/rpm"
}
},
"description": "RDM(다중 경로 행렬)의 결과",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"mode": "tms",
"origins": [
"127.110762,37.402184",
"127.111412,37.39476",
"127.119387,37.394735"
],
"destinations": [
"126.9071869221794,37.53078938747262"
],
"rows": [
{
"elements": [
{
"distance": {
"value": 31489,
"text": "31.5 km"
},
"duration": {
"value": 1956,
"text": "32 mins"
},
"status": "OK"
}
]
},
{
"elements": [
{
"distance": {
"value": 30908,
"text": "30.9 km"
},
"duration": {
"value": 1857,
"text": "30 mins"
},
"status": "OK"
}
]
},
{
"elements": [
{
"distance": {
"value": 31861,
"text": "31.9 km"
},
"duration": {
"value": 1973,
"text": "32 mins"
},
"status": "OK"
}
]
}
]
}
},
"Row": {
"type": "object",
"properties": {
"elements": {
"type": "array",
"description": "경로 정보 목록
*요청 좌표 및 목적지 좌표의 순서와 동일하게 정렬",
"items": {
"$ref": "#/components/schemas/Element"
}
}
},
"description": "RDM 결과"
},
"rdm": {
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "데이터 타입",
"example": "file"
},
"form": {
"type": "string",
"description": "파일 포멧",
"example": "bin"
},
"data": {
"type": "string",
"description": "파일 이름"
},
"size": {
"type": "integer",
"description": "파일 크기",
"format": "int32",
"example": 780
},
"created": {
"type": "integer",
"description": "파일 생성 시각",
"format": "int64",
"example": 1774423476
}
},
"description": "경로 요약 정보 서버 저장 결과"
},
"rpm": {
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "데이터 타입",
"example": "file"
},
"form": {
"type": "string",
"description": "파일 포멧",
"example": "bin"
},
"data": {
"type": "string",
"description": "파일 이름"
},
"size": {
"type": "integer",
"description": "파일 크기",
"format": "int32",
"example": 780
},
"created": {
"type": "integer",
"description": "파일 생성 시각",
"format": "int64",
"example": 1774423476
}
},
"description": "경로 선형 정보 서버 저장 결과"
},
"RouteClusteringOption": {
"required": [
"maxClusterCount"
],
"type": "object",
"properties": {
"maxClusterCount": {
"minimum": 1,
"type": "integer",
"description": "최대 클러스터 개수",
"format": "int32"
},
"maxValue": {
"minimum": 0,
"type": "integer",
"description": "클러스터 할당 최대 값
*클러스터링 방식에 따라 값의 의미가 달라집니다.
*미 입력 시 자동으로 할당 됩니다.
*좌표 개수 기반: 좌표 개수
*예상 주행 거리 기반: 주행 거리(m)
*예상 소요 시간 기반: 소요 시간(분)",
"format": "int32"
},
"maxDeviation": {
"minimum": 0,
"type": "integer",
"description": "클러스터 간 최대 편차
*클러스터링 방식에 따라 값의 의미가 달라집니다.
*미 입력 시 자동으로 할당 됩니다.
*좌표 개수 기반: 좌표 개수
*예상 주행 거리 기반: 주행 거리(m)
*예상 소요 시간 기반: 소요 시간(분)",
"format": "int32"
}
},
"description": "클러스터링 옵션"
},
"RouteClusteringRequest": {
"required": [
"clusterOption",
"clusterType",
"points"
],
"type": "object",
"properties": {
"points": {
"maxItems": 100,
"minItems": 3,
"type": "array",
"description": "좌표 목록
*최소 3개 좌표 이상 요청",
"items": {
"$ref": "#/components/schemas/PositionPoint"
}
},
"clusterType": {
"maximum": 3,
"minimum": 1,
"type": "integer",
"description": "클러스터링 방식",
"format": "int32",
"enum": [
1,
2,
3
],
"x-enum-descriptions": {
"1": "좌표 개수 기반",
"2": "예상 주행 거리 기반",
"3": "예상 소요 시간 기반"
}
},
"clusterOption": {
"$ref": "#/components/schemas/RouteClusteringOption"
},
"routeType": {
"maximum": 4,
"minimum": 0,
"type": "integer",
"description": "출/도착지 고정 타입",
"format": "int32",
"default": 0,
"enum": [
0,
1,
2,
3,
4
],
"x-enum-descriptions": {
"0": "미사용",
"1": "출발지 고정",
"2": "도착지 고정",
"3": "출-도착지 고정",
"4": "출발지 회귀"
}
},
"startX": {
"type": "string",
"description": "시작 지점(출발지)에 대한 X좌표(경도)
*출발지 고정, 출발지 회귀, 출-도착지 고정 시 필요
*wgs84",
"example": "127.110762"
},
"startY": {
"type": "string",
"description": "시작 지점(출발지)에 대한 Y좌표(위도)
*출발지 고정, 출발지 회귀, 출-도착지 고정 시 필요
*wgs84",
"example": "37.402184"
},
"endX": {
"type": "string",
"description": "끝 지점(도착지)에 대한 X좌표(경도)
*도착지 고정, 출-도착지 고정 시 필요
*wgs84",
"example": "127.105399"
},
"endY": {
"type": "string",
"description": "끝 지점(도착지)에 대한 Y좌표(위도)
*도착지 고정, 출-도착지 고정 시 필요
*wgs84",
"example": "37.5124518"
}
},
"description": "Clustering API를 위한 요청 파라미터 집합"
},
"Cluster": {
"type": "object",
"properties": {
"spend_time": {
"type": "integer",
"description": "클러스터 예상 소요 시간(초)",
"format": "int32",
"example": 109
},
"distance": {
"type": "integer",
"description": "클러스터 예상 주행 거리(m)",
"format": "int32",
"example": 399
},
"points": {
"type": "array",
"description": "클러스터 좌표 목록(배열)",
"items": {
"$ref": "#/components/schemas/NumberPoint"
}
},
"summary": {
"type": "array",
"description": "클러스터 좌표 간 요약 정보 목록(배열)",
"items": {
"$ref": "#/components/schemas/DetailSummary"
}
},
"center": {
"$ref": "#/components/schemas/NumberPoint"
},
"boundary": {
"type": "array",
"description": "클러스터 영역 좌표 목록(배열)",
"items": {
"$ref": "#/components/schemas/NumberVertex"
}
}
},
"description": "클러스터링 결과 정보 목록(배열)"
},
"DetailSummary": {
"type": "object",
"properties": {
"position": {
"type": "string",
"description": "요약 정보의 위치를 담는 객체
*예: 0|1 [출발지|1번째경유지]",
"example": "0|1"
},
"spend_time": {
"type": "integer",
"description": "해당 구간의 예상 소요 시간(초)",
"format": "int32",
"example": 29
},
"distance": {
"type": "integer",
"description": "해당 구간의 예상 주행 거리(m)",
"format": "int32",
"example": 82
}
},
"description": "클러스터 좌표 간 요약 정보 목록(배열)"
},
"NumberPoint": {
"type": "object",
"properties": {
"posX": {
"type": "number",
"description": "해당 지점의 X좌표(경도)",
"example": 127.11075
},
"posY": {
"type": "number",
"description": "해당 지점의 Y좌표(위도)",
"example": 37.402159
}
},
"description": "클러스터 영역 중심 좌표"
},
"RouteClustering": {
"type": "object",
"properties": {
"clusters": {
"type": "array",
"description": "클러스터링 결과 정보 목록(배열)",
"items": {
"$ref": "#/components/schemas/Cluster"
}
}
},
"description": "클러스터링 결과 데이터"
},
"RouteClusteringData": {
"type": "object",
"properties": {
"data": {
"$ref": "#/components/schemas/RouteClustering"
}
},
"description": "클러스터링 결과"
},
"RouteClusteringResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"route": {
"$ref": "#/components/schemas/RouteClusteringData"
}
},
"description": "클러스터링 API 의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"route": {
"data": {
"clusters": [
{
"spend_time": 96,
"distance": 312,
"points": [
{
"posX": 126.85066,
"posY": 37.470229
},
{
"posX": 126.850683,
"posY": 37.469485
},
{
"posX": 126.851302,
"posY": 37.468985
},
{
"posX": 126.85165,
"posY": 37.469683
}
],
"summary": [
{
"position": "0|1",
"spend_time": 29,
"distance": 82
},
{
"position": "1|2",
"spend_time": 30,
"distance": 83
},
{
"position": "2|3",
"spend_time": 37,
"distance": 147
}
],
"center": {
"posX": 126.8511192839822,
"posY": 37.4696171715002
},
"boundary": [
{
"x": 126.85066,
"y": 37.470229
},
{
"x": 126.850683,
"y": 37.469485
},
{
"x": 126.851302,
"y": 37.468985
},
{
"x": 126.85165,
"y": 37.469683
},
{
"x": 126.85066,
"y": 37.470229
}
]
},
{
"spend_time": 27,
"distance": 154,
"points": [
{
"posX": 126.851759,
"posY": 37.471893
},
{
"posX": 126.851726,
"posY": 37.4707
},
{
"posX": 126.851956,
"posY": 37.470604
},
{
"posX": 126.851668,
"posY": 37.47047
}
],
"summary": [
{
"position": "0|1",
"spend_time": 23,
"distance": 129
},
{
"position": "1|2",
"spend_time": 1,
"distance": 9
},
{
"position": "2|3",
"spend_time": 3,
"distance": 16
}
],
"center": {
"posX": 126.85187252948512,
"posY": 37.4710120986968
},
"boundary": [
{
"x": 126.851668,
"y": 37.47047
},
{
"x": 126.851956,
"y": 37.470604
},
{
"x": 126.851759,
"y": 37.471893
},
{
"x": 126.851668,
"y": 37.47047
}
]
},
{
"spend_time": 99,
"distance": 625,
"points": [
{
"posX": 126.849473,
"posY": 37.472311
},
{
"posX": 126.850187,
"posY": 37.472953
},
{
"posX": 126.850876,
"posY": 37.472735
},
{
"posX": 126.851804,
"posY": 37.469279
}
],
"summary": [
{
"position": "0|1",
"spend_time": 20,
"distance": 141
},
{
"position": "1|2",
"spend_time": 9,
"distance": 66
},
{
"position": "2|3",
"spend_time": 70,
"distance": 418
}
],
"center": {
"posX": 126.85066770520658,
"posY": 37.47156860669662
},
"boundary": [
{
"x": 126.849473,
"y": 37.472311
},
{
"x": 126.851804,
"y": 37.469279
},
{
"x": 126.850876,
"y": 37.472735
},
{
"x": 126.850187,
"y": 37.472953
},
{
"x": 126.849473,
"y": 37.472311
}
]
}
]
}
}
}
},
"MapMatchRoadRequest": {
"required": [
"paths",
"userId"
],
"type": "object",
"properties": {
"userId": {
"type": "string",
"description": "사용자를 구분하기 위한 고유 식별 ID"
},
"paths": {
"maxItems": 2147483647,
"minItems": 1,
"type": "array",
"description": "경로를 구성하는 각 지점에 대한 정보 목록(배열)",
"items": {
"$ref": "#/components/schemas/RoadMatchRequestPath"
}
}
}
},
"RoadMatchRequestPath": {
"required": [
"time",
"x",
"y"
],
"type": "object",
"properties": {
"time": {
"type": "integer",
"description": "해당 경로의 시간
*Unix time",
"format": "int64",
"example": 1768795262
},
"x": {
"minimum": 0,
"exclusiveMinimum": false,
"type": "number",
"description": "해당 지점의 X좌표(경도)",
"format": "double"
},
"y": {
"minimum": 0,
"exclusiveMinimum": false,
"type": "number",
"description": "해당 지점의 Y좌표(위도)",
"format": "double"
}
},
"description": "경로를 구성하는 각 지점에 대한 정보 목록(배열)"
},
"AccelDrivingEvent": {
"type": "object",
"properties": {
"startTimestamp": {
"type": "integer",
"description": "이벤트 시작 시간",
"format": "int64",
"example": 1669848945
},
"endTimestamp": {
"type": "integer",
"description": "이벤트 종료 시간",
"format": "int64",
"example": 1669848945
},
"eventLevel": {
"type": "integer",
"description": "급가속 이벤트 레벨
*1~3초 이내 속도 증가 기준",
"format": "int32",
"example": 1,
"enum": [
1,
2,
3,
4,
5
],
"x-enum-descriptions": {
"1": "10km/h 이상",
"2": "15km/h 이상",
"3": "20km/h 이상",
"4": "25km/h 이상",
"5": "30km/h 이상"
}
}
},
"description": "급가속 이벤트 리스트"
},
"DecelDrivingEvent": {
"type": "object",
"properties": {
"startTimestamp": {
"type": "integer",
"description": "이벤트 시작 시간",
"format": "int64",
"example": 1669848945
},
"endTimestamp": {
"type": "integer",
"description": "이벤트 종료 시간",
"format": "int64",
"example": 1669848945
},
"eventLevel": {
"type": "integer",
"description": "급감속 이벤트 레벨
*1~3초 이내 속도 증가 기준",
"format": "int32",
"example": 1,
"enum": [
1,
2,
3,
4,
5
],
"x-enum-descriptions": {
"1": "10km/h 이상",
"2": "15km/h 이상",
"3": "20km/h 이상",
"4": "25km/h 이상",
"5": "30km/h 이상"
}
}
},
"description": "급감속 이벤트 리스트"
},
"MapMatchPath": {
"type": "object",
"properties": {
"x": {
"type": "number",
"description": "해당 지점의 X좌표(경도)",
"format": "double",
"example": 127.105399
},
"y": {
"type": "number",
"description": "해당 지점의 Y좌표(위도)",
"format": "double",
"example": 37.5124518
},
"errorDistance": {
"type": "number",
"description": "요청 좌표와 매칭된 좌표와의 거리(m)",
"format": "double",
"example": 0
},
"angle": {
"type": "integer",
"description": "해당 지점의 진행 각도",
"format": "int32",
"example": 62
},
"roadAttr": {
"type": "integer",
"description": "도로 속성 정보",
"format": "int32",
"example": 0,
"enum": [
1,
2,
3,
4,
17,
18,
19,
20
],
"x-enum-descriptions": {
"1": "일반 도로",
"2": "JC(연결로)",
"3": "IC(램프)",
"4": "휴게소",
"17": "톨게이트 & 일반도로",
"18": "톨게이트 & JC(연결로)",
"19": "톨게이트 & IC(램프)",
"20": "톨게이트 & 휴게소"
}
},
"roadType": {
"type": "integer",
"description": "도로 종별 정보",
"format": "int32",
"example": 0,
"enum": [
0,
1,
2,
3,
4,
5
],
"x-enum-descriptions": {
"0": "미조사 도로",
"1": "고속자동차도로",
"2": "도시고속도로",
"3": "국도",
"4": "지방도",
"5": "일반도로"
}
},
"speed": {
"type": "integer",
"description": "해당 지점의 진행 속도",
"format": "int32",
"example": 73
},
"speedLimit": {
"type": "integer",
"description": "해당 지점의 도로 제한 속도",
"format": "int32",
"example": 30
},
"datetime": {
"type": "string",
"description": "해당 지점을 지난 시간",
"example": "2026-01-01 10:05:22"
}
},
"description": "경로를 구성하는 각 세부 구간에 대한 정보 목록(배열)"
},
"MapMatchRoadResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"roadMatch": {
"$ref": "#/components/schemas/roadMatch"
}
},
"description": "Road Map Matching 의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"roadMatch": {
"userId": "example",
"tollFee": 1200,
"totalDistance": 4038,
"totalPointCount": 141,
"safeDrivingScore": 71,
"safeDrivingEvents": {
"accel_events": [
{
"start_timestamp": 1669848945,
"end_timestamp": 1669848945,
"event_level": 1
}
],
"decel_events": [
{
"start_timestamp": 1669848945,
"end_timestamp": 1669848945,
"event_level": 1
}
],
"overspeed_events": [
{
"start_timestamp": 1669848945,
"end_timestamp": 1669848945,
"event_level": 1
}
]
},
"paths": [
{
"x": 128.91883308127652,
"y": 35.09120807737007,
"errorDistance": 0,
"angle": 0,
"roadAttr": 1,
"roadType": 5,
"speed": 0,
"speedLimit": 0,
"datetime": "2026-01-19 13:01:02"
},
{
"x": 128.9187838298793,
"y": 35.091293029004326,
"errorDistance": 0,
"angle": 0,
"roadAttr": 1,
"roadType": 5,
"speed": 0,
"speedLimit": 0,
"datetime": "2026-01-19 13:01:03"
},
{
"x": 128.9187838298793,
"y": 35.091293029004326,
"errorDistance": 0,
"angle": 0,
"roadAttr": 1,
"roadType": 5,
"speed": 25,
"speedLimit": 0,
"datetime": "2026-01-19 13:01:04"
},
{
"x": 128.9187838298793,
"y": 35.091293029004326,
"errorDistance": 0,
"angle": 0,
"roadAttr": 0,
"roadType": 0,
"speed": 25,
"speedLimit": 0,
"datetime": "2026-01-19 13:01:05"
},
{
"x": 128.9187838298793,
"y": 35.091293029004326,
"errorDistance": 0,
"angle": 0,
"roadAttr": 0,
"roadType": 0,
"speed": 57,
"speedLimit": 0,
"datetime": "2026-01-19 13:01:06"
}
]
}
}
},
"OverSpeedDrivingEvent": {
"type": "object",
"properties": {
"startTimestamp": {
"type": "integer",
"description": "이벤트 시작 시간",
"format": "int64",
"example": 1669848945
},
"endTimestamp": {
"type": "integer",
"description": "이벤트 종료 시간",
"format": "int64",
"example": 1669848945
},
"eventLevel": {
"type": "integer",
"description": "과속 이벤트 레벨
*2회 이상 제한속도 초과 기준",
"format": "int32",
"example": 1,
"enum": [
1,
2,
3,
4,
5,
6
],
"x-enum-descriptions": {
"1": "10km/h 이상",
"2": "20km/h 이상",
"3": "30km/h 이상",
"4": "40km/h 이상",
"5": "50km/h 이상",
"6": "60km/h 이상"
}
}
},
"description": "과속 이벤트 리스트"
},
"SafeDrivingEvent": {
"type": "object",
"properties": {
"accelEvents": {
"type": "array",
"description": "급가속 이벤트 리스트",
"items": {
"$ref": "#/components/schemas/AccelDrivingEvent"
}
},
"decelEvents": {
"type": "array",
"description": "급감속 이벤트 리스트",
"items": {
"$ref": "#/components/schemas/DecelDrivingEvent"
}
},
"overspeedEvents": {
"type": "array",
"description": "과속 이벤트 리스트",
"items": {
"$ref": "#/components/schemas/OverSpeedDrivingEvent"
}
}
},
"description": "경로 전체의 안전 운행 이벤트 정보"
},
"roadMatch": {
"type": "object",
"properties": {
"userId": {
"type": "string",
"description": "사용자를 구분하기 위한 고유 식별 ID"
},
"tollFee": {
"type": "integer",
"description": "경로 상에서 발생하는 총 톨게이트 통행 요금",
"format": "int32",
"example": 1200
},
"totalDistance": {
"type": "integer",
"description": "경로 전체의 총 거리(m)",
"format": "int32",
"example": 4038
},
"totalPointCount": {
"type": "integer",
"description": "경로 전체의 총 지점 개수",
"format": "int32",
"example": 141
},
"safeDrivingScore": {
"type": "integer",
"description": "경로 전체의 안전 운행 점수",
"format": "int32",
"example": 71
},
"safeDrivingEvents": {
"$ref": "#/components/schemas/SafeDrivingEvent"
},
"paths": {
"type": "array",
"description": "경로를 구성하는 각 세부 구간에 대한 정보 목록(배열)",
"items": {
"$ref": "#/components/schemas/MapMatchPath"
}
}
},
"description": "Road Map Matching 결과"
},
"MapMatchPreRequest": {
"required": [
"paths",
"userId"
],
"type": "object",
"properties": {
"userId": {
"type": "string",
"description": "사용자를 구분하기 위한 고유 식별 ID"
},
"paths": {
"maxItems": 2147483647,
"minItems": 1,
"type": "array",
"description": "경로를 구성하는 각 지점에 대한 정보 목록(배열)",
"items": {
"$ref": "#/components/schemas/MapMatchRequestPath"
}
}
}
},
"MapMatchRequestPath": {
"required": [
"angle",
"speed",
"time",
"x",
"y"
],
"type": "object",
"properties": {
"time": {
"type": "integer",
"description": "해당 경로의 시간
*Unix time",
"format": "int64",
"example": 1768795262
},
"x": {
"minimum": 0,
"exclusiveMinimum": false,
"type": "number",
"description": "해당 지점의 X좌표(경도)",
"format": "double"
},
"y": {
"minimum": 0,
"exclusiveMinimum": false,
"type": "number",
"description": "해당 지점의 Y좌표(위도)",
"format": "double"
},
"speed": {
"minimum": 0,
"type": "integer",
"description": "해당 지점의 속도",
"format": "int32"
},
"angle": {
"maximum": 359,
"minimum": 0,
"type": "integer",
"description": "해당 지점의 각도",
"format": "int32"
}
},
"description": "경로를 구성하는 각 지점에 대한 정보 목록(배열)"
},
"MapMatchPreResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"roadMatch": {
"$ref": "#/components/schemas/roadMatch"
}
},
"description": "Preprocess Map Matching 의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"roadMatch": {
"userId": "example",
"tollFee": 1200,
"totalDistance": 4038,
"totalPointCount": 141,
"safeDrivingScore": 71,
"safeDrivingEvents": {
"accel_events": [
{
"start_timestamp": 1669848945,
"end_timestamp": 1669848945,
"event_level": 1
}
],
"decel_events": [
{
"start_timestamp": 1669848945,
"end_timestamp": 1669848945,
"event_level": 1
}
],
"overspeed_events": [
{
"start_timestamp": 1669848945,
"end_timestamp": 1669848945,
"event_level": 1
}
]
},
"paths": [
{
"x": 128.91883308127652,
"y": 35.09120807737007,
"errorDistance": 0,
"angle": 0,
"roadAttr": 1,
"roadType": 5,
"speed": 20,
"speedLimit": 0,
"datetime": "2026-01-19 13:01:02"
},
{
"x": 128.91880220090727,
"y": 35.09126134160178,
"errorDistance": 0,
"angle": 0,
"roadAttr": 1,
"roadType": 5,
"speed": 20,
"speedLimit": 0,
"datetime": "2026-01-19 13:01:03"
},
{
"x": 128.91877027727705,
"y": 35.09131640530984,
"errorDistance": 0,
"angle": 0,
"roadAttr": 1,
"roadType": 5,
"speed": 20,
"speedLimit": 0,
"datetime": "2026-01-19 13:01:04"
},
{
"x": 128.91876805734992,
"y": 35.091320234367515,
"errorDistance": 0,
"angle": 0,
"roadAttr": 1,
"roadType": 5,
"speed": 20,
"speedLimit": 0,
"datetime": "2026-01-19 13:01:05"
},
{
"x": 128.91876805734992,
"y": 35.091320234367515,
"errorDistance": 0,
"angle": 0,
"roadAttr": 0,
"roadType": 0,
"speed": 20,
"speedLimit": 0,
"datetime": "2026-01-19 13:01:06"
}
]
}
}
},
"SearchPolygonToAdminRequest": {
"required": [
"polygon"
],
"type": "object",
"properties": {
"polygon": {
"maxItems": 2147483647,
"minItems": 3,
"type": "array",
"description": "검색 할 좌표를 담는 목록(배열)
*최소 3개 이상 입력",
"items": {
"$ref": "#/components/schemas/NumberVertex"
}
},
"coordtype": {
"maximum": 1,
"minimum": 0,
"type": "string",
"description": "좌표 체계",
"default": "1",
"enum": [
"0",
"1"
],
"x-enum-descriptions": {
"0": "TW 좌표",
"1": "WGS84 좌표"
}
},
"mode": {
"maximum": 2,
"minimum": 0,
"type": "integer",
"description": "검색 구역 범위",
"format": "int32",
"default": 0,
"enum": [
0,
1,
2
],
"x-enum-descriptions": {
"0": "법정동,행정동",
"1": "법정동",
"2": "행정동"
}
}
},
"description": "행정/법정동 영역 검색을 위한 요청 파라미터 집합"
},
"AdminCode": {
"type": "object",
"properties": {
"AdminCode": {
"type": "string",
"description": "행정동/법정동 코드",
"example": "4113510900"
},
"Address": {
"type": "string",
"description": "법정동/행정동 주소",
"example": "경기도 성남시 분당구 삼평동"
}
},
"description": "행정구역 정보 목록(배열)"
},
"AdminData": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"description": "행정구역 개수",
"format": "int32",
"example": 192
},
"admincodelist": {
"type": "array",
"description": "행정구역 정보 목록(배열)",
"items": {
"$ref": "#/components/schemas/AdminCode"
}
}
},
"description": "행정구역 정보 목록(배열)"
},
"PolygonToAdminData": {
"type": "object",
"properties": {
"result": {
"type": "boolean",
"description": "검색 결과 성공 여부",
"example": true
},
"admincodes": {
"$ref": "#/components/schemas/AdminData"
}
},
"description": "행정/법정동 영역 검색 결과"
},
"SearchPolygonToAdminResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"adm": {
"$ref": "#/components/schemas/PolygonToAdminData"
}
},
"description": "행정/법정동 영역 검색 API의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"adm": {
"result": true,
"admincodes": {
"count": 2,
"admincodelist": [
{
"adminCode": "4113510900",
"address": "경기도 성남시 분당구 삼평동"
},
{
"adminCode": "4113565500",
"address": "경기도 성남시 분당구 삼평동"
}
]
}
}
}
},
"SearchMultiAddressesRequest": {
"required": [
"points"
],
"type": "object",
"properties": {
"points": {
"maxItems": 300,
"minItems": 1,
"type": "array",
"description": "좌표 지점들의 목록(배열)
*최대 300개 까지 가능",
"items": {
"$ref": "#/components/schemas/PositionPoint"
}
},
"coordtype": {
"maximum": 1,
"minimum": 0,
"type": "string",
"description": "좌표 체계",
"default": "1",
"enum": [
"0",
"1"
],
"x-enum-descriptions": {
"0": "TW 좌표",
"1": "WGS84 좌표"
}
}
},
"description": "다중 리버스 지오코딩을 위한 요청 파라미터 집합"
},
"AddressesAdm": {
"type": "object",
"properties": {
"posx": {
"type": "string",
"description": "X좌표(경도) 값",
"example": "127.11065"
},
"posy": {
"type": "string",
"description": "Y좌표(위도) 값",
"example": "37.402109"
},
"address": {
"type": "string",
"description": "전체 주소",
"example": "경기도 성남시 분당구 삼평동"
},
"jibun": {
"type": "string",
"description": "지번 정보",
"example": "678"
},
"roadname": {
"type": "string",
"description": "도로명 주소",
"example": "경기도 성남시 분당구 판교역로"
},
"roadjibun": {
"type": "string",
"description": "건물 번호",
"example": "240"
},
"admcode": {
"type": "string",
"description": "법정구역 코드",
"example": "4113510900"
},
"postcode": {
"type": "string",
"description": "우편번호
*주소+지번 검색 시 제공",
"example": "13493"
},
"bldname": {
"type": "string",
"description": "건물 명칭
*도로명 주소 검색 시 제공",
"example": "삼환하이펙스A동"
},
"bldnum": {
"type": "string",
"description": "동호수 정보",
"example": "102동"
}
},
"description": "기본(법정동) 주소 정보"
},
"AddressesData": {
"type": "object",
"properties": {
"result": {
"type": "boolean",
"description": "검색 결과 성공 여부",
"example": true
},
"hasAdmAddress": {
"type": "boolean",
"description": "행정동 주소 반환 여부",
"example": true
},
"adm": {
"$ref": "#/components/schemas/AddressesAdm"
},
"adm_address": {
"$ref": "#/components/schemas/adm_address"
},
"legal_address": {
"$ref": "#/components/schemas/legal_address"
}
},
"description": "다중 리버스 지오코딩 정보 목록(배열)"
},
"MultiAddressesData": {
"type": "object",
"properties": {
"result": {
"type": "boolean",
"description": "검색 결과 성공 여부",
"example": true
},
"admlist": {
"type": "array",
"description": "다중 리버스 지오코딩 정보 목록(배열)",
"items": {
"$ref": "#/components/schemas/AddressesData"
}
}
},
"description": "다중 리버스 지오코딩 결과"
},
"SearchMultiAddressesResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"location": {
"$ref": "#/components/schemas/MultiAddressesData"
}
},
"description": "다중 리버스 지오코딩 API의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"location": {
"result": true,
"admlist": [
{
"result": true,
"hasAdmAddress": true,
"adm": {
"posX": "127.110450",
"posY": "37.402125",
"address": "경기도 성남시 분당구 삼평동",
"jibun": "678",
"roadname": "경기도 성남시 분당구 판교역로",
"roadjibun": "240",
"admcode": "4113510900",
"postcode": "13493",
"bldname": "삼환하이펙스A동",
"bldnum": ""
},
"adm_address": {
"address": "경기도 성남시 분당구 삼평동",
"jibun": "678",
"cut_address": "경기 성남시 분당구 삼평동",
"admcode": "4113565500",
"address_category1": "경기도",
"address_category2": "성남시 분당구",
"address_category3": "삼평동",
"address_category4": ""
},
"legal_address": {
"address": "경기도 성남시 분당구 삼평동",
"jibun": "678",
"cut_address": "경기 성남시 분당구 삼평동",
"admcode": "4113510900",
"address_category1": "경기도",
"address_category2": "성남시 분당구",
"address_category3": "삼평동",
"address_category4": ""
}
},
{
"result": true,
"hasAdmAddress": true,
"adm": {
"posX": "127.110963",
"posY": "37.394885",
"address": "경기도 성남시 분당구 백현동",
"jibun": "534-1",
"roadname": "경기도 성남시 분당구 분당내곡로",
"roadjibun": "121",
"admcode": "4113511000",
"postcode": "13529",
"bldname": "판교역 KTX",
"bldnum": ""
},
"adm_address": {
"address": "경기도 성남시 분당구 백현동",
"jibun": "534-1",
"cut_address": "경기 성남시 분당구 백현동",
"admcode": "4113565700",
"address_category1": "경기도",
"address_category2": "성남시 분당구",
"address_category3": "백현동",
"address_category4": ""
},
"legal_address": {
"address": "경기도 성남시 분당구 백현동",
"jibun": "534-1",
"cut_address": "경기 성남시 분당구 백현동",
"admcode": "4113511000",
"address_category1": "경기도",
"address_category2": "성남시 분당구",
"address_category3": "백현동",
"address_category4": ""
}
}
]
}
}
},
"adm_address": {
"type": "object",
"properties": {
"address": {
"type": "string",
"description": "전체 주소",
"example": "경기도 성남시 분당구 삼평동"
},
"jibun": {
"type": "string",
"description": "지번 정보",
"example": "678"
},
"cut_address": {
"type": "string",
"description": "축약 주소",
"example": "경기 성남시 분당구 삼평동"
},
"admcode": {
"type": "string",
"description": "법정구역 코드",
"example": "4113510900"
},
"address_category1": {
"type": "string",
"description": "시도 정보",
"example": "경기도"
},
"address_category2": {
"type": "string",
"description": "시군구 정보",
"example": "성남시 분당구"
},
"address_category3": {
"type": "string",
"description": "읍면동 정보",
"example": "삼평동"
},
"address_category4": {
"type": "string",
"description": "리 정보"
}
},
"description": "행정동 주소 정보"
},
"legal_address": {
"type": "object",
"properties": {
"address": {
"type": "string",
"description": "전체 주소",
"example": "경기도 성남시 분당구 삼평동"
},
"jibun": {
"type": "string",
"description": "지번 정보",
"example": "678"
},
"cut_address": {
"type": "string",
"description": "축약 주소",
"example": "경기 성남시 분당구 삼평동"
},
"admcode": {
"type": "string",
"description": "법정구역 코드",
"example": "4113510900"
},
"address_category1": {
"type": "string",
"description": "시도 정보",
"example": "경기도"
},
"address_category2": {
"type": "string",
"description": "시군구 정보",
"example": "성남시 분당구"
},
"address_category3": {
"type": "string",
"description": "읍면동 정보",
"example": "삼평동"
},
"address_category4": {
"type": "string",
"description": "리 정보"
}
},
"description": "법정동 주소 정보"
},
"MapMatch100Request": {
"required": [
"coords"
],
"type": "object",
"properties": {
"coords": {
"type": "string",
"description": "맵매칭 요청 할 좌표
*경도와 위도 사이는 ‘,’로 구분, 좌표와 좌표 사이는 ‘|’ 로 구분
*최대 100개 까지 가능",
"example": "126.95042955033101,37.39952907832974|126.95100890747277,37.39935861417968"
},
"responseType": {
"maximum": 2,
"minimum": 1,
"type": "integer",
"description": "데이터 요청 타입",
"format": "int32",
"default": 1,
"enum": [
1,
2
],
"x-enum-descriptions": {
"1": "전체 데이터 요청",
"2": "요청좌표 및 매치된좌표를 제외한 데이터 요청"
}
}
}
},
"Location": {
"type": "object",
"properties": {
"latitude": {
"type": "string",
"description": "좌표의 위도",
"example": "37.399343674475396"
},
"longitude": {
"type": "string",
"description": "좌표의 경도",
"example": "126.95049099397443"
}
},
"description": "매칭된 좌표의 정보
*보간점의 경우 이전의 매칭된 링크의 연결성을 유지하기 위한 정보"
},
"MapMatch100Response": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"roadMatch": {
"$ref": "#/components/schemas/MapMatchSLData"
}
},
"description": "MTR 100 의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"roadMatch": {
"requestPointCount": 19,
"totalDistance": 1995,
"totalPointCount": 64,
"matchedLinkCount": 20,
"matchedPoints": [
{
"idxName": "185316",
"linkId": "185316003366003907",
"sourceIndex": 18,
"sourceLocation": {
"latitude": "37.39865118381423",
"longitude": "126.96302788610492"
},
"matchedLocation": {
"latitude": "37.398552722989585",
"longitude": "126.96306223005134"
},
"speed": 0,
"roadCategory": 6,
"endPoint": "Y"
}
]
}
}
},
"MapMatchSLData": {
"type": "object",
"properties": {
"requestPointCount": {
"type": "integer",
"description": "요청한 좌표의 개수",
"format": "int32"
},
"totalDistance": {
"type": "integer",
"description": "맵매칭 경로의 총 거리(m)",
"format": "int32"
},
"totalPointCount": {
"type": "integer",
"description": "총 좌표의 개수",
"format": "int32"
},
"matchedLinkCount": {
"type": "integer",
"description": "매칭 된 링크의 개수",
"format": "int32"
},
"matchedPoints": {
"type": "array",
"description": "맵매칭 된 정보 데이터에 대한 정보 목록(배열)",
"items": {
"$ref": "#/components/schemas/MatchedPoints"
}
}
},
"description": "MTR 100 결과"
},
"MatchedPoints": {
"type": "object",
"properties": {
"idxName": {
"type": "string",
"description": "링크의 Mesh ID",
"example": "185316"
},
"linkId": {
"type": "string",
"description": "매칭된 링크의 ID",
"example": "185316000665004661"
},
"sourceIndex": {
"type": "integer",
"description": "요청된 좌표의 순번
*보간점의 경우 sourceIndex가 없음",
"format": "int32"
},
"sourceLocation": {
"$ref": "#/components/schemas/Location"
},
"matchedLocation": {
"$ref": "#/components/schemas/Location"
},
"speed": {
"type": "integer",
"description": "매칭된 링크의 제한속도(km/h)",
"format": "int32",
"example": 20
},
"roadCategory": {
"type": "integer",
"description": "도로 속성",
"format": "int32",
"example": 6,
"enum": [
0,
1,
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13
],
"x-enum-descriptions": {
"0": "고속국도",
"1": "도시고속화도로",
"2": "국도",
"3": "국가지원지방도",
"4": "지방도",
"5": "주요도로 1",
"6": "주요도로 2",
"7": "주요도로 3",
"8": "기타도로 1",
"9": "이면도로",
"10": "페리항로",
"11": "단지내 도로",
"12": "이면도로 2(세도로)",
"13": "도로 아님(오프로드)"
}
},
"endPoint": {
"type": "string",
"description": "매칭 종료 포인트",
"example": "Y"
}
},
"description": "맵매칭 된 정보 데이터에 대한 정보 목록(배열)"
},
"MapMatch1000Request": {
"required": [
"coords"
],
"type": "object",
"properties": {
"coords": {
"type": "string",
"description": "맵매칭 요청 할 좌표
*경도와 위도 사이는 ‘,’로 구분, 좌표와 좌표 사이는 ‘|’ 로 구분
*최대 1000개 까지 가능",
"example": "126.95042955033101,37.39952907832974|126.95100890747277,37.39935861417968"
},
"responseType": {
"maximum": 2,
"minimum": 1,
"type": "integer",
"description": "데이터 요청 타입",
"format": "int32",
"default": 1,
"enum": [
1,
2
],
"x-enum-descriptions": {
"1": "전체 데이터 요청",
"2": "요청좌표 및 매치된좌표를 제외한 데이터 요청"
}
}
}
},
"MapMatch1000Response": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"roadMatch": {
"$ref": "#/components/schemas/MapMatchSLData"
}
},
"description": "MTR 1000 의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"roadMatch": {
"requestPointCount": 20,
"totalDistance": 2046,
"totalPointCount": 68,
"matchedLinkCount": 21,
"matchedPoints": [
{
"idxName": "185316",
"linkId": "185316003366003907",
"sourceIndex": 18,
"sourceLocation": {
"latitude": "37.39865118381423",
"longitude": "126.96302788610492"
},
"matchedLocation": {
"latitude": "37.398552722989585",
"longitude": "126.96306223005134"
},
"speed": 0,
"roadCategory": 6,
"endPoint": "Y"
}
]
}
}
},
"MapMatchPlusRequest": {
"required": [
"paths",
"userId"
],
"type": "object",
"properties": {
"userId": {
"type": "string",
"description": "사용자를 구분하기 위한 고유 식별 ID"
},
"paths": {
"maxItems": 2147483647,
"minItems": 1,
"type": "array",
"description": "경로를 구성하는 각 지점에 대한 정보 목록(배열)",
"items": {
"$ref": "#/components/schemas/MapMatchRequestPath"
}
}
}
},
"MapMatchPlusResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"roadMatch": {
"$ref": "#/components/schemas/roadMatch"
}
},
"description": "Special Map Matching 의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"roadMatch": {
"userId": "example",
"tollFee": 1200,
"totalDistance": 4038,
"totalPointCount": 141,
"safeDrivingScore": 71,
"safeDrivingEvents": {
"accel_events": [
{
"start_timestamp": 1669848945,
"end_timestamp": 1669848945,
"event_level": 1
}
],
"decel_events": [
{
"start_timestamp": 1669848945,
"end_timestamp": 1669848945,
"event_level": 1
}
],
"overspeed_events": [
{
"start_timestamp": 1669848945,
"end_timestamp": 1669848945,
"event_level": 1
}
]
},
"paths": [
{
"x": 128.91883308127652,
"y": 35.09120807737007,
"errorDistance": 0,
"angle": 336,
"roadAttr": 1,
"roadType": 5,
"speed": 20,
"speedLimit": 0,
"datetime": "2026-01-19 13:01:02"
},
{
"x": 128.91877728800293,
"y": 35.09130431280779,
"errorDistance": 0,
"angle": 336,
"roadAttr": 1,
"roadType": 5,
"speed": 20,
"speedLimit": 0,
"datetime": "2026-01-19 13:01:03"
},
{
"x": 128.91877728800293,
"y": 35.09130431280779,
"errorDistance": 0,
"angle": 336,
"roadAttr": 1,
"roadType": 5,
"speed": 20,
"speedLimit": 0,
"datetime": "2026-01-19 13:01:04"
},
{
"x": 128.91877728800293,
"y": 35.09130431280779,
"errorDistance": 0,
"angle": 336,
"roadAttr": 0,
"roadType": 0,
"speed": 20,
"speedLimit": 0,
"datetime": "2026-01-19 13:01:05"
},
{
"x": 128.91877728800293,
"y": 35.09130431280779,
"errorDistance": 0,
"angle": 0,
"roadAttr": 0,
"roadType": 0,
"speed": 20,
"speedLimit": 0,
"datetime": "2026-01-19 13:01:06"
}
]
}
}
},
"RequestRpm": {
"required": [
"data",
"form",
"size",
"type"
],
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "데이터 타입"
},
"form": {
"type": "string",
"description": "파일 포멧"
},
"data": {
"type": "string",
"description": "파일 이름"
},
"size": {
"type": "integer",
"description": "파일 크기",
"format": "int32"
},
"created": {
"type": "integer",
"description": "파일 생성 시각",
"format": "int64"
}
},
"description": "경로 선형 정보 객체"
},
"RoutePathMatrixDemoRequest": {
"required": [
"id",
"routes",
"rpm"
],
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "사용자를 구분하기 위한 고유 식별 ID"
},
"rpm": {
"$ref": "#/components/schemas/RequestRpm"
},
"routes": {
"maxItems": 2147483647,
"minItems": 1,
"type": "array",
"description": "rdm에서 생성된 경로 선형의 필요 구간 index",
"items": {
"type": "array",
"description": "sprp.request.route-path-matrix-demo.routes.description",
"items": {
"type": "integer",
"description": "sprp.request.route-path-matrix-demo.routes.description",
"format": "int32"
}
}
}
},
"description": "Path Matrix 를 위한 요청 파라미터 집합"
},
"RoutePathMatrixDemoResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"routes": {
"type": "array",
"description": "실제 선형 데이터 목록(배열)",
"items": {
"$ref": "#/components/schemas/Rpm"
}
}
},
"description": "Path Matrix (RPM)의 결과",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"routes": [
{
"index": [
0,
1
],
"vertices": [
[
126.8501929372,
37.4729653408
],
[
126.8505245864,
37.4728648412
],
[
126.8512370474,
37.4726315185
],
[
126.8510620556,
37.4723482529
],
[
126.850899525,
37.4721149906
],
[
126.8507370261,
37.471956631
],
[
126.8504995696,
37.4717566671
],
[
126.8495246391,
37.4710233691
],
[
126.8492247449,
37.4707733943
],
[
126.8490747546,
37.470581751
],
[
126.8488872594,
37.4706984351
],
[
126.8489497372,
37.4709400723
],
[
126.848987245,
37.4711400194
],
[
126.8490996556,
37.4717399502
],
[
126.8492371704,
37.4721316256
],
[
126.8493246658,
37.4723315775
],
[
126.849459999,
37.4722864448
]
]
},
{
"index": [
2,
3
],
"vertices": [
[
126.8517700621,
37.4719186648
],
[
126.8519369588,
37.4718733532
],
[
126.8519119661,
37.4717816383
],
[
126.8518994745,
37.4716566419
],
[
126.8518494873,
37.4709233851
],
[
126.8517744372,
37.4709317165
],
[
126.8517495157,
37.4709234676
],
[
126.8517369529,
37.4708984311
],
[
126.8517369628,
37.470740153
],
[
126.8517119193,
37.4707067556
],
[
126.8517119193,
37.4707067556
]
]
},
{
"index": [
3,
5
],
"vertices": [
[
126.8517119193,
37.4707067556
],
[
126.8517119193,
37.4707067556
],
[
126.8517369628,
37.470740153
],
[
126.8517369529,
37.4708984311
],
[
126.8517495157,
37.4709234676
],
[
126.8517744372,
37.4709317165
],
[
126.8518494873,
37.4709233851
],
[
126.8518244322,
37.4705901064
],
[
126.8517619649,
37.4696652428
],
[
126.8516492024,
37.4696694124
]
]
}
]
}
},
"Rpm": {
"type": "object",
"properties": {
"index": {
"type": "array",
"description": "rdm의 출발, 도착 index",
"items": {
"type": "integer",
"description": "sprp.data.rpm.index.description",
"format": "int32"
}
},
"vertices": {
"type": "array",
"description": "rdm의 경로 선형",
"items": {
"type": "array",
"description": "sprp.data.rpm.vertices.description",
"items": {
"type": "number",
"description": "sprp.data.rpm.vertices.description",
"format": "double"
}
}
}
},
"description": "실제 선형 데이터 목록(배열)"
},
"RouteDistanceMatrixDemoRequest": {
"required": [
"id",
"origins"
],
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "사용자를 구분하기 위한 고유 식별 ID"
},
"origins": {
"maxItems": 100,
"minItems": 2,
"type": "array",
"description": "좌표 목록
*최소 2개에서 최대 100개의 좌표 설정 가능",
"items": {
"type": "array",
"description": "sprp.request.route-distance-matrix-demo.origins.description",
"items": {
"type": "number",
"description": "sprp.request.route-distance-matrix-demo.origins.description",
"format": "double"
}
}
},
"destinations": {
"maxItems": 100,
"minItems": 0,
"type": "array",
"description": "목적지 좌표 목록
*최대 100개의 좌표 설정 가능",
"items": {
"type": "array",
"description": "sprp.request.route-distance-matrix-demo.destinations.description",
"items": {
"type": "number",
"description": "sprp.request.route-distance-matrix-demo.destinations.description",
"format": "double"
}
}
},
"traffic": {
"maximum": 3,
"minimum": 0,
"type": "integer",
"description": "교통 정보 유형",
"format": "int32",
"example": 0,
"default": 0,
"enum": [
0,
1,
2,
3
],
"x-enum-descriptions": {
"0": "미사용",
"1": "실시간",
"2": "통계",
"3": "실시간+통계"
}
},
"time": {
"type": "integer",
"description": "요청 시각(초)
*Unix time
*통계 교통 정보를 사용할 때 적용",
"format": "int64",
"example": 1723188000
},
"artifact": {
"maximum": 3,
"minimum": 0,
"type": "integer",
"description": "경로 정보를 서버에 저장할 파일 유형",
"format": "int32",
"example": 0,
"default": 0,
"enum": [
0,
1,
2,
3
],
"x-enum-descriptions": {
"0": "미사용",
"1": "경로 요약 정보(RDM) 저장",
"2": "경로 선형 정보(RPM) 저장",
"3": "경로 요약 정보(RDM) 및 경로 선형 정보(RPM) 저장"
}
}
},
"description": "Distance Matrix 를 위한 요청 파라미터 집합
예상 소요 시간 및 거리를 탐색합니다"
},
"RouteDistanceMatrixDemoResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"origins": {
"type": "array",
"description": "요청에 사용된 경도/위도 좌표 목록(배열)",
"example": [
127.0955,
37.417,
127.0978,
37.4113,
126.8465,
37.5683
],
"items": {
"type": "array",
"description": "sprp.response.route-distance-matrix-demo.origins.description",
"example": [
127.0955,
37.417,
127.0978,
37.4113,
126.8465,
37.5683
],
"items": {
"type": "number",
"description": "sprp.response.route-distance-matrix-demo.origins.description",
"format": "double"
}
}
},
"destinations": {
"type": "array",
"description": "요청에 사용된 도착지 경도/위도 좌표 목록(배열)",
"items": {
"type": "array",
"description": "sprp.response.route-distance-matrix-demo.destinations.description",
"items": {
"type": "number",
"description": "sprp.response.route-distance-matrix-demo.destinations.description",
"format": "double"
}
}
},
"rows": {
"type": "array",
"description": "각 출발지별 경로 결과 목록(배열)
*요청 좌표마다 하나의 Row가 생성되며 N×N 행렬 구조를 형성 (N=좌표 개수)",
"items": {
"$ref": "#/components/schemas/Row"
}
},
"rdm": {
"$ref": "#/components/schemas/rdm"
},
"rpm": {
"$ref": "#/components/schemas/rpm"
}
},
"description": "Distance Matrix (RDM)의 결과",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"origins": [
[
126.850187,
37.472953
],
[
126.849473,
37.472311
],
[
126.851759,
37.471893
],
[
126.851726,
37.4707
],
[
126.851668,
37.47047
],
[
126.85165,
37.469683
],
[
126.851302,
37.468985
],
[
126.850683,
37.469485
],
[
126.851804,
37.469279
],
[
126.851956,
37.470604
],
[
126.850876,
37.472735
],
[
126.85066,
37.470229
]
],
"rows": [
{
"elements": [
{
"distance": {
"value": 0,
"text": "0 km"
},
"duration": {
"value": 0,
"text": "0 mins"
},
"status": "OK"
},
{
"distance": {
"value": 605,
"text": "0.61 km"
},
"duration": {
"value": 83,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 255,
"text": "0.25 km"
},
"duration": {
"value": 48,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 379,
"text": "0.38 km"
},
"duration": {
"value": 80,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 597,
"text": "0.60 km"
},
"duration": {
"value": 161,
"text": "2 mins"
},
"status": "OK"
},
{
"distance": {
"value": 484,
"text": "0.48 km"
},
"duration": {
"value": 80,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 566,
"text": "0.57 km"
},
"duration": {
"value": 94,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 599,
"text": "0.60 km"
},
"duration": {
"value": 120,
"text": "2 mins"
},
"status": "OK"
},
{
"distance": {
"value": 484,
"text": "0.48 km"
},
"duration": {
"value": 80,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 393,
"text": "0.39 km"
},
"duration": {
"value": 70,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 66,
"text": "0.07 km"
},
"duration": {
"value": 9,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 488,
"text": "0.49 km"
},
"duration": {
"value": 81,
"text": "1 mins"
},
"status": "OK"
}
]
},
{
"elements": [
{
"distance": {
"value": 155,
"text": "0.16 km"
},
"duration": {
"value": 29,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 0,
"text": "0 km"
},
"duration": {
"value": 0,
"text": "0 mins"
},
"status": "OK"
},
{
"distance": {
"value": 410,
"text": "0.41 km"
},
"duration": {
"value": 77,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 535,
"text": "0.54 km"
},
"duration": {
"value": 109,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 753,
"text": "0.75 km"
},
"duration": {
"value": 191,
"text": "3 mins"
},
"status": "OK"
},
{
"distance": {
"value": 650,
"text": "0.65 km"
},
"duration": {
"value": 117,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 722,
"text": "0.72 km"
},
"duration": {
"value": 123,
"text": "2 mins"
},
"status": "OK"
},
{
"distance": {
"value": 754,
"text": "0.75 km"
},
"duration": {
"value": 150,
"text": "2 mins"
},
"status": "OK"
},
{
"distance": {
"value": 683,
"text": "0.68 km"
},
"duration": {
"value": 117,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 549,
"text": "0.55 km"
},
"duration": {
"value": 100,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 221,
"text": "0.22 km"
},
"duration": {
"value": 38,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 644,
"text": "0.64 km"
},
"duration": {
"value": 110,
"text": "1 mins"
},
"status": "OK"
}
]
},
{
"elements": [
{
"distance": {
"value": 771,
"text": "0.77 km"
},
"duration": {
"value": 117,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 397,
"text": "0.40 km"
},
"duration": {
"value": 67,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 0,
"text": "0 km"
},
"duration": {
"value": 0,
"text": "0 mins"
},
"status": "OK"
},
{
"distance": {
"value": 155,
"text": "0.16 km"
},
"duration": {
"value": 55,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 373,
"text": "0.37 km"
},
"duration": {
"value": 136,
"text": "2 mins"
},
"status": "OK"
},
{
"distance": {
"value": 271,
"text": "0.27 km"
},
"duration": {
"value": 62,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 410,
"text": "0.41 km"
},
"duration": {
"value": 93,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 490,
"text": "0.49 km"
},
"duration": {
"value": 122,
"text": "2 mins"
},
"status": "OK"
},
{
"distance": {
"value": 303,
"text": "0.30 km"
},
"duration": {
"value": 62,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 170,
"text": "0.17 km"
},
"duration": {
"value": 45,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 835,
"text": "0.83 km"
},
"duration": {
"value": 126,
"text": "2 mins"
},
"status": "OK"
},
{
"distance": {
"value": 309,
"text": "0.31 km"
},
"duration": {
"value": 71,
"text": "1 mins"
},
"status": "OK"
}
]
},
{
"elements": [
{
"distance": {
"value": 893,
"text": "0.89 km"
},
"duration": {
"value": 147,
"text": "2 mins"
},
"status": "OK"
},
{
"distance": {
"value": 519,
"text": "0.52 km"
},
"duration": {
"value": 98,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 153,
"text": "0.15 km"
},
"duration": {
"value": 53,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 0,
"text": "0 km"
},
"duration": {
"value": 0,
"text": "0 mins"
},
"status": "OK"
},
{
"distance": {
"value": 315,
"text": "0.31 km"
},
"duration": {
"value": 151,
"text": "2 mins"
},
"status": "OK"
},
{
"distance": {
"value": 181,
"text": "0.18 km"
},
"duration": {
"value": 55,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 320,
"text": "0.32 km"
},
"duration": {
"value": 86,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 302,
"text": "0.30 km"
},
"duration": {
"value": 93,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 213,
"text": "0.21 km"
},
"duration": {
"value": 55,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 80,
"text": "0.08 km"
},
"duration": {
"value": 37,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 957,
"text": "0.96 km"
},
"duration": {
"value": 157,
"text": "2 mins"
},
"status": "OK"
},
{
"distance": {
"value": 219,
"text": "0.22 km"
},
"duration": {
"value": 64,
"text": "1 mins"
},
"status": "OK"
}
]
},
{
"elements": [
{
"distance": {
"value": 1145,
"text": "1.1 km"
},
"duration": {
"value": 253,
"text": "4 mins"
},
"status": "OK"
},
{
"distance": {
"value": 771,
"text": "0.77 km"
},
"duration": {
"value": 204,
"text": "3 mins"
},
"status": "OK"
},
{
"distance": {
"value": 405,
"text": "0.41 km"
},
"duration": {
"value": 159,
"text": "2 mins"
},
"status": "OK"
},
{
"distance": {
"value": 318,
"text": "0.32 km"
},
"duration": {
"value": 153,
"text": "2 mins"
},
"status": "OK"
},
{
"distance": {
"value": 0,
"text": "0 km"
},
"duration": {
"value": 0,
"text": "0 mins"
},
"status": "OK"
},
{
"distance": {
"value": 134,
"text": "0.13 km"
},
"duration": {
"value": 96,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 293,
"text": "0.29 km"
},
"duration": {
"value": 141,
"text": "2 mins"
},
"status": "OK"
},
{
"distance": {
"value": 373,
"text": "0.37 km"
},
"duration": {
"value": 170,
"text": "2 mins"
},
"status": "OK"
},
{
"distance": {
"value": 186,
"text": "0.19 km"
},
"duration": {
"value": 110,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 258,
"text": "0.26 km"
},
"duration": {
"value": 130,
"text": "2 mins"
},
"status": "OK"
},
{
"distance": {
"value": 1209,
"text": "1.2 km"
},
"duration": {
"value": 263,
"text": "4 mins"
},
"status": "OK"
},
{
"distance": {
"value": 397,
"text": "0.40 km"
},
"duration": {
"value": 156,
"text": "2 mins"
},
"status": "OK"
}
]
},
{
"elements": [
{
"distance": {
"value": 1011,
"text": "1.0 km"
},
"duration": {
"value": 157,
"text": "2 mins"
},
"status": "OK"
},
{
"distance": {
"value": 636,
"text": "0.64 km"
},
"duration": {
"value": 107,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 271,
"text": "0.27 km"
},
"duration": {
"value": 62,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 183,
"text": "0.18 km"
},
"duration": {
"value": 56,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 133,
"text": "0.13 km"
},
"duration": {
"value": 96,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 0,
"text": "0 km"
},
"duration": {
"value": 0,
"text": "0 mins"
},
"status": "OK"
},
{
"distance": {
"value": 158,
"text": "0.16 km"
},
"duration": {
"value": 45,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 239,
"text": "0.24 km"
},
"duration": {
"value": 74,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 52,
"text": "0.05 km"
},
"duration": {
"value": 14,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 123,
"text": "0.12 km"
},
"duration": {
"value": 33,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 1075,
"text": "1.1 km"
},
"duration": {
"value": 166,
"text": "2 mins"
},
"status": "OK"
},
{
"distance": {
"value": 263,
"text": "0.26 km"
},
"duration": {
"value": 60,
"text": "1 mins"
},
"status": "OK"
}
]
},
{
"elements": [
{
"distance": {
"value": 1148,
"text": "1.1 km"
},
"duration": {
"value": 188,
"text": "3 mins"
},
"status": "OK"
},
{
"distance": {
"value": 797,
"text": "0.80 km"
},
"duration": {
"value": 154,
"text": "2 mins"
},
"status": "OK"
},
{
"distance": {
"value": 408,
"text": "0.41 km"
},
"duration": {
"value": 93,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 320,
"text": "0.32 km"
},
"duration": {
"value": 87,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 259,
"text": "0.26 km"
},
"duration": {
"value": 118,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 157,
"text": "0.16 km"
},
"duration": {
"value": 45,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 0,
"text": "0 km"
},
"duration": {
"value": 0,
"text": "0 mins"
},
"status": "OK"
},
{
"distance": {
"value": 80,
"text": "0.08 km"
},
"duration": {
"value": 28,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 459,
"text": "0.46 km"
},
"duration": {
"value": 106,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 261,
"text": "0.26 km"
},
"duration": {
"value": 64,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 1212,
"text": "1.2 km"
},
"duration": {
"value": 197,
"text": "3 mins"
},
"status": "OK"
},
{
"distance": {
"value": 162,
"text": "0.16 km"
},
"duration": {
"value": 58,
"text": "1 mins"
},
"status": "OK"
}
]
},
{
"elements": [
{
"distance": {
"value": 1133,
"text": "1.1 km"
},
"duration": {
"value": 197,
"text": "3 mins"
},
"status": "OK"
},
{
"distance": {
"value": 717,
"text": "0.72 km"
},
"duration": {
"value": 126,
"text": "2 mins"
},
"status": "OK"
},
{
"distance": {
"value": 392,
"text": "0.39 km"
},
"duration": {
"value": 102,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 305,
"text": "0.31 km"
},
"duration": {
"value": 96,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 234,
"text": "0.23 km"
},
"duration": {
"value": 163,
"text": "2 mins"
},
"status": "OK"
},
{
"distance": {
"value": 152,
"text": "0.15 km"
},
"duration": {
"value": 104,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 83,
"text": "0.08 km"
},
"duration": {
"value": 30,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 0,
"text": "0 km"
},
"duration": {
"value": 0,
"text": "0 mins"
},
"status": "OK"
},
{
"distance": {
"value": 204,
"text": "0.20 km"
},
"duration": {
"value": 118,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 245,
"text": "0.25 km"
},
"duration": {
"value": 73,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 1197,
"text": "1.2 km"
},
"duration": {
"value": 206,
"text": "3 mins"
},
"status": "OK"
},
{
"distance": {
"value": 82,
"text": "0.08 km"
},
"duration": {
"value": 29,
"text": "1 mins"
},
"status": "OK"
}
]
},
{
"elements": [
{
"distance": {
"value": 1044,
"text": "1.0 km"
},
"duration": {
"value": 158,
"text": "2 mins"
},
"status": "OK"
},
{
"distance": {
"value": 669,
"text": "0.67 km"
},
"duration": {
"value": 108,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 304,
"text": "0.30 km"
},
"duration": {
"value": 63,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 216,
"text": "0.22 km"
},
"duration": {
"value": 57,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 186,
"text": "0.19 km"
},
"duration": {
"value": 111,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 52,
"text": "0.05 km"
},
"duration": {
"value": 15,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 106,
"text": "0.11 km"
},
"duration": {
"value": 30,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 187,
"text": "0.19 km"
},
"duration": {
"value": 59,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 0,
"text": "0 km"
},
"duration": {
"value": 0,
"text": "0 mins"
},
"status": "OK"
},
{
"distance": {
"value": 156,
"text": "0.16 km"
},
"duration": {
"value": 34,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 1108,
"text": "1.1 km"
},
"duration": {
"value": 167,
"text": "2 mins"
},
"status": "OK"
},
{
"distance": {
"value": 296,
"text": "0.30 km"
},
"duration": {
"value": 61,
"text": "1 mins"
},
"status": "OK"
}
]
},
{
"elements": [
{
"distance": {
"value": 910,
"text": "0.91 km"
},
"duration": {
"value": 140,
"text": "2 mins"
},
"status": "OK"
},
{
"distance": {
"value": 536,
"text": "0.54 km"
},
"duration": {
"value": 90,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 170,
"text": "0.17 km"
},
"duration": {
"value": 45,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 83,
"text": "0.08 km"
},
"duration": {
"value": 39,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 227,
"text": "0.23 km"
},
"duration": {
"value": 107,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 124,
"text": "0.12 km"
},
"duration": {
"value": 34,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 263,
"text": "0.26 km"
},
"duration": {
"value": 65,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 244,
"text": "0.24 km"
},
"duration": {
"value": 72,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 156,
"text": "0.16 km"
},
"duration": {
"value": 34,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 0,
"text": "0 km"
},
"duration": {
"value": 0,
"text": "0 mins"
},
"status": "OK"
},
{
"distance": {
"value": 974,
"text": "0.97 km"
},
"duration": {
"value": 149,
"text": "2 mins"
},
"status": "OK"
},
{
"distance": {
"value": 162,
"text": "0.16 km"
},
"duration": {
"value": 43,
"text": "1 mins"
},
"status": "OK"
}
]
},
{
"elements": [
{
"distance": {
"value": 650,
"text": "0.65 km"
},
"duration": {
"value": 89,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 539,
"text": "0.54 km"
},
"duration": {
"value": 73,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 189,
"text": "0.19 km"
},
"duration": {
"value": 38,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 313,
"text": "0.31 km"
},
"duration": {
"value": 70,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 531,
"text": "0.53 km"
},
"duration": {
"value": 152,
"text": "2 mins"
},
"status": "OK"
},
{
"distance": {
"value": 418,
"text": "0.42 km"
},
"duration": {
"value": 70,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 500,
"text": "0.50 km"
},
"duration": {
"value": 85,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 532,
"text": "0.53 km"
},
"duration": {
"value": 111,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 418,
"text": "0.42 km"
},
"duration": {
"value": 70,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 327,
"text": "0.33 km"
},
"duration": {
"value": 61,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 0,
"text": "0 km"
},
"duration": {
"value": 0,
"text": "0 mins"
},
"status": "OK"
},
{
"distance": {
"value": 422,
"text": "0.42 km"
},
"duration": {
"value": 71,
"text": "1 mins"
},
"status": "OK"
}
]
},
{
"elements": [
{
"distance": {
"value": 1051,
"text": "1.1 km"
},
"duration": {
"value": 167,
"text": "2 mins"
},
"status": "OK"
},
{
"distance": {
"value": 634,
"text": "0.63 km"
},
"duration": {
"value": 96,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 310,
"text": "0.31 km"
},
"duration": {
"value": 72,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 223,
"text": "0.22 km"
},
"duration": {
"value": 67,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 285,
"text": "0.28 km"
},
"duration": {
"value": 181,
"text": "3 mins"
},
"status": "OK"
},
{
"distance": {
"value": 191,
"text": "0.19 km"
},
"duration": {
"value": 114,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 166,
"text": "0.17 km"
},
"duration": {
"value": 59,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 82,
"text": "0.08 km"
},
"duration": {
"value": 29,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 270,
"text": "0.27 km"
},
"duration": {
"value": 89,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 163,
"text": "0.16 km"
},
"duration": {
"value": 43,
"text": "1 mins"
},
"status": "OK"
},
{
"distance": {
"value": 1115,
"text": "1.1 km"
},
"duration": {
"value": 176,
"text": "2 mins"
},
"status": "OK"
},
{
"distance": {
"value": 0,
"text": "0 km"
},
"duration": {
"value": 0,
"text": "0 mins"
},
"status": "OK"
}
]
}
],
"rdm": {
"type": "file",
"form": "bin",
"data": "_t1773220263_d20260311181103_u260311-for-iMPS.rdm",
"size": 3372,
"created": 1773220263
},
"rpm": {
"type": "file",
"form": "bin",
"data": "_t1773220263_d20260311181103_u260311-for-iMPS.rpm",
"size": 47236,
"created": 1773220263
}
}
},
"ClusteringOption": {
"required": [
"division_type",
"limit_deviation",
"limit_value"
],
"type": "object",
"properties": {
"division_type": {
"maximum": 4,
"minimum": 0,
"type": "integer",
"description": "분배 방식",
"format": "int32",
"default": 0,
"enum": [
0,
1,
2,
3,
4
],
"x-enum-descriptions": {
"0": "개수 균등",
"1": "거리 균등",
"2": "시간 균등",
"3": "물량 균등",
"4": "링크 균등"
}
},
"limit_value": {
"type": "integer",
"description": "그룹 당 최대 값
*분배 방식에 따라 값의 의미가 달라짐",
"format": "int32"
},
"limit_deviation": {
"type": "integer",
"description": "그룹 당 최대 편차
*분배 방식에 따라 값의 의미가 달라짐",
"format": "int32"
},
"limit_cluster": {
"type": "integer",
"description": "최대 그룹 개수",
"format": "int32"
},
"reservation": {
"type": "integer",
"description": "시간 예약",
"format": "int64"
},
"reservation_type": {
"maximum": 2,
"minimum": 0,
"type": "integer",
"description": "시간 예약 방식",
"format": "int32",
"default": 0,
"enum": [
0,
1,
2
],
"x-enum-descriptions": {
"0": "미사용",
"1": "출발",
"2": "도착"
}
},
"endpoint_type": {
"maximum": 5,
"minimum": 0,
"type": "integer",
"description": "출/도착지 고정 타입",
"format": "int32",
"default": 0,
"enum": [
0,
1,
2,
3,
4,
5
],
"x-enum-descriptions": {
"0": "미사용",
"1": "출발지 고정",
"2": "도착지 고정",
"3": "출-도착지 고정",
"4": "출발지 회귀",
"5": "출-도착지 자동"
}
},
"clustering_method": {
"maximum": 2,
"minimum": 0,
"type": "integer",
"description": "클러스터링 방식",
"format": "int32",
"default": 0,
"enum": [
0,
1,
2
],
"x-enum-descriptions": {
"0": "기본(K-means 기반)",
"1": "TSP 기반",
"2": "K-means 기반"
}
}
},
"description": "최적화 옵션"
},
"RouteClusteringDemoRequest": {
"required": [
"id",
"option",
"origins"
],
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "사용자를 구분하기 위한 고유 식별 ID"
},
"origins": {
"maxItems": 100,
"minItems": 3,
"type": "array",
"description": "좌표 목록",
"items": {
"type": "array",
"description": "sprp.request.clustering-demo.origins.description",
"items": {
"type": "number",
"description": "sprp.request.clustering-demo.origins.description",
"format": "double"
}
}
},
"option": {
"$ref": "#/components/schemas/ClusteringOption"
}
},
"description": "Clustering API를 위한 요청 파라미터 집합"
},
"ClusteringClusters": {
"type": "object",
"properties": {
"group": {
"type": "integer",
"description": "클러스터링 ID",
"format": "int32"
},
"time": {
"type": "integer",
"description": "예상 주행 시간",
"format": "int32"
},
"distance": {
"type": "integer",
"description": "예상 주행 거리",
"format": "int32"
},
"etd": {
"type": "integer",
"description": "출발 예정 시간
*요청 시",
"format": "int32"
},
"eta": {
"type": "integer",
"description": "도착 예정 시간
*요청 시",
"format": "int32"
},
"pois": {
"type": "array",
"description": "좌표 정보 목록(배열)",
"items": {
"$ref": "#/components/schemas/ClusteringPois"
}
},
"center": {
"type": "array",
"description": "영역 중심점 좌표",
"items": {
"type": "number",
"description": "sprp.response.clustering-demo.clusters.center.description",
"format": "double"
}
},
"boundary": {
"type": "array",
"description": "영역 좌표 목록(배열)",
"items": {
"type": "array",
"description": "sprp.response.clustering-demo.clusters.boundary.description",
"items": {
"type": "number",
"description": "sprp.response.clustering-demo.clusters.boundary.description",
"format": "double"
}
}
},
"way_times": {
"type": "array",
"description": "방문지 간 예상 시간 목록(배열)",
"items": {
"type": "number",
"description": "sprp.response.clustering-demo.clusters.way_times.description",
"format": "double"
}
},
"way_distances": {
"type": "array",
"description": "방문지 간 예상 거리 목록(배열)",
"items": {
"type": "number",
"description": "sprp.response.clustering-demo.clusters.way_distances.description",
"format": "double"
}
}
},
"description": "클러스터링 정보 목록(배열)"
},
"ClusteringPois": {
"type": "object",
"properties": {
"idx": {
"type": "integer",
"description": "요청 좌표 index",
"format": "int32"
},
"coord": {
"type": "array",
"description": "좌표 목록(배열)",
"items": {
"type": "number",
"description": "sprp.response.clustering-demo.clusters.pois.coord.description",
"format": "double"
}
}
},
"description": "좌표 정보 목록(배열)"
},
"ClusteringResponseOption": {
"type": "object",
"properties": {
"division_type": {
"maximum": 4,
"minimum": 0,
"type": "integer",
"description": "sprp.request.clustering.option.division_type.description",
"format": "int32",
"default": 0,
"enum": [
0,
1,
2,
3,
4
],
"x-enum-descriptions": {
"0": "sprp.request.clustering.option.division_type-0.description",
"1": "sprp.request.clustering.option.division_type-1.description",
"2": "sprp.request.clustering.option.division_type-2.description",
"3": "sprp.request.clustering.option.division_type-3.description",
"4": "sprp.request.clustering.option.division_type-4.description"
}
},
"limit_value": {
"type": "integer",
"description": "sprp.request.clustering.option.limit_value.description",
"format": "int32"
},
"limit_deviation": {
"type": "integer",
"description": "sprp.request.clustering.option.limit_deviation.description",
"format": "int32"
},
"limit_cluster": {
"type": "integer",
"description": "sprp.request.clustering.option.limit_cluster.description",
"format": "int32"
},
"reservation": {
"type": "integer",
"description": "sprp.request.clustering.option.reservation.description",
"format": "int64"
},
"reservation_type": {
"maximum": 2,
"minimum": 0,
"type": "integer",
"description": "sprp.request.clustering.option.reservation_type.description",
"format": "int32",
"default": 0,
"enum": [
0,
1,
2
],
"x-enum-descriptions": {
"0": "sprp.request.clustering.option.reservation_type-0.description",
"1": "sprp.request.clustering.option.reservation_type-1.description",
"2": "sprp.request.clustering.option.reservation_type-2.description"
}
},
"endpoint_type": {
"maximum": 5,
"minimum": 0,
"type": "integer",
"description": "sprp.request.clustering.option.endpoint_type.description",
"format": "int32",
"default": 0,
"enum": [
0,
1,
2,
3,
4,
5
],
"x-enum-descriptions": {
"0": "sprp.request.clustering.option.endpoint_type-0.description",
"1": "sprp.request.clustering.option.endpoint_type-1.description",
"2": "sprp.request.clustering.option.endpoint_type-2.description",
"3": "sprp.request.clustering.option.endpoint_type-3.description",
"4": "sprp.request.clustering.option.endpoint_type-4.description",
"5": "sprp.request.clustering.option.endpoint_type-5.description"
}
},
"clustering_method": {
"maximum": 2,
"minimum": 0,
"type": "integer",
"description": "sprp.request.clustering.option.clustering_method.description",
"format": "int32",
"default": 0,
"enum": [
0,
1,
2
],
"x-enum-descriptions": {
"0": "sprp.request.clustering.option.clustering_method-0.description",
"1": "sprp.request.clustering.option.clustering_method-1.description",
"2": "sprp.request.clustering.option.clustering_method-2.description"
}
}
},
"description": "요청 옵션 정보"
},
"ClusteringSummary": {
"type": "object",
"properties": {
"avg_count": {
"type": "integer",
"description": "그룹당 평균 방문지 개수",
"format": "int32"
},
"avg_time": {
"type": "integer",
"description": "그룹당 평균 예상 주행 시간",
"format": "int32"
},
"avg_dist": {
"type": "integer",
"description": "그룹당 평균 예상 주행 거리",
"format": "int32"
},
"start_lock": {
"type": "array",
"description": "출발지 고정 좌표
*요청 시",
"items": {
"type": "number",
"description": "sprp.response.clustering-demo.summary.start_lock.description",
"format": "double"
}
},
"end_lock": {
"type": "array",
"description": "도착지 고정 좌표
*요청 시",
"items": {
"type": "number",
"description": "sprp.response.clustering-demo.summary.end_lock.description",
"format": "double"
}
}
},
"description": "요약 정보"
},
"RouteClusteringDemoResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"origins": {
"type": "array",
"description": "사용자 입력 좌표 목록(배열)",
"items": {
"type": "array",
"description": "sprp.response.clustering-demo.origins.description",
"items": {
"type": "number",
"description": "sprp.response.clustering-demo.origins.description",
"format": "double"
}
}
},
"option": {
"$ref": "#/components/schemas/ClusteringResponseOption"
},
"summary": {
"$ref": "#/components/schemas/ClusteringSummary"
},
"clusters": {
"type": "array",
"description": "클러스터링 정보 목록(배열)",
"items": {
"$ref": "#/components/schemas/ClusteringClusters"
}
}
},
"description": "클러스터링 API 의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"origins": [
[
126.850187,
37.472953
],
[
126.849473,
37.472311
],
[
126.851759,
37.471893
],
[
126.851726,
37.4707
],
[
126.851668,
37.47047
],
[
126.85165,
37.469683
],
[
126.851302,
37.468985
],
[
126.850683,
37.469485
],
[
126.851804,
37.469279
],
[
126.851956,
37.470604
],
[
126.850876,
37.472735
],
[
126.85066,
37.470229
]
],
"summary": {
"avg_count": 6,
"avg_time": 224,
"avg_dist": 0,
"start_lock": null,
"end_lock": null
},
"clusters": [
{
"group": 0,
"time": 229,
"distance": 560,
"etd": 0,
"eta": 0,
"pois": [
{
"idx": 11,
"coord": [
126.85066,
37.470229
]
},
{
"idx": 7,
"coord": [
126.850683,
37.469485
]
},
{
"idx": 6,
"coord": [
126.851302,
37.468985
]
},
{
"idx": 5,
"coord": [
126.85165,
37.469683
]
},
{
"idx": 8,
"coord": [
126.851804,
37.469279
]
},
{
"idx": 4,
"coord": [
126.851668,
37.47047
]
}
],
"center": [
126.85126118083915,
37.4697584272312
],
"boundary": [
[
126.85066,
37.470229
],
[
126.850683,
37.469485
],
[
126.851302,
37.468985
],
[
126.851804,
37.469279
],
[
126.851668,
37.47047
],
[
126.85066,
37.470229
]
],
"way_times": [
0,
29,
30,
45,
14,
111
],
"way_distances": [
0,
82,
83,
157,
52,
186
]
},
{
"group": 1,
"time": 220,
"distance": 992,
"etd": 0,
"eta": 0,
"pois": [
{
"idx": 2,
"coord": [
126.851759,
37.471893
]
},
{
"idx": 3,
"coord": [
126.851726,
37.4707
]
},
{
"idx": 9,
"coord": [
126.851956,
37.470604
]
},
{
"idx": 1,
"coord": [
126.849473,
37.472311
]
},
{
"idx": 0,
"coord": [
126.850187,
37.472953
]
},
{
"idx": 10,
"coord": [
126.850876,
37.472735
]
}
],
"center": [
126.85085046247941,
37.47192702689023
],
"boundary": [
[
126.849473,
37.472311
],
[
126.851726,
37.4707
],
[
126.851956,
37.470604
],
[
126.851759,
37.471893
],
[
126.850876,
37.472735
],
[
126.850187,
37.472953
],
[
126.849473,
37.472311
]
],
"way_times": [
0,
55,
37,
90,
29,
9
],
"way_distances": [
0,
155,
80,
536,
155,
66
]
}
]
}
},
"RouteOptimizePointsDemoRequest": {
"required": [
"id",
"origins"
],
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "사용자를 구분하기 위한 고유 식별 ID"
},
"origins": {
"maxItems": 100,
"minItems": 2,
"type": "array",
"description": "좌표 목록
*최소 2개에서 최대 100개의 좌표 설정 가능",
"items": {
"type": "array",
"description": "sprp.request.best-waypoints-demo.origins.description",
"items": {
"type": "number",
"description": "sprp.request.best-waypoints-demo.origins.description",
"format": "double"
}
}
},
"matrix": {
"type": "array",
"description": "경로 요약(거리) 행렬(M:M) 정보
*M: 출발지, 도착지, 좌표 개수의 합",
"items": {
"type": "array",
"description": "sprp.request.best-waypoints-demo.matrix.description",
"items": {
"type": "integer",
"description": "sprp.request.best-waypoints-demo.matrix.description",
"format": "int32"
}
}
},
"option": {
"$ref": "#/components/schemas/TspOption"
}
},
"description": "Best WayPoints (TSP)를 위한 요청 파라미터 집합"
},
"TspOption": {
"type": "object",
"properties": {
"endpoint_type": {
"maximum": 4,
"minimum": 0,
"type": "integer",
"description": "출/도착지 고정 타입",
"format": "int32",
"default": 0,
"enum": [
0,
1,
2,
3,
4
],
"x-enum-descriptions": {
"0": "미사용",
"1": "출발지 고정",
"2": "도착지 고정",
"3": "출-도착지 고정",
"4": "출발지 자동"
}
}
},
"description": "최적화 옵션"
},
"RouteOptimizePointsDemoResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"origins": {
"type": "array",
"description": "사용자 입력 좌표 목록(배열)",
"items": {
"type": "array",
"description": "sprp.response.best-waypoints-demo.origins.description",
"items": {
"type": "number",
"description": "sprp.response.best-waypoints-demo.origins.description",
"format": "double"
}
}
},
"matrix": {
"type": "array",
"description": "사용자 입력 행렬 데이터 목록(배열)",
"items": {
"type": "array",
"description": "sprp.response.best-waypoints-demo.matrix.description",
"items": {
"type": "integer",
"description": "sprp.response.best-waypoints-demo.matrix.description",
"format": "int32"
}
}
},
"waypoints": {
"type": "array",
"description": "방문지 정보 목록(배열)",
"items": {
"$ref": "#/components/schemas/Waypoints"
}
},
"routes": {
"type": "array",
"description": "결과 순서 정보 목록(배열)",
"items": {
"type": "integer",
"description": "sprp.response.best-waypoints-demo.routes.description",
"format": "int32"
}
}
},
"description": "Best WayPoints (TSP) API 의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"origins": [
[
126.850187,
37.472953
],
[
126.849473,
37.472311
],
[
126.851759,
37.471893
],
[
126.851726,
37.4707
],
[
126.851668,
37.47047
],
[
126.85165,
37.469683
],
[
126.851302,
37.468985
],
[
126.850683,
37.469485
],
[
126.851804,
37.469279
],
[
126.851956,
37.470604
],
[
126.850876,
37.472735
],
[
126.85066,
37.470229
]
],
"waypoints": [
{
"index": 0,
"distance": 0,
"time": 0
},
{
"index": 10,
"distance": 605,
"time": 83
},
{
"index": 4,
"distance": 410,
"time": 77
},
{
"index": 5,
"distance": 155,
"time": 55
},
{
"index": 8,
"distance": 315,
"time": 151
},
{
"index": 6,
"distance": 134,
"time": 96
},
{
"index": 7,
"distance": 158,
"time": 45
},
{
"index": 11,
"distance": 80,
"time": 28
},
{
"index": 9,
"distance": 204,
"time": 118
},
{
"index": 3,
"distance": 156,
"time": 34
},
{
"index": 2,
"distance": 974,
"time": 149
},
{
"index": 1,
"distance": 422,
"time": 71
}
],
"routes": [
0,
10,
4,
5,
8,
6,
7,
11,
9,
3,
2,
1
]
}
},
"Waypoints": {
"type": "object",
"properties": {
"index": {
"type": "integer",
"description": "사용자 입력 인덱스",
"format": "int32"
},
"distance": {
"type": "integer",
"description": "이전 방문지로부터의 이동 거리
*단일 matrix 가 제공된 경우 time과 동일 값",
"format": "int32"
},
"time": {
"type": "integer",
"description": "이전 방문지로부터의 이동 시간
*단일 matrix가 제공된 경우 distance와 동일 값",
"format": "int32"
}
},
"description": "방문지 정보 목록(배열)"
},
"SearchAdminToPolygonRequest": {
"required": [
"mode",
"query"
],
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "검색 할 행정구역 코드 및 행정 명칭",
"example": "4113510900"
},
"mode": {
"maximum": 4,
"minimum": 1,
"type": "integer",
"description": "검색 구역 범위",
"format": "int32",
"example": 3,
"enum": [
1,
2,
3,
4
],
"x-enum-descriptions": {
"1": "광역시도",
"2": "시군구",
"3": "읍면동",
"4": "리"
}
},
"coordtype": {
"maximum": 1,
"minimum": 0,
"type": "string",
"description": "좌표 체계",
"default": "1",
"enum": [
"0",
"1"
],
"x-enum-descriptions": {
"0": "TW 좌표",
"1": "WGS84 좌표"
}
}
},
"description": "공간 검색을 위한 요청 파라미터 집합"
},
"AdminToPolygonData": {
"type": "object",
"properties": {
"result": {
"type": "boolean",
"description": "검색 결과 성공 여부",
"example": true
},
"count": {
"type": "integer",
"description": "총 응답 결과 개수",
"format": "int32",
"example": 192
},
"polygondata": {
"type": "array",
"description": "행정구역 공간 정보 목록(배열)",
"items": {
"$ref": "#/components/schemas/PolygonData"
}
}
},
"description": "공간 검색 결과"
},
"PolygonData": {
"type": "object",
"properties": {
"admincode": {
"type": "string",
"description": "행정표준코드",
"example": "true"
},
"count": {
"type": "integer",
"description": "행정구역 공간 개수",
"format": "int32",
"example": 192
},
"polygonlist": {
"$ref": "#/components/schemas/polygonlist"
}
},
"description": "행정구역 공간 정보 목록(배열)"
},
"SearchAdminToPolygonResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"polygon": {
"$ref": "#/components/schemas/AdminToPolygonData"
}
},
"description": "공간 검색 API의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"polygon": {
"result": true,
"count": 1,
"polygondata": [
{
"admincode": "41135109",
"count": 1,
"polygonlist": [
{
"count": 392,
"polygon": [
{
"x": 127.118274,
"y": 37.410508
},
{
"x": 127.118299,
"y": 37.410191
},
{
"x": 127.118362,
"y": 37.409591
},
{
"x": 127.118412,
"y": 37.40905
},
{
"x": 127.118474,
"y": 37.408416
},
{
"x": 127.118499,
"y": 37.408183
},
{
"x": 127.118549,
"y": 37.407783
},
{
"x": 127.118612,
"y": 37.407392
},
{
"x": 127.118724,
"y": 37.406558
},
{
"x": 127.118837,
"y": 37.405683
},
{
"x": 127.118862,
"y": 37.405517
},
{
"x": 127.118874,
"y": 37.40545
},
{
"x": 127.118912,
"y": 37.405184
},
{
"x": 127.119024,
"y": 37.404375
},
{
"x": 127.119099,
"y": 37.403867
},
{
"x": 127.119124,
"y": 37.403684
},
{
"x": 127.119149,
"y": 37.403559
},
{
"x": 127.119162,
"y": 37.403434
},
{
"x": 127.119162,
"y": 37.403242
},
{
"x": 127.119199,
"y": 37.402984
},
{
"x": 127.119237,
"y": 37.402725
},
{
"x": 127.119312,
"y": 37.402342
},
{
"x": 127.119412,
"y": 37.401701
},
{
"x": 127.119462,
"y": 37.401384
},
{
"x": 127.119499,
"y": 37.401076
},
{
"x": 127.119587,
"y": 37.400759
},
{
"x": 127.119599,
"y": 37.400592
},
{
"x": 127.119662,
"y": 37.400226
},
{
"x": 127.119674,
"y": 37.400134
},
{
"x": 127.119699,
"y": 37.399892
},
{
"x": 127.119737,
"y": 37.399701
},
{
"x": 127.119737,
"y": 37.399642
},
{
"x": 127.119749,
"y": 37.399551
},
{
"x": 127.119787,
"y": 37.399301
},
{
"x": 127.119799,
"y": 37.399234
},
{
"x": 127.119812,
"y": 37.399151
},
{
"x": 127.119824,
"y": 37.399026
},
{
"x": 127.119862,
"y": 37.398726
},
{
"x": 127.119874,
"y": 37.398659
},
{
"x": 127.119887,
"y": 37.398593
},
{
"x": 127.119899,
"y": 37.398484
},
{
"x": 127.119912,
"y": 37.398343
},
{
"x": 127.119937,
"y": 37.397968
},
{
"x": 127.119987,
"y": 37.397601
},
{
"x": 127.119999,
"y": 37.397543
},
{
"x": 127.120024,
"y": 37.397334
},
{
"x": 127.120024,
"y": 37.397284
},
{
"x": 127.120037,
"y": 37.397176
},
{
"x": 127.120049,
"y": 37.397068
},
{
"x": 127.120062,
"y": 37.396984
},
{
"x": 127.120074,
"y": 37.396901
},
{
"x": 127.120137,
"y": 37.396468
},
{
"x": 127.120162,
"y": 37.396335
},
{
"x": 127.120199,
"y": 37.395993
},
{
"x": 127.120212,
"y": 37.395918
},
{
"x": 127.120237,
"y": 37.39576
},
{
"x": 127.120287,
"y": 37.394901
},
{
"x": 127.118337,
"y": 37.39491
},
{
"x": 127.118337,
"y": 37.394993
},
{
"x": 127.118337,
"y": 37.395185
},
{
"x": 127.118112,
"y": 37.395185
},
{
"x": 127.11665,
"y": 37.395185
},
{
"x": 127.116612,
"y": 37.39491
},
{
"x": 127.1127,
"y": 37.394918
},
{
"x": 127.1127,
"y": 37.394976
},
{
"x": 127.1127,
"y": 37.396001
},
{
"x": 127.112625,
"y": 37.396059
},
{
"x": 127.112412,
"y": 37.396059
},
{
"x": 127.112025,
"y": 37.396059
},
{
"x": 127.112012,
"y": 37.396059
},
{
"x": 127.111988,
"y": 37.396051
},
{
"x": 127.111975,
"y": 37.396043
},
{
"x": 127.11195,
"y": 37.396026
},
{
"x": 127.11195,
"y": 37.396009
},
{
"x": 127.111938,
"y": 37.395993
},
{
"x": 127.111925,
"y": 37.395976
},
{
"x": 127.111913,
"y": 37.395959
},
{
"x": 127.1119,
"y": 37.395951
},
{
"x": 127.111875,
"y": 37.395934
},
{
"x": 127.111863,
"y": 37.395926
},
{
"x": 127.111838,
"y": 37.395918
},
{
"x": 127.111813,
"y": 37.395909
},
{
"x": 127.1118,
"y": 37.395909
},
{
"x": 127.111775,
"y": 37.395909
},
{
"x": 127.110663,
"y": 37.395909
},
{
"x": 127.110638,
"y": 37.395909
},
{
"x": 127.110613,
"y": 37.395918
},
{
"x": 127.1106,
"y": 37.395918
},
{
"x": 127.110575,
"y": 37.395926
},
{
"x": 127.11055,
"y": 37.395943
},
{
"x": 127.110538,
"y": 37.395951
},
{
"x": 127.110525,
"y": 37.395968
},
{
"x": 127.110513,
"y": 37.395984
},
{
"x": 127.1105,
"y": 37.395993
},
{
"x": 127.110488,
"y": 37.396009
},
{
"x": 127.110488,
"y": 37.396026
},
{
"x": 127.110463,
"y": 37.396043
},
{
"x": 127.11045,
"y": 37.396051
},
{
"x": 127.110425,
"y": 37.396059
},
{
"x": 127.1104,
"y": 37.396059
},
{
"x": 127.110188,
"y": 37.396059
},
{
"x": 127.109938,
"y": 37.396059
},
{
"x": 127.10935,
"y": 37.396034
},
{
"x": 127.10905,
"y": 37.396034
},
{
"x": 127.108913,
"y": 37.396068
},
{
"x": 127.107913,
"y": 37.396068
},
{
"x": 127.107775,
"y": 37.396034
},
{
"x": 127.107213,
"y": 37.396043
},
{
"x": 127.107063,
"y": 37.395943
},
{
"x": 127.107,
"y": 37.395768
},
{
"x": 127.106975,
"y": 37.395693
},
{
"x": 127.106888,
"y": 37.395601
},
{
"x": 127.106863,
"y": 37.395543
},
{
"x": 127.106825,
"y": 37.395476
},
{
"x": 127.106788,
"y": 37.395393
},
{
"x": 127.106651,
"y": 37.395143
},
{
"x": 127.106426,
"y": 37.394818
},
{
"x": 127.106351,
"y": 37.394726
},
{
"x": 127.106263,
"y": 37.394626
},
{
"x": 127.106201,
"y": 37.394543
},
{
"x": 127.106063,
"y": 37.394401
},
{
"x": 127.106013,
"y": 37.394351
},
{
"x": 127.106051,
"y": 37.394318
},
{
"x": 127.106063,
"y": 37.394293
},
{
"x": 127.106101,
"y": 37.394251
},
{
"x": 127.105776,
"y": 37.394468
},
{
"x": 127.105538,
"y": 37.394626
},
{
"x": 127.104738,
"y": 37.395059
},
{
"x": 127.104663,
"y": 37.394968
},
{
"x": 127.104313,
"y": 37.394559
},
{
"x": 127.104251,
"y": 37.394601
},
{
"x": 127.104076,
"y": 37.394668
},
{
"x": 127.104001,
"y": 37.394676
},
{
"x": 127.103938,
"y": 37.394684
},
{
"x": 127.103876,
"y": 37.394684
},
{
"x": 127.103851,
"y": 37.394693
},
{
"x": 127.103676,
"y": 37.394734
},
{
"x": 127.103488,
"y": 37.394768
},
{
"x": 127.103338,
"y": 37.394801
},
{
"x": 127.102576,
"y": 37.395218
},
{
"x": 127.102413,
"y": 37.395293
},
{
"x": 127.102338,
"y": 37.395326
},
{
"x": 127.102251,
"y": 37.395351
},
{
"x": 127.102176,
"y": 37.395368
},
{
"x": 127.102113,
"y": 37.395368
},
{
"x": 127.102076,
"y": 37.395376
},
{
"x": 127.102026,
"y": 37.395368
},
{
"x": 127.101988,
"y": 37.395368
},
{
"x": 127.101976,
"y": 37.395359
},
{
"x": 127.101938,
"y": 37.395351
},
{
"x": 127.101876,
"y": 37.395334
},
{
"x": 127.101851,
"y": 37.395359
},
{
"x": 127.101801,
"y": 37.395334
},
{
"x": 127.101763,
"y": 37.395309
},
{
"x": 127.101688,
"y": 37.395259
},
{
"x": 127.101776,
"y": 37.395143
},
{
"x": 127.101776,
"y": 37.395068
},
{
"x": 127.101726,
"y": 37.395009
},
{
"x": 127.101526,
"y": 37.394868
},
{
"x": 127.101538,
"y": 37.394718
},
{
"x": 127.101451,
"y": 37.394584
},
{
"x": 127.101014,
"y": 37.393968
},
{
"x": 127.100989,
"y": 37.393951
},
{
"x": 127.100964,
"y": 37.393968
},
{
"x": 127.100939,
"y": 37.394118
},
{
"x": 127.100989,
"y": 37.394159
},
{
"x": 127.100939,
"y": 37.394359
},
{
"x": 127.100901,
"y": 37.394326
},
{
"x": 127.100901,
"y": 37.394326
},
{
"x": 127.100901,
"y": 37.394334
},
{
"x": 127.100864,
"y": 37.394551
},
{
"x": 127.100826,
"y": 37.394659
},
{
"x": 127.100751,
"y": 37.394976
},
{
"x": 127.100676,
"y": 37.395276
},
{
"x": 127.100589,
"y": 37.395559
},
{
"x": 127.100489,
"y": 37.395826
},
{
"x": 127.100276,
"y": 37.396259
},
{
"x": 127.100139,
"y": 37.396484
},
{
"x": 127.100001,
"y": 37.396701
},
{
"x": 127.099839,
"y": 37.396926
},
{
"x": 127.099664,
"y": 37.397159
},
{
"x": 127.099539,
"y": 37.397334
},
{
"x": 127.099464,
"y": 37.397467
},
{
"x": 127.099426,
"y": 37.397534
},
{
"x": 127.099351,
"y": 37.397676
},
{
"x": 127.099301,
"y": 37.397826
},
{
"x": 127.099276,
"y": 37.397901
},
{
"x": 127.099251,
"y": 37.397959
},
{
"x": 127.099226,
"y": 37.398042
},
{
"x": 127.099201,
"y": 37.398142
},
{
"x": 127.099189,
"y": 37.398201
},
{
"x": 127.099176,
"y": 37.398276
},
{
"x": 127.099164,
"y": 37.398351
},
{
"x": 127.099164,
"y": 37.398426
},
{
"x": 127.099151,
"y": 37.398501
},
{
"x": 127.099151,
"y": 37.398576
},
{
"x": 127.099151,
"y": 37.398651
},
{
"x": 127.099151,
"y": 37.398734
},
{
"x": 127.099164,
"y": 37.398809
},
{
"x": 127.099176,
"y": 37.398884
},
{
"x": 127.099239,
"y": 37.399251
},
{
"x": 127.099239,
"y": 37.399292
},
{
"x": 127.099251,
"y": 37.399342
},
{
"x": 127.099251,
"y": 37.399392
},
{
"x": 127.099251,
"y": 37.399442
},
{
"x": 127.099251,
"y": 37.399492
},
{
"x": 127.099251,
"y": 37.399534
},
{
"x": 127.099251,
"y": 37.399584
},
{
"x": 127.099251,
"y": 37.399634
},
{
"x": 127.099251,
"y": 37.399684
},
{
"x": 127.099251,
"y": 37.399734
},
{
"x": 127.099251,
"y": 37.399784
},
{
"x": 127.099239,
"y": 37.399875
},
{
"x": 127.099201,
"y": 37.400075
},
{
"x": 127.099101,
"y": 37.400384
},
{
"x": 127.099114,
"y": 37.400467
},
{
"x": 127.099064,
"y": 37.400492
},
{
"x": 127.099051,
"y": 37.400525
},
{
"x": 127.099039,
"y": 37.400567
},
{
"x": 127.099014,
"y": 37.400609
},
{
"x": 127.099001,
"y": 37.400625
},
{
"x": 127.098989,
"y": 37.400642
},
{
"x": 127.099039,
"y": 37.400642
},
{
"x": 127.099026,
"y": 37.40065
},
{
"x": 127.098989,
"y": 37.400667
},
{
"x": 127.098989,
"y": 37.400667
},
{
"x": 127.098976,
"y": 37.400692
},
{
"x": 127.098964,
"y": 37.400717
},
{
"x": 127.098939,
"y": 37.40075
},
{
"x": 127.098914,
"y": 37.4008
},
{
"x": 127.098889,
"y": 37.40085
},
{
"x": 127.098864,
"y": 37.400892
},
{
"x": 127.098826,
"y": 37.400942
},
{
"x": 127.098801,
"y": 37.400984
},
{
"x": 127.098764,
"y": 37.401034
},
{
"x": 127.098739,
"y": 37.401075
},
{
"x": 127.098701,
"y": 37.401117
},
{
"x": 127.098676,
"y": 37.401159
},
{
"x": 127.098639,
"y": 37.4012
},
{
"x": 127.098601,
"y": 37.40125
},
{
"x": 127.098526,
"y": 37.401334
},
{
"x": 127.098451,
"y": 37.401409
},
{
"x": 127.098326,
"y": 37.401542
},
{
"x": 127.098101,
"y": 37.401759
},
{
"x": 127.097576,
"y": 37.402267
},
{
"x": 127.097614,
"y": 37.402258
},
{
"x": 127.097514,
"y": 37.402358
},
{
"x": 127.097401,
"y": 37.402425
},
{
"x": 127.097189,
"y": 37.402633
},
{
"x": 127.097076,
"y": 37.402733
},
{
"x": 127.097014,
"y": 37.4028
},
{
"x": 127.096939,
"y": 37.402858
},
{
"x": 127.096864,
"y": 37.402917
},
{
"x": 127.096814,
"y": 37.402958
},
{
"x": 127.096726,
"y": 37.403017
},
{
"x": 127.096651,
"y": 37.403058
},
{
"x": 127.096564,
"y": 37.403108
},
{
"x": 127.096476,
"y": 37.403158
},
{
"x": 127.096376,
"y": 37.403208
},
{
"x": 127.096289,
"y": 37.403242
},
{
"x": 127.096201,
"y": 37.403283
},
{
"x": 127.096126,
"y": 37.403308
},
{
"x": 127.096064,
"y": 37.403325
},
{
"x": 127.095989,
"y": 37.40335
},
{
"x": 127.095864,
"y": 37.403375
},
{
"x": 127.095751,
"y": 37.4034
},
{
"x": 127.095626,
"y": 37.403408
},
{
"x": 127.095501,
"y": 37.403417
},
{
"x": 127.095376,
"y": 37.403408
},
{
"x": 127.095026,
"y": 37.403383
},
{
"x": 127.094801,
"y": 37.403375
},
{
"x": 127.094651,
"y": 37.403375
},
{
"x": 127.094489,
"y": 37.403383
},
{
"x": 127.094239,
"y": 37.403425
},
{
"x": 127.093989,
"y": 37.403475
},
{
"x": 127.093864,
"y": 37.403517
},
{
"x": 127.093776,
"y": 37.40355
},
{
"x": 127.093614,
"y": 37.403608
},
{
"x": 127.093451,
"y": 37.403675
},
{
"x": 127.093301,
"y": 37.403742
},
{
"x": 127.093076,
"y": 37.403842
},
{
"x": 127.092927,
"y": 37.403917
},
{
"x": 127.092764,
"y": 37.403992
},
{
"x": 127.092677,
"y": 37.404025
},
{
"x": 127.092589,
"y": 37.40405
},
{
"x": 127.092552,
"y": 37.404066
},
{
"x": 127.092452,
"y": 37.404091
},
{
"x": 127.092627,
"y": 37.404291
},
{
"x": 127.092677,
"y": 37.404566
},
{
"x": 127.092677,
"y": 37.404575
},
{
"x": 127.092664,
"y": 37.404616
},
{
"x": 127.092677,
"y": 37.404625
},
{
"x": 127.092789,
"y": 37.404783
},
{
"x": 127.092826,
"y": 37.404833
},
{
"x": 127.092914,
"y": 37.404966
},
{
"x": 127.093001,
"y": 37.4051
},
{
"x": 127.092926,
"y": 37.405116
},
{
"x": 127.092676,
"y": 37.40515
},
{
"x": 127.092452,
"y": 37.405291
},
{
"x": 127.092626,
"y": 37.405358
},
{
"x": 127.092701,
"y": 37.405383
},
{
"x": 127.092901,
"y": 37.405633
},
{
"x": 127.093426,
"y": 37.406016
},
{
"x": 127.093676,
"y": 37.406191
},
{
"x": 127.093876,
"y": 37.406291
},
{
"x": 127.094151,
"y": 37.406491
},
{
"x": 127.094226,
"y": 37.406566
},
{
"x": 127.094451,
"y": 37.4068
},
{
"x": 127.094489,
"y": 37.406841
},
{
"x": 127.094776,
"y": 37.406966
},
{
"x": 127.094964,
"y": 37.406966
},
{
"x": 127.095201,
"y": 37.406925
},
{
"x": 127.095401,
"y": 37.406941
},
{
"x": 127.095489,
"y": 37.406983
},
{
"x": 127.095576,
"y": 37.407016
},
{
"x": 127.095639,
"y": 37.40705
},
{
"x": 127.095826,
"y": 37.407075
},
{
"x": 127.095964,
"y": 37.407091
},
{
"x": 127.096126,
"y": 37.407116
},
{
"x": 127.096501,
"y": 37.406991
},
{
"x": 127.096764,
"y": 37.406858
},
{
"x": 127.096839,
"y": 37.406616
},
{
"x": 127.097089,
"y": 37.406566
},
{
"x": 127.097214,
"y": 37.406541
},
{
"x": 127.097701,
"y": 37.406558
},
{
"x": 127.098013,
"y": 37.406575
},
{
"x": 127.098776,
"y": 37.406783
},
{
"x": 127.099501,
"y": 37.406958
},
{
"x": 127.099638,
"y": 37.406908
},
{
"x": 127.099838,
"y": 37.4069
},
{
"x": 127.099888,
"y": 37.40695
},
{
"x": 127.099976,
"y": 37.406983
},
{
"x": 127.099988,
"y": 37.407058
},
{
"x": 127.100013,
"y": 37.407175
},
{
"x": 127.100076,
"y": 37.407291
},
{
"x": 127.099913,
"y": 37.407683
},
{
"x": 127.099851,
"y": 37.407883
},
{
"x": 127.099863,
"y": 37.407941
},
{
"x": 127.099926,
"y": 37.408008
},
{
"x": 127.100013,
"y": 37.408083
},
{
"x": 127.100013,
"y": 37.408166
},
{
"x": 127.100113,
"y": 37.408233
},
{
"x": 127.100163,
"y": 37.408441
},
{
"x": 127.100226,
"y": 37.408674
},
{
"x": 127.100251,
"y": 37.408799
},
{
"x": 127.101226,
"y": 37.409174
},
{
"x": 127.101638,
"y": 37.409241
},
{
"x": 127.102001,
"y": 37.409299
},
{
"x": 127.102425,
"y": 37.409716
},
{
"x": 127.102675,
"y": 37.409533
},
{
"x": 127.102775,
"y": 37.409491
},
{
"x": 127.10295,
"y": 37.409324
},
{
"x": 127.10315,
"y": 37.409141
},
{
"x": 127.103588,
"y": 37.408758
},
{
"x": 127.10375,
"y": 37.408608
},
{
"x": 127.104075,
"y": 37.408691
},
{
"x": 127.104575,
"y": 37.408566
},
{
"x": 127.104825,
"y": 37.408583
},
{
"x": 127.104925,
"y": 37.40845
},
{
"x": 127.105313,
"y": 37.408441
},
{
"x": 127.105525,
"y": 37.4083
},
{
"x": 127.105613,
"y": 37.4082
},
{
"x": 127.105713,
"y": 37.408083
},
{
"x": 127.106375,
"y": 37.407716
},
{
"x": 127.106463,
"y": 37.407675
},
{
"x": 127.106663,
"y": 37.407716
},
{
"x": 127.1069,
"y": 37.407408
},
{
"x": 127.107025,
"y": 37.407225
},
{
"x": 127.107075,
"y": 37.40715
},
{
"x": 127.107125,
"y": 37.40705
},
{
"x": 127.10735,
"y": 37.40715
},
{
"x": 127.107588,
"y": 37.407066
},
{
"x": 127.108962,
"y": 37.407325
},
{
"x": 127.111062,
"y": 37.407358
},
{
"x": 127.111925,
"y": 37.407525
},
{
"x": 127.112112,
"y": 37.407458
},
{
"x": 127.11315,
"y": 37.407725
},
{
"x": 127.114612,
"y": 37.408125
},
{
"x": 127.115112,
"y": 37.408358
},
{
"x": 127.115099,
"y": 37.408416
},
{
"x": 127.115912,
"y": 37.408641
},
{
"x": 127.116074,
"y": 37.408841
},
{
"x": 127.116399,
"y": 37.408991
},
{
"x": 127.116662,
"y": 37.409041
},
{
"x": 127.116874,
"y": 37.409233
},
{
"x": 127.117137,
"y": 37.409575
},
{
"x": 127.117287,
"y": 37.40965
},
{
"x": 127.117337,
"y": 37.409816
},
{
"x": 127.117612,
"y": 37.410075
},
{
"x": 127.118162,
"y": 37.410408
},
{
"x": 127.118249,
"y": 37.410383
},
{
"x": 127.118249,
"y": 37.410458
}
]
}
]
}
]
}
}
},
"polygonlist": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"description": "공간의 좌표 개수",
"format": "int32",
"example": 236
},
"polygon": {
"type": "array",
"description": "공간의 좌표 정보 목록(배열)",
"items": {
"$ref": "#/components/schemas/NumberVertex"
}
}
},
"description": "행정구역 공간 정보 목록(배열)"
},
"SearchW3WProposerResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"proposer": {
"$ref": "#/components/schemas/W3WProposerData"
}
},
"description": "W3W 검색어 추천 API의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"proposer": {
"result": true,
"keyword": [
{
"keyword": "외치다.효자.소포",
"address": "경기도 성남시",
"distance": 9
},
{
"keyword": "외치다.효도.소포",
"address": "경기도 성남시",
"distance": 4
},
{
"keyword": "외치다.겨자.소수",
"address": "경기도 수원시",
"distance": 13
}
]
}
}
},
"W3WProposer": {
"type": "object",
"properties": {
"keyword": {
"type": "string",
"description": "추천 w3w(what3words) 키워드",
"example": "외치다.효자.다소"
},
"address": {
"type": "string",
"description": "축약 주소",
"example": "대전광역시"
},
"distance": {
"type": "integer",
"description": "기준점과의 거리",
"format": "int32",
"example": 9
}
},
"description": "w3w 검색어 추천 결과 목록(배열)"
},
"W3WProposerData": {
"type": "object",
"properties": {
"result": {
"type": "boolean",
"description": "검색 결과 성공 여부",
"example": true
},
"keyword": {
"type": "array",
"description": "w3w 검색어 추천 결과 목록(배열)",
"items": {
"$ref": "#/components/schemas/W3WProposer"
}
}
},
"description": "W3W 검색어 추천 결과"
},
"SearchW3WOptimalPositionResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"data": {
"$ref": "#/components/schemas/W3WOptimalPositionData"
}
},
"description": "W3W 최적 지점 검색 API의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"data": {
"result": true,
"entrypoint": {
"keyword": "승차.수영.왼발",
"posX": 127.110876,
"posY": 37.402324,
"address": "경기도 성남시 분당구 삼평동 678",
"roadname": "경기도 성남시 분당구 판교역로 240"
}
}
}
},
"W3WOptimalPosition": {
"type": "object",
"properties": {
"keyword": {
"type": "string",
"description": "해당 지점의 w3w(what3words) 키워드",
"example": "승차.수영.왼발"
},
"posX": {
"type": "number",
"description": "X좌표(경도) 값",
"example": 127.110766
},
"posY": {
"type": "number",
"description": "Y좌표(위도) 값",
"example": 37.402153
},
"address": {
"type": "string",
"description": "법정동 주소",
"example": "경기도 성남시 분당구 삼평동 678"
},
"roadname": {
"type": "string",
"description": "도로명 주소",
"example": "경기도 성남시 분당구 판교역로 240"
}
},
"description": "w3w 최적 지점 검색 결과 정보"
},
"W3WOptimalPositionData": {
"type": "object",
"properties": {
"result": {
"type": "boolean",
"description": "검색 결과 성공 여부",
"example": true
},
"entrypoint": {
"$ref": "#/components/schemas/W3WOptimalPosition"
}
},
"description": "W3W 최적 지점 검색 결과"
},
"SearchW3WAddressesResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"address": {
"$ref": "#/components/schemas/W3WAddressesData"
}
},
"description": "W3W 리버스 지오코딩 API의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"address": {
"result": true,
"adm": {
"keyword": "승차.수영.왼발",
"posX": "127.110766",
"posY": "37.402153",
"address": "경기도 성남시 분당구 삼평동 678",
"roadname": "경기도 성남시 분당구 판교역로 240"
}
}
}
},
"W3WAddresses": {
"type": "object",
"properties": {
"keyword": {
"type": "string",
"description": "해당 지점의 w3w(what3words) 키워드",
"example": "승차.수영.왼발"
},
"posX": {
"type": "string",
"description": "X좌표(경도) 값",
"example": "127.110766"
},
"posY": {
"type": "string",
"description": "Y좌표(위도) 값",
"example": "37.402153"
},
"address": {
"type": "string",
"description": "법정동 주소",
"example": "경기도 성남시 분당구 삼평동 678"
},
"roadname": {
"type": "string",
"description": "도로명 주소",
"example": "경기도 성남시 분당구 판교역로 240"
}
},
"description": "w3w 리버스 지오코딩 결과 정보"
},
"W3WAddressesData": {
"type": "object",
"properties": {
"result": {
"type": "boolean",
"description": "검색 결과 성공 여부",
"example": true
},
"adm": {
"$ref": "#/components/schemas/W3WAddresses"
}
},
"description": "W3W 리버스 지오코딩 결과"
},
"SearchTransCoordinatesResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"coordinate": {
"$ref": "#/components/schemas/TransCoordinatesData"
}
},
"description": "좌표(계) 변환 API의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"coordinate": {
"x": "209991.93",
"y": "433345.71",
"coordtype": "TM"
}
}
},
"TransCoordinatesData": {
"type": "object",
"properties": {
"x": {
"type": "string",
"description": "X좌표(경도) 값
*입력 좌표계에 따라 경도(Longitude) 또는 Easting",
"example": "209991.93"
},
"y": {
"type": "string",
"description": "Y좌표(위도) 값
*입력 좌표계에 따라 위도(Latitude) 또는 Northing",
"example": "433345.71"
},
"coordtype": {
"type": "string",
"description": "변환된 좌표 형식",
"example": "TM"
}
},
"description": "좌표(계) 변환 결과"
},
"SearchSubRoadResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"subroad": {
"$ref": "#/components/schemas/SubRoadData"
}
},
"description": "하위 도로명 검색 API의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"subroad": {
"result": true,
"totalcount": 22,
"count": 22,
"road": [
{
"cid": 35966,
"roadname": "경부고속도로"
},
{
"cid": 70331,
"roadname": "대왕판교로"
},
{
"cid": 71188,
"roadname": "대왕판교로606번길"
},
{
"cid": 71191,
"roadname": "대왕판교로644번길"
},
{
"cid": 71186,
"roadname": "대왕판교로645번길"
},
{
"cid": 71195,
"roadname": "대왕판교로712번길"
},
{
"cid": 70444,
"roadname": "동판교로"
},
{
"cid": 71198,
"roadname": "동판교로177번길"
},
{
"cid": 71197,
"roadname": "동판교로266번길"
},
{
"cid": 70372,
"roadname": "분당내곡로"
},
{
"cid": 71190,
"roadname": "운중천자전거2길"
},
{
"cid": 71071,
"roadname": "판교로"
},
{
"cid": 71183,
"roadname": "판교로227번길"
},
{
"cid": 71184,
"roadname": "판교로228번길"
},
{
"cid": 71182,
"roadname": "판교로255번길"
},
{
"cid": 71185,
"roadname": "판교로256번길"
},
{
"cid": 71196,
"roadname": "판교로289번길"
},
{
"cid": 71194,
"roadname": "판교로319번길"
},
{
"cid": 71187,
"roadname": "판교역로"
},
{
"cid": 71189,
"roadname": "판교역로192번길"
},
{
"cid": 71192,
"roadname": "판교역로226번길"
},
{
"cid": 71193,
"roadname": "판교역로241번길"
}
]
}
}
},
"SubRoad": {
"type": "object",
"properties": {
"cid": {
"type": "string",
"description": "도로명 코드",
"example": "4113510900"
},
"roadname": {
"type": "string",
"description": "도로명 주소",
"example": "경기도 성남시 분당구 삼평동"
}
},
"description": "도로명 검색 결과 목록(배열)"
},
"SubRoadData": {
"type": "object",
"properties": {
"result": {
"type": "boolean",
"description": "검색 결과 성공 여부",
"example": true
},
"totalcount": {
"type": "integer",
"description": "총 검색 결과 개수",
"format": "int32",
"example": 192
},
"count": {
"type": "integer",
"description": "총 응답 결과 개수",
"format": "int32",
"example": 102
},
"road": {
"type": "array",
"description": "도로명 검색 결과 목록(배열)",
"items": {
"$ref": "#/components/schemas/SubRoad"
}
}
},
"description": "하위 도로명 검색 결과"
},
"ExternalLink": {
"type": "object",
"properties": {
"Site": {
"type": "string",
"description": "연동 Site"
},
"ID": {
"type": "string",
"description": "연동 ID"
},
"ExtraInfo1": {
"type": "string",
"description": "추가정보1"
},
"ExtraInfo2": {
"type": "string",
"description": "추가정보2"
}
},
"description": "연동 Site 정보 목록(배열)"
},
"PoiDataB": {
"type": "object",
"properties": {
"poiid": {
"type": "integer",
"description": "POI 고유 ID",
"format": "int32",
"example": 8827198
},
"subflag": {
"type": "string",
"description": "하위 시설의 분류 정보",
"example": "1",
"enum": [
"1",
"2",
"3",
"4",
"5",
"6",
"7"
],
"x-enum-descriptions": {
"1": "입구(차량+사람)",
"2": "입구(차량진출입)",
"3": "입구(차량)",
"4": "출구(차량)",
"5": "입구(사람)",
"6": "부속시설",
"7": "대등시설"
}
},
"dpx": {
"type": "string",
"description": "지도 표출용 X좌표(경도)",
"example": "127.110762"
},
"dpy": {
"type": "string",
"description": "지도 표출용 Y좌표(위도)",
"example": "37.402184"
},
"rpx": {
"type": "string",
"description": "차량 진입로 X좌표(경도)",
"example": "127.110862"
},
"rpy": {
"type": "string",
"description": "차량 진입로 Y좌표(위도)",
"example": "37.402334"
},
"routepoints": {
"type": "array",
"description": "차량 진입로 좌표 정보 목록(배열)
>*차량 경로 탐색 시 사용 가능",
"items": {
"$ref": "#/components/schemas/RoutePoint"
}
},
"name1": {
"type": "string",
"description": "대표 명칭",
"example": "아이나비시스템즈"
},
"name2": {
"type": "string",
"description": "축약 명칭"
},
"name3": {
"type": "string",
"description": "확장 명칭1"
},
"name4": {
"type": "string",
"description": "확장 명칭2"
},
"admcode": {
"type": "string",
"description": "행정구역 코드(법정동/행정동)
*법정동 검색 → 법정동 코드
*행정동 검색 → 행정동 코드",
"example": "4113510900"
},
"address": {
"type": "string",
"description": "전체 주소",
"example": "경기도 성남시 분당구 삼평동"
},
"jibun": {
"type": "string",
"description": "지번 주소",
"example": "678"
},
"roadname": {
"type": "string",
"description": "도로명주소",
"example": "경기도 성남시 분당구 판교역로"
},
"roadjibun": {
"type": "string",
"description": "건물 번호",
"example": "240"
},
"detailaddress": {
"type": "string",
"description": "상세 주소 정보",
"example": "삼환하이펙스 A동 8층"
},
"catecode": {
"type": "string",
"description": "카테고리 코드",
"example": "130602"
},
"catename": {
"type": "string",
"description": "카테고리 명칭",
"example": "팅크웨어"
},
"dp_catecode": {
"type": "string",
"description": "전시용 카테고리 코드",
"example": "000"
},
"distance": {
"type": "integer",
"description": "기준 좌표와의 거리(m)",
"format": "int32",
"example": 21713
},
"tel": {
"type": "string",
"description": "대표 전화번호",
"example": "02-589-9610"
},
"hasoildata": {
"type": "boolean",
"description": "주유소 유가 정보 보유 여부"
},
"islandmark": {
"type": "boolean",
"description": "랜드마크 여부"
},
"updateTS": {
"type": "string",
"description": "데이터의 최종 갱신 시각",
"example": "2023-08-17"
},
"externallink": {
"type": "array",
"description": "연동 Site 정보 목록(배열)",
"items": {
"$ref": "#/components/schemas/ExternalLink"
}
},
"popularity": {
"type": "boolean",
"description": "인기 여부"
},
"pop_tv": {
"type": "boolean",
"description": "TV 기반 인기 여부"
},
"pop_sns": {
"type": "boolean",
"description": "SNS 기반 인기 여부"
},
"pop_hot": {
"type": "boolean",
"description": "HOT 인기 여부"
},
"pop_hit": {
"type": "boolean",
"description": "HIT 인기 여부"
},
"pop_top": {
"type": "string",
"description": "TOP 인기 단계",
"example": "경기_1,분당구_1"
}
},
"description": "POI 검색 결과 목록(배열)"
},
"RoutePoint": {
"type": "object",
"properties": {
"rpx": {
"type": "string",
"description": "차량 진입로 X좌표(경도)",
"example": "127.110862"
},
"rpy": {
"type": "string",
"description": "차량 진입로 Y좌표(위도)",
"example": "37.402334"
}
},
"description": "차량 진입로 좌표 정보 목록(배열)
>*차량 경로 탐색 시 사용 가능"
},
"SearchSubPoisResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"subpoi": {
"$ref": "#/components/schemas/SubPoisData"
}
},
"description": "시설물 정보 조회 API의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"subpoi": {
"result": true,
"totalcount": 1,
"count": 1,
"poi": [
{
"poiid": 1415980,
"subflag": "1",
"dpx": "127.110862",
"dpy": "37.402334",
"rpx": "127.110862",
"rpy": "37.402334",
"routepoints": [
{
"rpx": "127.110862",
"rpy": "37.402334"
}
],
"name1": "입구",
"name2": "팅크웨어정문",
"name3": "",
"name4": "",
"admcode": "4113510900",
"address": "경기도 성남시 분당구 삼평동",
"jibun": "",
"roadname": "",
"roadjibun": "",
"detailaddress": "",
"catecode": "181104",
"catename": "도로시설",
"dp_catecode": "000",
"distance": 0,
"tel": "",
"hasoildata": false,
"islandmark": false,
"updateTS": "2023-08-17",
"externallink": [],
"popularity": false,
"pop_tv": false,
"pop_sns": false,
"pop_hot": false,
"pop_hit": false,
"pop_top": ""
}
]
}
}
},
"SubPoisData": {
"type": "object",
"properties": {
"result": {
"type": "boolean",
"description": "검색 결과 성공 여부",
"example": true
},
"totalcount": {
"type": "integer",
"description": "총 검색 결과 개수",
"format": "int32",
"example": 192
},
"count": {
"type": "integer",
"description": "총 응답 결과 개수",
"format": "int32",
"example": 102
},
"poi": {
"type": "array",
"description": "POI 검색 결과 목록(배열)",
"items": {
"$ref": "#/components/schemas/PoiDataB"
}
}
},
"description": "시설물 정보 조회 결과"
},
"SearchSubAdmResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"subadm": {
"$ref": "#/components/schemas/SubAdmData"
}
},
"description": "하위 행정계 검색 API의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"subadm": {
"result": true,
"totalcount": 18,
"count": 18,
"adm": [
{
"posx": "127.111764",
"posy": "37.349357",
"admname": "구미동",
"admcode": "4113511400",
"address": "경기도 성남시 분당구 구미동",
"hassub": false
},
{
"posx": "127.102227",
"posy": "37.364996",
"admname": "궁내동",
"admcode": "4113511200",
"address": "경기도 성남시 분당구 궁내동",
"hassub": false
},
{
"posx": "127.107077",
"posy": "37.351615",
"admname": "금곡동",
"admcode": "4113511100",
"address": "경기도 성남시 분당구 금곡동",
"hassub": false
},
{
"posx": "127.070142",
"posy": "37.368679",
"admname": "대장동",
"admcode": "4113511600",
"address": "경기도 성남시 분당구 대장동",
"hassub": false
},
{
"posx": "127.090403",
"posy": "37.352464",
"admname": "동원동",
"admcode": "4113511300",
"address": "경기도 성남시 분당구 동원동",
"hassub": false
},
{
"posx": "127.110738",
"posy": "37.388552",
"admname": "백현동",
"admcode": "4113511000",
"address": "경기도 성남시 분당구 백현동",
"hassub": false
},
{
"posx": "127.131086",
"posy": "37.370146",
"admname": "분당동",
"admcode": "4113510100",
"address": "경기도 성남시 분당구 분당동",
"hassub": false
},
{
"posx": "127.116262",
"posy": "37.40615",
"admname": "삼평동",
"admcode": "4113510900",
"address": "경기도 성남시 분당구 삼평동",
"hassub": false
},
{
"posx": "127.125874",
"posy": "37.382845",
"admname": "서현동",
"admcode": "4113510500",
"address": "경기도 성남시 분당구 서현동",
"hassub": false
},
{
"posx": "127.040182",
"posy": "37.377677",
"admname": "석운동",
"admcode": "4113511700",
"address": "경기도 성남시 분당구 석운동",
"hassub": false
},
{
"posx": "127.117862",
"posy": "37.375604",
"admname": "수내동",
"admcode": "4113510200",
"address": "경기도 성남시 분당구 수내동",
"hassub": false
},
{
"posx": "127.130198",
"posy": "37.412058",
"admname": "야탑동",
"admcode": "4113510700",
"address": "경기도 성남시 분당구 야탑동",
"hassub": false
},
{
"posx": "127.077716",
"posy": "37.390576",
"admname": "운중동",
"admcode": "4113511500",
"address": "경기도 성남시 분당구 운중동",
"hassub": false
},
{
"posx": "127.150997",
"posy": "37.383162",
"admname": "율동",
"admcode": "4113510400",
"address": "경기도 성남시 분당구 율동",
"hassub": false
},
{
"posx": "127.127148",
"posy": "37.399585",
"admname": "이매동",
"admcode": "4113510600",
"address": "경기도 성남시 분당구 이매동",
"hassub": false
},
{
"posx": "127.106288",
"posy": "37.372746",
"admname": "정자동",
"admcode": "4113510300",
"address": "경기도 성남시 분당구 정자동",
"hassub": false
},
{
"posx": "127.098576",
"posy": "37.390002",
"admname": "판교동",
"admcode": "4113510800",
"address": "경기도 성남시 분당구 판교동",
"hassub": false
},
{
"posx": "127.071416",
"posy": "37.381694",
"admname": "하산운동",
"admcode": "4113511800",
"address": "경기도 성남시 분당구 하산운동",
"hassub": false
}
]
}
}
},
"SubAdm": {
"type": "object",
"properties": {
"posx": {
"type": "string",
"description": "X좌표(경도) 값",
"example": "127.11065"
},
"posy": {
"type": "string",
"description": "Y좌표(위도) 값",
"example": "37.402109"
},
"admname": {
"type": "string",
"description": "행정 명칭",
"example": "삼평동"
},
"admcode": {
"type": "string",
"description": "행정 코드",
"example": "4113510900"
},
"address": {
"type": "string",
"description": "전체 주소",
"example": "경기도 성남시 분당구 삼평동"
},
"hassub": {
"type": "boolean",
"description": "하위 행정계 존재여부"
}
},
"description": "search.data.sub-adm.description"
},
"SubAdmData": {
"type": "object",
"properties": {
"result": {
"type": "boolean",
"description": "검색 결과 성공 여부",
"example": true
},
"totalcount": {
"type": "integer",
"description": "총 검색 결과 개수",
"format": "int32",
"example": 192
},
"count": {
"type": "integer",
"description": "총 응답 결과 개수",
"format": "int32",
"example": 102
},
"adm": {
"type": "array",
"description": "주소 검색 결과 목록(배열)",
"items": {
"$ref": "#/components/schemas/SubAdm"
}
}
},
"description": "하위 행정계 검색 결과"
},
"HeaderResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
}
},
"description": "API 응답 결과의 상태"
},
"Adm": {
"type": "object",
"properties": {
"type": {
"type": "integer",
"description": "검색 타입",
"format": "int32",
"example": 1,
"enum": [
1,
2,
3
],
"x-enum-descriptions": {
"1": "행정구역 검색",
"2": "지번 검색",
"3": "도로명 주소 검색"
}
},
"posx": {
"type": "string",
"description": "X좌표(경도) 값",
"example": "127.11065"
},
"posy": {
"type": "string",
"description": "Y좌표(위도) 값",
"example": "37.402109"
},
"admcode": {
"type": "string",
"description": "법정구역 코드",
"example": "4113510900"
},
"address": {
"type": "string",
"description": "전체 주소",
"example": "경기도 성남시 분당구 삼평동"
},
"address_sido": {
"type": "string",
"description": "시/도",
"example": "경기도"
},
"address_gu": {
"type": "string",
"description": "군/구",
"example": "성남시 분당구"
},
"address_dong": {
"type": "string",
"description": "법정동 명칭",
"example": "삼평동"
},
"address_haeng": {
"type": "string",
"description": "행정동 명칭",
"example": "삼평동"
},
"legalcode": {
"type": "string",
"description": "법정동 코드",
"example": "4113510900"
},
"haengcode": {
"type": "string",
"description": "행정동 코드",
"example": "4113565500"
},
"jibun": {
"type": "string",
"description": "지번 정보",
"example": "678"
},
"roadname": {
"type": "string",
"description": "도로명 주소",
"example": "경기도 성남시 분당구 판교역로"
},
"roadjibun": {
"type": "string",
"description": "건물 번호",
"example": "240"
},
"postcode": {
"type": "string",
"description": "우편번호
*주소+지번 검색 시 제공",
"example": "13493"
},
"buildname": {
"type": "string",
"description": "건물 명칭
*도로명 주소 검색 시 제공",
"example": "삼환하이펙스A동"
},
"accuracy": {
"type": "integer",
"description": "지번 정확도
*검색 된 방식에 따라 정확도가 결정",
"format": "int32",
"example": 0,
"enum": [
0,
1,
2,
3
],
"x-enum-descriptions": {
"0": "지번 일치 검색",
"1": "호지번 확장 검색",
"2": "모지번 확장 검색",
"3": "행정구역 검색"
}
},
"distance": {
"type": "integer",
"description": "기준점과의 거리 정보(m)",
"format": "int32",
"example": 0
}
},
"description": "주소 검색 결과 목록(배열)"
},
"EntryPoint": {
"type": "object",
"properties": {
"px": {
"type": "string",
"description": "진입 지점의 X좌표(경도)",
"example": "127.109987"
},
"py": {
"type": "string",
"description": "진입 지점의 Y좌표(위도)",
"example": "37.401942"
}
},
"description": "진입 지점 정보"
},
"PoiDataA": {
"type": "object",
"properties": {
"poiid": {
"type": "integer",
"description": "POI 고유 ID",
"format": "int32",
"example": 8827198
},
"depth": {
"type": "string",
"description": "계층 정보",
"example": "0",
"x-enum-descriptions": {
"0": "일반 시설물",
"1": "하위 시설물",
"2": "최하위 시설물"
}
},
"dpx": {
"type": "string",
"description": "지도 표출용 X좌표(경도)",
"example": "127.110762"
},
"dpy": {
"type": "string",
"description": "지도 표출용 Y좌표(위도)",
"example": "37.402184"
},
"rpx": {
"type": "string",
"description": "차량 진입로 X좌표(경도)",
"example": "127.110862"
},
"rpy": {
"type": "string",
"description": "차량 진입로 Y좌표(위도)",
"example": "37.402334"
},
"routepoints": {
"type": "array",
"description": "차량 진입로 좌표 정보 목록(배열)
>*차량 경로 탐색 시 사용 가능",
"items": {
"$ref": "#/components/schemas/RoutePoint"
}
},
"entrypoint": {
"$ref": "#/components/schemas/EntryPoint"
},
"name1": {
"type": "string",
"description": "대표 명칭",
"example": "아이나비시스템즈"
},
"name2": {
"type": "string",
"description": "축약 명칭"
},
"name3": {
"type": "string",
"description": "확장 명칭1"
},
"name4": {
"type": "string",
"description": "확장 명칭2"
},
"admcode": {
"type": "string",
"description": "행정구역 코드(법정동/행정동)
*법정동 검색 → 법정동 코드
*행정동 검색 → 행정동 코드",
"example": "4113510900"
},
"haengcode": {
"type": "string",
"description": "행정동 코드",
"example": "4113565500"
},
"address": {
"type": "string",
"description": "전체 주소",
"example": "경기도 성남시 분당구 삼평동"
},
"address_haeng": {
"type": "string",
"description": "행정동 기준 주소",
"example": "삼평동"
},
"jibun": {
"type": "string",
"description": "지번 주소",
"example": "678"
},
"roadname": {
"type": "string",
"description": "도로명주소",
"example": "경기도 성남시 분당구 판교역로"
},
"roadjibun": {
"type": "string",
"description": "건물 번호",
"example": "240"
},
"detailaddress": {
"type": "string",
"description": "상세 주소 정보",
"example": "삼환하이펙스 A동 8층"
},
"catecode": {
"type": "string",
"description": "카테고리 코드",
"example": "130602"
},
"catename": {
"type": "string",
"description": "카테고리 명칭",
"example": "팅크웨어"
},
"dp_catecode": {
"type": "string",
"description": "전시용 카테고리 코드",
"example": "000"
},
"distance": {
"type": "integer",
"description": "기준 좌표와의 거리(m)",
"format": "int32",
"example": 21713
},
"tel": {
"type": "string",
"description": "대표 전화번호",
"example": "02-589-9610"
},
"hasoildata": {
"type": "boolean",
"description": "주유소 유가 정보 보유 여부"
},
"hasdetailinfo": {
"type": "boolean",
"description": "상세 정보 보유 여부"
},
"hassubpoi": {
"type": "boolean",
"description": "하위 POI 존재 여부"
},
"islandmark": {
"type": "boolean",
"description": "랜드마크 여부"
},
"updateTS": {
"type": "string",
"description": "데이터의 최종 갱신 시각",
"example": "2023-08-17"
},
"subpoi": {
"$ref": "#/components/schemas/SubPoi"
},
"externallink": {
"type": "array",
"description": "연동 Site 정보 목록(배열)",
"items": {
"$ref": "#/components/schemas/ExternalLink"
}
},
"popularity": {
"type": "boolean",
"description": "인기 여부"
},
"pop_tv": {
"type": "boolean",
"description": "TV 기반 인기 여부"
},
"pop_sns": {
"type": "boolean",
"description": "SNS 기반 인기 여부"
},
"pop_hot": {
"type": "boolean",
"description": "HOT 인기 여부"
},
"pop_hit": {
"type": "boolean",
"description": "HIT 인기 여부"
},
"pop_top": {
"type": "string",
"description": "TOP 인기 단계",
"example": "경기_1,분당구_1"
}
},
"description": "POI 검색 결과 목록(배열)"
},
"SearchSearchesResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"search": {
"$ref": "#/components/schemas/SearchesData"
}
},
"description": "통합 검색 API의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"search": {
"result": true,
"type": 0,
"totalcount": 2,
"count": 2,
"poitotalcount": 2,
"poicount": 2,
"admtotalcount": 0,
"admcount": 0,
"poi": [
{
"poiid": 8827198,
"depth": "0",
"dpx": "127.110762",
"dpy": "37.402184",
"rpx": "127.110862",
"rpy": "37.402334",
"routepoints": [
{
"rpx": "127.110862",
"rpy": "37.402334"
}
],
"entrypoint": {
"px": "127.109987",
"py": "37.401942"
},
"name1": "아이나비시스템즈",
"name2": "INAVISYSTEMS",
"name3": "아이나비시스템즈판교캠퍼스",
"name4": "아이나비판교캠퍼스",
"admcode": "4113510900",
"haengcode": "4113565500",
"address": "경기도 성남시 분당구 삼평동",
"address_haeng": "삼평동",
"jibun": "678",
"roadname": "경기도 성남시 분당구 판교역로",
"roadjibun": "240",
"detailaddress": "삼환하이펙스 A동 8층",
"catecode": "130602",
"catename": "팅크웨어",
"dp_catecode": "000",
"distance": 21713,
"tel": "02-589-9610",
"hasoildata": false,
"hasdetailinfo": true,
"hassubpoi": false,
"islandmark": true,
"updateTS": "2023-08-17",
"subpoi": {
"count": 0,
"poi": []
},
"externallink": [
{
"Site": "PLOG",
"ID": "http://m.fivepin.co.kr/MyStory/Plog?pid=8827198",
"ExtraInfo1": "단골 많은 팅크웨어(재방문54%)",
"ExtraInfo2": "재방문54%기업"
}
],
"popularity": false,
"pop_tv": false,
"pop_sns": false,
"pop_hot": false,
"pop_hit": false,
"pop_top": "경기_1,분당구_1"
}
],
"adm": [
{
"type": 2,
"posx": "127.11065",
"posy": "37.402109",
"admcode": "4113510900",
"address": "경기도 성남시 분당구 삼평동",
"address_sido": "경기도",
"address_gu": "성남시 분당구",
"address_dong": "삼평동",
"address_haeng": "삼평동",
"legalcode": "4113510900",
"haengcode": "4113565500",
"jibun": "678",
"roadname": "경기도 성남시 분당구 판교역로",
"roadjibun": "240",
"postcode": "13493",
"buildname": "삼환하이펙스A동",
"accuracy": 0,
"distance": 21715
}
]
}
}
},
"SearchesData": {
"type": "object",
"properties": {
"result": {
"type": "boolean",
"description": "검색 결과 성공 여부",
"example": true
},
"type": {
"type": "integer",
"description": "검색 결과 타입
*예: 연관 검색 -> 판교역 주변 주유소",
"format": "int32",
"example": 1,
"enum": [
0,
1
],
"x-enum-descriptions": {
"0": "일반 검색",
"1": "연관 검색"
}
},
"totalcount": {
"type": "integer",
"description": "총 검색 결과 개수",
"format": "int32",
"example": 192
},
"count": {
"type": "integer",
"description": "총 응답 결과 개수",
"format": "int32",
"example": 102
},
"poitotalcount": {
"type": "integer",
"description": "총 POI 검색 결과 개수",
"format": "int32",
"example": 190
},
"poicount": {
"type": "integer",
"description": "POI(명칭) 검색 결과 개수",
"format": "int32",
"example": 100
},
"admtotalcount": {
"type": "integer",
"description": "총 주소 검색 결과 개수",
"format": "int32",
"example": 2
},
"admcount": {
"type": "integer",
"description": "주소 검색 응답 개수",
"format": "int32",
"example": 2
},
"poi": {
"type": "array",
"description": "POI 검색 결과 목록(배열)",
"items": {
"$ref": "#/components/schemas/PoiDataA"
}
},
"adm": {
"type": "array",
"description": "주소 검색 결과 목록(배열)",
"items": {
"$ref": "#/components/schemas/Adm"
}
}
},
"description": "통합 검색 결과"
},
"SubPoi": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"description": "하위 POI 개수",
"format": "int32",
"example": 2
},
"poi": {
"type": "array",
"description": "하위 POI 정보",
"items": {
"$ref": "#/components/schemas/PoiDataA"
}
}
},
"description": "하위 POI 정보"
},
"SearchEntryPointData": {
"type": "object",
"properties": {
"result": {
"type": "boolean",
"description": "검색 결과 성공 여부",
"example": true
},
"count": {
"type": "integer",
"description": "입구점 개수",
"format": "int32",
"example": 102
},
"entrypoints": {
"type": "array",
"description": "입구점 정보 목록(배열)",
"items": {
"$ref": "#/components/schemas/Vertex"
}
}
},
"description": "건물 입구점 조회 결과"
},
"SearchEntryPointResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"data": {
"$ref": "#/components/schemas/SearchEntryPointData"
}
},
"description": "건물 입구점 조회 API의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"data": {
"result": true,
"count": 2,
"entrypoints": [
{
"x": "127.110000",
"y": "37.401959"
},
{
"x": "127.109988",
"y": "37.401942"
}
]
}
}
},
"Vertex": {
"type": "object",
"properties": {
"x": {
"type": "string",
"description": "해당 지점의 X좌표(경도)",
"example": "127.110762"
},
"y": {
"type": "string",
"description": "해당 지점의 Y좌표(위도)",
"example": "37.402184"
}
},
"description": "입구점 정보 목록(배열)"
},
"Proposer": {
"type": "object",
"properties": {
"keyword": {
"type": "string",
"description": "추천 검색어",
"example": "아이나비시스템즈"
},
"frequency": {
"type": "integer",
"description": "조희 빈도",
"format": "int32",
"example": 10230
}
},
"description": "검색어 추천 결과 목록(배열)"
},
"ProposerData": {
"type": "object",
"properties": {
"result": {
"type": "boolean",
"description": "검색 결과 성공 여부",
"example": true
},
"count": {
"type": "integer",
"description": "총 응답 결과 개수",
"format": "int32",
"example": 102
},
"keyword": {
"type": "array",
"description": "검색어 추천 결과 목록(배열)",
"items": {
"$ref": "#/components/schemas/Proposer"
}
}
},
"description": "검색어 추천 결과"
},
"SearchProposerResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"proposer": {
"$ref": "#/components/schemas/ProposerData"
}
},
"description": "검색어 추천 API의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"proposer": {
"result": true,
"count": 10,
"keyword": [
{
"keyword": "아이나비시스템즈",
"frequency": 10230
},
{
"keyword": "아이나비시스템즈서현캠퍼스",
"frequency": 6
},
{
"keyword": "아이나비프리미엄스토어인천점",
"frequency": 6
},
{
"keyword": "아이나비프리미엄스토어",
"frequency": 6
},
{
"keyword": "아이나비프리미엄스토어경기점",
"frequency": 5
},
{
"keyword": "아이나비공식대리점강릉점",
"frequency": 4
},
{
"keyword": "아이나비공식대리점거창점",
"frequency": 4
},
{
"keyword": "아이나비공식대리점광주양산점",
"frequency": 4
},
{
"keyword": "아이나비공식대리점광주하남점",
"frequency": 4
},
{
"keyword": "아이나비공식대리점군산시청점",
"frequency": 4
}
]
}
}
},
"Pois": {
"type": "object",
"properties": {
"poiid": {
"type": "integer",
"description": "POI 고유 ID",
"format": "int32",
"example": 8827198
},
"dpx": {
"type": "string",
"description": "지도 표출용 X좌표(경도)",
"example": "127.110762"
},
"dpy": {
"type": "string",
"description": "지도 표출용 Y좌표(위도)",
"example": "37.402184"
},
"rpx": {
"type": "string",
"description": "차량 진입로 X좌표(경도)",
"example": "127.110862"
},
"rpy": {
"type": "string",
"description": "차량 진입로 Y좌표(위도)",
"example": "37.402334"
},
"routepoints": {
"type": "array",
"description": "차량 진입로 좌표 정보 목록(배열)
>*차량 경로 탐색 시 사용 가능",
"items": {
"$ref": "#/components/schemas/RoutePoint"
}
},
"entrypoint": {
"$ref": "#/components/schemas/EntryPoint"
},
"name1": {
"type": "string",
"description": "대표 명칭",
"example": "아이나비시스템즈"
},
"name2": {
"type": "string",
"description": "축약 명칭",
"example": "INAVISYSTEMS"
},
"name3": {
"type": "string",
"description": "확장 명칭1",
"example": "아이나비시스템즈판교캠퍼스"
},
"name4": {
"type": "string",
"description": "확장 명칭2",
"example": "아이나비판교캠퍼스"
},
"admcode": {
"type": "string",
"description": "행정구역 코드(법정동/행정동)
*법정동 검색 → 법정동 코드
*행정동 검색 → 행정동 코드",
"example": "4113510900"
},
"address": {
"type": "string",
"description": "전체 주소",
"example": "경기도 성남시 분당구 삼평동"
},
"jibun": {
"type": "string",
"description": "지번 주소",
"example": "678"
},
"roadname": {
"type": "string",
"description": "도로명주소",
"example": "경기도 성남시 분당구 판교역로"
},
"roadjibun": {
"type": "string",
"description": "건물 번호",
"example": "240"
},
"detailaddress": {
"type": "string",
"description": "상세 주소 정보",
"example": "삼환하이펙스 A동 8층"
},
"catecode": {
"type": "string",
"description": "카테고리 코드",
"example": "130602"
},
"catename": {
"type": "string",
"description": "카테고리 명칭",
"example": "팅크웨어"
},
"fulladdress": {
"type": "string",
"description": "전체 주소(행정주소+지번+상세주소)",
"example": "경기도 성남시 분당구 삼평동 678 삼환하이펙스 A동 8층"
},
"zip": {
"type": "string",
"description": "우편번호",
"example": "13493"
},
"homepage": {
"type": "string",
"description": "홈페이지 URL",
"example": "https://www.inavisys.com"
},
"email": {
"type": "string",
"description": "E-mail 정보"
},
"howtogo": {
"type": "string",
"description": "교통편"
},
"tel1": {
"type": "string",
"description": "전화번호1",
"example": "02-589-9610"
},
"tel2": {
"type": "string",
"description": "전화번호2"
},
"fax1": {
"type": "string",
"description": "팩스번호1",
"example": "02-2107-7470"
},
"fax2": {
"type": "string",
"description": "팩스번호2"
},
"detail_count": {
"type": "integer",
"description": "분류 상세 항목 개수",
"format": "int32",
"example": 0
},
"etc_count": {
"type": "integer",
"description": "분류 기타 항목 개수",
"format": "int32",
"example": 0
},
"detailinfo": {
"type": "array",
"description": "분류 상세 항목",
"items": {
"$ref": "#/components/schemas/PoisInfo"
}
},
"etcinfo": {
"type": "array",
"description": "분류 기타 항목",
"items": {
"$ref": "#/components/schemas/PoisInfo"
}
},
"hasoildata": {
"type": "boolean",
"description": "주유소 유가 정보 보유 여부"
},
"externallink": {
"type": "array",
"description": "연동 Site 정보 목록(배열)",
"items": {
"$ref": "#/components/schemas/ExternalLink"
}
},
"popularity": {
"type": "boolean",
"description": "인기 여부"
},
"pop_tv": {
"type": "boolean",
"description": "TV 기반 인기 여부"
},
"pop_sns": {
"type": "boolean",
"description": "SNS 기반 인기 여부"
},
"pop_hot": {
"type": "boolean",
"description": "HOT 인기 여부"
},
"pop_hit": {
"type": "boolean",
"description": "HIT 인기 여부"
},
"pop_top": {
"type": "string",
"description": "TOP 인기 단계",
"example": "경기_1,분당구_1"
}
},
"description": "POI 검색 결과 목록(배열)"
},
"PoisData": {
"type": "object",
"properties": {
"result": {
"type": "boolean",
"description": "검색 결과 성공 여부",
"example": true
},
"totalcount": {
"type": "integer",
"description": "총 검색 결과 개수",
"format": "int32",
"example": 192
},
"count": {
"type": "integer",
"description": "총 응답 결과 개수",
"format": "int32",
"example": 102
},
"poiinfo": {
"type": "array",
"description": "POI 검색 결과 목록(배열)",
"items": {
"$ref": "#/components/schemas/Pois"
}
}
},
"description": "장소 상세 조회 결과"
},
"PoisInfo": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "분류 항목 설명"
},
"value": {
"type": "string",
"description": "분류 항목 내용"
}
},
"description": "분류 기타 항목"
},
"SearchPoisResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"poi": {
"$ref": "#/components/schemas/PoisData"
}
},
"description": "장소 상세 조회 API의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"poi": {
"result": true,
"totalcount": 1,
"count": 1,
"poiinfo": [
{
"poiid": 8827198,
"dpx": "127.110762",
"dpy": "37.402184",
"rpx": "127.110862",
"rpy": "37.402334",
"routepoints": [
{
"rpx": "127.110862",
"rpy": "37.402334"
}
],
"entrypoint": {
"px": "127.109987",
"py": "37.401942"
},
"name1": "아이나비시스템즈",
"name2": "INAVISYSTEMS",
"name3": "아이나비시스템즈판교캠퍼스",
"name4": "아이나비판교캠퍼스",
"admcode": "4113510900",
"address": "경기도 성남시 분당구 삼평동",
"jibun": "678",
"roadname": "경기도 성남시 분당구 판교역로",
"roadjibun": "240",
"detailaddress": "삼환하이펙스 A동 8층",
"catecode": "130602",
"catename": "팅크웨어",
"fulladdress": "경기도 성남시 분당구 삼평동 678 삼환하이펙스 A동 8층",
"zip": "13493",
"homepage": "https://www.inavisys.com",
"email": "",
"howtogo": "",
"tel1": "02-589-9610",
"tel2": "",
"fax1": "02-2107-7470",
"fax2": "",
"detail_count": 0,
"etc_count": 0,
"detailinfo": [],
"etcinfo": [],
"hasoildata": false,
"externallink": [
{
"Site": "PLOG",
"ID": "http://m.fivepin.co.kr/MyStory/Plog?pid=8827198",
"ExtraInfo1": "단골 많은 팅크웨어(재방문53%)",
"ExtraInfo2": "재방문53%기업"
}
],
"popularity": false,
"pop_tv": false,
"pop_sns": false,
"pop_hot": false,
"pop_hit": false,
"pop_top": "경기_1,분당구_1"
}
]
}
}
},
"SearchPigAddressesResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"location": {
"$ref": "#/components/schemas/AddressesData"
}
},
"description": "리버스 지오코딩 (PIG) API의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"location": {
"result": true,
"hasAdmAddress": true,
"adm": {
"posX": "127.110450",
"posY": "37.402125",
"address": "경기도 성남시 분당구 삼평동",
"jibun": "678",
"roadname": "경기도 성남시 분당구 판교역로",
"roadjibun": "240",
"admcode": "4113510900",
"postcode": "13493",
"bldname": "삼환하이펙스A동",
"bldnum": ""
},
"adm_address": {
"address": "경기도 성남시 분당구 삼평동",
"jibun": "678",
"cut_address": "경기 성남시 분당구 삼평동",
"admcode": "4113565500",
"address_category1": "경기도",
"address_category2": "성남시 분당구",
"address_category3": "삼평동",
"address_category4": ""
},
"legal_address": {
"address": "경기도 성남시 분당구 삼평동",
"jibun": "678",
"cut_address": "경기 성남시 분당구 삼평동",
"admcode": "4113510900",
"address_category1": "경기도",
"address_category2": "성남시 분당구",
"address_category3": "삼평동",
"address_category4": ""
}
}
}
},
"OptimalPositionSearchesData": {
"type": "object",
"properties": {
"result": {
"type": "boolean",
"description": "검색 결과 성공 여부",
"example": true
},
"count": {
"type": "integer",
"description": "최적 지점 개수",
"format": "int32",
"example": 102
},
"entrypoints": {
"type": "array",
"description": "최적 지점 정보 목록(배열)",
"items": {
"$ref": "#/components/schemas/OptimalSearchEntryPoint"
}
}
},
"description": "최적 지점 검색 결과"
},
"OptimalSearchEntryPoint": {
"type": "object",
"properties": {
"x": {
"type": "number",
"description": "해당 지점의 X좌표(경도)",
"example": 127.110762
},
"y": {
"type": "number",
"description": "해당 지점의 Y좌표(위도)",
"example": 37.402184
},
"type": {
"type": "integer",
"description": "최적 지점 속성",
"format": "int32",
"example": 1,
"enum": [
0,
1,
2,
3
],
"x-enum-descriptions": {
"0": "전체",
"1": "차량 입구점",
"2": "택시 승하차 지점(건물)",
"3": "택시 승하차 지점(단지)"
}
},
"angle": {
"type": "integer",
"description": "도로 매칭 각도
*매칭된 도로로 진출입 하는 차량의 예상 방향
*예: 0 -> 정북",
"format": "int32",
"example": 180
}
},
"description": "최적 지점 정보 목록(배열)"
},
"SearchOptimalPositionResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"data": {
"$ref": "#/components/schemas/OptimalPositionSearchesData"
}
},
"description": "최적 지점 검색 API의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"data": {
"result": true,
"count": 4,
"entrypoints": [
{
"x": "127.110876",
"y": "37.402324",
"type": 1,
"angle": 180
},
{
"x": "127.110839",
"y": "37.40234",
"type": 1,
"angle": 180
},
{
"x": "127.110876",
"y": "37.40234",
"type": 1,
"angle": 180
},
{
"x": "127.110002",
"y": "37.401949",
"type": 2,
"angle": 0
}
]
}
}
},
"NearbyCategorySearchesData": {
"type": "object",
"properties": {
"result": {
"type": "boolean",
"description": "검색 결과 성공 여부",
"example": true
},
"totalcount": {
"type": "integer",
"description": "총 검색 결과 개수",
"format": "int32",
"example": 192
},
"count": {
"type": "integer",
"description": "총 응답 결과 개수",
"format": "int32",
"example": 102
},
"poi": {
"type": "array",
"description": "POI 검색 결과 목록(배열)",
"items": {
"$ref": "#/components/schemas/PoiDataA"
}
}
},
"description": "주변 카테고리 검색 결과"
},
"SearchNearbyCategoryResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"cate": {
"$ref": "#/components/schemas/NearbyCategorySearchesData"
}
},
"description": "주변 카테고리 검색 API의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"cate": {
"result": true,
"totalcount": 1,
"count": 1,
"poi": [
{
"poiid": 8827198,
"depth": "0",
"dpx": "127.110762",
"dpy": "37.402184",
"rpx": "127.110862",
"rpy": "37.402334",
"routepoints": [
{
"rpx": "127.110862",
"rpy": "37.402334"
}
],
"entrypoint": {
"px": "127.109987",
"py": "37.401942"
},
"name1": "아이나비시스템즈",
"name2": "INAVISYSTEMS",
"name3": "아이나비시스템즈판교캠퍼스",
"name4": "아이나비판교캠퍼스",
"admcode": "4113510900",
"haengcode": "4113565500",
"address": "경기도 성남시 분당구 삼평동",
"address_haeng": "삼평동",
"jibun": "678",
"roadname": "경기도 성남시 분당구 판교역로",
"roadjibun": "240",
"detailaddress": "삼환하이펙스 A동 8층",
"catecode": "130602",
"catename": "팅크웨어",
"dp_catecode": "000",
"distance": 21713,
"tel": "02-589-9610",
"hasoildata": false,
"hasdetailinfo": true,
"hassubpoi": false,
"islandmark": true,
"updateTS": "2023-08-17",
"subpoi": {
"count": 0,
"poi": []
},
"externallink": [
{
"Site": "PLOG",
"ID": "http://m.fivepin.co.kr/MyStory/Plog?pid=8827198",
"ExtraInfo1": "단골 많은 팅크웨어(재방문54%)",
"ExtraInfo2": "재방문54%기업"
}
],
"popularity": false,
"pop_tv": false,
"pop_sns": false,
"pop_hot": false,
"pop_hit": false,
"pop_top": "경기_1,분당구_1"
}
]
}
}
},
"MapsStyleInfoData": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"description": "조회된 StyleJson 개수",
"format": "int32"
},
"baseStyleURL": {
"type": "string",
"description": "기본 StyleJson"
},
"styleList": {
"type": "array",
"description": "조회된 StyleJson 목록(배열)",
"items": {
"$ref": "#/components/schemas/StyleInfo"
}
}
},
"description": "지도 스타일 조회 API 의 결과"
},
"MapsStyleInfoResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"result": {
"$ref": "#/components/schemas/MapsStyleInfoData"
}
},
"description": "지도 스타일 조회 API의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"result": {
"count": 1,
"baseStyleURL": "https://timbase.inavi.com/resources/web//inavi_5595128678a34daabf6dc772dad1e7e4.json",
"styleList": [
{
"styleID": "adb955f0-6c88-11ed-a0e3-8d37e77b6c33",
"styleName": "unban map style 1",
"workspace": "d390f05a-14b9-4873-a5c9-96aa62a3ae1a",
"filename": "style",
"pkgName": "",
"platform": "C",
"keyKind": "C",
"appVersion": "",
"sdkVersion": "",
"registerDt": "2022-11-25 15:17:50",
"modifyDt": "2022-12-16 10:33:11",
"styleURL": "https://timbase.inavi.com/resources_maps/map-studio_dev/6c72d57a50e81fa01eb3b209deb40b7a97e74b73/style/adb955f0-6c88-11ed-a0e3-8d37e77b6c33/style.json"
}
]
}
}
},
"StyleInfo": {
"type": "object",
"properties": {
"styleID": {
"type": "string",
"description": "Style Studio style ID 정보"
},
"styleName": {
"type": "string",
"description": "Style Studio style 이름 정보"
},
"workspace": {
"type": "string",
"description": "Style Studio WorkSpace 정보"
},
"filename": {
"type": "string",
"description": "StyleJson 파일 이름"
},
"pkgName": {
"type": "string",
"description": "패키지 이름"
},
"platform": {
"type": "string",
"description": "플랫폼 종류",
"example": "N",
"enum": [
"N",
"M",
"W",
"C"
],
"x-enum-descriptions": {
"C": "Common",
"W": "Web",
"M": "Mobile",
"N": "Navi"
}
},
"keyKind": {
"type": "string",
"description": "OS 종류",
"example": "A",
"enum": [
"A",
"I",
"C"
],
"x-enum-descriptions": {
"A": "ANDROID",
"C": "COMMON",
"I": "IOS"
}
},
"appVersion": {
"type": "string",
"description": "앱 버전"
},
"sdkVersion": {
"type": "string",
"description": "SDK 버전"
},
"registerDt": {
"type": "string",
"description": "등록 시간"
},
"modifyDt": {
"type": "string",
"description": "수정 시간"
},
"styleURL": {
"type": "string",
"description": "StyleJson URL"
}
},
"description": "조회된 StyleJson 목록(배열)"
},
"MapsSDKResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"keycode": {
"type": "string",
"description": "SDK 구별을 위한 keyCode"
},
"serverURL": {
"type": "string",
"description": "SDK에서 활용 가능한 서버 URL"
},
"serverURL2": {
"type": "string",
"description": "SDK에서 활용 가능한 서버 URL2"
},
"result": {
"type": "string",
"description": "일반 지도 StyleJson URL"
},
"result_dem": {
"type": "string",
"description": "일반 지도(DEM) StyleJson URL"
},
"result_h": {
"type": "string",
"description": "하이브리드 지도 StyleJson URL"
},
"result_h_dem": {
"type": "string",
"description": "하이브리드 지도(DEM) StyleJson URL"
},
"data": {
"$ref": "#/components/schemas/MapsStyleSummaryData"
}
},
"description": "모바일 SDK 인증의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"result": "https://timbase.inavi.com/resources/inaviMap2601/sdk/5595128678a34daabf6dc772dad1e7e4.json",
"result_dem": "https://timbase.inavi.com/resources/inaviMap2601/sdk/DNK9f7D8k34lQ8sNfB2jM6xT5rH0uQ3y1bZ4.json",
"result_h": "https://timbase.inavi.com/resources/inaviMap2601/sdk/H32f25fdesd941das42dbc19dqas4d29.json",
"result_h_dem": "https://timbase.inavi.com/resources/inaviMap2601/sdk/DHd8A4b2vX6yJ1nQzK9tR0pF3cM7uH5xY8.json"
}
},
"MapsStyleSummaryData": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"description": "조회된 StyleJson 개수",
"format": "int32"
},
"styleList": {
"type": "array",
"description": "조회된 StyleJson 목록(배열)",
"items": {
"$ref": "#/components/schemas/StyleInfoSummary"
}
}
},
"description": "Style Studio를 사용해 등록 한 스타일 Json 목록"
},
"StyleInfoSummary": {
"type": "object",
"properties": {
"styleID": {
"type": "string",
"description": "Style Studio style ID 정보"
},
"styleName": {
"type": "string",
"description": "Style Studio style 이름 정보"
},
"styleURL": {
"type": "string",
"description": "StyleJson URL"
}
},
"description": "조회된 StyleJson 목록(배열)"
},
"MapsNaviSDKResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"keycode": {
"type": "string",
"description": "SDK 구별을 위한 keyCode"
},
"serverURL": {
"type": "string",
"description": "SDK에서 활용 가능한 서버 URL"
},
"serverURL2": {
"type": "string",
"description": "SDK에서 활용 가능한 서버 URL2"
},
"result": {
"type": "string",
"description": "일반 지도 StyleJson URL"
},
"result_dem": {
"type": "string",
"description": "일반 지도(DEM) StyleJson URL"
},
"result_h": {
"type": "string",
"description": "하이브리드 지도 StyleJson URL"
},
"result_h_dem": {
"type": "string",
"description": "하이브리드 지도(DEM) StyleJson URL"
},
"data": {
"$ref": "#/components/schemas/MapsStyleSummaryData"
}
},
"description": "네비 SDK 인증의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"result": "https://timbase.inavi.com/resources/inaviMap2601/sdk/5595128678a34daabf6dc772dad1e7e4.json",
"result_dem": "https://timbase.inavi.com/resources/inaviMap2601/sdk/DNK9f7D8k34lQ8sNfB2jM6xT5rH0uQ3y1bZ4.json",
"result_h": "https://timbase.inavi.com/resources/inaviMap2601/sdk/H32f25fdesd941das42dbc19dqas4d29.json",
"result_h_dem": "https://timbase.inavi.com/resources/inaviMap2601/sdk/DHd8A4b2vX6yJ1nQzK9tR0pF3cM7uH5xY8.json"
}
},
"Indoor": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "영역 ID",
"format": "int32"
},
"sourceUrl": {
"type": "string",
"description": "데이터 호출 URL"
},
"name": {
"type": "string",
"description": "영역 이름"
},
"level": {
"type": "integer",
"description": "지도 표출 레벨",
"format": "int32"
},
"floor": {
"$ref": "#/components/schemas/IndoorFloor"
},
"boundary": {
"type": "array",
"description": "지도 영역",
"items": {
"type": "array",
"description": "map.data.indoor.boundary.description",
"items": {
"type": "array",
"description": "map.data.indoor.boundary.description",
"items": {
"type": "number",
"description": "map.data.indoor.boundary.description",
"format": "double"
}
}
}
}
},
"description": "실내 지도 정보 목록(배열)"
},
"IndoorFloor": {
"type": "object",
"properties": {
"main": {
"$ref": "#/components/schemas/IndoorFloorInfo"
},
"list": {
"type": "array",
"description": "층 정보 목록(배열)",
"items": {
"$ref": "#/components/schemas/IndoorFloorInfo"
}
}
},
"description": "층 정보"
},
"IndoorFloorInfo": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "층 ID"
},
"name": {
"type": "string",
"description": "층 이름"
}
},
"description": "층 정보 목록(배열)"
},
"MapIndoorSDKData": {
"type": "object",
"properties": {
"indoorList": {
"type": "array",
"description": "실내 지도 정보 목록(배열)",
"items": {
"$ref": "#/components/schemas/Indoor"
}
}
},
"description": "실내 지도 정보 조회 API 의 결과"
},
"MapsIndoorInfoResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"indoor": {
"$ref": "#/components/schemas/MapIndoorSDKData"
}
},
"description": "실내 지도 정보 조회 API 의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"indoor": {
"indoorList": [
{
"id": 1,
"sourceUrl": "https://timbase.inavi.com/indoor",
"name": "가락농수산물종합도매시장",
"boundary": [
[
[
127.115278787736,
37.4957759023255
],
[
127.115286097989,
37.4957865631064
],
[
127.11536041779,
37.4957140316304
],
[
127.115406076993,
37.4956601519088
],
[
127.115620784243,
37.4955111948369
],
[
127.11563923081,
37.4954909852299
],
[
127.115801496915,
37.4953102556018
],
[
127.115886322708,
37.4952168101432
],
[
127.115889167645,
37.4952137439308
],
[
127.115974628499,
37.4951216042437
],
[
127.116086142882,
37.4950000030161
],
[
127.116090952066,
37.4949947634431
],
[
127.116229524383,
37.4948425733477
],
[
127.116252937678,
37.494816853607
],
[
127.116367791097,
37.4946905635886
],
[
127.116478625324,
37.4945687103707
],
[
127.11648738548,
37.4945590789842
],
[
127.116490772136,
37.4945553544881
],
[
127.116635031966,
37.4943966350115
],
[
127.116853709059,
37.4941576612002
],
[
127.116899609119,
37.4941072495255
],
[
127.116979352703,
37.4940196648362
],
[
127.117085317885,
37.493902104649
],
[
127.117185717534,
37.4937907217806
],
[
127.11726940727,
37.4936961141356
],
[
127.117367364864,
37.493585382258
],
[
127.117714407575,
37.4932038571058
],
[
127.117898644333,
37.493000289151
],
[
127.118021652647,
37.4928643665995
],
[
127.118025651963,
37.4928332868824
],
[
127.118149770496,
37.4926989848969
],
[
127.118140998398,
37.4926002523398
],
[
127.118150217938,
37.4925810336558
],
[
127.118158954984,
37.4925641941115
],
[
127.118100633438,
37.4925453583158
],
[
127.117985800606,
37.4925082704843
],
[
127.117967603723,
37.4925425719635
],
[
127.117943787399,
37.4925412802726
],
[
127.117936730388,
37.4925406926532
],
[
127.117932093264,
37.4925401116278
],
[
127.117925102315,
37.4925383886732
],
[
127.117900655113,
37.4925314032406
],
[
127.117809391406,
37.492503743275
],
[
127.117768346591,
37.4924909899013
],
[
127.11738546374,
37.492375420393
],
[
127.116957148098,
37.4922458118904
],
[
127.116961521477,
37.4922368065026
],
[
127.116860779816,
37.4922073892118
],
[
127.116338069326,
37.4920635097445
],
[
127.116239904267,
37.4920327739158
],
[
127.11596767834,
37.4919503560465
],
[
127.115686312641,
37.4918655227901
],
[
127.115658099118,
37.4918503774578
],
[
127.115615637411,
37.4918275965147
],
[
127.11556959722,
37.4918013952307
],
[
127.115546259617,
37.4917950479391
],
[
127.115521349594,
37.4917882787072
],
[
127.115138780342,
37.4916735215086
],
[
127.114999985631,
37.4916340394193
],
[
127.114895070805,
37.4916031828993
],
[
127.114830960868,
37.4915840718023
],
[
127.114777145656,
37.4915680321131
],
[
127.114666438185,
37.4915350186005
],
[
127.114333310577,
37.4914363748543
],
[
127.114233973178,
37.4914069629693
],
[
127.113995637148,
37.4913370587977
],
[
127.113617343511,
37.4912201211078
],
[
127.113408742934,
37.4911545480229
],
[
127.113393221609,
37.4911572208921
],
[
127.113303499702,
37.4911299794304
],
[
127.113289640487,
37.4911250912429
],
[
127.113273764847,
37.4911102848999
],
[
127.113049156963,
37.4910396358353
],
[
127.112662322285,
37.4909181801966
],
[
127.112638227664,
37.4909194105205
],
[
127.112544412483,
37.4908993804399
],
[
127.112538925967,
37.4908902854949
],
[
127.112529423077,
37.4908797347439
],
[
127.11251258454,
37.4908711641839
],
[
127.112353604364,
37.490821255528
],
[
127.111967981382,
37.4906994901151
],
[
127.111695608837,
37.4907855868836
],
[
127.111311232057,
37.4906721975133
],
[
127.111239743273,
37.4905561700797
],
[
127.111177646219,
37.4904596315573
],
[
127.110829006418,
37.4903481531503
],
[
127.110258189976,
37.49016184539
],
[
127.11000003214,
37.4900791303026
],
[
127.109759169238,
37.4900000206323
],
[
127.109681008567,
37.4899743694639
],
[
127.109249882431,
37.4898374554185
],
[
127.10917742646,
37.4898543712334
],
[
127.1091400317,
37.4898769309654
],
[
127.109133028705,
37.4898821632765
],
[
127.109128962885,
37.4898855007589
],
[
127.109096583588,
37.4899357167665
],
[
127.109059113776,
37.490000029217
],
[
127.108989881236,
37.4901188098169
],
[
127.108883163062,
37.4902913609961
],
[
127.108741238,
37.4905143107846
],
[
127.108639128032,
37.4906683868448
],
[
127.108635643314,
37.4906826259618
],
[
127.108561574619,
37.4907812732357
],
[
127.108556975171,
37.490783160567
],
[
127.108547486476,
37.490789836738
],
[
127.108545228485,
37.4907922715318
],
[
127.108459123819,
37.4909112835477
],
[
127.108341382875,
37.4910478040519
],
[
127.108231203693,
37.4911746767332
],
[
127.10822228147,
37.4911821632651
],
[
127.108066812158,
37.4913464690609
],
[
127.108060149868,
37.4913528723048
],
[
127.108014721387,
37.4914431857413
],
[
127.107779711032,
37.4916613629759
],
[
127.107645212327,
37.4917761207189
],
[
127.107328344911,
37.4920193024627
],
[
127.106885108716,
37.4923561853303
],
[
127.106794806655,
37.4924291134005
],
[
127.106472633698,
37.4926746582596
],
[
127.10646646756,
37.4926802590691
],
[
127.106464504856,
37.4926836846638
],
[
127.106462388881,
37.4926906603635
],
[
127.106254842433,
37.4928328729178
],
[
127.106248004086,
37.4928349333635
],
[
127.106243337385,
37.4928373702787
],
[
127.105887812626,
37.4930820605302
],
[
127.10571605991,
37.4931565293843
],
[
127.105703697728,
37.4931626943221
],
[
127.105167938045,
37.4934923102336
],
[
127.104999983399,
37.4935911829334
],
[
127.104981622982,
37.4936019482603
],
[
127.104802081343,
37.4937038313254
],
[
127.104659596924,
37.4937823452199
],
[
127.104484223196,
37.4938733219262
],
[
127.104374171482,
37.4939369401763
],
[
127.104343294667,
37.4939571139604
],
[
127.104337432002,
37.4939615791213
],
[
127.104332778006,
37.4939651151775
],
[
127.10432154095,
37.4939755046975
],
[
127.104310972957,
37.4939872541457
],
[
127.104302901156,
37.4939969290738
],
[
127.104297452454,
37.4940063403937
],
[
127.10429218815,
37.494018247339
],
[
127.104288732392,
37.4940296210935
],
[
127.104286140476,
37.4940604468189
],
[
127.10428369783,
37.4940929032343
],
[
127.10428278709,
37.4941454507452
],
[
127.104753417613,
37.4942910244784
],
[
127.104999980724,
37.4943647061555
],
[
127.105526883532,
37.4945265440018
],
[
127.106052715801,
37.4946894166107
],
[
127.106387155051,
37.494793425437
],
[
127.106459394623,
37.4948194174693
],
[
127.106542872578,
37.4948440027625
],
[
127.106614744282,
37.4948656972303
],
[
127.106838041835,
37.4949335395133
],
[
127.106891688948,
37.4949501415854
],
[
127.106943016879,
37.4949660249273
],
[
127.107048446515,
37.4950000325368
],
[
127.107142368709,
37.4950290769332
],
[
127.107619470358,
37.4951767687363
],
[
127.107809444599,
37.4952369088949
],
[
127.108037833987,
37.4953054019924
],
[
127.108355764294,
37.4954063839361
],
[
127.108806828651,
37.4955469047791
],
[
127.108808389754,
37.495547290774
],
[
127.108810334855,
37.4955473430429
],
[
127.109346191494,
37.4957117504628
],
[
127.109393821231,
37.4957266630732
],
[
127.109856386924,
37.4958727825174
],
[
127.110000008739,
37.4959154016252
],
[
127.110062900545,
37.4959349849862
],
[
127.110201903677,
37.495951037475
],
[
127.110442169258,
37.4960258939586
],
[
127.110627307876,
37.4960859980547
],
[
127.11066000399,
37.4960731280928
],
[
127.110787390608,
37.4961099769877
],
[
127.110790461998,
37.4961299043662
],
[
127.111006558898,
37.496194537921
],
[
127.11101826854,
37.4961982300533
],
[
127.111160673736,
37.4962431464561
],
[
127.111180692342,
37.4962526332339
],
[
127.111252150284,
37.4962985172807
],
[
127.111261002034,
37.4963043024147
],
[
127.111420569257,
37.4963538154907
],
[
127.111714224036,
37.4964436207679
],
[
127.11201853794,
37.4965373616139
],
[
127.112289650199,
37.4966230151714
],
[
127.112497881268,
37.496689077057
],
[
127.112517600816,
37.4966950139279
],
[
127.112557828764,
37.4967427289335
],
[
127.112563568485,
37.4967243429388
],
[
127.112564697031,
37.496722810153
],
[
127.112566731469,
37.4967220874095
],
[
127.112576797879,
37.4967233392259
],
[
127.112612992484,
37.4967283503636
],
[
127.112686961911,
37.4967363888849
],
[
127.112742381975,
37.4967421024476
],
[
127.112822332708,
37.4967420261202
],
[
127.112910646946,
37.4967387882238
],
[
127.112946287362,
37.4967362223272
],
[
127.113047874872,
37.496701085029
],
[
127.113177333559,
37.4966857340712
],
[
127.113259190338,
37.496674843548
],
[
127.113424487004,
37.4966530608115
],
[
127.113631053479,
37.4966273638285
],
[
127.113838860183,
37.4965993226731
],
[
127.113993302343,
37.4965788110085
],
[
127.114211745607,
37.4965466477991
],
[
127.114415881761,
37.4965191349557
],
[
127.114562711455,
37.4963758041048
],
[
127.114671808584,
37.4961349493941
],
[
127.114702476364,
37.4960754532094
],
[
127.114737648959,
37.4960038791571
],
[
127.114914683831,
37.4956513235238
],
[
127.115071271569,
37.4956966539026
],
[
127.11507860205,
37.4956984127345
],
[
127.115169272987,
37.4957284720473
],
[
127.115206754199,
37.4957393917384
],
[
127.115227923152,
37.4957466151833
],
[
127.115249490198,
37.4957553339066
],
[
127.115267552161,
37.495764371398
],
[
127.115278787736,
37.4957759023255
]
]
],
"level": 16,
"floor": {
"main": {
"id": "200000",
"name": "1F"
},
"list": [
{
"id": "201700",
"name": "18F"
},
{
"id": "201600",
"name": "17F"
},
{
"id": "201500",
"name": "16F"
},
{
"id": "201400",
"name": "15F"
},
{
"id": "201300",
"name": "14F"
},
{
"id": "201200",
"name": "13F"
},
{
"id": "201100",
"name": "12F"
},
{
"id": "201000",
"name": "11F"
},
{
"id": "200900",
"name": "10F"
},
{
"id": "200800",
"name": "9F"
},
{
"id": "200700",
"name": "8F"
},
{
"id": "200600",
"name": "7F"
},
{
"id": "200500",
"name": "6F"
},
{
"id": "200400",
"name": "5F"
},
{
"id": "200300",
"name": "4F"
},
{
"id": "200200",
"name": "3F"
},
{
"id": "200100",
"name": "2F"
},
{
"id": "200000",
"name": "1F"
},
{
"id": "109900",
"name": "B1"
},
{
"id": "109800",
"name": "B2"
},
{
"id": "109700",
"name": "B3"
}
]
}
}
]
}
}
},
"BdmdUpdate": {
"type": "object",
"properties": {
"city_do": {
"type": "string",
"description": "광역시도 정보",
"example": "경기도"
},
"city_do_en": {
"type": "string",
"description": "영문 광역시도 정보",
"example": "Gyeonggi-do"
},
"cut_city_do": {
"type": "string",
"description": "축약 광역시도 정보",
"example": "경기"
},
"gu_gun": {
"type": "string",
"description": "시군구 정보",
"example": "성남시 분당구"
},
"gu_gun_en": {
"type": "string",
"description": "영문 시군구 정보",
"example": "Gwangju-si"
},
"legalDong": {
"type": "string",
"description": "법정동 정보",
"example": "정자동"
},
"legalDong_en": {
"type": "string",
"description": "영문 법정동 정보",
"example": "Jeongja-dong"
},
"legalDongCode": {
"type": "string",
"description": "법정동코드 정보",
"example": "4113510300"
},
"status": {
"type": "string",
"description": "업데이트 상태
*추가/수정/삭제",
"example": "추가"
},
"info": {
"type": "string",
"description": "업데이트 사유",
"example": "분동"
},
"geometry": {
"oneOf": [
{
"$ref": "#/components/schemas/Feature"
},
{
"$ref": "#/components/schemas/FeatureCollection"
},
{
"$ref": "#/components/schemas/GeometryCollection"
},
{
"$ref": "#/components/schemas/LineString"
},
{
"$ref": "#/components/schemas/MultiLineString"
},
{
"$ref": "#/components/schemas/MultiPoint"
},
{
"$ref": "#/components/schemas/MultiPolygon"
},
{
"$ref": "#/components/schemas/Point"
},
{
"$ref": "#/components/schemas/Polygon"
}
]
}
},
"description": "법정동 업데이트 정보"
},
"Crs": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"name",
"link"
]
},
"properties": {
"type": "object",
"additionalProperties": {
"type": "object"
}
}
}
},
"Feature": {
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/GeoJsonObject"
},
{
"type": "object",
"properties": {
"properties": {
"type": "object",
"additionalProperties": {
"type": "object"
}
},
"geometry": {
"oneOf": [
{
"$ref": "#/components/schemas/Feature"
},
{
"$ref": "#/components/schemas/FeatureCollection"
},
{
"$ref": "#/components/schemas/GeometryCollection"
},
{
"$ref": "#/components/schemas/LineString"
},
{
"$ref": "#/components/schemas/MultiLineString"
},
{
"$ref": "#/components/schemas/MultiPoint"
},
{
"$ref": "#/components/schemas/MultiPolygon"
},
{
"$ref": "#/components/schemas/Point"
},
{
"$ref": "#/components/schemas/Polygon"
}
]
},
"id": {
"type": "string"
}
}
}
]
},
"FeatureCollection": {
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/GeoJsonObject"
},
{
"type": "object",
"properties": {
"features": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Feature"
}
}
}
}
]
},
"GeoJsonObject": {
"required": [
"type"
],
"type": "object",
"properties": {
"crs": {
"$ref": "#/components/schemas/Crs"
},
"bbox": {
"type": "array",
"items": {
"type": "number",
"format": "double"
}
},
"type": {
"type": "string"
}
},
"description": "영역 정보",
"discriminator": {
"propertyName": "type"
}
},
"GeometryCollection": {
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/GeoJsonObject"
},
{
"type": "object",
"properties": {
"geometries": {
"type": "array",
"items": {
"oneOf": [
{
"$ref": "#/components/schemas/Feature"
},
{
"$ref": "#/components/schemas/FeatureCollection"
},
{
"$ref": "#/components/schemas/GeometryCollection"
},
{
"$ref": "#/components/schemas/LineString"
},
{
"$ref": "#/components/schemas/MultiLineString"
},
{
"$ref": "#/components/schemas/MultiPoint"
},
{
"$ref": "#/components/schemas/MultiPolygon"
},
{
"$ref": "#/components/schemas/Point"
},
{
"$ref": "#/components/schemas/Polygon"
}
]
}
}
}
}
]
},
"LegalDongUpdatesData": {
"type": "object",
"properties": {
"sidoCount": {
"type": "integer",
"description": "시도 업데이트 개수",
"format": "int32",
"example": 2
},
"sggCount": {
"type": "integer",
"description": "시군구 업데이트 개수",
"format": "int32",
"example": 4
},
"bdmdCount": {
"type": "integer",
"description": "법정동 업데이트 개수",
"format": "int32",
"example": 3
},
"sidoUpdateList": {
"type": "array",
"description": "시도 업데이트 정보",
"items": {
"$ref": "#/components/schemas/SidoUpdate"
}
},
"sggUpdateList": {
"type": "array",
"description": "시군구 업데이트 정보",
"items": {
"$ref": "#/components/schemas/SggUpdate"
}
},
"bdmdUpdateList": {
"type": "array",
"description": "법정동 업데이트 정보",
"items": {
"$ref": "#/components/schemas/BdmdUpdate"
}
}
},
"description": "법정동 데이터 업데이트 내역 조회 검색 결과"
},
"LineString": {
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/GeoJsonObject"
},
{
"type": "object",
"properties": {
"coordinates": {
"type": "array",
"items": {
"$ref": "#/components/schemas/LngLatAlt"
}
}
}
}
]
},
"LngLatAlt": {
"type": "object",
"properties": {
"longitude": {
"type": "number",
"format": "double"
},
"latitude": {
"type": "number",
"format": "double"
},
"altitude": {
"type": "number",
"format": "double"
},
"additionalElements": {
"type": "array",
"items": {
"type": "number",
"format": "double"
}
}
}
},
"MultiLineString": {
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/GeoJsonObject"
},
{
"type": "object",
"properties": {
"coordinates": {
"type": "array",
"items": {
"type": "array",
"items": {
"$ref": "#/components/schemas/LngLatAlt"
}
}
}
}
}
]
},
"MultiPoint": {
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/GeoJsonObject"
},
{
"type": "object",
"properties": {
"coordinates": {
"type": "array",
"items": {
"$ref": "#/components/schemas/LngLatAlt"
}
}
}
}
]
},
"MultiPolygon": {
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/GeoJsonObject"
},
{
"type": "object",
"properties": {
"coordinates": {
"type": "array",
"items": {
"type": "array",
"items": {
"type": "array",
"items": {
"$ref": "#/components/schemas/LngLatAlt"
}
}
}
}
}
}
]
},
"Point": {
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/GeoJsonObject"
},
{
"type": "object",
"properties": {
"coordinates": {
"$ref": "#/components/schemas/LngLatAlt"
}
}
}
]
},
"Polygon": {
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/GeoJsonObject"
},
{
"type": "object",
"properties": {
"coordinates": {
"type": "array",
"items": {
"type": "array",
"items": {
"$ref": "#/components/schemas/LngLatAlt"
}
}
}
}
}
]
},
"SearchLegalDongUpdatesResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"result": {
"$ref": "#/components/schemas/LegalDongUpdatesData"
}
},
"description": "법정동 데이터 업데이트 내역 조회 API의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"result": {
"bdmdCount": 4,
"sggCount": 3,
"bdmdUpdateList": [
{
"legalDongCode": "4113510300",
"city_do": "경기도",
"gu_gun": "성남시 분당구",
"legalDong": "정자동",
"status": "추가",
"info": "분동",
"geometry": {
"type": "MultiPolygon",
"coordinates": [
[
[
[
127.104002837031,
37.362979133935
],
[
127.104002836546,
37.3630291281639
],
[
127.104152818649,
37.3634790771523
],
[
127.104240308249,
37.3637373812096
],
[
127.104240307764,
37.3637873754386
]
]
]
]
}
},
{
"legalDongCode": "4113510500",
"city_do": "경기도",
"gu_gun": "성남시 분당구",
"legalDong": "서현동",
"status": "추가",
"info": "분동",
"geometry": {
"type": "MultiPolygon",
"coordinates": [
[
[
[
127.144599012993,
37.379577469792
],
[
127.14436153572,
37.3794441503708
],
[
127.143886578325,
37.3794691445291
],
[
127.143836585195,
37.3792275054459
],
[
127.143749093414,
37.3791941754157
]
]
]
]
}
},
{
"legalDongCode": "4161011500",
"city_do": "경기도",
"gu_gun": "광주시",
"legalDong": "신현동",
"status": "삭제",
"info": "통합",
"geometry": {
"type": "MultiPolygon",
"coordinates": [
[
[
[
127.134812607223,
37.3578965781717
],
[
127.135237563783,
37.3584215202244
],
[
127.135825009824,
37.3585215123312
],
[
127.136262465986,
37.3589714631168
],
[
127.137312366502,
37.3594630795637
]
]
]
]
}
},
{
"legalDongCode": "4113511400",
"city_do": "경기도",
"gu_gun": "성남시 분당구",
"legalDong": "구미동",
"status": "변경",
"info": "경계 재조정",
"geometry": {
"type": "MultiPolygon",
"coordinates": [
[
[
[
127.132887846421,
37.3511556775227
],
[
127.132687871588,
37.3504224275691
],
[
127.132662874977,
37.3503057742097
],
[
127.132675374417,
37.350247447685
],
[
127.13270037346,
37.3501141298921
]
]
]
]
}
}
],
"sggUpdateList": [
{
"sggCode": "41610",
"city_do": "경기도",
"gu_gun": "광주시",
"status": "추가",
"info": "분구",
"geometry": {
"type": "MultiPolygon",
"coordinates": [
[
[
[
127.39818828556,
37.4158082276361
],
[
127.398450768393,
37.415166636687
],
[
127.398663253541,
37.4147416870861
],
[
127.398863239478,
37.4143500668922
],
[
127.399388195536,
37.4140167753945
]
]
]
]
}
},
{
"sggCode": "41135",
"city_do": "경기도",
"gu_gun": "성남시 분당구",
"status": "삭제",
"info": "통합",
"geometry": {
"type": "MultiPolygon",
"coordinates": [
[
[
[
127.132887846421,
37.3511556775227
],
[
127.132687871588,
37.3504224275691
],
[
127.132662874977,
37.3503057742097
],
[
127.132675374417,
37.350247447685
],
[
127.13270037346,
37.3501141298921
]
]
]
]
}
},
{
"sggCode": "41133",
"city_do": "경기도",
"gu_gun": "성남시 중원구",
"status": "변경",
"info": "경계 재조정",
"geometry": {
"type": "MultiPolygon",
"coordinates": [
[
[
[
127.177233222891,
37.4148152718183
],
[
127.177258225637,
37.4143069973342
],
[
127.177758183636,
37.4139903703621
],
[
127.177695695097,
37.4133987716174
],
[
127.177858183632,
37.4130738101594
],
[
127.17789568525,
37.4125655357523
]
]
]
]
}
}
]
}
}
},
"SggUpdate": {
"type": "object",
"properties": {
"sggCode": {
"type": "string",
"description": "법정동코드(시군구) 정보",
"example": "41610"
},
"city_do": {
"type": "string",
"description": "광역시도 정보",
"example": "경기도"
},
"gu_gun": {
"type": "string",
"description": "시군구 정보",
"example": "광주시"
},
"gu_gun_en": {
"type": "string",
"description": "영문 시군구 정보",
"example": "Gwangju-si"
},
"status": {
"type": "string",
"description": "업데이트 상태
*추가/수정/삭제",
"example": "추가"
},
"info": {
"type": "string",
"description": "업데이트 사유",
"example": "분동"
},
"geometry": {
"oneOf": [
{
"$ref": "#/components/schemas/Feature"
},
{
"$ref": "#/components/schemas/FeatureCollection"
},
{
"$ref": "#/components/schemas/GeometryCollection"
},
{
"$ref": "#/components/schemas/LineString"
},
{
"$ref": "#/components/schemas/MultiLineString"
},
{
"$ref": "#/components/schemas/MultiPoint"
},
{
"$ref": "#/components/schemas/MultiPolygon"
},
{
"$ref": "#/components/schemas/Point"
},
{
"$ref": "#/components/schemas/Polygon"
}
]
}
},
"description": "시군구 업데이트 정보"
},
"SidoUpdate": {
"type": "object",
"properties": {
"sidoCode": {
"type": "string",
"description": "법정동코드(시군구) 정보",
"example": "41610"
},
"city_do": {
"type": "string",
"description": "광역시도 정보",
"example": "경기도"
},
"city_do_en": {
"type": "string",
"description": "영문 광역시도 정보",
"example": "Gyeonggi-do"
},
"cut_city_do": {
"type": "string",
"description": "축약 광역시도 정보",
"example": "경기"
},
"status": {
"type": "string",
"description": "업데이트 상태
*추가/수정/삭제",
"example": "추가"
},
"info": {
"type": "string",
"description": "업데이트 사유",
"example": "분동"
},
"geometry": {
"oneOf": [
{
"$ref": "#/components/schemas/Feature"
},
{
"$ref": "#/components/schemas/FeatureCollection"
},
{
"$ref": "#/components/schemas/GeometryCollection"
},
{
"$ref": "#/components/schemas/LineString"
},
{
"$ref": "#/components/schemas/MultiLineString"
},
{
"$ref": "#/components/schemas/MultiPoint"
},
{
"$ref": "#/components/schemas/MultiPolygon"
},
{
"$ref": "#/components/schemas/Point"
},
{
"$ref": "#/components/schemas/Polygon"
}
]
}
},
"description": "시도 업데이트 정보"
},
"GlobalAdm": {
"type": "object",
"properties": {
"type": {
"type": "integer",
"description": "검색 타입",
"format": "int32",
"example": 2,
"enum": [
1,
2,
3
],
"x-enum-descriptions": {
"1": "행정구역 검색",
"2": "지번 검색",
"3": "도로명 주소 검색"
}
},
"posx": {
"type": "string",
"description": "X좌표(경도) 값",
"example": "127.11065"
},
"posy": {
"type": "string",
"description": "Y좌표(위도) 값",
"example": "37.402109"
},
"admcode": {
"type": "string",
"description": "법정구역 코드",
"example": "4113510900"
},
"address": {
"type": "string",
"description": "전체 주소",
"example": "Gyeonggi-do Seongnam-si Bundang-gu Sampyeong-dong"
},
"address_ko": {
"type": "string",
"description": "전체 국문 주소",
"example": "경기도 성남시 분당구 삼평동"
},
"jibun": {
"type": "string",
"description": "지번 정보",
"example": "678"
},
"jibun_ko": {
"type": "string",
"description": "국문 지번 주소"
},
"roadname": {
"type": "string",
"description": "도로명 주소",
"example": "Gyeonggi-do Seongnam-si Bundang-gu Pangyoyeok-ro"
},
"roadname_ko": {
"type": "string",
"description": "국문 도로명 주소",
"example": "경기도 성남시 분당구 판교역로"
},
"roadjibun": {
"type": "string",
"description": "건물 번호",
"example": "240"
},
"roadjibun_ko": {
"type": "string",
"description": "국문 건물 번호",
"example": "240"
},
"postcode": {
"type": "string",
"description": "우편번호
*주소+지번 검색 시 제공",
"example": "13493"
},
"buildname": {
"type": "string",
"description": "건물 명칭
*도로명 주소 검색 시 제공"
},
"buildname_ko": {
"type": "string",
"description": "국문 건물 명칭
*도로명 주소 검색 시 제공",
"example": "삼환하이펙스A동"
},
"accuracy": {
"type": "integer",
"description": "지번 정확도
*검색 된 방식에 따라 정확도가 결정",
"format": "int32",
"example": 0,
"enum": [
0,
1,
2,
3
],
"x-enum-descriptions": {
"0": "지번 일치 검색",
"1": "호지번 확장 검색",
"2": "모지번 확장 검색",
"3": "행정구역 검색"
}
},
"distance": {
"type": "integer",
"description": "기준점과의 거리 정보(m)",
"format": "int32",
"example": 0
}
},
"description": "주소 검색 결과 목록(배열)"
},
"GlobalPoi": {
"type": "object",
"properties": {
"poiid": {
"type": "integer",
"description": "POI 고유 ID",
"format": "int32",
"example": 8827198
},
"depth": {
"type": "string",
"description": "계층 정보",
"example": "0"
},
"dpx": {
"type": "string",
"description": "지도 표출용 X좌표(경도)",
"example": "127.110762"
},
"dpy": {
"type": "string",
"description": "지도 표출용 Y좌표(위도)",
"example": "37.402184"
},
"rpx": {
"type": "string",
"description": "차량 진입로 X좌표(경도)",
"example": "127.110862"
},
"rpy": {
"type": "string",
"description": "차량 진입로 Y좌표(위도)",
"example": "37.402334"
},
"routepoints": {
"type": "array",
"description": "차량 진입로 좌표 정보 목록(배열)
>*차량 경로 탐색 시 사용 가능",
"items": {
"$ref": "#/components/schemas/RoutePoint"
}
},
"entrypoint": {
"$ref": "#/components/schemas/EntryPoint"
},
"name1": {
"type": "string",
"description": "대표 명칭",
"example": "INavi Systems"
},
"name1_ko": {
"type": "string",
"description": "국문 대표 명칭",
"example": "아이나비시스템즈"
},
"name2": {
"type": "string",
"description": "축약 명칭"
},
"name2_ko": {
"type": "string",
"description": "국문 축약 명칭"
},
"name3": {
"type": "string",
"description": "확장 명칭1"
},
"name3_ko": {
"type": "string",
"description": "국문 확장 명칭1"
},
"name4": {
"type": "string",
"description": "확장 명칭2"
},
"name4_ko": {
"type": "string",
"description": "국문 확장 명칭2"
},
"admcode": {
"type": "string",
"description": "행정구역 코드(법정동/행정동)
*법정동 검색 → 법정동 코드
*행정동 검색 → 행정동 코드",
"example": "4113510900"
},
"address": {
"type": "string",
"description": "전체 주소",
"example": "Gyeonggi-do Seongnam-si Bundang-gu Sampyeong-dong"
},
"address_ko": {
"type": "string",
"description": "국문 전체 주소",
"example": "경기도 성남시 분당구 삼평동"
},
"jibun": {
"type": "string",
"description": "지번 주소",
"example": "678"
},
"jibun_ko": {
"type": "string",
"description": "국문 지번 주소"
},
"roadname": {
"type": "string",
"description": "도로명주소",
"example": "Gyeonggi-do Seongnam-si Bundang-gu Pangyoyeok-ro"
},
"roadname_ko": {
"type": "string",
"description": "국문 도로명주소",
"example": "경기도 성남시 분당구 판교역로"
},
"roadjibun": {
"type": "string",
"description": "건물 번호",
"example": "240"
},
"roadjibun_ko": {
"type": "string",
"description": "국문 건물 번호"
},
"detailaddress": {
"type": "string",
"description": "상세 주소 정보"
},
"detailaddress_ko": {
"type": "string",
"description": "국문 상세 주소 정보"
},
"catecode": {
"type": "string",
"description": "카테고리 코드",
"example": "130602"
},
"catename": {
"type": "string",
"description": "카테고리 명칭",
"example": "Thinkware"
},
"catename_ko": {
"type": "string",
"description": "국문 카테고리 명칭",
"example": "팅크웨어"
},
"dp_catecode": {
"type": "string",
"description": "전시용 카테고리 코드",
"example": "000"
},
"distance": {
"type": "integer",
"description": "기준 좌표와의 거리(m)",
"format": "int32",
"example": 21713
},
"tel": {
"type": "string",
"description": "대표 전화번호",
"example": "02-589-9610"
},
"hasoildata": {
"type": "boolean",
"description": "주유소 유가 정보 보유 여부"
},
"hasdetailinfo": {
"type": "boolean",
"description": "상세 정보 보유 여부"
},
"hassubpoi": {
"type": "boolean",
"description": "하위 POI 존재 여부"
},
"islandmark": {
"type": "boolean",
"description": "랜드마크 여부"
},
"updateTS": {
"type": "string",
"description": "데이터의 최종 갱신 시각",
"example": "2023-08-17"
},
"subpoi": {
"$ref": "#/components/schemas/GlobalSubPoi"
},
"popularity": {
"type": "boolean",
"description": "인기 여부"
},
"pop_tv": {
"type": "boolean",
"description": "TV 기반 인기 여부"
},
"pop_sns": {
"type": "boolean",
"description": "SNS 기반 인기 여부"
},
"pop_hot": {
"type": "boolean",
"description": "HOT 인기 여부"
},
"pop_hit": {
"type": "boolean",
"description": "HIT 인기 여부"
},
"pop_top": {
"type": "string",
"description": "TOP 인기 단계"
}
},
"description": "POI 검색 결과 목록(배열)"
},
"GlobalSearchesData": {
"type": "object",
"properties": {
"result": {
"type": "boolean",
"description": "검색 결과 성공 여부",
"example": true
},
"lang": {
"type": "string",
"description": "검색 결과 반환 언어",
"example": "en",
"enum": [
"ko",
"en",
"ja",
"zh"
],
"x-enum-descriptions": {
"ko": "국문",
"ja": "일문",
"en": "영문",
"zh": "중문(간체)"
}
},
"totalcount": {
"type": "integer",
"description": "총 검색 결과 개수",
"format": "int32",
"example": 192
},
"count": {
"type": "integer",
"description": "총 응답 결과 개수",
"format": "int32",
"example": 102
},
"poitotalcount": {
"type": "integer",
"description": "총 POI 검색 결과 개수",
"format": "int32",
"example": 190
},
"poicount": {
"type": "integer",
"description": "POI(명칭) 검색 결과 개수",
"format": "int32",
"example": 100
},
"admtotalcount": {
"type": "integer",
"description": "총 주소 검색 결과 개수",
"format": "int32",
"example": 2
},
"admcount": {
"type": "integer",
"description": "주소 검색 응답 개수",
"format": "int32",
"example": 2
},
"poi": {
"type": "array",
"description": "POI 검색 결과 목록(배열)",
"items": {
"$ref": "#/components/schemas/GlobalPoi"
}
},
"adm": {
"type": "array",
"description": "주소 검색 결과 목록(배열)",
"items": {
"$ref": "#/components/schemas/GlobalAdm"
}
}
},
"description": "다국어 통합 검색 결과"
},
"GlobalSubPoi": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"description": "하위 POI 개수",
"format": "int32",
"example": 2
},
"poi": {
"type": "array",
"description": "하위 POI 정보",
"items": {
"$ref": "#/components/schemas/GlobalPoi"
}
}
},
"description": "하위 POI 정보"
},
"SearchGlobalSearchesResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"search": {
"$ref": "#/components/schemas/GlobalSearchesData"
}
},
"description": "다국어 통합 검색 API의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"search": {
"result": true,
"lang": "en",
"totalcount": 1,
"count": 1,
"poitotalcount": 1,
"poicount": 1,
"admtotalcount": 0,
"admcount": 0,
"poi": [
{
"poiid": 8827198,
"depth": "0",
"dpx": "127.110762",
"dpy": "37.402184",
"rpx": "127.110862",
"rpy": "37.402334",
"routepoints": [
{
"rpx": "127.110862",
"rpy": "37.402334"
}
],
"entrypoint": {
"px": "127.109987",
"py": "37.401942"
},
"name1": "INavi Systems",
"name1_ko": "아이나비시스템즈",
"name2": "",
"name2_ko": "",
"name3": "",
"name3_ko": "",
"name4": "",
"name4_ko": "",
"admcode": "4113510900",
"address": "Gyeonggi-do Seongnam-si Bundang-gu Sampyeong-dong",
"address_ko": "경기도 성남시 분당구 삼평동",
"jibun": "678",
"jibun_ko": "678",
"roadname": "Gyeonggi-do Seongnam-si Bundang-gu Pangyoyeok-ro",
"roadname_ko": "경기도 성남시 분당구 판교역로",
"roadjibun": "240",
"roadjibun_ko": "240",
"detailaddress": "",
"detailaddress_ko": "삼환하이펙스 A동 8층",
"catecode": "130602",
"catename": "Thinkware",
"catename_ko": "팅크웨어",
"dp_catecode": "000",
"distance": 0,
"tel": "02-589-9610",
"hasoildata": false,
"hasdetailinfo": true,
"hassubpoi": false,
"islandmark": true,
"updateTS": "2023-08-17",
"subpoi": {
"count": 0,
"poi": []
},
"popularity": false,
"pop_tv": false,
"pop_sns": false,
"pop_hot": false,
"pop_hit": false,
"pop_top": ""
}
],
"adm": [
{
"type": 3,
"posx": "127.11065",
"posy": "37.402109",
"admcode": "4113510900",
"address": "Gyeonggi-do Seongnam-si Bundang-gu Sampyeong-dong",
"address_ko": "경기도 성남시 분당구 삼평동",
"jibun": "678",
"jibun_ko": "678",
"roadname": "Gyeonggi-do Seongnam-si Bundang-gu Pangyoyeok-ro",
"roadname_ko": "경기도 성남시 분당구 판교역로",
"roadjibun": "240",
"roadjibun_ko": "240",
"postcode": "13493",
"buildname": "",
"buildname_ko": "삼환하이펙스A동",
"accuracy": 0,
"distance": 0
}
]
}
}
},
"GlobalAddressesAdm": {
"type": "object",
"properties": {
"posx": {
"type": "string",
"description": "X좌표(경도) 값",
"example": "127.11065"
},
"posy": {
"type": "string",
"description": "Y좌표(위도) 값",
"example": "37.402109"
},
"address": {
"type": "string",
"description": "전체 주소",
"example": "Gyeonggi-do Seongnam-si Sujeong-gu Sasong-dong"
},
"address_ko": {
"type": "string",
"description": "국문 전체 주소",
"example": "경기도 성남시 분당구 삼평동"
},
"jibun": {
"type": "string",
"description": "지번 정보",
"example": "678"
},
"jibun_ko": {
"type": "string",
"description": "국문 지번 정보",
"example": "678"
},
"roadname": {
"type": "string",
"description": "도로명 주소",
"example": "Gyeonggi-do Seongnam-si Sujeong-gu Sasong-ro"
},
"roadname_ko": {
"type": "string",
"description": "국문 도로명 주소",
"example": "경기도 성남시 분당구 판교역로"
},
"roadjibun": {
"type": "string",
"description": "건물 번호",
"example": "240"
},
"admcode": {
"type": "string",
"description": "법정구역 코드",
"example": "4113510900"
},
"postcode": {
"type": "string",
"description": "우편번호
*주소+지번 검색 시 제공",
"example": "13493"
},
"bldname": {
"type": "string",
"description": "건물 명칭
*도로명 주소 검색 시 제공",
"example": "삼환하이펙스A동"
},
"bldnum": {
"type": "string",
"description": "동호수 정보",
"example": "102동"
}
},
"description": "기본(법정동) 주소 정보"
},
"GlobalAddressesData": {
"type": "object",
"properties": {
"result": {
"type": "boolean",
"description": "검색 결과 성공 여부",
"example": true
},
"lang": {
"type": "string",
"description": "검색 결과 반환 언어",
"example": "en",
"enum": [
"ko",
"en",
"ja",
"zh"
],
"x-enum-descriptions": {
"ko": "국문",
"ja": "일문",
"en": "영문",
"zh": "중문(간체)"
}
},
"hasAdmAddress": {
"type": "boolean",
"description": "행정동 주소 반환 여부",
"example": true
},
"adm": {
"$ref": "#/components/schemas/GlobalAddressesAdm"
},
"adm_address": {
"$ref": "#/components/schemas/adm_address"
},
"legal_address": {
"$ref": "#/components/schemas/legal_address"
}
},
"description": "다국어 리버스 지오코딩 결과"
},
"SearchGlobalAddressesResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"location": {
"$ref": "#/components/schemas/GlobalAddressesData"
}
},
"description": "다국어 리버스 지오코딩 API의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"location": {
"result": true,
"hasAdmAddress": true,
"adm": {
"posx": "127.110450",
"posy": "37.402125",
"address": "Gyeonggi-do Seongnam-si Bundang-gu Sampyeong-dong",
"address_ko": "경기도 성남시 분당구 삼평동",
"jibun": "678",
"jibun_ko": "678",
"roadname": "Gyeonggi-do Seongnam-si Bundang-gu Pangyoyeok-ro",
"roadname_ko": "경기도 성남시 분당구 판교역로",
"roadjibun": "240",
"admcode": "4113510900",
"postcode": "13493",
"bldname": "",
"bldnum": ""
},
"adm_address": {
"address": "Gyeonggi-do Seongnam-si Bundang-gu Sampyeong-dong",
"address_ko": "경기도 성남시 분당구 삼평동",
"jibun": "678",
"jibun_ko": "678",
"cut_address": "Gyeonggi-do Seongnam-si Bundang-gu Sampyeong-dong",
"cut_address_ko": "경기 성남시 분당구 삼평동",
"admcode": "4113565500",
"address_category1": "Gyeonggi-do",
"address_category1_ko": "경기도",
"address_category2": "Seongnam-si Bundang-gu",
"address_category2_ko": "성남시 분당구",
"address_category3": "Sampyeong-dong",
"address_category3_ko": "삼평동",
"address_category4": "",
"address_category4_ko": ""
},
"legal_address": {
"address": "Gyeonggi-do Seongnam-si Bundang-gu Sampyeong-dong",
"address_ko": "경기도 성남시 분당구 삼평동",
"jibun": "678",
"jibun_ko": "678",
"cut_address": "Gyeonggi-do Seongnam-si Bundang-gu Sampyeong-dong",
"cut_address_ko": "경기 성남시 분당구 삼평동",
"admcode": "4113510900",
"address_category1": "Gyeonggi-do",
"address_category1_ko": "경기도",
"address_category2": "Seongnam-si Bundang-gu",
"address_category2_ko": "성남시 분당구",
"address_category3": "Sampyeong-dong",
"address_category3_ko": "삼평동",
"address_category4": "",
"address_category4_ko": ""
}
}
}
},
"CoordinatesData": {
"type": "object",
"properties": {
"result": {
"type": "boolean",
"description": "검색 결과 성공 여부",
"example": true
},
"totalcount": {
"type": "integer",
"description": "총 검색 결과 개수",
"format": "int32",
"example": 192
},
"admtotalcount": {
"type": "integer",
"description": "총 주소 검색 결과 개수",
"format": "int32",
"example": 2
},
"admcount": {
"type": "integer",
"description": "주소 검색 응답 개수",
"format": "int32",
"example": 2
},
"adm": {
"type": "array",
"description": "주소 검색 결과 목록(배열)",
"items": {
"$ref": "#/components/schemas/Adm"
}
}
},
"description": "지오코딩 결과"
},
"SearchCoordinatesResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"address": {
"$ref": "#/components/schemas/CoordinatesData"
}
},
"description": "지오코딩 API의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"address": {
"result": true,
"totalcount": 1,
"admtotalcount": 1,
"admcount": 1,
"adm": [
{
"type": 3,
"posx": "127.11065",
"posy": "37.402109",
"admcode": "4113510900",
"address": "경기도 성남시 분당구 삼평동",
"address_sido": "경기도",
"address_gu": "성남시 분당구",
"address_dong": "삼평동",
"address_haeng": "삼평동",
"legalcode": "4113510900",
"haengcode": "4113565500",
"jibun": "678",
"roadname": "경기도 성남시 분당구 판교역로",
"roadjibun": "240",
"postcode": "13493",
"buildname": "",
"accuracy": 0,
"distance": 0
}
]
}
}
},
"SearchAddressesResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"location": {
"$ref": "#/components/schemas/AddressesData"
}
},
"description": "리버스 지오코딩 API의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"location": {
"result": true,
"hasAdmAddress": true,
"adm": {
"posx": "127.110450",
"posy": "37.402125",
"address": "경기도 성남시 분당구 삼평동",
"jibun": "678",
"roadname": "경기도 성남시 분당구 판교역로",
"roadjibun": "240",
"admcode": "4113510900",
"postcode": "13493",
"bldname": "삼환하이펙스A동",
"bldnum": ""
},
"adm_address": {
"address": "경기도 성남시 분당구 삼평동",
"jibun": "678",
"cut_address": "경기 성남시 분당구 삼평동",
"admcode": "4113565500",
"address_category1": "경기도",
"address_category2": "성남시 분당구",
"address_category3": "삼평동",
"address_category4": ""
},
"legal_address": {
"address": "경기도 성남시 분당구 삼평동",
"jibun": "678",
"cut_address": "경기 성남시 분당구 삼평동",
"admcode": "4113510900",
"address_category1": "경기도",
"address_category2": "성남시 분당구",
"address_category3": "삼평동",
"address_category4": ""
}
}
}
},
"AddrSearchesAdm": {
"type": "object",
"properties": {
"posx": {
"type": "string",
"description": "X좌표(경도) 값",
"example": "127.11065"
},
"posy": {
"type": "string",
"description": "Y좌표(위도) 값",
"example": "37.402109"
},
"admcode": {
"type": "string",
"description": "법정구역 코드",
"example": "4113510900"
},
"address": {
"type": "string",
"description": "전체 주소",
"example": "경기도 성남시 분당구 삼평동"
},
"distance": {
"type": "integer",
"description": "기준점과의 거리 정보(m)",
"format": "int32",
"example": 0
}
},
"description": "search.data.addr-searches-adm.description"
},
"AddrSearchesData": {
"type": "object",
"properties": {
"result": {
"type": "boolean",
"description": "검색 결과 성공 여부",
"example": true
},
"totalcount": {
"type": "integer",
"description": "총 검색 결과 개수",
"format": "int32",
"example": 192
},
"adm": {
"type": "array",
"description": "주소 검색 결과 목록(배열)",
"items": {
"$ref": "#/components/schemas/AddrSearchesAdm"
}
}
},
"description": "주소 정규화 지오코딩 결과"
},
"SearchAddrSearchesResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"address": {
"$ref": "#/components/schemas/AddrSearchesData"
}
},
"description": "주소 정규화 지오코딩 API의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"address": {
"result": true,
"totalcount": 1,
"adm": [
{
"posx": "127.11065",
"posy": "37.402109",
"admcode": "4113510900",
"address": "경기도 성남시 분당구 판교역로 240",
"distance": 10
}
]
}
}
},
"A2pSearchesData": {
"type": "object",
"properties": {
"result": {
"type": "boolean",
"description": "검색 결과 성공 여부",
"example": true
},
"type": {
"type": "integer",
"description": "검색 결과 타입
*예: 연관 검색 -> 판교역 주변 주유소",
"format": "int32",
"example": 1,
"enum": [
0,
1
],
"x-enum-descriptions": {
"0": "일반 검색",
"1": "연관 검색"
}
},
"totalcount": {
"type": "integer",
"description": "총 검색 결과 개수",
"format": "int32",
"example": 192
},
"count": {
"type": "integer",
"description": "총 응답 결과 개수",
"format": "int32",
"example": 102
},
"poitotalcount": {
"type": "integer",
"description": "총 POI 검색 결과 개수",
"format": "int32",
"example": 190
},
"poicount": {
"type": "integer",
"description": "POI(명칭) 검색 결과 개수",
"format": "int32",
"example": 100
},
"admtotalcount": {
"type": "integer",
"description": "총 주소 검색 결과 개수",
"format": "int32",
"example": 2
},
"admcount": {
"type": "integer",
"description": "주소 검색 응답 개수",
"format": "int32",
"example": 2
},
"poi": {
"type": "array",
"description": "POI 검색 결과 목록(배열)",
"items": {
"$ref": "#/components/schemas/PoiDataA"
}
},
"adm": {
"type": "array",
"description": "주소 검색 결과 목록(배열)",
"items": {
"$ref": "#/components/schemas/Adm"
}
}
},
"description": "주소 내 POI 검색 결과"
},
"SearchA2pSearchesResponse": {
"type": "object",
"properties": {
"header": {
"$ref": "#/components/schemas/Header"
},
"search": {
"$ref": "#/components/schemas/A2pSearchesData"
}
},
"description": "주소 내 POI 검색 API의 전체 응답",
"example": {
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "Success"
},
"search": {
"result": true,
"type": 0,
"totalcount": 115,
"count": 20,
"poi": [
{
"poiid": 8827198,
"depth": "0",
"dpx": "127.110762",
"dpy": "37.402184",
"rpx": "127.110862",
"rpy": "37.402334",
"routepoints": [
{
"rpx": "127.110862",
"rpy": "37.402334"
}
],
"entrypoint": {
"px": "127.109987",
"py": "37.401942"
},
"name1": "아이나비시스템즈",
"name2": "INAVISYSTEMS",
"name3": "아이나비시스템즈판교캠퍼스",
"name4": "아이나비판교캠퍼스",
"admcode": "4113510900",
"haengcode": "",
"address": "경기도 성남시 분당구 삼평동",
"address_haeng": "",
"jibun": "678",
"roadname": "경기도 성남시 분당구 판교역로",
"roadjibun": "240",
"detailaddress": "삼환하이펙스 A동 8층",
"catecode": "130602",
"catename": "팅크웨어",
"dp_catecode": "000",
"distance": 21713,
"tel": "02-589-9610",
"hasoildata": false,
"hasdetailinfo": true,
"hassubpoi": false,
"islandmark": true,
"updateTS": "2023-08-17",
"subpoi": {
"count": 0,
"poi": []
},
"externallink": [
{
"Site": "PLOG",
"ID": "http://m.fivepin.co.kr/MyStory/Plog?pid=8827198",
"ExtraInfo1": "단골 많은 팅크웨어(재방문54%)",
"ExtraInfo2": "재방문54%기업"
}
],
"popularity": false,
"pop_tv": false,
"pop_sns": false,
"pop_hot": false,
"pop_hit": false,
"pop_top": "경기_1,분당구_1"
}
]
}
}
}
}
},
"x-tagGroups": [
{
"name": "지도",
"tags": [
"WEB(JS)",
"Static Map"
]
},
{
"name": "검색",
"tags": [
"장소/주소 검색",
"지오코딩",
"공간 검색",
"W3W"
]
},
{
"name": "경로",
"tags": [
"탐색",
"최적화",
"복원",
"매트릭스"
]
}
]
}