سيتوفّر تصميم الخريطة الجديد قريبًا على "منصة خرائط Google". يتضمن هذا التحديث على تصميم الخريطة لوحة ألوان تلقائية جديدة وتحسينات على تجارب الخرائط وسهولة الاستخدام. سيتم تعديل جميع أنماط الخرائط تلقائيًا في آذار (مارس) 2025. للمزيد من المعلومات عن مدى التوفّر وكيفية تفعيل الميزة في وقت سابق، يُرجى الاطّلاع على نمط الخريطة الجديد في "منصة خرائط Google".

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

خط متعدد

الفئة النهائية العامة Polyline هي ميزة توسّع الكائن
.

الخط المتعدد هو قائمة من النقاط يتم فيها رسم أجزاء من الخط بين نقاط متتابعة. ويضم الخط المتعدد السمات السمات التالية:

النقاط: رؤوس الخط. يتم رسم المقاطع الخطية بين نقاط متتالية. لا يتم إغلاق الخطوط المتعددة تلقائيًا، ولكن لإنشاء خط متعدد مغلق، يجب أن تكون نقطتا البداية والنهاية متطابقتين.
العرض: عرض القطع الخطية بوحدات بكسل الشاشة يكون العرض ثابتًا ومستقلًا عن مستوى تكبير/تصغير الكاميرا. القيمة التلقائية هي 10.
اللون: لون الجزء من الخط بتنسيق ARGB، وهو التنسيق نفسه المستخدَم في Color. القيمة التلقائية هي الأسود (0xff000000).
حد أقصى البداية/النهاية: تحدد الشكل الذي سيتم استخدامه في بداية أو نهاية الخط المتعدد. أنواع الأحرف الاستهلالية المسموح بها: ButtCap وSquareCap وRoundCap (يسري ذلك على نمط الكتابة بخط اليد) وCustomCap (يسري ذلك على أي نمط للرسم). الإعداد التلقائي لكل من البداية والنهاية: ButtCap.
نوع المفصل: يحدِّد نوع الموصّل الشكل الذي يجب استخدامه عند ضم أجزاء الخط المتجاورة في جميع رؤوس الخط المتعدد باستثناء رأسَي البداية والنهاية. يُرجى الاطّلاع على JointType للتعرّف على أنواع المفاصل المتوافقة. القيمة التلقائية هي DEFAULT.
نمط الكتابة: رقم صلب (يتم تمثيله بالرمز null) أو تسلسل من عناصر PatternItem يتم تكراره على طول الخط. أنواع PatternItem المتاحة: Gap (محدّدة حسب طول الفجوة بالبكسل) وDash (محدّدة بعرض الخط وطول الشرطة بالبكسل) وDot (دائرية، في وسط الخط، ويتم تحديد القطر بعرض الخط بالبكسل).
مؤشر Z: ترتيب رسم تراكب المربّعات هذا بالنسبة إلى تراكبات أخرى (بما في ذلك GroundOverlay وTileOverlay وCircle وPolygon وs وليس Marker). يتم رسم مركّب يحتوي على مؤشر z أكبر على طبقات تحتوي على مؤشرات z أصغر. يكون ترتيب التراكبات التي لها نفس مؤشر z عشوائيًا. قيمة zIndex التلقائية هي 0.
مستوى العرض: تشير إلى ما إذا كان الخط المتعدد مرئيًا أو غير مرئي، بمعنى ما إذا كان مرسومًا على الخريطة. لا يتم رسم خط متعدد غير مرئي، ولكن يحتفظ بجميع خصائصه الأخرى. وتكون القيمة التلقائية true، أي مرئية.
الحالة الجيوديسية: يشير إلى ما إذا كان يجب رسم مقاطع الخطوط المتعددة كأشكال جيوديسية بعكس خطوط مستقيمة على إسقاط ماركتور. الجيوديسية هي أقصر مسار بين نقطتين على سطح الأرض. تم إنشاء المنحنى الجيوديسي على افتراض أنّ الأرض هي كرة
إمكانية النقر: إذا أردت معالجة الأحداث التي يتم تنشيطها عندما ينقر المستخدم على الخطوط المتعددة، اضبط هذه السمة على true. ويمكنك تغيير هذه القيمة في أي وقت. والقيمة التلقائية هي false. في حال ضبط هذه السمة على true، سيتلقّى تطبيقك إشعارات على GoogleMap.OnPolylineClickListener المسجَّلة من خلال setOnPolylineClickListener(GoogleMap.OnPolylineClickListener).
علامة: Object مرتبط بالخط المتعدد. على سبيل المثال، يمكن أن يحتوي Object على بيانات حول ما يمثّله الخط المتعدد. وهذه الطريقة أسهل من تخزين Map<Polyline, Object> منفصلة. وكمثال آخر، يمكنك ربط رقم تعريف String مطابق للرقم التعريفي من مجموعة بيانات. إنّ حزمة تطوير البرامج (SDK) في "خرائط Google" لنظام التشغيل Android لا تقرأ هذه السمة ولا تكتبها.
طيور متباعدة: تحدِّد هذه العلامة النطاقات بأنماط مختلفة تُستخدم لعرض هذا الخط المتعدد. يمكنك استخدام هذه السمة لإنشاء خط متعدد بقيم StrokeStyle مختلفة على أجزاء مختلفة من الخط المتعدد.

