איך להשתמש ב-Nominatim (OpenStreetMap) — מדריך מעשי בעברית

אם הגעת לכאן, כנראה שאתה רוצה לראות קוד שעובד בתוך חמש דקות. זה בדיוק מה שהמדריך הזה נותן.

חמישה צעדים להתחלה

  1. 1
    שלח GET ל-nominatim.openstreetmap.org/search עם הכתובת.
  2. 2
    הוסף User-Agent header עם פרטי הפרויקט שלך (חובה).
  3. 3
    הגבל את עצמך ל-1 בקשה בשנייה.
  4. 4
    אם צריך יותר — הרם Nominatim שלך ב-Docker.

הדוגמה הכי קצרה שתעבוד אצלך

curl -H "User-Agent: my-app/1.0 (me@example.com)" \
  "https://nominatim.openstreetmap.org/search?q=Jerusalem&format=json&limit=1"

טעויות נפוצות (וואלה, באמת)

תמיד cache את התשובות — הכתובת של רחוב לא משתנה.
לפרוייקט עם >1K geocodes ביום — הרם משלך ב-Docker.