문의하기

서울 실시간 도시데이터 OpenAPI 운영 호출량·HTTPS·필드 의미 문의

작성일2026-07-27 | 작성자박중혁 | 조회수73

안녕하세요.

 

서울시 실시간 인구데이터(citydata_ppltn, OA-21778)를 활용해 서울 주요 상권의 혼잡도 분석 서비스를 개발하고 있습니다. 브라우저가 아닌 서버 수집기에서 공식 API를 호출하며, 현재는 홍대 관광특구 한 곳으로 제한된 파일럿을 진행하고 있습니다. 안정적이고 정책에 맞는 운영을 위해 아래 내용을 문의드립니다.

 

1. 일반 인증키로 citydata_ppltn을 호출할 때 적용되는 일일 또는 시간당 요청 상한이 별도로 있는지 궁금합니다.

 

2. 공식 안내의 5분 단위를 기준으로 9개 장소를 수집하면 하루 최대 2,592회 요청이 발생합니다. 이 사용량이 일반 인증키 허용 범위인지, 활용사례 등록 또는 별도 협의가 필요한지 궁금합니다.

 

3. 현재 명세의 http://openapi.seoul.go.kr:8088 주소 외에 인증키를 URL 경로에 노출하지 않거나 HTTPS로 호출할 수 있는 공식 endpoint가 있는지 궁금합니다.

 

4. REPLACE_YN이 Y가 되는 정확한 조건과, 대체 데이터의 생성 방식 또는 품질상 주의사항을 확인하고 싶습니다.

 

5. PPLTN_TIME이 같은 응답의 내용이 사후 변경될 가능성이 있는지, 변경될 경우 이를 보정 데이터로 해석해 별도 revision으로 보존해도 되는지 궁금합니다.

 

6. 서비스 운영을 위해 원본 응답을 내부 분석용으로 보관할 때 권장 보관기간이나 별도의 이용상 제한이 있는지 궁금합니다. 외부 표시 시에는 서울특별시 출처를 명시할 예정입니다.

 

7. ROAD_TRAFFIC_SPD, TEMP, HUMIDITY, WIND_SPD, PRECIPITATION, PM10,

   PM25 등 수치 필드의 공식 단위를 확인할 수 있는 최신 명세가 있는지 궁금합니다.

 

8. 2026-07-27 홍대 관광특구 JSON 응답에서 UV_INDEX는 "보통", UV_INDEX_LVL은 "5"로 반환됐습니다. 데이터셋 페이지의 한글 설명과 값 형태가 반대로 보이는데, 두 필드의 정확한 의미를 확인하고 싶습니다.

 

9. LIVE_SUB_PPLTN과 LIVE_BUS_PPLTN의 5분·10분·30분 승하차 값에 대응하는 정확한 관측 또는 업데이트 시각 필드가 있는지 궁금합니다. SUB_STN_TIME과 BUS_STN_TIME은 명세상 역·정류장 개수 기준년월로 안내되어 승하차 시각으로 사용하지 않고 있습니다.

 

10. 위 두 기준년월 필드가 2026-07-27 홍대 관광특구 응답에서는 "20260727"로 반환됐습니다. YYYYMM이 아닌 8자리 값의 정확한 의미와 형식을 확인하고 싶습니다.

 

11. LIVE_CMRCL_STTS의 결제금액·소비비율 공식 단위, 신한카드 가공 데이터의 내부 원본 보관 및 외부 서비스 표시 시 추가로 지켜야 할 이용조건이 있는지 궁금합니다. 인증키나 개인 연락처는 본문에 기재하지 않았습니다. 확인 부탁드립니다. 감사합니다.

 

안녕하세요. 열린데이터광장입니다.
원천부서에 문의 결과 전달드립니다.

1. 일반 인증키로 citydata_ppltn을 호출할 때 적용되는 일일 또는 시간당 요청 상한이 별도로 있는지 궁금합니다.
답변 -> 일일 호출 상한 제도는 없습니다. 다만 너무 많은 양의 데이터를 호출하실 경우 인증키 사용 제한이 걸릴 수 있으므로 이 점 참고해 주시기 바랍니다.

2. 공식 안내의 5분 단위를 기준으로 9개 장소를 수집하면 하루 최대 2,592회 요청이 발생합니다.
이 사용량이 일반 인증키 허용 범위인지, 활용사례 등록 또는 별도 협의가 필요한지 궁금합니다.
답변 -> 허용 범위이며, 별도로 활용사례(갤러리)에 등록안해 주셔도 됩니다.

3. 현재 명세의 http://openapi.seoul.go.kr:8088 주소 외에 인증키를 URL 경로에 노출하지 않거나 HTTPS로 호출할 수 있는 공식 endpoint가 있는지 궁금합니다.
답변 -> 내부 규정 및 기술적인 문제로 인해 https는 제공이 불가합니다.

4. REPLACE_YN이 Y가 되는 정확한 조건과, 대체 데이터의 생성 방식 또는 품질상 주의사항을 확인하고 싶습니다.
-> 답변4 : 해당지역(POI)별 데이터와 관련된 통신사 시스템 전산 오류 또는 서울시 시스템 오류시, 발생하는 데이터 오류 (미집계, 과소집계 등)에 대해 대체 데이터로 변하게 되며,
대체데이터는 최근 4주 동일 요일, 동일 시간 평균값으로 제공합니다.

