مرجع الواجهة البرمجية

هياكل التقاطعات

خطوط مركز الجسور والأنفاق الكاملة قرب نقطة، لعرض التقاطعات ثلاثية الأبعاد وفصل المستويات.

هياكل التقاطعات

تُعيد خطوط المركز الكاملة وغير المقطوعة للجسور والأنفاق قرب نقطة معيّنة. هذا ما يشغّل عرض التقاطع ثلاثي الأبعاد في Navvo أثناء الملاحة منعطفًا بمنعطف — جسور علوية مرتفعة على دعامات، وفتحات أنفاق غائرة — لكنه مفيد لأي تطبيق يحتاج هندسة فصل المستويات لمنطقة صغيرة.

النطاق المطلوب: geo

بلاطات الخرائط المتجهة مقطوعة لكل بلاطة، لذا لا يمكنها إلا أن تُنتج شظايا من الجسور/الأنفاق. تُعيد هذه النقطة النهائية بدلاً من ذلك كل هيكل بوصفه مسارًا واحدًا متصلاً من OSM (من فهرس هندسة Navvo المستضاف ذاتيًا)، فيُرسم الجسر العلوي كسطح واحد، ويمكن مطابقة النفق مع المسار لمعرفة أين يمر تحت الأرض بالضبط.

GET /junction/structures

تُعيد كل جسر ونفق ضمن مسافة radius بالأمتار من lat,lng.

معاملات الاستعلام

lat

number required

خط العرض (WGS84).

lng

number required

خط الطول (WGS84).

radius

integer

نصف قطر البحث بالأمتار. الافتراضي 320، محصور بين 80–800.

curl -s "https://navvo.io/api/v1/junction/structures?lat=31.98382&lng=35.89252&radius=320" \
  -H "x-api-key: nvvo_YOUR_KEY"

الاستجابة

{
  "source": "navvo-junction",
  "available": true,
  "bridges": [
    {
      "id": 150918346,
      "kind": "bridge",
      "roadClass": "secondary",
      "layer": 1,
      "name": "شارع الشهيد وصفي التل",
      "oneway": true,
      "lanes": 2,
      "coordinates": [[35.8923719, 31.9831129], [35.892758, 31.9829988], "…"]
    }
  ],
  "tunnels": []
}

الحقل	النوع	الوصف
`source`	string	دائمًا `navvo-junction`.
`available`	boolean	`false` إذا تعذّر الوصول إلى فهرس الهندسة — على التطبيقات التعامل مع ذلك بسلاسة.
`bridges` / `tunnels`	array	الهياكل من كل نوع قرب النقطة.
`…[].id`	number	معرّف مسار بيانات خرائط Navvo.
`…[].kind`	string	`bridge` أو `tunnel`.
`…[].roadClass`	string	صنف `highway` في OSM (`motorway`، `trunk`، `primary`، `secondary`، …) — استخدمه لاشتقاق عرض الطريق.
`…[].layer`	number	الترتيب الرأسي (`layer` في OSM): `>0` فوق الأرض، `<0` تحتها.
`…[].name`	string \| null	اسم الشارع إن وُجد.
`…[].oneway`	boolean	هل المسار باتجاه واحد (المسارات المزدوجة تصل كمسارين).
`…[].lanes`	number \| null	عدد الحارات إن وُسم.
`…[].coordinates`	array	خط المركز الكامل `[lng, lat]` للهيكل (مسار واحد متصل).

لرسم سطح الجسر، وسّع coordinates إلى عرض الطريق (من lanes أو roadClass) وارفعه إلى layer × ~5.5 م؛ ثم أنزل دعامات على طوله ودِعامة طرفية عند كل نهاية. وللـنفق، اقطع خط مسارك حيث يمر ضمن نصف عرض الطريق من coordinates النفق لكي يغوص المسار بوضوح داخل الفتحة ولا يُرسم تحت الأرض.

تُخزَّن الاستجابات الناجحة على الخادم لكل خلية ~120 م لمدة 24 ساعة (هندسة الجسور/الأنفاق ثابتة).

تفاصيل Geo ثلاثية الأبعاد

ميزات المباني والطرق والغطاء النباتي والبنية التحتية ثلاثية الأبعاد لمشاهد خرائط غنية.

العنونة

عنونة برموز Plus Code لمنطقة الشرق الأوسط وشمال إفريقيا — ترميز وفك ترميز وحل عناوين قابلة للمشاركة وقابلة للاشتقاق دون اتصال، بالإضافة إلى إكمال تلقائي متسامح مع الأخطاء بالعربية.