تراكب الأجزاء

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

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

مزوِّد المربّعات
يعرض TileProvider الصور المستخدمة في تراكب الصور. يجب تحديد موفر المربع قبل إضافته إلى الخريطة. لا يمكن إيقاف موفِّر المربّع يتم تغييره بمجرد إضافته؛ ومع ذلك، يمكنك تعديل سلوك موفِّر المربّعات. لعرض صور مختلفة لإحداثيات محددة. إذا كانت المربّعات التي توفّرها المربّع بتغيير مقدم الخدمة، فيجب عليك الاتصال بـ clearTileCache() بعد ذلك للتأكد من لن يتم عرض المربعات السابقة بعد الآن.
المؤشر Z
الترتيب الذي يتم به رسم تراكب الصور هذا بالنسبة إلى التراكبات الأخرى (بما في ذلك GroundOverlay وCircle وPolyline وPolygons ولكن ليس Marker). يتم رسم تراكب به مؤشر z أكبر فوق تراكبات ذات حجم أصغر مؤشرات z. يكون ترتيب التراكبات مع فهرس z نفسه عشوائيًا. قيمة zIndex الافتراضية هي 0.
الشفافية
شفافية تراكب الصور في النطاق [0..1] حيث تعني 0 يكون التراكب معتمًا ويعني 1 أن التراكب شفاف بالكامل. إذا تم تحديد الصورة النقطية شفافة جزئيًا بالفعل، فسيتم قياس شفافية كل بكسل وفقًا لذلك (على سبيل المثال، إذا كانت قيمة ألفا للبكسل في الصورة النقطية 200 تحديد شفافية تراكب الصور على 0.25، فسيتم عرض البكسل على الشاشة بقيمة ألفا 150). تعتبر مواصفات هذه الخاصية اختيارية قيمة الشفافية التلقائية هي 0 (قيمة فارغة).
مستوى الرؤية
: يشير هذا الرمز إلى ما إذا كان تراكب المربّعات مرئيًا أو غير مرئي، بمعنى ما إذا كان مرسومًا على الخريطة. لا يتم رسم تراكب متجانب غير مرئي، ولكنه يحتفظ بكل خصائصه الأخرى. تشير رسالة الأشكال البيانية القيمة التلقائية هي true، أي مرئية.

يجب عدم استدعاء الطرق المتاحة في هذه الفئة إلا في سلسلة المحادثات الرئيسية. وسيؤدي عدم الالتزام بذلك إلى IllegalStateException

إحداثيات المربّعات

لاحظ أن العالم يتم توقعه باستخدام إسقاط ماركتور (راجع ويكيبيديا) والجانب الأيسر (الغربي) من الخريطة بما يتوافق مع -180 درجة من خط الطول والجانب الأيمن (الشرقي) من الخريطة بما يتوافق مع 180 درجة من خط الطول. لجعل الخريطة مربعة، يكون الجانب العلوي (الشمالي) من الخريطة مع 85.0511 درجة من خط العرض ويتجاوب الجانب السفلي (الجنوبي) من الخريطة إلى -85.0511 درجة من خط العرض. لا يتم عرض المناطق خارج نطاق خط العرض هذا.

في كل مستوى من مستويات التكبير، يتم تقسيم الخريطة إلى مربّعات ولا تظهر إلا على المربّعات التي تتداخل مع الشاشة. وعرضها. يكون كل مربع مربعًا ويتم تقسيم الخريطة إلى مربّعات على النحو التالي:

  • عند مستوى التكبير/التصغير 0، يمثل مربع واحد العالم بكامله. إحداثيات هذا المربع هي (x، ص) = (0، 0).
  • في مستوى التكبير/التصغير 1، ينقسم العالم إلى 4 مربعات تم ترتيبها في شبكة 2 × 2.
  • ...
  • عند مستوى التكبير/التصغير N، ينقسم العالم إلى 4N مربّعات يتم ترتيبها في 2N. × شبكة N طولها 2.
يُرجى مراعاة الحد الأدنى لمستوى التكبير/التصغير الذي تدعمه الكاميرا (والذي قد يعتمد على عوامل مختلفة) GoogleMap.getMinZoomLevel و الحد الأقصى لمستوى التكبير أو التصغير هو GoogleMap.getMaxZoomLevel.

