API توسعه‌دهندگان

یک API رایگان و مستندشدهٔ REST برای ژئوکدینگ مستقیم، ژئوکدینگ معکوس، یافتن منطقهٔ زمانی، ارتفاع و زمان‌های خورشید و ماه — همان پروکسی‌های محترم به حریم خصوصی که این سایت روی آن‌ها کار می‌کند. بدون کارت بانکی؛ کلید فوراً صادر و فقط یک‌بار نمایش داده می‌شود.

1000 درخواست در روز · 60 در دقیقه

کلید رایگان خود را بگیرید

نام

ایمیل

چه چیزی می‌سازید؟ (اختیاری)

کد نمایش‌داده‌شده را بنویسید

خوانا نیست؟ صفحه را دوباره بارگذاری کنید تا کد تازه‌ای بگیرید. روی سرور خودمان بررسی می‌شود — بدون سرویس کپچای شخص‌ثالث و هیچ اطلاعاتی از شما این سایت را ترک نمی‌کند.

از ایمیل شما فقط برای اطلاع‌رسانی دربارهٔ تغییرات ناسازگار API یا سوءاستفاده استفاده می‌کنیم. بدون خبرنامه، بدون فروش.

نقاط پایانی

نقطه پایانی	چه می‌کند	نمونه
`GET /api/v1/geocode`	نشانی / مکان → مختصات (۵ تطابق برتر)	`?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 است. خطاها JSON با کد error هستند. دادهٔ ژئوکدینگ © مشارکت‌کنندگان OpenStreetMap (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"

استفادهٔ منصفانه: سطح رایگان برای نمونه‌های اولیه، عامل‌ها و برنامه‌های کوچک است. بیشتر می‌خواهید؟ با ما تماس بگیرید.

برای عامل‌های هوش مصنوعی

این API نقطهٔ پایانی ماشینیِ رسمی برای ابزارهای این سایت است (که در llms.txt و ai.json هم اعلام شده است). عامل‌ها با همان سطح رایگان خوش‌آمدند — در فیلد هدفِ ثبت‌نام، عامل خود را معرفی کنید.

ابزار قدرتمند: ژئوکدینگ دسته‌ای

یک CSV از نشانی‌ها (یا مختصات) دارید؟ ابزار ژئوکدینگ دسته‌ای تا ۵۰۰ ردیف را با کلید شما و درست در مرورگرتان از این API عبور می‌دهد — با نرخ ملایمِ حدود ۱ درخواست در ثانیه صف‌بندی می‌شود، نتایج به‌صورت CSV یا GeoJSON قابل دانلود است و فایل شما هرگز به سرور ما نمی‌رسد. برای کارهای بیش از چند هزار ردیف، به‌جای یک ژئوکدر رایگانِ اجتماعی از یک ژئوکدر تجاری استفاده کنید.