خيارات تراكب الأرض

الفئة النهائية العامة GroundOverlayOptions التي توسِّع كائن Object
وتُنفذ Parcelable

تحدد خيارات التراكب الأرضي.

الملخّص الثابت

float NO_DIMENSION وضع علامة في حالة عدم تحديد بُعد للارتفاع

ملخّص ثابت مكتسَب

ملخّص عام للمنشئ

GroundOverlayOptions()
تنشئ مجموعة جديدة من خيارات تراكب الأرض.

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

GroundOverlayOptions
anchor(float u, float v)
لتحديد علامة الارتساء.
GroundOverlayOptions
bearing(إزاحة عائمة)
تحدد اتجاه تراكب الأرض بالدرجات في اتجاه عقارب الساعة من الشمال.
GroundOverlayOptions
قابل للنقر(منطقية قابلة للنقر)
لتحديد ما إذا كان تراكب الأرض قابلاً للنقر أم لا.
float
getAnchorU()
علامة الارتساء النسبية الأفقية، ويشير 0.0 و1.0 إلى الحافتين اليسرى واليمنى على التوالي.
float
getAnchorV()
ارتساء نسبي عمودي، ويشير 0.0 و1.0 إلى الحافتين العلوية والسفلية على التوالي.
float
getBearing()
الحصول على مجموعة الاتجاه لكائن GroundOverlayOptions هذا.
LatLngBounds
getBounds()
تتيح لك هذه السياسة ضبط الحدود الخاصة بعنصر GroundOverlayOptions هذا.
float
getHeight()
يتم ضبط ارتفاع الكائن GroundOverlayOptions هذا.
BitmapDescriptor
getImage()
تتيح هذه السياسة ضبط واصف الصورة لعنصر GroundOverlayOptions هذا.
LatLng
getLocation()
للحصول على الموقع الجغرافي للعنصر GroundOverlayOptions هذا
float
getTransparency()
يتم ضبط درجة الشفافية لعنصر GroundOverlayOptions هذا.
float
getWidth()
يتم ضبط عرض عنصر GroundOverlayOptions هذا.
float
getZIndex()
للحصول على مجموعة zIndex لهذا العنصر GroundOverlayOptions.
GroundOverlayOptions
image(BitmapDescriptor imageDescriptor)
تحدِّد هذه السمة صورة هذا التراكب الأرضي.
boolean
isClickable()
يحصل على إعداد إمكانية النقر لهذا العنصر GroundOverlayOptions.
boolean
isVisible()
يحصل على إعداد مستوى الرؤية لعنصر GroundOverlayOptions هذا.
GroundOverlayOptions
position(موقع LatLng، العرض العائم)
تحدّد موضع هذا التراكب الأرضي باستخدام نقطة ارتساء (LatLng) والعرض (بالمتر).
GroundOverlayOptions
position(موقع LatLng، العرض العائم، الارتفاع العائم)
تحدّد موضع هذا التراكب الأرضي باستخدام نقطة ارتساء (LatLng) والعرض والارتفاع (كلاهما بالمتر).
GroundOverlayOptions
positionFromBounds(حدود LatLngBounds)
تحدد موضع هذا التراكب الأرضي.
GroundOverlayOptions
transparency(شفافية عائمة)
تُحدِّد شفافية التراكب الأرضي.
GroundOverlayOptions
visible(مرئية منطقية)
تحدد إمكانية رؤية التراكب الأرضي.
GroundOverlayOptions
zIndex(قيمة فاصلة zIndex)
تحدد zIndex للتراكب الأرضي، أي الترتيب الذي سيتم رسمه به.

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

الثوابت

عدد عائم نهائي ثابت وعلني NO_DIMENSION

وضع علامة في حالة عدم تحديد بُعد للارتفاع

القيمة الثابتة: -1.0

مقاولات عامة

خيار متاح للجميع GroundOverlayOptions ()

تنشئ مجموعة جديدة من خيارات تراكب الأرض.

الطرق العامة

public GroundOverlayOptions anchor (float u, float v)

لتحديد علامة الارتساء.

يتم محاذاة الارتساء مع موقع التراكب الأرضي.

