개발자 API

정방향 지오코딩, 역지오코딩, 시간대 조회, 고도, 해와 달 시각을 제공하는 무료 REST API이며 문서도 함께 제공됩니다 — 이 사이트가 사용하는, 개인정보를 존중하는 바로 그 프록시입니다. 신용카드는 필요 없고 키는 즉시 발급되며 한 번만 표시됩니다.

1000 요청/일 · 60 분당

무료 키 받기

이름

이메일

무엇을 만들 계획인가요? (선택 사항)

표시된 코드를 입력하세요

읽기 어렵나요? 페이지를 새로 고치면 새 코드가 나옵니다. 저희 서버에서 직접 확인하므로 서드파티 캡차 서비스를 쓰지 않으며, 사용자에 관한 정보는 이 사이트를 벗어나지 않습니다.

이메일은 API의 호환성 변경이나 남용에 대해 연락할 때만 사용합니다. 뉴스레터도, 재판매도 없습니다.

엔드포인트

엔드포인트	기능	예시
`GET /api/v1/geocode`	주소 / 장소 → 좌표 (상위 5개 결과)	`?q=Eiffel+Tower`
`GET /api/v1/reverse-geocode`	좌표 → 주소	`?lat=48.858&lng=2.294`
`GET /api/v1/timezone`	좌표 → IANA 시간대 + UTC 오프셋	`?lat=28.61&lng=77.21`
`GET /api/v1/elevation`	좌표 → 지형 고도 (Copernicus DEM)	`?lat=27.99&lng=86.93`
`GET /api/v1/sun-times`	일출, 일몰, 여명, 황혼, 낮 길이	`?lat=51.5&lng=-0.12&date=2026-07-19`
`GET /api/v1/moon`	달 위상, 밝기 비율, 월출/월몰	`?lat=51.5&lng=-0.12`

인증: 키를 X-Api-Key 헤더로 보내거나(권장) ?key= 매개변수로 전달하세요. 모든 응답에는 X-RateLimit-Remaining-Today이(가) 포함됩니다. 오류는 error 코드가 담긴 JSON으로 반환됩니다. 지오코딩 데이터 © OpenStreetMap contributors (ODbL) — 같은 값을 다시 조회하지 말고 결과를 캐시하고, 최종 사용자 앱에는 출처를 표시하세요.

빠른 시작

# 1. 주소 지오코딩
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/geocode?q=Taj+Mahal"

# 2. 역지오코딩
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/reverse-geocode?lat=27.1751&lng=78.0421"

# 3. 오늘의 태양 시각
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/sun-times?lat=27.1751&lng=78.0421"

공정 사용: 무료 등급은 프로토타입, 에이전트, 소규모 앱을 위한 것입니다. 더 필요하신가요? 문의하기.

AI 에이전트용

이 API는 이 사이트 도구들의 공식 기계용 엔드포인트입니다(llms.txt 및 ai.json에도 안내되어 있습니다). 에이전트도 동일한 무료 등급으로 환영하며, 신청서의 용도 항목에 에이전트임을 밝혀 주세요.

강력한 도구: 일괄 지오코딩

주소(또는 좌표)가 담긴 CSV 파일이 있으신가요? 일괄 지오코딩 도구는 내 키를 사용해 브라우저에서 바로 최대 500행을 이 API로 처리합니다 — 초당 약 1건씩 정중하게 대기열에 넣고, 결과는 CSV 또는 GeoJSON으로 내려받을 수 있으며, 파일은 저희 서버에 전송되지 않습니다. 수천 행이 넘는 작업이라면 무료 커뮤니티 지오코더 대신 상용 지오코더를 사용하세요.