يجب استدعاء الطُرق في هذا الصف في سلسلة محادثات واجهة مستخدم Android. وإذا لم يكن الأمر كذلك، سيتم طرح IllegalStateException في وقت التشغيل.

مثال

GoogleMap map;
 // ... get a map.
 // Add a thin red line from London to New York.
 Polyline line = map.addPolyline(new PolylineOptions()
     .add(new LatLng(51.5, -0.1), new LatLng(40.7, -74.0))
     .width(5)
     .color(Color.RED));

دليل المطوِّر

للحصول على مزيد من المعلومات، يُرجى قراءة دليل مطوِّر الأشكال.

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

boolean	يساوي(كائن آخر) لاختبار ما إذا كانت قيمة `Polyline` تساوي قيمة أخرى.
int	getColor() الحصول على لون هذا الخطوط المتعددة
الحد الأقصى	getEndCap() نحصل على الحدّ الأقصى في نهاية هذا الخط المتعدد.
سلسلة	getId() للحصول على معرّف هذا الخط المتعدد
int	getJointType() للحصول على نوع المفصل المُستخدَم عند جميع رؤوس الخط المتعدد، ما عدا رأسي البداية والنهاية.
List<PatternItem>	getPattern() نحصل على نمط الخط لهذا الخط المتعدد.
List<LatLng>	getPoints() تعرض لقطة لرؤوس هذا الخط المتعدد في الوقت الحالي .
الحد الأقصى	getStartCap() نحصل على الحدّ الأقصى في رأس بداية هذا الخط المتعدد.
الكائن	getTag() تحصل على علامة الخط المتعدد.
float	getWidth() نحصل على عرض هذا الخط المتعدد.
float	getZIndex() للحصول على قيمة zIndex لهذا الخطوط المتعددة،
int	hashCode()
boolean	isClickable() للحصول على إمكانية النقر على الخطوط المتعددة.
boolean	isGeodesic() يمكنك معرفة ما إذا كان كل جزء من الخط مرسومًا جيوديسيًا أم لا.
boolean	isVisible() يتيح الحصول على إمكانية رؤية هذا الخط المتعدد.
void	remove() لإزالة هذا الخط المتعدد الأبعاد من الخريطة.
void	setClickable(منطقية قابلة للنقر) لضبط إمكانية النقر على الخطوط المتعددة.
void	setColor(لون طبيعي) لضبط لون هذا الخط المتعدد
void	setEndCap(Cap endCap) لضبط الحد الأقصى للرأس في نهاية هذا الخط المتعدد
void	setGeodesic(جيوديسيك منطقية) لتعيين ما إذا كان سيتم رسم كل جزء من الخط كجيوديسية أم لا.
void	setJointType(int JointType) لضبط نوع المفصل على جميع رؤوس الخط المتعدد باستثناء رأسي البداية والنهاية.
void	setPattern(List<PatternItem> النمط) لضبط نمط شطب الخطوط المتعددة.
void	setPoints(قائمة<LatLng> نقاط) تُستخدم في تعيين نقاط هذا الخط المتعدد.
void	setSpans(List<StyleSpan> spans) لتعيين امتدادات الخطوط المتعددة.
void	setStartCap(Cap startCap) لضبط الحد الأقصى عند رأس بداية هذا الخط المتعدد.
void	setTag(علامة الكائن) لضبط علامة الخط المتعدد
void	setVisible(مرئية منطقية) تحدِّد هذه السياسة مستوى رؤية هذا الخط المتعدد.
void	setWidth(عرض عائم) لضبط عرض هذا الخط المتعدد
void	setZIndex(قيمة عائمة لمؤشر zIndex) لضبط zIndex لهذا الخط المتعدد

