Skip to content

Latest commit

 

History

History
320 lines (298 loc) · 5.79 KB

bike.md

File metadata and controls

320 lines (298 loc) · 5.79 KB
Raw

서울시 공공자전거 (비공식)

아래에는 서울시 공공자전거 (따릉이) 대여소 안내에 대해 서술되어 있습니다.

/query

자전거 대여소를 검색합니다.

https://api.yhs.kr/bike/query

Parameter

키 설명 형태 필수 유무 기본 값 비고
name 대여소 명칭 string O

Return

{
  "data": [
    {
      "id": "ST-4",
      "name": "102. 망원역 1번출구 앞",
      "parking": 20,
      "posX": 126.91062927,
      "posY": 37.5556488,
      "rests": 24,
      "shared": 120
    }
  ],
  "lastUpdate": 0
}
  • 기본 구조
키 설명 형태 필수 유무 기본 값 비고
lastUpdate 마지막 업데이트 float X timestamp 제공
data 대여소 상황 list[QueryBikeStation] O
  • QueryBikeStation 객체
키 설명 형태 필수 유무 기본 값 비고
id 대여소 ID string O
name 대여소 명 string O
parking 최대 반납 가능한 자릿수 integer O
posX 정류장 X좌표 float O
posY 정류장 Y좌표 float O
rests 반납 가능한 자릿 수 integer O
shared 공유현황 integer O

/around

좌표 값을 기준으로 주변에 있는 자전거 대여소 정보를 불러옵니다.

https://api.yhs.kr/bus/station/around

Parameter

키 설명 형태 필수 유무 기본 값 비고
posX 경도 float O
posY 위도 float O

Return

{
  "data": [
      {
          "direction": -51,
          "distance": 64.4,
          "id": "ST-4",
          "name": "102. 망원역 1번출구 앞",
          "parking": 20,
          "posX": 126.91062927,
          "posY": 37.5556488,
          "rests": 17,
          "shared": 85
      }
  ],
  "lastUpdate": 1649434003.6246
}
  • 기본 구조
키 설명 형태 필수 유무 기본 값 비고
lastUpdate 마지막 업데이트 float X timestamp 제공
data 대여소 상황 list[AroundBikeStation] O
  • AroundBikeStation 객체
키 설명 형태 필수 유무 기본 값 비고
id 대여소 ID string O
direction 대여소 방향 integer O
distance 대여소까지 거리(m) float O
name 정류장 명 string O
parking 최대 반납 가능한 자릿수 integer O
posX 정류장 X좌표 float O
posY 정류장 Y좌표 float O
rests 반납 가능한 자릿 수 integer O
shared 공유현황 integer O