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

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

موفِّر البلاط

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

مؤشر Z

ترتيب رسم تراكب المربّعات هذا بالنسبة إلى تراكبات أخرى (بما في ذلك GroundOverlay وCircle وPolyline وPolygon وs وليس Marker). يتم رسم مركّب يحتوي على مؤشر z أكبر على طبقات تحتوي على مؤشرات z أصغر. يكون ترتيب التراكبات التي لها نفس مؤشر z عشوائيًا. قيمة zIndex التلقائية هي 0.

الشفافية

شفافية تراكب مربّعات في النطاق [0..1] حيث تعني 0 أن التراكب معتم و1 يعني أن تراكب الصور شفاف بالكامل إذا كانت الصورة النقطية المحددة شفافة جزئيًا، سيتم ضبط حجم شفافية كل بكسل وفقًا لذلك (على سبيل المثال، إذا كانت قيمة ألفا في الصورة النقطية 200 وبلغت شفافية تراكب الصور 0.25، فسيتم عرض وحدة البكسل على الشاشة بقيمة ألفا 150). تحديد هذه السمة اختيارية والشفافية التلقائية هي 0 (معتم).

مستوى العرض

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

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

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

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

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

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

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

مثال

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