ملخّص الطريقة المكتسبة

من الفئة java.lang.Object

boolean	equals(كائن arg0)
الفئة النهائية<?>	getClass()
int	hashCode()
الفراغ الأخير	notify()
الفراغ الأخير	notifyAll()
سلسلة	toString()
الفراغ الأخير	انتظار(long arg0, int arg1)
الفراغ الأخير	انتظار(طول طويل arg0)
الفراغ الأخير	نحن()

الطرق العامة

منطقية عامة يساوي (كائن آخر)

لاختبار ما إذا كانت قيمة Polyline تساوي قيمة أخرى.

المَعلمات

غير ذلك	`Object`.

المرتجعات

true إذا كان كلا الكائنين نفس الكائن، أي أن == other.

public int getColor ()

الحصول على لون هذا الخطوط المتعددة

المرتجعات

اللون بتنسيق ARGB.

public Cap getEndCap ()

نحصل على الحدّ الأقصى في نهاية هذا الخط المتعدد.

المرتجعات

ونوع الإعلان في نهاية الفيديو.

public سلسلة getId ()

للحصول على معرّف هذا الخط المتعدد سيكون المعرّف فريدًا بين جميع الخطوط المتعددة على الخريطة.

المرتجعات

معرف الخط المتعدد هذا.

public int getJointType ()

للحصول على نوع المفصل المُستخدَم عند جميع رؤوس الخط المتعدد، ما عدا رأسي البداية والنهاية. راجِع JointType للتعرّف على القيم المحتمَلة.

المرتجعات

نوع المفصل.

public List<PatternItem> getPattern ()

نحصل على نمط الخط لهذا الخط المتعدد.

المرتجعات

نمط الخط.

public List<LatLng> getPoints ()

تعرض لقطة لرؤوس هذا الخط المتعدد في الوقت الحالي . والقائمة التي يتم عرضها هي نسخة من قائمة رؤوس الخطوط المتعددة، ولذلك لن تنعكس التغييرات التي تطرأ على رؤوس الخطوط المتعددة في هذه القائمة، ولن يظهر في الخط المتعدد التغييرات التي تدخل على هذه القائمة. لتغيير رؤوس الخطوط المتعددة، يجب طلب الرقم setPoints(List).

public Cap getStartCap ()

نحصل على الحدّ الأقصى في رأس بداية هذا الخط المتعدد.

المرتجعات

حرف البدء.

public Object getTag ()

تحصل على علامة الخط المتعدد.

المرتجعات

العلامة في حال ضبط العلامة باستخدام setTag، وnull في حال عدم ضبط أي علامة.

public float getWidth ()

نحصل على عرض هذا الخط المتعدد.

المرتجعات

العرض ببكسل الشاشة.

عدد عائم getZIndex ()

للحصول على قيمة zIndex لهذا الخطوط المتعددة،

المرتجعات

zIndex للخطوط المتعددة.

public int hashCode ()

عامة منطقية isClickable ()

للحصول على إمكانية النقر على الخطوط المتعددة. إذا كان الخط المتعدد قابلاً للنقر، سيتلقى تطبيقك إشعارات إلى GoogleMap.OnPolylineClickListener عندما ينقر المستخدم على الخط المتعدد. تم تسجيل أداة معالجة الحدث من خلال setOnPolylineClickListener(GoogleMap.OnPolylineClickListener).

المرتجعات

true إذا كان الخط المتعدد قابلاً للنقر، وإلا سيتم عرض false.

public منطقي isGeodesic ()

يمكنك معرفة ما إذا كان كل جزء من الخط مرسومًا جيوديسيًا أم لا.

المرتجعات

true إذا تم رسم كل جزء على شكل جيوديسي، وfalse إذا تم رسم كل جزء كخط مستقيم على إسقاط ماركاتور.

عامة منطقية isVisible ()

يتيح الحصول على إمكانية رؤية هذا الخط المتعدد.

المرتجعات

رؤية هذه الخطوط المتعددة.

إلغاء عام إزالة ()

لإزالة هذا الخط المتعدد الأبعاد من الخريطة. بعد إزالة الخطوط المتعددة، يصبح سلوك كل طرقها غير معروف.

إلغاء علني setClickable (قيمة منطقية قابلة للنقر)

