ما هي واجهة Overpass API؟

OpenStreetMap خريطة مجانية للعالم يرسمها متطوعون. وإلى جانب الطرق والمباني، تضم ملايين المتاجر والمقاهي والمقاعد وأجهزة إزالة الرجفان ونوافير مياه الشرب، ويُوصف كل منها بوسوم مثل amenity=cafe أو shop=bakery. واجهة Overpass API خدمة بحث للقراءة فقط لهذه البيانات: تطلب كل ما يحمل وسمًا معينًا في منطقة ما، فتعيد إليك الأماكن المطابقة وأسماءها وعناوينها وساعات عملها.

تدير عدة مجموعات خوادم Overpass عامة ومجانية. وهي مشتركة بين الجميع، لذا قد يكون أحدها بطيئًا في أوقات الذروة أو يرفض الطلبات، بينما يستجيب خادم آخر على الفور.

وصف الأداة

حرّك الخريطة وقرّبها أو أبعدها لتحديد المنطقة التي تريد البحث فيها، ثم اختر ما تريد العثور عليه: فئة مثل الصيدليات أو دورات المياه العامة، أو وسم OSM مخصص، أو أي شيء مع تحديد اسم. يمكنك أيضًا تضييق نطاق أي فئة باستخدام الاسم، مثل البحث عن المتاجر الكبرى التي يحتوي اسمها على Lidl. اضغط على «البحث في المنطقة المعروضة على الخريطة» للبحث ضمن المنطقة الظاهرة فيها. ينقلك الزر الموجود أسفل أزرار التكبير على الخريطة إلى موقعك.

تظهر الأماكن على الخريطة كنقاط، وفي جدول أسفل إعدادات البحث، مع اسم كل مكان ووسمه وعنوانه. انقر على نقطة أو صف في الجدول للاطلاع أيضًا على ساعات العمل والموقع الإلكتروني للمكان، مع رابط لفتحه على OpenStreetMap. يمكنك ترتيب الجدول حسب أي عمود وحفظ النتائج بصيغة CSV أو JSON.

تختار الأداة الخادم تلقائيًا بشكل افتراضي: داخل أوروبا، تستعلم من خادم يحتفظ بالبيانات الأوروبية فقط، ويكون أقل ازدحامًا في كثير من الأحيان. وفي سائر المناطق، تنتقل إلى الخادم التالي عندما يكون أحدها مشغولًا، كما تستعلم من الخادم التالي إذا كان أحد الخوادم بطيئًا في الاستجابة. ويمكنك أيضًا اختيار خادم بنفسك. يوضح سطر الحالة الخادم الذي استجاب ومدى حداثة نسخته من بيانات الخريطة.

ينتقل بحثك مباشرةً من متصفحك إلى خادم Overpass: يستقبل الخادم المنطقة وما بحثت عنه، ولا يمر أي شيء عبر خادمنا.

الميزات

  • البحث في المنطقة المعروضة على خريطة OpenStreetMap، مع إمكانية الوصول إلى موقعك بنقرة واحدة
  • فئات للاستخدام اليومي، وأي وسم من OSM، والبحث حسب الاسم
  • خوادم Overpass عامة ومجانية لا تتطلب مفتاح API، مع الانتقال تلقائيًا إلى خادم آخر عند انشغال أحدها
  • عرض النتائج على الخريطة وفي جدول قابل للترتيب بجانبها، مع الأسماء والوسوم والعناوين
  • نوافذ منبثقة تعرض ساعات العمل والموقع الإلكتروني ورابطًا إلى المكان على OpenStreetMap
  • تصدير النتائج بصيغة CSV أو JSON

نصائح

  • ابحث عن بلدة أو حي بدلًا من منطقة كاملة؛ فالمناطق الأصغر تعطي نتائج أسرع وتبقى ضمن الحدود التي تسمح بها الخوادم العامة.
  • للبحث باستخدام وسم مخصص، ابحث عن المفتاح والقيمة في قائمة معالم الخريطة على ويكي OpenStreetMap. ويؤدي استخدام مفتاح وحده، مثل wheelchair أو opening_hours، إلى العثور على كل ما يحمل هذا المفتاح، أيًا كانت قيمته.
  • لا يراعي البحث حالة الأحرف، ويطابق الاسم أينما وردت الكلمة فيه؛ لذا فإن bank يعثر أيضًا على «Swedbank» و«بنك أيرلندا».
  • إذا استمر فشل الاختيار التلقائي، فقد تكون جميع الخوادم مشغولة في الوقت نفسه. انتظر دقيقة ثم حاول مجددًا، أو اختر خادمًا بنفسك.
  • لا يمكن العثور هنا على الأماكن غير المسجلة في OpenStreetMap. ويمكنك إضافة متجر أو مقعد غير مُدرج بنفسك على openstreetmap.org.