API cho nhà phát triển
Một API REST miễn phí, có tài liệu đầy đủ cho mã hóa địa lý thuận, mã hóa địa lý ngược, tra cứu múi giờ, độ cao cùng giờ mặt trời và mặt trăng — chính là những proxy tôn trọng quyền riêng tư mà trang này đang chạy trên đó. Không cần thẻ tín dụng; khóa được cấp ngay lập tức và chỉ hiển thị một lần.
1000 yêu cầu/ngày · 60 mỗi phút
| Điểm cuối | Chức năng | Ví dụ |
|---|---|---|
GET /api/v1/geocode | Địa chỉ / địa điểm → tọa độ (5 kết quả khớp nhất) | ?q=Eiffel+Tower |
GET /api/v1/reverse-geocode | Tọa độ → địa chỉ | ?lat=48.858&lng=2.294 |
GET /api/v1/timezone | Tọa độ → múi giờ IANA + chênh lệch UTC | ?lat=28.61&lng=77.21 |
GET /api/v1/elevation | Tọa độ → độ cao địa hình (Copernicus DEM) | ?lat=27.99&lng=86.93 |
GET /api/v1/sun-times | Mặt trời mọc, mặt trời lặn, bình minh, hoàng hôn, độ dài ngày | ?lat=51.5&lng=-0.12&date=2026-07-19 |
GET /api/v1/moon | Pha mặt trăng, độ sáng, trăng mọc/lặn | ?lat=51.5&lng=-0.12 |
Xác thực: gửi khóa qua header X-Api-Key (khuyến nghị) hoặc tham số ?key=. Mọi phản hồi đều kèm X-RateLimit-Remaining-Today. Lỗi trả về dạng JSON với mã error. Dữ liệu mã hóa địa lý © những người đóng góp OpenStreetMap (ODbL) — hãy lưu đệm kết quả thay vì truy vấn lại, và hiển thị ghi công trong ứng dụng dành cho người dùng cuối.
# 1. Mã hóa địa lý một địa chỉ
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/geocode?q=Taj+Mahal"
# 2. Mã hóa địa lý ngược
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/reverse-geocode?lat=27.1751&lng=78.0421"
# 3. Giờ mặt trời hôm nay
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/sun-times?lat=27.1751&lng=78.0421"Sử dụng hợp lý: gói miễn phí dành cho bản thử nghiệm, tác nhân AI và ứng dụng nhỏ. Cần nhiều hơn? Hãy liên hệ với chúng tôi.
API này là điểm cuối dành cho máy được công nhận của các công cụ trên trang này (cũng được công bố trong llms.txt và ai.json). Tác nhân AI được chào đón với cùng gói miễn phí — hãy nêu rõ tác nhân của bạn trong ô mục đích khi đăng ký.
Bạn có tệp CSV chứa địa chỉ (hoặc tọa độ)? công cụ mã hóa địa lý hàng loạt chạy tối đa 500 dòng qua API này ngay trong trình duyệt bằng khóa của bạn — xếp hàng lịch sự ở mức ~1 yêu cầu/giây, kết quả tải về dưới dạng CSV hoặc GeoJSON, và tệp của bạn không bao giờ chạm tới máy chủ của chúng tôi. Với khối lượng vượt vài nghìn dòng, hãy dùng dịch vụ mã hóa địa lý thương mại thay vì một dịch vụ cộng đồng miễn phí.