البدء

مقدمة

ما هي واجهة Navvo البرمجية، ولمن هي موجّهة، وما الذي يمكنك بناؤه بها.

مقدمة

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

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

عنوان URL الأساسي — كل نقطة نهاية تقع تحت:

https://navvo.io/api/v1

ما الذي يمكنك بناؤه

خرائط في تطبيقك

خريطة أساس Navvo Maps كاملة — بلاطات متجهة ونقطية، وأنماط فاتحة/داكنة/قمر صناعي، وطبقات تراكب — مُقدَّمة من المصدر الأول من Navvo.

محدِّدات المتاجر والأماكن

ابحث عن الأماكن، واعرض تفاصيل غنية (ساعات العمل، الصور، التقييمات)، ووجّه المستخدمين إلى المدخل الصحيح.

الاتجاهات وأوقات الوصول المتوقّعة

توجيه خطوة بخطوة، ومصفوفات أوقات السفر، وأوقات وصول متوقّعة معدّلة وفقًا لحركة مرور حيّة مصدرها Navvo.

الأساطيل والخدمات اللوجستية

حسِّن المسارات متعددة التوقّفات، وقيّم مخاطر المسار، وساهم ببيانات استكشاف مجهولة المصدر لتحسين حركة المرور.

نظرة سريعة على الواجهة البرمجية

المجال	النطاق	ما الذي يفعله
البحث	`search`	بحث نصّي كامل عن الأماكن في الشرق الأوسط.
الترميز الجغرافي	`geocode`	ترميز جغرافي أمامي وعكسي (عنوان ⇄ إحداثيات).
الأماكن	`places`	قوائم الأماكن وتفاصيلها الغنية، بما في ذلك إرشادات الوصول.
التوجيه	`routing`	الاتجاهات، المصفوفة، خطوط الزمن المتساوي، مطابقة الخريطة، التحسين.
حركة المرور والحوادث	`traffic`	الازدحام الحيّ/النمطي، أوقات الوصول المراعية لحركة المرور، حوادث المستخدمين.
القياسات	`telemetry`	إرسال رحلات مجهولة المصدر؛ قراءة بيانات حركة المرور المجمّعة.
بلاطات الخرائط والأنماط	`tiles`	أنماط Navvo Maps، البلاطات المتجهة/النقطية، المحارف، الرموز المصوّرة.
بيانات الخريطة والمخاطر	`tiles` / `routing`	إعدادات الخريطة، طبقات التراكب، الطقس، وتقييم مخاطر المسار.
الصور	`imagery`	صور الشوارع وملامح الطرق.
تفاصيل Geo ثلاثية الأبعاد	`geo`	ملامح المباني/الطرق/الغطاء النباتي ثلاثية الأبعاد لمشاهد الخريطة.

كيف يعمل

احصل على مفتاح API. أنشئ مؤسسة، ومشروعًا، ومفتاح API في بوابة مطوّري Navvo. راجع المصادقة.
أرسل مفتاحك مع كل طلب عبر ترويسة x-api-key (أو معامل الاستعلام api_key لعناوين URL الخاصة بالخرائط).
استدعِ نقطة النهاية التي تحتاجها. يحمل كل مفتاح نطاقات تمنح الوصول إلى مجالات محدّدة.

هل أنت جديد على الواجهة البرمجية؟ انتقل مباشرةً إلى البدء السريع ونفّذ أول استدعاء لك خلال دقائق قليلة.

التغطية ومصادر البيانات

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

يُلزَم ذكر المصدر عند عرض بلاطات خرائط Navvo أو الصور أو البيانات المشتقّة منها — راجع المواصفات.

البدء السريع

احصل على مفتاح API ونفّذ أول استدعاء لواجهة Navvo البرمجية خلال دقائق قليلة.