لضبط إمكانية النقر على الخطوط المتعددة. إذا كان الخط المتعدد قابلاً للنقر، سيتلقى تطبيقك إشعارات إلى GoogleMap.OnPolylineClickListener عندما ينقر المستخدم على الخط المتعدد. تم تسجيل أداة معالجة الحدث من خلال setOnPolylineClickListener(GoogleMap.OnPolylineClickListener).

المَعلمات

قابل للنقر عليه	إعداد جديد لقابلية النقر للخطوط المتعددة.

فارغ عام setColor (int color)

لضبط لون هذا الخط المتعدد

المَعلمات

لون	اللون بتنسيق ARGB

إلغاء عام setEndCap (Cap endCap)

لضبط الحد الأقصى للرأس في نهاية هذا الخط المتعدد الإعلان النهائي التلقائي هو ButtCap.

المَعلمات

endCap	الإعلان في نهاية الفيديو، ولا يجب أن يكون `null`.

فراغ عام setGeodesic (boolean geodesic)

لتعيين ما إذا كان سيتم رسم كل جزء من الخط كجيوديسية أم لا.

المَعلمات

جيوديسك	إذا كانت قيمة `true`، سيتم رسم كل جزء على شكل جيوديسي. وإذا كانت قيمة `false`، سيتم رسم كل جزء كخط مستقيم على إسقاط ماركتور.

إلغاء عام setJointType (int jointType)

لضبط نوع المفصل على جميع رؤوس الخط المتعدد باستثناء رأسي البداية والنهاية.

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

المَعلمات

jointType	نوع المفصل.

إلغاء عام setPattern (List<PatternItem> style)

لضبط نمط شطب الخطوط المتعددة. نمط الخط التلقائي هو نمط ثابت، ويتم تمثيله بالرمز null.

المَعلمات

التصميم	نمط الخط.

إلغاء عام setPoints (List<LatLng> Points)

تُستخدم في تعيين نقاط هذا الخط المتعدد. ستستهلك هذه الطريقة نسخة من النقاط، وبالتالي لن تؤثر أي تغييرات إضافية على points في هذا الخط المتعدد.

المَعلمات

نقاط	قائمة `LatLng`s التي تُمثل قمم الخط المتعدد.

إلغاء عام setSpans (List<StyleSpan> spans)

لتعيين امتدادات الخطوط المتعددة.

المَعلمات

يمتدّ

إلغاء عام setStartCap (Cap startCap)

لضبط الحد الأقصى عند رأس بداية هذا الخط المتعدد. الحد الأقصى التلقائي لعدد المستخدمين هو ButtCap.

المَعلمات

startCap	حرف البدء، أي يجب ألا يكون `null`

إلغاء عام setTag (علامة الكائن)

لضبط علامة الخط المتعدد

يمكنك استخدام هذه السمة لربط Object عشوائي بهذا الخط المتعدد. على سبيل المثال، يمكن أن يحتوي Object على بيانات حول ما يمثّله الخط المتعدد. وهذه الطريقة أسهل من تخزين Map<Polyline, Object> منفصلة. وكمثال آخر، يمكنك ربط رقم تعريف String متوافق مع المعرّف من مجموعة بيانات. إنّ حزمة تطوير البرامج (SDK) في "خرائط Google" لنظام التشغيل Android لا تقرأ هذه السمة ولا تكتبها. تقع على عاتقك مسؤولية طلب الرقم setTag(null) لمحو العلامة عند الاستغناء عنها، وذلك لمنع تسرُّب الذاكرة في تطبيقك.

المَعلمات

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

فراغ علني setVisible (boolean visible)

تحدِّد هذه السياسة مستوى رؤية هذا الخط المتعدد. عندما لا يتم رسم خط متعدد، لا يتم رسمه، ولكنه يحتفظ بجميع خصائصه الأخرى.

المَعلمات

مرئي	إذا كانت القيمة `true`، يكون الخط المتعدد مرئيًا، أمّا إذا كان `false`، فلا يكون مرئيًا.

فارغ عام setWidth (float width)

لضبط عرض هذا الخط المتعدد

المَعلمات

width	العرض ببكسل الشاشة

إلغاء علني setZIndex (float zIndex)

لضبط zIndex لهذا الخط المتعدد يتم رسم الخطوط المتعددة ذات المؤشرات الأعلى من حيث عدد المؤشرات فوق الخطوط ذات المؤشرات المنخفضة.

المَعلمات

zIndex	zIndex لهذا الخط المتعدد.