5. PPLTN_TIME이 같은 응답의 내용이 사후 변경될 가능성이 있는지, 변경될 경우 이를 보정 데이터로 해석해 별도 revision으로 보존해도 되는지 궁금합니다.
-> 답변 5: 해당 컬럼값은 실시간 인구의 실제 시점을 나타내는 컬럼입니다.
향후 장비 업그레이드, 네트워크 속도 향상 등으로 업데이트 시간이 줄어들 수 있습니다. (실제 서비스 오픈 후, 실시간 인구 시점과 서비스 시간 차이가 40분 전 ->23~33분 사이로 변경되었습니다.)

6. 서비스 운영을 위해 원본 응답을 내부 분석용으로 보관할 때 권장 보관기간이나 별도의 이용상 제한이 있는지 궁금합니다.
외부 표시 시에는 서울특별시 출처를 명시할 예정입니다.
답변 -> 데이터 보장 기간은 별도로 제한이 없으며, 출처만 명시해 주시면 됩니다.

7. ROAD_TRAFFIC_SPD, TEMP, HUMIDITY, WIND_SPD, PRECIPITATION, PM10,
PM25 등 수치 필드의 공식 단위를 확인할 수 있는 최신 명세가 있는지 궁금합니다.
-> 답변 7: 추후 각 항목에 대해 컬럼명세서에 단위를 추가하도록 하겠습니다.

문의주신 각 데이터의 출처와 단위 전달드립니다.
1) ROAD_TRAFFIC_SPD(도로속도)
- 원천 데이터는 ITS에서 수집중이며 단위는 시/Km입니다.
- URL: https://its.go.kr/opendata/opendataList?service=traffic
2) TEMP(온도), HUMIDITY(습도), WIND_SPD(풍속), PRECIPITATION(강수량)
- 원천 데이터는 기상청에서 제공하는 초단기실황정보를 공공데이터 포털을 통해 수집중입니다.
- TEMP(온도): ℃
- HUMIDITY(습도): %
- WIND_SPD(풍속): m/s
- PRECIPITATION(강수량): mm
- URL: https://www.data.go.kr/data/15084084/openapi.do
3) PM10(미세먼지농도), PM25(초미세먼지농도)
- 원천데이터는 서울 열린데이터 광장에서 제공하는 서울시 권역별 실시간 대기현황 정보를 수집중입니다.
- PM10(미세먼지농도): ㎍/㎥
- PM20(초미세먼지농도): ㎍/㎥
- URL: https://data.seoul.go.kr/dataList/OA-2219/S/1/datasetView.do

8. 2026-07-27 홍대 관광특구 JSON 응답에서 UV_INDEX는 "보통", UV_INDEX_LVL은 "5"로 반환됐습니다.
데이터셋 페이지의 한글 설명과 값 형태가 반대로 보이는데, 두 필드의 정확한 의미를 확인하고 싶습니다.
-> 답변 9: 원데이터 출처의 컬럼 변경으로 7월 31일 오후 수정작업 예정입니다. 문의주셔서 감사합니다.

9. LIVE_SUB_PPLTN과 LIVE_BUS_PPLTN의 5분·10분·30분 승하차 값에 대응하는 정확한 관측 또는 업데이트 시각 필드가 있는지 궁금합니다.
SUB_STN_TIME과 BUS_STN_TIME은 명세상 역·정류장 개수 기준년월로 안내되어 승하차 시각으로 사용하지 않고 있습니다.
-> 답변 9: 데이터 조회 시점 기준으로 제공됩니다. (예시) SUB_ACML_GTON_PPLTN_MIN : 첫차 이후, 데이터 조회시점까지 (1분 이내) 승차인원 최소값 입니다.

10. 위 두 기준년월 필드가 2026-07-27 홍대 관광특구 응답에서는 "20260727"로 반환됐습니다. YYYYMM이 아닌 8자리 값의 정확한 의미와 형식을 확인하고 싶습니다.
> 답변 10: YYYYMMDD(년월일) 입니다. 해당 기준일자는 POI 내 지하철역 갯수, 버스정류소 갯수의 기준일자 입니다.
지하철 승하차 인원수의 경우 POI 내 모든 지하철 역 승하차 합산을 의미합니다. 마찬가지로 버스 승하차 인원수 또한 POI 내 모든 버스정류소 승하차 합산치를 의미합니다.
승하차 인원수가 변동이 있을 경우, POI 내 지하철역, 버스정류장 개통, 폐쇄에 따른 영향일수 있어 참고 자료로 제공중에 있습니다.

11. LIVE_CMRCL_STTS의 결제금액·소비비율 공식 단위, 신한카드 가공 데이터의 내부 원본 보관 및 외부 서비스 표시 시 추가로 지켜야 할 이용조건이 있는지 궁금합니다.
->답변 11.
해당 라이센스는 공공누리1유형 출처표시 (상업적이용 및 변경가능) 로 활용 가능합니다.
데이터 셋 내 데이터정보-라이선스 확인가능