خط متعدد

حصة نهائية علنية Polyline توسيع Object

الخطوط المتعددة هي قائمة من النقاط يتم فيها رسم المقاطع الخطية بين نقاط متتالية. حاسمة للخطوط المتعددة السمات التالية:

النقاط
رؤوس الخط. يتم رسم المقاطع الخطية بين نقاط متتالية. الخطوط المتعددة هي ألا يتم إغلاقها تلقائيًا لتشكيل خط متعدد الخطوط، يجب أن تكون نقطتا البداية والنهاية الشيء نفسه.
العرض
عرض الخط بوحدات بكسل الشاشة ويكون العرض ثابتًا ومستقلاً عن عرض الكاميرا. مستوى التكبير/التصغير. القيمة التلقائية هي 10.
اللون
لون الجزء الخطي بتنسيق ARGB، وهو التنسيق نفسه المستخدَم في Color القيمة التلقائية هي الأسود (0xff000000).
البداية/النهاية
لتحديد الشكل المراد استخدامه في بداية أحد الخطوط المتعددة أو نهايتها. أنواع الأحرف الكبيرة المتوافقة: ButtCap وSquareCap وRoundCap (يسري ذلك على نمط الخط المصمت) و CustomCap (ينطبق على أي نمط سكتة). الإعدادات التلقائية لكل من البداية والنهاية: ButtCap
نوع المفصل
يحدد نوع المفصل الشكل الذي سيتم استخدامه عند ضم أجزاء الخط المجاورة على الإطلاق رؤوس الخط متعدد الخطوط باستثناء رأسي البداية والنهاية. يمكنك الاطّلاع على JointType عن أنواع المفاصل المتوافقة. القيمة التلقائية هي DEFAULT.
نمط الخط
قيمة ثابتة (تلقائية، يتم تمثيلها بـ null) أو تسلسل من عناصر PatternItem تكراره على طول الخط. أنواع PatternItem المتاحة: Gap (محددة بواسطة طول الفجوة بالبكسل) وDash (يتم تحديدها بعرض السطر وطول الشرطة بالبكسل) Dot (دائري، في منتصف الخط، القطر المحدّد بعرض الخط بالبكسل)
المؤشر Z
الترتيب الذي يتم به رسم تراكب الصور هذا بالنسبة إلى التراكبات الأخرى (بما في ذلك GroundOverlay وTileOverlay وCircle وPolygons ولكن ليس 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));

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

لمزيد من المعلومات، يُرجى الاطّلاع على مطوِّر برامج الأشكال. الدليل.

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

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

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

الطرق العامة

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

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

المعلمات
غير ذلك Object
المرتجعات
  • true إذا كان الكائنان في نفس الكائن، أي أن == other.

علنية تدخُّل دفاعي getColor ()

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

المرتجعات
  • اللون بتنسيق ARGB.

علنية الحد الأقصى getEndCap ()

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

المرتجعات
  • نوع الإعلان في نهاية الفيديو.

علنية السلسلة getId ()

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

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

علنية تدخُّل دفاعي getJointType ()

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

المرتجعات
  • نوع الوصلة.

علنية قائمة <PatternItem> getPattern ()

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

المرتجعات
  • نمط الخط.

علنية قائمة<LatLng> getPoints ()

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

علنية الحد الأقصى getStartCap ()

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

المرتجعات
  • الحد الأقصى للبدء.

علنية كائن getTag ()

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

المرتجعات
  • العلامة إذا تمّ ضبط علامة باستخدام setTag null في حال عدم ضبط أي علامة

علنية عدد عائم getWidth ()

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

المرتجعات
  • العرض ببكسل الشاشة.

علنية عدد عائم getZIndex ()

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

المرتجعات
  • مؤشر z للخط المتعدد.

علنية تدخُّل دفاعي hashCode ()

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

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

المرتجعات
  • true إذا كان الخط المتعدد قابلاً للنقر، في الحالات الأخرى، سيتم إرجاع false.

علنية منطقية isGeodesic ()

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

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

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

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

المرتجعات
  • مستوى ظهور هذه الخطوط المتعددة.

علنية فراغ إزالة ()

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

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

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

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

علنية فراغ setColor (اللون الصحيح)

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

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

علنية فراغ setEndCap (Cap endCap)

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

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

علنية فراغ setGeodesic (جيوديسية منطقية)

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

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

علنية فراغ setJointType (int sharedType)

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

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

المعلمات
jointType نوع الوصلة.

علنية فراغ setPattern (نمط القائمة<PatternItem> )

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

المعلمات
نمط نمط الخط.

علنية فراغ setPoints (قائمة<LatLng> نقطة)

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

المعلمات
نقاط قائمة من LatLng تمثل رؤوس الخطوط المتعددة.

علنية فراغ setSpans (قائمة<StyleSpan> spans)

تحدد مساحات الخطوط المتعددة.

المعلمات
يمتد

علنية فراغ setStartCap (Cap startCap)

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

المعلمات
startCap الحد الأقصى للبدء. يجب ألا يكون null.

علنية فراغ setTag (علامة الكائن)

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

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

المعلمات
علامة إذا كانت القيمة خالية، يتم محو العلامة.

علنية فراغ setVisible (قيمة منطقية مرئية)

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

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

علنية فراغ setWidth (عرض عائم)

لتعيين عرض هذا الخط المتعدد.

المعلمات
العرض العرض بوحدات بكسل الشاشة

علنية فراغ setZIndex (المؤشر z العشري)

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

المعلمات
zIndex مؤشر z لهذا الخط المتعدد.