API למפתחים

API חינמי ומתועד בסגנון REST ל-Geocoding קדימה, Geocoding הפוך, איתור אזור זמן, גובה וזמני שמש וירח — אותם שרתי מתווך שומרי פרטיות שעליהם רץ האתר הזה. בלי כרטיס אשראי; המפתח מונפק מיד ומוצג פעם אחת בלבד.

1000 בקשות/יום · 60 לדקה

קבלו מפתח חינמי

שם

אימייל

מה תבנו? (אופציונלי)

הקלידו את הקוד המוצג

לא קריא? רעננו את העמוד לקוד חדש. האימות נעשה בשרת שלנו — ללא שירות captcha של צד שלישי, שום מידע עליכם לא יוצא מהאתר.

אנחנו משתמשים באימייל שלכם רק כדי ליצור קשר בנוגע לשינויים שוברים ב-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. שגיאות מוחזרות כ-JSON עם קוד error. נתוני ה-Geocoding © תורמי OpenStreetMap (ODbL) — שמרו את התוצאות במטמון במקום לשאול שוב, והציגו קרדיט באפליקציות למשתמשי קצה.

התחלה מהירה

# 1. מציאת קואורדינטות לכתובת
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/geocode?q=Taj+Mahal"

# 2. Geocoding הפוך
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). סוכנים מוזמנים להשתמש באותו מסלול חינמי — ציינו את זהות הסוכן בשדה המטרה בהרשמה.

כלי עוצמתי: Geocoding קבוצתי

יש לכם CSV של כתובות (או קואורדינטות)? כלי ה-Geocoding הקבוצתי מריץ עד 500 שורות דרך ה-API הזה ישירות בדפדפן שלכם עם המפתח שלכם — בתור מנומס של בקשה אחת בשנייה בערך, התוצאות ניתנות להורדה כ-CSV או GeoJSON, והקובץ שלכם לעולם לא מגיע לשרת שלנו. לעבודות של יותר מכמה אלפי שורות, השתמשו בשירות geocoding מסחרי ולא בשירות קהילתי חינמי.