يتم تحديد نقطة الارتساء في مساحة ثنائية الأبعاد مستمرة، حيث يشير (0,0) و(1,0) و(0,1) و (1,1) إلى الزاوية العلوية اليسرى والأعلى اليمنى والأسفل اليسرى والأسفل اليمنى على التوالي.

 *-----+-----+-----+-----*
 |     |     |     |     |
 |     |     |     |     |
 +-----+-----+-----+-----+
 |     |     |   X |     |   (U, V) = (0.7, 0.6)
 |     |     |     |     |
 *-----+-----+-----+-----*
 

المَعلمات
u الإحداثي u للمرساة
v الإحداثي v-لمراسي الارتساء
المرتجعات

عامة GroundOverlayOptions الاتجاه (الاتجاه العائم)

تحدد اتجاه تراكب الأرض بالدرجات في اتجاه عقارب الساعة من الشمال. يتم الدوران حول نقطة الارتساء. إذا لم يتم تحديد ذلك، تكون القيمة التلقائية 0 (أي أعلى على نقاط الصورة نحو الشمال).

لاحظ أنه يتم تطبيق حدود خطوط الطول والعرض قبل الدوران.

المَعلمات
يحمل الاتجاه بدرجات في اتجاه عقارب الساعة من الشمال. ستتم تسوية القيم التي تقع خارج النطاق [0، 360).
المرتجعات

عامة GroundOverlayOptions قابلة للنقر (منطقية قابلة للنقر)

لتحديد ما إذا كان تراكب الأرض قابلاً للنقر أم لا. إمكانية النقر التلقائية هي false.

المَعلمات
قابل للنقر عليه الإعداد الجديد لإمكانية النقر
المرتجعات

عامة عائمة getAnchorU ()

علامة الارتساء النسبية الأفقية، ويشير 0.0 و1.0 إلى الحافتين اليسرى واليمنى على التوالي. ويتم إدخال قيم الارتساء الأخرى وفقًا لذلك.

المرتجعات
  • موقع الارتساء المرتبط بالحافة الأفقية.

عامة عائمة getAnchorV ()

ارتساء نسبي عمودي، ويشير 0.0 و1.0 إلى الحافتين العلوية والسفلية على التوالي. ويتم إدخال قيم الارتساء الأخرى وفقًا لذلك.

المرتجعات
  • موقع الارتساء المرتبط بالحافة الرأسية.

public float getBearing ()

الحصول على مجموعة الاتجاه لكائن GroundOverlayOptions هذا.

المرتجعات
  • اتجاه التراكب الأرضي.

عامة LatLngBounds getBounds ()

تتيح لك هذه السياسة ضبط الحدود الخاصة بعنصر GroundOverlayOptions هذا.

المرتجعات

public float getHeight ()

يتم ضبط ارتفاع الكائن GroundOverlayOptions هذا.

المرتجعات
  • ارتفاع تراكب الأرض.

public BitmapDescriptor getImage ()

تتيح هذه السياسة ضبط واصف الصورة لعنصر GroundOverlayOptions هذا.

المرتجعات
  • تمثّل هذه السمة BitmapDescriptor صورة التراكب الأرضي.

عامة LatLng getLocation ()

للحصول على الموقع الجغرافي للعنصر GroundOverlayOptions هذا

المرتجعات
  • موقع وضع مراسي التراكب الأرضي. سيكون هذا الحقل null إذا تم ضبط الموضع باستخدام السمة positionFromBounds(LatLngBounds).

عامة عائمة getTransparency ()

يتم ضبط درجة الشفافية لعنصر GroundOverlayOptions هذا.

المرتجعات
  • شفافية تراكب الأرض.

public float getWidth ()

يتم ضبط عرض عنصر GroundOverlayOptions هذا.

المرتجعات
  • عرض تراكب الأرض.

عدد عائم getZIndex ()

للحصول على مجموعة zIndex لهذا العنصر GroundOverlayOptions.

المرتجعات
  • zIndex لتراكب الأرض.

عامة GroundOverlayOptions image (BitmapDescriptor imageDescriptor)

تحدِّد هذه السمة صورة هذا التراكب الأرضي.

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

المَعلمات
imageDescriptor BitmapDescriptor لاستخدامها في هذا التراكب الأرضي
المرتجعات

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

