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

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

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

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

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

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

نطاق geoغير مُفعَّل افتراضيًا على المفاتيح الجديدة — اطلبه صراحةً عند إنشاء مفتاحك (scopes: { "geo": true }). راجع المصادقة.
على الرغم من مسار {z}/{x}/{y} بنمط البلاطات، تُعيد هذه النقاط النهائية مصفوفة JSON من الميزات، وليست بلاطة متجهة ثنائية. هندسة way لكل ميزة هي سلسلة WKT أُعيد إسقاطها إلى EPSG:3857 (أمتار Web Mercator) — وليست درجات خط طول/خط عرض.

GET /geo/profiles/navvo3d

الواصف الثابت لملف تعريف navvo3d: معرّفه، فئات الميزات المدعومة (queryNames)، التنسيق الافتراضي، ومصدر البيانات.

{
  "profile": "navvo3d",
  "queryNames": [
    "car", "road", "building", "building_part", "barrier", "fence",
    "tree", "scrub", "park", "green_area", "playground", "sports_pitch",
    "vineyard", "cemetery", "fountain", "street_lamp", "power_line",
    "power_pole", "power_tower", "wind_generator", "sculpture", "crane",
    "water", "aerial_line"
  ],
  "defaultFormat": "f4map-array",
  "source": "Navvo map data index for the Middle East"
}

الـ 24 قيمة في queryNames هي القيم الصالحة لمرشّح الفئة في نقاط نهاية التفاصيل.

GET /geo/details/{z}/{x}/{y}

يُعيد ميزات التفاصيل ثلاثية الأبعاد التي تتقاطع أطر إحاطتها مع بلاطة XYZ المعطاة.

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

z
integer required
مستوى تكبير البلاطة، 0–22.
x
integer required
عمود البلاطة.
y
integer required
صف البلاطة (الأصل في الشمال).

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

queryNames
string
مرشّح فئات مفصول بفواصل، مثال building,road,tree. تُسقَط الأسماء غير المعروفة؛ وإذا لم يكن أيٌّ منها صالحًا، تُعاد جميع الفئات الـ 24.
limit
integer
الحد الأقصى لصفوف الميزات. القيمة الافتراضية 4500، محصورة بين 1–15000.
balanced
boolean
عند true، يطبّق حصصًا لكل فئة بحيث لا تزاحم الفئات الكثيفة (مثل المباني) الفئات المتفرّقة.
curl -s "https://navvo.io/api/v1/geo/details/16/39102/26456?queryNames=building,road&limit=2000" \
  -H "x-api-key: nvvo_YOUR_KEY"

الاستجابة

مصفوفة JSON مسطّحة من كائنات الميزات (تنسيق f4map-array):

[
  {
    "queryName": "building",
    "osm_id": "123456789",
    "name": "City Mall",
    "building": "retail",
    "building:levels": "3",
    "height": "14",
    "roof:shape": "flat",
    "z_order": 28,
    "way": "POLYGON((3970123.4567 3760456.1234,3970150.1 3760460.5,3970155.2 3760430.9,3970123.4567 3760456.1234))",
    "queryType": "polygon"
  },
  {
    "queryName": "road",
    "osm_id": "987654321",
    "highway": "secondary",
    "name": "Zahran Street",
    "lanes": "4",
    "z_order": 35,
    "way": "LINESTRING(3969800.10 3759900.20,3969950.30 3760010.55)",
    "queryType": "line"
  }
]
الحقلالنوعالوصف
queryNamestringالفئة المطابِقة.
osm_idstringمعرّف عنصر بيانات خرائط Navvo.
(tags)scalarوسوم بيانات الخرائط المسموح بها (name, name:ar, highway, building, height, building:levels, roof:shape, …) مبسوطة ضمنيًا.
z_ordernumberترتيب العرض (الرسم).
waystringهندسة WKT بأمتار EPSG:3857 (ترتيب X Y).
queryTypestringpoint أو line أو polygon.

تعني المصفوفة الفارغة [] عدم وجود ميزات تتقاطع مع البلاطة. تضبط الاستجابات Cache-Control: public, max-age=60.

POST /geo/details/{z}/{x}/{y}

نفس طلب GET، لكن تُقدَّم الفئات في جسم JSON — مفيد لقوائم الفئات الطويلة أو الحمولات بنمط F4Map. نفس معاملات المسار؛ ويُعدّ limit وbalanced معاملي استعلام. يُعيد 201 بنفس بنية المصفوفة المطابِقة.

جسم الطلب

queryNames
array
أسماء الفئات المراد تضمينها (مُرشَّحة إلى الـ 24 الصالحة).
balanced
boolean
تفعيل الحصص لكل فئة (يُدمَج بعامل OR مع معامل الاستعلام balanced).
queries
array
بديل بنمط F4Map: إذا غاب queryNames، تؤخذ الفئات من مفاتيح كل كائن queries[].union.
{ "queryNames": ["building", "building_part", "road", "tree", "water"], "balanced": true }
هندسة way بأمتار Web Mercator (EPSG:3857). إذا كان مُصيّرك (renderer) يتوقع خط طول/خط عرض (EPSG:4326)، فأعِد الإسقاط قبل الاستخدام — أو غذِّ الأمتار مباشرةً إلى محرّك ثلاثي الأبعاد يعمل بإحداثيات عالم Web Mercator.

البحث

بحث نصّي كامل عن الأماكن في الشرق الأوسط، مع فهم الاستعلام بالذكاء الاصطناعي وترتيب يراعي المُموَّل.

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

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

Copyright © 2026