Geolocation

지도(위치) 관련 정보를 제공하는 서비스입니다.

서울시 공영주차장 조회 서비스
서울시 공영주차장 위치 및 정보를 리턴합니다.
End Point Method Parameter
/v1/geolcation/inquiry/seoul/public-parking-lot GET Query

Request Parameters
필드 설명 타입
address 주소 String
start_index 데이터 시작번호 String
end_index 데이터 마지막번호 String
lang 변수언어 String

Response
필드 설명 타입
PARKING_NAME 주차장명 String
ADDR 주소 String
PARKING_CODE 주차장코드 String
PARKING_TYPE 주차장종류 String
PARKING_TYPE_NM 주차장종류명 String
OPERATION_RULE 운영구분 String
OPERATION_RULE_NM 운영구분명 String
TEL 전화번호 String
QUE_STATUS 주차현황정보제공여부 String
QUE_STATUS_NM 주차현황정보제공여부명 String
CAPACITY 총주차면 String
PAY_YN 유무료구분 String
PAY_NM 유무료구분명 String
NIGHT_FREE_OPEN 야간무료개방여부 String
NIGHT_FREE_OPEN_NM 야간무료개방여부명 String
WEEKDAY_BEGIN_TIME 평일운영시작시각 String
WEEKDAY_END_TIME 평일운영종료시각 String
WEEKEND_BEGIN_TIME 주말운영시작시각 String
WEEKEND_END_TIME 주말운영종료시각 String
HOLIDAY_BEGIN_TIME 공휴일운영시작시각 String
HOLIDAY_END_TIME 공휴일운영종료시각 String
최종데이터동기화시간 SYNC_TIME String
SATURDAY_PAY_YN 토요일유무료구분 String
SATURDAY_PAY_NM 토요일유무료구분명 String
HOLIDAY_PAY_YN 공휴일유무료구분 String
HOLIDAY_PAY_NM 공휴일유무료구분명 String
FULLTIME_MONTHLY 월정기권금액 String
GRP_PARKNM 노상주차장관리그룹번호 String
RATES 기본주차요금 String
TIME_RATE 기본주차시간(분단위) String
ADD_RATES 추가단위요금 String
ADD_TIME_RATE 추가단위시간(분단위) String
BUS_RATES 버스기본주차요금 String
BUS_TIME_RATE 버스기본주차시간(분단위) String
BUS_ADD_TIME_RATE 버스추가단위시간(분단위) String
BUS_ADD_RATES 버스추가단위요금 String
LAT 위도 String
LNG 경도 String

Response Sample