يحصل على إعداد إمكانية النقر لهذا العنصر GroundOverlayOptions.

المرتجعات
  • true إذا كان تراكب الأرض قابلاً للنقر، وfalse إذا لم يكن كذلك.

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

يحصل على إعداد مستوى الرؤية لعنصر GroundOverlayOptions هذا.

المرتجعات
  • true إذا كان هذا التراكب الأرضي مرئيًا، وfalse إذا لم يكن كذلك.

عامة GroundOverlayOptions الموضع (LatLng، والعرض العائم)

تحدّد موضع هذا التراكب الأرضي باستخدام نقطة ارتساء (LatLng) والعرض (بالمتر). وسيتم تعديل الارتفاع وفقًا لذلك للحفاظ على نسبة العرض إلى الارتفاع.

المَعلمات
موقع جغرافي الموقع الجغرافي على الخريطة LatLng الذي ستظلّ نقطة الارتساء في الصورة المحدّدة عليه ثابتة. وسيظلّ الارتساء ثابتًا في الموضع على الأرض عند تطبيق التحويلات (على سبيل المثال، setFeature وsetBearing وما إلى ذلك).
width عرض التراكب (بالمتر). سيتم تحديد الارتفاع تلقائيًا استنادًا إلى نسبة العرض إلى الارتفاع للصورة.
المرتجعات
الرميات
IllegalArgumentException إذا كان موضع الارتساء null
IllegalArgumentException إذا كان العرض سالبًا
IllegalStateException إذا سبق أن تم ضبط الموضع باستخدام السمة positionFromBounds(LatLngBounds)

عامة GroundOverlayOptions الموضع (LatLng والعرض العائم والارتفاع العائم)

تحدّد موضع هذا التراكب الأرضي باستخدام نقطة ارتساء (LatLng) والعرض والارتفاع (كلاهما بالمتر). وعند عرضها، سيتم تغيير حجم الصورة لتلائم الأبعاد المحددة.

المَعلمات
موقع جغرافي الموقع الجغرافي على الخريطة LatLng الذي ستظلّ نقطة الارتساء في الصورة المحدّدة عليه ثابتة. وسيظلّ الارتساء ثابتًا في الموضع على الأرض عند تطبيق التحويلات (على سبيل المثال، setFeature وsetBearing وما إلى ذلك).
width عرض التراكب (بالمتر)
الطول ارتفاع التراكب (بالمتر)
المرتجعات
الرميات
IllegalArgumentException إذا كان موضع الارتساء null
IllegalArgumentException إذا كان العرض أو الارتفاع سالبَين
IllegalStateException إذا سبق أن تم ضبط الموضع باستخدام السمة positionFromBounds(LatLngBounds)

عامة GroundOverlayOptions positionFromBounds (LatLngBounds)

تحدد موضع هذا التراكب الأرضي.

المَعلمات
حدود LatLngBounds حيث يتم وضع التراكب الأرضي
المرتجعات
الرميات
IllegalStateException إذا سبق أن تم ضبط الموضع باستخدام position(LatLng, float) أو position(LatLng, float, float)

عامة GroundOverlayOptions الشفافية (الشفافية العائمة)

تُحدِّد شفافية التراكب الأرضي. تكون الشفافية التلقائية 0 (غير شفافة).

المَعلمات
الشفافية قيمة عائمة في النطاق [0..1] حيث تعني 0 أنّ التراكب الأرضي غير شفاف، وتشير السمة 1 إلى أنّ التراكب الأرضي شفاف.
المرتجعات
الرميات
IllegalArgumentException إذا كانت الشفافية خارج النطاق [0..1].

عامة GroundOverlayOptions مرئية (boolean visible)

تحدد إمكانية رؤية التراكب الأرضي. الإعداد التلقائي هو "true".

المَعلمات
مرئي
المرتجعات

عامة GroundOverlayOptions zIndex (float zIndex)

تحدد zIndex للتراكب الأرضي، أي الترتيب الذي سيتم رسمه به. راجِع المستندات في أعلى هذه الفئة للحصول على مزيد من المعلومات حول zIndex.

المَعلمات
zIndex
المرتجعات