الرئيسية / البحث
البحث بالاسم
GET
/geocoder/api
إكمال تلقائي لأسماء الأماكن والشوارع في العراق بالعربي والإنجليزي. يجد التهجئة التي لم يكتبها المستخدم («مدينه» تجد «مدينة»)، وأماكن عميلك الخاصة أولاً.
الصلاحية المطلوبة على المفتاح: search
جرّب الآن
GET /geocoder/apiالطلب كـ curl
اضغط على الخريطة لترتيب النتائج حول تلك النقطة (lat/lon).
الرد كاملاً
المعاملات
| الاسم | المكان | النوع | الوصف |
|---|---|---|---|
q * |
الاستعلام | نص | نص البحث، والكلمة الناقصة تعمل. حتى 200 حرف. |
lang |
الاستعلام | ar | en | لغة النتائج. بدونها تقرّر ترويسة Accept-Language. |
limit |
الاستعلام | 1–20 | أقصى عدد للنتائج. |
lat |
الاستعلام | رقم | خط عرض لترتيب النتائج حسب القرب (موقع المستخدم أو مركز الخريطة)، مع lon. |
lon |
الاستعلام | رقم | خط الطول المقابل. |
bbox |
الاستعلام | minLon,minLat,maxLon,maxLat | النتائج داخل هذا المستطيل فقط. |
osm_tag |
الاستعلام | key:value | تصفية حسب وسم OpenStreetMap، مثل amenity:hospital، أو !highway للاستبعاد. |
layer |
الاستعلام | house | street | city … | تصفية حسب نوع النتيجة. |
الرد
- features[].geometry.coordinates
- [خط الطول, خط العرض]: خط الطول أولاً.
- features[].properties.name
- الاسم بلغة الطلب.
- features[].properties.street / district / city
- أجزاء العنوان، وأي منها قد يغيب.
- features[].properties.source
- «tenant» لأماكن عميلك الخاصة، وهي أول النتائج.
- features[].properties.osm_type + osm_id
- معرّف ثابت للنتيجة (P لأماكن العميل).
ملاحظات
- أخّر الطلب نحو 300 ms بعد آخر حرف، ولا تبحث قبل حرفين، وألغِ الطلب السابق.
- أرسل lat/lon دائماً: النتائج القريبة من المستخدم أولاً.
- الردود المتكررة تأتي من الـ cache خلال ساعة (الترويسة X-Cache: HIT).
مثال
curl -H "X-Api-Key: $KEY" \
"https://<الخادم>/geocoder/api?q=%D9%85%D8%AF%D9%8A%D9%86%D9%87%20%D8%A7%D9%84%D8%B5%D8%AF%D8%B1&lang=ar&limit=5&lat=33.3152&lon=44.3661"