{
  "code": "0000",
  "message": "정상처리",
  "body": {
    "total_count": 1383,
    "start_index": 1,
    "end_index": 10,
    "list": [
      {
        "BUS_TIME_RATE": "0",
        "NIGHT_FREE_OPEN": "N",
        "PARKING_TYPE_NM": "노외 주차장",
        "LNG": "127.02647115",
        "QUE_STATUS_NM": "현재~20분이내 연계데이터 존재(현재 주차대수 표현)",
        "OPERATION_RULE_NM": "시간제 주차장",
        "PARKING_TYPE": "NW",
        "RATES": "400",
        "WEEKEND_END_TIME": "2100",
        "WEEKEND_BEGIN_TIME": "0900",
        "PAY_NM": "유료",
        "SATURDAY_PAY_NM": "무료",
        "BUS_ADD_RATES": "0",
        "PARKING_NAME": "압구정 428 공영주차장(구)",
        "BUS_RATES": "0",
        "DAY_MAXIMUM": "",
        "HOLIDAY_END_TIME": "2100",
        "TIME_RATE": "5",
        "BUS_ADD_TIME_RATE": "0",
        "HOLIDAY_PAY_NM": "무료",
        "FULLTIME_MONTHLY": "200000",
        "CAPACITY": "344",
        "ADD_RATES": "400",
        "SYNC_TIME": "2020-07-07 18:25:48",
        "WEEKDAY_BEGIN_TIME": "0900",
        "QUE_STATUS": "1",
        "OPERATION_RULE": "1",
        "ADD_TIME_RATE": "5",
        "PAY_YN": "Y",
        "ADDR": "강남구 압구정동 428-0",
        "PARKING_CODE": "1033125",
        "HOLIDAY_BEGIN_TIME": "0900",
        "HOLIDAY_PAY_YN": "N",
        "GRP_PARKNM": "",
        "WEEKDAY_END_TIME": "2100",
        "SATURDAY_PAY_YN": "N",
        "TEL": "02-2176-0971",
        "NIGHT_FREE_OPEN_NM": "야간 미개방",
        "LAT": "37.52701729"
      },
      {
        "BUS_TIME_RATE": "0",
        "NIGHT_FREE_OPEN": "N",
        "PARKING_TYPE_NM": "노외 주차장",
        "LNG": "127.05236496",
        "QUE_STATUS_NM": "현재~20분이내 연계데이터 존재(현재 주차대수 표현)",
        "OPERATION_RULE_NM": "시간제 주차장",
        "PARKING_TYPE": "NW",
        "RATES": "200",
        "WEEKEND_END_TIME": "2400",
        "WEEKEND_BEGIN_TIME": "0000",
        "PAY_NM": "유료",
        "SATURDAY_PAY_NM": "무료",
        "BUS_ADD_RATES": "0",
        "PARKING_NAME": "포이초교 공영주차장(구)",
        "BUS_RATES": "0",
        "DAY_MAXIMUM": "",
        "HOLIDAY_END_TIME": "2400",
        "TIME_RATE": "5",
        "BUS_ADD_TIME_RATE": "0",
        "HOLIDAY_PAY_NM": "무료",
        "FULLTIME_MONTHLY": "120000",
        "CAPACITY": "194",
        "ADD_RATES": "200",
        "SYNC_TIME": "2020-07-08 18:09:52",
        "WEEKDAY_BEGIN_TIME": "0000",
        "QUE_STATUS": "1",
        "OPERATION_RULE": "1",
        "ADD_TIME_RATE": "5",
        "PAY_YN": "Y",
        "ADDR": "강남구 개포동 1273-0",
        "PARKING_CODE": "1033754",
        "HOLIDAY_BEGIN_TIME": "0000",
        "HOLIDAY_PAY_YN": "N",
        "GRP_PARKNM": "",
        "WEEKDAY_END_TIME": "2400",
        "SATURDAY_PAY_YN": "N",
        "TEL": "02-2176-0925",
        "NIGHT_FREE_OPEN_NM": "야간 미개방",
        "LAT": "37.47564571"
      },
      #...
    ]
  }                  
서울시 전기차 충전소 조회 서비스
서울시 전기차 충전소 위치 및 정보를 리턴합니다.
End Point Method Parameter
/v1/geolocation/inquiry/seoul/ev-chargingstation GET Query

Request Parameters
필드 설명 타입
start_index 데이터 시작번호 String
end_index 데이터 마지막번호 String
lang 변수언어 String

Response
필드 설명 타입
OPER_INST_NM 운영기관 String
CHARGING_STATION 충전소 String
CHARGER_ID 충전기ID String
CHARGER_TYPE 충전기타입 String
FCLT_SE_L 시설구분(대) String
FCLT_SE_S 시설구분(소) String
RGN 지역 String
SGG 시군구 String
ADDR 주소 String
UTZTN_PSBLTY_TM 이용가능시간 String
UTZTN_USER_LMT 이용자제한 String
CHARGING_CAPACITY 충전용량 String
CON_PVSN 편의제공 String
RMRK 비고 String

Response Sample

{
  "code": "0000",
  "message": "정상처리",
  "body": {
    "total_count": 87,
    "start_index": 1,
    "end_index": 10,
    "list": [
      {
        "CHARGING_CAPACITY": "7kW",
        "CHARGER_ID": "01",
        "CHARGER_TYPE": "AC완속",
        "CON_PVSN": "N",
        "OPER_INST_NM": "서울시",
        "FCLT_SE_L": "주차시설",
        "CHARGING_STATION": "SK허브수 인근 거주자우선주차장",
        "ADDR": "서울특별시 구로구 구일로10길 27(구로동, SK허브수) 지상1층 A동 앞 노상공영주차장",
        "SGG": "구로구",
        "RMRK": "",
        "UTZTN_USER_LMT": "",
        "FCLT_SE_S": "공영주차장",
        "RGN": "서울특별시",
        "UTZTN_PSBLTY_TM": "24시간 이용가능"
      },
#...
    ]
  }
}
                    
주소에 대한 우편번호 조회 서비스
요청 주소 대해 우편번호 및 주소 리스트를 리턴합니다.
End Point Method Parameter
/v1/geolocation/inquiry/postcode GET Query

Request Parameters
필드 설명 타입
address_query 주소검색어
- 도로명 + 건물번호 (예) 도움5로 19
- 건물명 (예) 우정사업본부
- 읍/면/동/리 + 지번 (예) 어진동 307-19
- 사서함 + 사서함번호 (예) 광화문우체국사서함 45
String
count_per_page 페이지당 데이터 개수 String
search_page 조회페이지 String

Response
필드 설명 타입
postcd 우편번호 String
address 도로명주소 String
addrjibun 지번주소 String
addressEng 영문주소 String

Response Sample


{
  "code": "0000",
  "message": "정상처리",
  "body": {
    "total_page": 2,
    "total_count": 18,
    "list": [
      {
        "postcd": "05700",
        "address": "서울특별시 송파구 양재대로68길 3 (가락동, 동방빌라)",
        "addressEng": "3, Yangjae-daero 68-gil, Songpa-gu, Seoul, 05700",
        "addrjibun": "서울특별시 송파구 가락동 1 (동방빌라)"
      },
      {
        "postcd": "05700",
        "address": "서울특별시 송파구 양재대로68길 3-3 (가락동, 다우빌라)",
        "addressEng": "3, Yangjae-daero 68-gil, Songpa-gu, Seoul, 05700",
        "addrjibun": "서울특별시 송파구 가락동 1-1 (다우빌라)"
      },
      #...
    ]
  }
}                    
IP주소에 대한 위치 확인 서비스
IP주소 대해 위치정보를 리턴합니다.
End Point Method Parameter
/v1/geolocation/inquiry/byip GET Query

Request Parameters
필드 설명 타입
ip_address IP주소 String

Response
필드 설명 타입
ip_address IP주소 String
country_code 국가코드 String
country_name 국가명 String
subdivision_code 주소코드 String
subdivision_name 주소명 String
city 도시 String
postal_code 우편번호 String
latitude 위도 String
longitude 경도 String

Response Sample


{
  "code": "0000",
  "message": "정상처리",
  "body": {
    "country_code": "US",
    "city": null,
    "subdivision_name": null,
    "latitude": 37.751,
    "country_name": "United States",
    "subdivision_code": null,
    "ip_address": "198.121.0.0",
    "postal_code": null,
    "longitude": -97.822
  }
}