{"openapi":"3.0.3","info":{"title":"APICK 행정구역 경계·면적 분석","version":"1.0.0","description":"시도·시군구·읍면동·리의 경계로 면적·둘레·중심점·경계 상자를 계산하고 단순화한 GeoJSON 을 돌려줍니다. 행정구역 단위 분석·지도 표시용 경계를 만들 때 씁니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/geo_district_boundary":{"post":{"summary":"행정구역 경계·면적 분석","description":"시도·시군구·읍면동·리의 경계로 면적·둘레·중심점·경계 상자를 계산하고 단순화한 GeoJSON 을 돌려줍니다. 행정구역 단위 분석·지도 표시용 경계를 만들 때 씁니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"district":{"type":"object","properties":{"code":{"type":"string","description":"행정구역 코드입니다."},"name":{"type":"string","description":"행정구역 이름입니다."},"level":{"type":"string","description":"찾은 단계(L1~L4)입니다."},"center":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"crs":{"type":"string"}},"description":"행정구역 대표 지점 좌표입니다."}}},"area":{"type":"object","properties":{"m2":{"type":"integer","description":"면적(m²)입니다."},"km2":{"type":"number","description":"면적(km²)입니다."},"pyeong":{"type":"number","description":"면적(평)입니다."}}},"perimeterM":{"type":"number","description":"경계 둘레(m)입니다."},"centroid":{"type":"object","properties":{"x":{"type":"number","description":"면적 중심 경도입니다."},"y":{"type":"number","description":"면적 중심 위도입니다."}}},"bbox":{"type":"array","items":{"type":"number"},"description":"경계 상자입니다."},"vertexCount":{"type":"integer","description":"원본 정점 수입니다."},"simplifiedVertexCount":{"type":"integer","description":"단순화 뒤 정점 수입니다."},"simplifyToleranceM":{"type":"integer","description":"적용한 단순화 오차(m)입니다. 단순화하지 않았으면 null 입니다.","nullable":true},"autoSimplified":{"type":"boolean","description":"자동으로 단순화했으면 true 입니다."},"geometry":{"type":"object","properties":{"type":{"type":"string"},"geometries":{"type":"array","items":{}}},"description":"경계 GeoJSON(GeometryCollection)입니다. includeGeometry=false 면 없습니다."},"error":{"type":"string","description":"실패 사유입니다. 이 필드가 있으면 과금되지 않습니다."}}},"api":{"type":"object","properties":{"cost":{"type":"integer","description":"차감된 포인트입니다. 실패한 응답은 0입니다."},"success":{"type":"boolean"},"ms":{"type":"integer","description":"처리 시간(밀리초)입니다."}}}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"행정구역 이름 또는 코드 (예: 강남구, 11680) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)","example":"강남구"},"level":{"type":"string","description":"행정구역 단계. 생략하면 이름으로 추정합니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. 가능한 값은 4가지입니다. L1 = L1 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. L2 = L2 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. L3 = L3 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. L4 = L4 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. (string)","enum":["L1","L2","L3","L4"],"example":"L2"},"simplify":{"type":"string","description":"단순화 허용 오차(m) 숫자로 보내며, 허용 범위를 벗어나면 요청이 거부됩니다. (number)","example":"20"},"includeGeometry":{"type":"string","description":"단순화한 경계 포함 여부 (기본 true) true/false로 보내며, 생략하면 서버 기본값이 적용됩니다. true = 이 필드가 나타내는 조건이 성립한 경우, false = 성립하지 않은 경우입니다. 두 값 모두 정상 응답에 올 수 있으며, 값이 없으면 필드가 생략되거나 null일 수 있습니다. (boolean)"}},"required":["query"]}}}}}}},"x-code-tables":[{"title":"오류 코드","columns":["상황","data.error 예","대처"],"rows":[["입력 누락·형식 오류","검색어가 필요합니다. / 주소 유형이 잘못됐습니다. / 좌표가 올바르지 않습니다. …","문구가 가리키는 입력을 고쳐 다시 요청합니다. 조회 전에 끝나며 과금되지 않습니다."],["개수·길이 초과","주소가 너무 깁니다. / 한 요청에 주소를 50개까지 보낼 수 있습니다. …","표의 최대값 안으로 줄이거나 나눠서 요청합니다."],["위치를 찾지 못함","입력한 위치를 찾지 못했습니다.","주소 표기(시도·시군구 포함 여부, 오탈자)를 확인합니다. 과금되지 않습니다."],["처리 시간 초과","처리 시간이 초과됐습니다. 범위를 줄여 다시 시도해 주세요.","목록 건수·반경·분류 수를 줄여 다시 요청합니다. 과금되지 않습니다."],["일시적 실패","공간정보를 일시적으로 가져오지 못했습니다. 잠시 후 다시 시도해 주세요.","잠시 뒤 같은 요청을 다시 보냅니다. 과금되지 않습니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}