خريطة التنقّل

الواجهة العامة NavigationMap

توفر طرقًا لتعديل محتوى خريطة التنقل، مثل إضافة العلامات وإزالتها.

يجب الوصول إلى جميع الطرق في سلسلة محادثات واجهة مستخدم Android فقط.

ملخص الفئة المدمَجة

واحدة	NavigationMap.OnMapClickListener		واجهة معاودة الاتصال لاستخدامها عندما ينقر المستخدم على الخريطة
واحدة	NavigationMap.OnMarkerClickListener		يحدد التوقيعات للطرق التي يتم استدعاؤها عند النقر على علامة أو النقر عليها.

ملخّص الطريقة العلنية

تجريدي علامة	addMarker(MarkerOptions markerOptions) إضافة علامة واحدة إلى الخريطة.
تجريدي توقع	getProjection() تعرض عنصر Projection يمكنك استخدامه للتحويل بين إحداثيات الشاشة وإحداثيات خطوط العرض/الطول.
تجريدي باطلة	removeAllMarkers() إزالة جميع العلامات على الخريطة حاليًا.
تجريدي باطلة	removeMarker(علامة Marker) إزالة العلامة المحددة من الخريطة.
تجريدي باطلة	setOnMapClickListener(NavigationMap.OnMapClickListener مستمع) لضبط معاودة الاتصال التي يتم استدعاؤها عند النقر على الخريطة.
تجريدي باطلة	setOnMarkerClickListener(NavigationMap.OnMarkerClickListener مستمع) لضبط معاودة الاتصال التي يتم استدعاؤها عند النقر على علامة.
تجريدي باطلة	setPadding(int left, int top, int right, int below) لتعيين المساحة المتروكة لعناصر واجهة المستخدم داخل منطقة الخريطة بالبكسل.
تجريدي باطلة	setTrafficEnabled(تفعيل منطقي) لتحديد ما إذا كان سيتم عرض معلومات حركة المرور أم لا.

الطرق العامة

عامة ملخص علامة addMarker (MarkerOptions markerOptions)

إضافة علامة واحدة إلى الخريطة.

المَعلمات

markerOptions	تمثّل هذه السمة MarkerOptions التي تحدد خصائص العلامة مثل الموضع. سيتم نسخ الخيارات إلى العلامة وستكون آمنة لإعادة استخدامها.

المرتجعات

• كائن يمثل العلامة

علني تجريدي عرض getProjection ()

تعرض عنصر Projection يمكنك استخدامه للتحويل بين إحداثيات الشاشة وإحداثيات خطوط العرض/الطول.

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

المرتجعات

• تمثّل هذه السمة Projection للخريطة في حالتها الحالية أو null إذا لم يتم إعداد الخريطة بالكامل.

عام ملخص لاغٍ removeAllMarkers ()

إزالة جميع العلامات على الخريطة حاليًا.

عامة علامة ملخصة لاغية removeMarker (علامة علامة)

إزالة العلامة المحددة من الخريطة.

المَعلمات

مُحدِد موقع	العلامة المطلوب إزالتها

متاح للجميع محتوى تجريدي فارغ setOnMapClickListener (NavigationMap.OnMapClickListener مستمع)

لضبط معاودة الاتصال التي يتم استدعاؤها عند النقر على الخريطة.

المَعلمات

أداة معالجة الحدث	معاودة الاتصال الذي يتم استدعاؤه عند النقر على الخريطة. لإلغاء ضبط معاودة الاتصال، استخدِم null.

عام ملخص لاغ setOnMarkerClickListener (NavigationMap.OnMarkerClickListener مستمع)

لضبط معاودة الاتصال التي يتم استدعاؤها عند النقر على علامة.

المَعلمات

أداة معالجة الحدث	معاودة الاتصال الذي يتم استدعاؤه عند النقر على علامة. لإلغاء ضبط معاودة الاتصال، استخدِم null.

علني محتوى تجريدي فارغ setPadding (int left, int top, int right, int below)

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

ملاحظة: لا يتم تطبيق قيمة المساحة المتروكة العلوية إلا عند إيقاف العنوان (راجِع setHeaderEnabled(boolean))، ولا يتم تطبيق المساحة المتروكة السفلية إلا عند إيقاف بطاقة الوقت المقدّر للوصول (راجِع setEtaCardEnabled(boolean)). ويتم تطبيق قيم المساحة المتروكة اليمنى واليسرى في جميع الأوقات.

المَعلمات

لليسار
النصف العلوي
لليمين
النصف السفلي

عام ملخص لاغٍ setTrafficEnabled (boolean enabled)

لتحديد ما إذا كان سيتم عرض معلومات حركة المرور أم لا.

المَعلمات

مفعّلة	إذا كانت القيمة صحيحة، سيتم عرض معلومات حركة المرور.