يتم قياس إحداثيات المربعات من الزاوية اليسرى العليا (الشمالية الغربية) من الخريطة. علامة @ مستوى التكبير/التصغير N، تتراوح قيم x لإحداثيات المربع بين 0 و2N - 1 زيادة من الغرب إلى الشرق وتتراوح قيم y من 0 إلى 2N - 1 زيادة من الشمال إلى الجنوب.

مثال

GoogleMap map; // ... get a map.
 TileProvider tileProvider; // ... create a tile provider.
 TileOverlay tileOverlay = map.addTileOverlay(
     new TileOverlayOptions().tileProvider(tileProvider));
 

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

فراغ
clearTileCache()
محو ذاكرة التخزين المؤقت للمربّعات حتى يتم طلب جميع المربّعات مرة أخرى من "TileProvider"
منطقي
يساوي(كائن آخر)
لاختبار ما إذا كانت قيمة TileOverlay هذه تساوي قيمة أخرى.
منطقي
getFadeIn()
يحدد ما إذا كان يجب أن تتلاشى مربّعات التراكب.
سلسلة
getId()
يحصل على معرّف تراكب هذه المربّعات.
عدد عائم
getTransparency()
الحصول على شفافية تراكب الصور هذا.
عدد عائم
getZIndex()
للحصول على قيمة zIndex لتراكب الصور هذا.
int
منطقي
isVisible()
الحصول على إذن الوصول إلى تراكب هذه المربّعات
فراغ
remove()
إزالة تراكب الصور هذا من الخريطة.
فراغ
setFadeIn(boolean fadeIn)
لضبط ما إذا كان يجب أن تتلاشى مربّعات التراكب
فراغ
setTransparency(الشفافية العائمة)
يتم ضبط شفافية تراكب الصور هذا.
فراغ
setVisible(boolean visible)
يضبط هذا الإعداد مستوى رؤية تراكب الصور هذا.
فراغ
setZIndex(قيمة zIndex بقيمة عائمة)
لتعيين zIndex لتراكب الصور هذا.

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

الطرق العامة

علنية فراغ clearTileCache ()

محو ذاكرة التخزين المؤقت للمربّعات حتى يتم طلب جميع المربّعات مرة أخرى من "TileProvider" سيتم أيضًا محو المربّعات الحالية من تراكب هذه المربّعات من الخريطة بعد استدعاء هذا الإعداد. . تحتفظ واجهة برمجة التطبيقات بذاكرة تخزين مؤقت صغيرة تتضمّن مربّعات. إذا كنت ترغب في تخزين مربعات مؤقتًا لفترة أطول، فيجب تنفيذ ذاكرة تخزين مؤقت على القرص.

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

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

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

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

يحدد ما إذا كان يجب أن تتلاشى مربّعات التراكب.

المرتجعات
  • true إذا تغيّر لون المربّعات للداخل. false إذا لم تكن كذلك.

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

يحصل على معرّف تراكب هذه المربّعات.

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

الحصول على شفافية تراكب الصور هذا.

المرتجعات
  • شفافية تراكب الصور هذا.

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

للحصول على قيمة zIndex لتراكب الصور هذا.

المرتجعات
  • zIndex لتراكب الصور.

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

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

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

المرتجعات
  • مستوى رؤية تراكب هذه المربّعات.

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

إزالة تراكب الصور هذا من الخريطة.

علنية فراغ setFadeIn (التلاشي المنطقي)

لضبط ما إذا كان يجب أن تتلاشى مربّعات التراكب

المعلمات
fadeIn true لجعل المربّعات تتلاشى. false لعرضها على الفور.

علنية فراغ setTransparency (الشفافية العائمة)

يتم ضبط شفافية تراكب الصور هذا. اطّلع على الوثائق في أعلى هذا الصف مزيد من المعلومات.

المعلمات
شفافية عدد عائم في النطاق [0..1] حيث تعني 0 أن المربع يكون تراكب الصور معتمًا ويعني 1 أن تراكب المربعات شفاف.

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

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

المعلمات
مرئي true لإظهار هذا التراكب؛ false لجعلها غير مرئية.

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

لتعيين zIndex لتراكب الصور هذا. اطّلع على المستندات في أعلى هذا الصف لمعرفة المزيد المعلومات.

المعلمات
zIndex zIndex لتراكب الصور هذا.