무료 위성 위치 API
어떤 위성이든 지금 어디 있는지 JSON으로 받아 보세요. 가입도 키도 필요 없어요. 동호회 페이지, 수업 과제, 라즈베리파이 화면, 직접 만드는 추적기에 쓰면 돼요.
주소
GET https://orbitnight.com/api/v1/satellites/{id}/position매개변수
- id: NORAD 번호 (ISS는 25544).
- lat, lon (선택): 내 위치(도). 넣으면 내 하늘에서 위성이 어디 있는지(방위각·고도각·거리)도 같이 알려 줘요.
응답 예시
https://orbitnight.com/api/v1/satellites/25544/position?lat=37.57&lon=126.98
{
"noradId": "25544",
"name": "ISS (ZARYA)",
"timestamp": "2026-11-20T14:00:00.000Z",
"latitude": 21.4127,
"longitude": 143.0981,
"altitudeKm": 418.62,
"velocityKmS": 7.664,
"sunlit": true,
"observer": {
"latitude": 37.57,
"longitude": 126.98,
"azimuthDeg": 141.35,
"elevationDeg": 3.18,
"rangeKm": 2091.4
},
"page": "https://orbitnight.com/satellite/25544",
"attribution": "OrbitNight (https://orbitnight.com). Orbital data: US Space Force via Space-Track.org"
}제한
- 네트워크마다 1분에 60번까지예요. 몇 초마다 새로 받아도 괜찮아요.
- 위치는 미 우주군 궤도 자료(1시간마다 갱신)로 SGP4 계산해요.
- 오류는 JSON 오류 코드로 와요: invalid_id, not_found, not_in_orbit, rate_limited, unavailable.
출처를 밝혀 주세요
공개 페이지에 쓰신다면 https://orbitnight.com 링크를 보이게 달아 주세요. 그래야 API를 계속 무료로 둘 수 있어요.
위젯을 붙이는 게 더 편하다면
위성 페이지마다 실시간 지구본 위젯이 있어요. 코드를 복사해 어느 사이트에나 붙이면 되고, 우리 동네 다음 통과 시각도 보여 줘요. 예시: ISS (ZARYA) →