فئة تحتوي على طرق لإنشاء عناصر CameraUpdate تؤدي إلى تغيير كاميرا الخريطة.
لتعديل كاميرا الخريطة، يمكنك استدعاء animateCamera(CameraUpdate)، أو animateCamera(CameraUpdate, GoogleMap.CancelableCallback)، أو moveCamera(CameraUpdate)، باستخدام عنصر CameraUpdate تم إنشاؤه لهذا الفئة.
على سبيل المثال، لتكبير الخريطة، يمكنك استخدام الرمز التالي:
GoogleMap map = ...;
map.animateCamera(CameraUpdateFactory.zoomIn());
قبل استخدام أي طرق من هذه الفئة، عليك تنفيذ أحد الإجراءات التالية لضمان إعداد هذه الفئة:
- يُرجى الانتظار إلى أن تصبح
GoogleMapمتاحة من خلالMapFragmentأوMapViewالتي أضفتها إلى تطبيقك. يمكنك الحصول على مثيلGoogleMapمن خلال استدعاءgetMapAsync()وانتظار معاودة الاتصال بـonMapReady(GoogleMap map). - تواصل هاتفيًا مع "
initialize(Context)". طالما لم يتم طرحGooglePlayServicesNotAvailableException، سيتم إعداد هذه الفئة بشكل صحيح.
دليل المطوِّر
للحصول على مزيد من المعلومات، يُرجى الاطّلاع على دليل مطوّر برامج الكاميرا والعرض.
ملخّص الطريقة العلنية
| CameraUpdate ثابت |
newCameraPosition(CameraPosition CameraPosition)
لعرض
CameraUpdate الذي يحرّك الكاميرا إلى CameraPosition محدّد |
| CameraUpdate ثابت |
newLatLng(LatLng خطوط الطول والعرض)
يتم عرض
CameraUpdate والذي يحرّك مركز الشاشة إلى خط عرض وخط طول
محدَّدين بكائن LatLng. |
| CameraUpdate ثابت |
newLatLngBounds(الحدود في LatLngBounds، وعرض عدد صحيح، وارتفاع عدد صحيح، ومساحة متروكة لعدد صحيح)
تعرض هذه الدالة
CameraUpdate لتحويل الكاميرا بحيث تتمركز حدود خطوط الطول/العرض المحددة على الشاشة داخل مربع إحاطة بأبعاد محددة بأعلى مستوى ممكن من التكبير. |
| CameraUpdate ثابت |
newLatLngBounds(حدود LatLngBounds والمساحة المتروكة)
تعرض هذه الدالة
CameraUpdate لتحويل الكاميرا بحيث تتمركز حدود خطوط الطول/العرض المحددة على الشاشة في أقصى مستوى ممكن من التكبير. |
| CameraUpdate ثابت |
newLatLngZoom(LatLng خطوط الطول والعرض والتكبير/التصغير العائم)
يتم عرض
CameraUpdate الذي يحرّك مركز الشاشة إلى خط عرض وخط طول
محدّدَين بواسطة عنصر LatLng، وينتقل إلى مستوى التكبير أو التصغير المحدّد. |
| CameraUpdate ثابت |
scrollBy(float xPixel، float yPixel)
لعرض
CameraUpdate يتم تمرير الكاميرا فوق الخريطة مع تغيير مركز
العرض بمقدار العدد المحدد من وحدات البكسل في الاتجاهين x وy. |
| CameraUpdate ثابت |
zoomBy(المقدار العائم، تركيز النقطة)
لعرض
CameraUpdate لتغيير مستوى التكبير أو التصغير لنقطة العرض الحالية للكاميرا. |
| CameraUpdate ثابت |
zoomBy(العدد العائم)
لعرض
CameraUpdate لتغيير مستوى التكبير أو التصغير لنقطة العرض الحالية للكاميرا. |
| CameraUpdate ثابت |
zoomIn()
يتم عرض
CameraUpdate لتكبير الخريطة من خلال تحريك ارتفاع نقطة العرض إلى مكان أقرب
من سطح الأرض. |
| CameraUpdate ثابت |
zoomOut()
لعرض
CameraUpdate، يتم تصغير الخريطة من خلال تحريك ارتفاع نقطة العرض
بعيدًا عن سطح الأرض. |
| CameraUpdate ثابت |
zoomTo(تكبير عائم)
لعرض
CameraUpdate، يتم تحريك نقطة العرض للكاميرا إلى مستوى تكبير معيّن. |
ملخّص الطريقة المكتسبة
الطرق العامة
عامة ثابتة CameraUpdate newCameraPosition (CameraPosition CameraPosition)
لعرض CameraUpdate الذي يحرّك الكاميرا إلى CameraPosition محدّد وفي
الواقع، يؤدّي ذلك إلى حدوث تحويل من خط العرض وخط الطول ومستوى التكبير/التصغير والاتجاه والإمالة للكائن CameraPosition.
المَعلمات
| cameraPosition |
|---|
المرتجعات
- سمة
CameraUpdateتحتوي على التحويل.
علني ثابت CameraUpdate newLatLng (LatLng لخط الطول والعرض)
يتم عرض CameraUpdate والذي يحرّك مركز الشاشة إلى خط عرض وخط طول
محدَّدين بكائن LatLng. يؤدي ذلك إلى توسيط الكاميرا على العنصر LatLng.
المَعلمات
| latLng | العنصر LatLng الذي يحتوي على خط العرض وخط الطول المطلوبَين |
|---|
المرتجعات
- سمة
CameraUpdateتحتوي على التحويل.
public static CameraUpdate newLatLngBounds (LatLngBounds، وعرض int، وارتفاع int، والمساحة المتروكة بشكل صحيح)
تعرض هذه الدالة CameraUpdate لتحويل الكاميرا بحيث تتمركز حدود خطوط الطول/العرض المحددة على الشاشة داخل مربع إحاطة بأبعاد محددة بأعلى مستوى ممكن من التكبير. يمكنك تحديد مساحة متروكة إضافية لفرض قيود على حجم مربّع الإحاطة بشكل أكبر. ويجب أن تكون قيمة اتجاه إمالة CameraUpdate التي تم إرجاعها 0.
على عكس newLatLngBounds(LatLngBounds, int)، يمكنك استخدام CameraUpdate
التي تعرضها هذه الطريقة لتغيير الكاميرا قبل مرحلة التنسيق على الخريطة، لأنّ
الوسيطات تحدّد الحجم المطلوب لمربّع الإحاطة.
المَعلمات
| حدود | المساحة التي تتلاءم مع مربع الإحاطة |
|---|---|
| width | عرض مربع الإحاطة بالبكسل (بكسل) |
| الطول | ارتفاع مربع الإحاطة بالبكسل (بكسل) |
| padding | قيد الحجم الإضافي (بالبكسل) لمربع الإحاطة |
المرتجعات
- سمة
CameraUpdateتحتوي على التحويل.
عام ثابت CameraUpdate newLatLngBounds (LatLngBounds والمساحة المتروكة)
تعرض هذه الدالة CameraUpdate لتحويل الكاميرا بحيث تتمركز حدود خطوط الطول/العرض المحددة على الشاشة في أقصى مستوى ممكن من التكبير. ويمكنك تحديد مساحة متروكة لإدراج مربّع الإحاطة من حواف عرض الخريطة. ويجب أن تكون قيمة اتجاه إمالة CameraUpdate التي تم إرجاعها 0.
لا تغيّر الكاميرا من خلال هذا التحديث إلى أن يتم تعديل الخريطة (من أجل تحديد مربّع الإحاطة ومستوى التكبير أو التصغير المناسبَين للخريطة، يجب تحديد حجم الخريطة). وبخلاف ذلك، سيتم طرح IllegalStateException. ولا يكفي أن تتوفّر الخريطة، بل يجب أن يكون العرض الذي يتضمّن الخريطة قد خضع أيضًا للتخطيط بحيث تم تحديد أبعادها. وإذا لم تكن متأكدًا من حدوث ذلك،
استخدِم newLatLngBounds(LatLngBounds, int, int, int) بدلاً من ذلك وقدِّم
أبعاد الخريطة يدويًا.
المَعلمات
| حدود | المنطقة التي تناسب الشاشة |
|---|---|
| padding | المسافة (بالبكسل) للمغادرة بين حواف مربع الإحاطة وحواف العرض. يتم تطبيق هذه القيمة على جميع الجوانب الأربعة لمربّع الإحاطة. |
المرتجعات
- سمة
CameraUpdateتحتوي على التحويل.
متاح للجميع ثابت CameraUpdate newLatLngZoom (LatLng خط الطول والعرض العائم)
يتم عرض CameraUpdate الذي يحرّك مركز الشاشة إلى خط عرض وخط طول
محدّدَين بواسطة عنصر LatLng، وينتقل إلى مستوى التكبير أو التصغير المحدّد.
المَعلمات
| latLng | العنصر LatLng الذي يحتوي على خط العرض وخط الطول المطلوبَين |
|---|---|
| تكبير / تصغير | مستوى التكبير المطلوب، في النطاق من 2.0 إلى 21.0. يتم ضبط القيم الموجودة أسفل هذا النطاق على 2.0، والقيم الأعلى منه يتم ضبطها على 21.0. قم بزيادة القيمة للتكبير. لا تحتوي بعض المناطق على مربّعات بأعلى مستويات التكبير. |
المرتجعات
- سمة
CameraUpdateتحتوي على التحويل.
public static CameraUpdate scrollBy (float xPixel, float yPixel)
لعرض CameraUpdate يتم تمرير الكاميرا فوق الخريطة مع تغيير مركز
العرض بمقدار العدد المحدد من وحدات البكسل في الاتجاهين x وy.
أمثلة:
- إذا كانت xPixel = 5 وyPixel = 0، ينتقل النظام إلى اليمين من خلال تحريك الكاميرا لتظهر الخريطة في اتجاه 5 بكسل إلى اليسار.
- إذا كانت xPixel = 0 وyPixel = 5، ينتقل النظام للأسفل من خلال تحريك الكاميرا لتظهر الخريطة في اتجاه 5 بكسل للأعلى.
يكون التمرير متناسبًا مع الاتجاه الحالي للكاميرا. على سبيل المثال، إذا كانت زاوية الكاميرا نحو 90 درجة، تكون درجة الاتجاه "لأعلى" والتمرير لليمين سيؤدي إلى تحريك الكاميرا نحو الجنوب.
المَعلمات
| xPixel | عدد وحدات البكسل للتمرير أفقيًا. وتؤدي القيمة الموجبة إلى تحريك الكاميرا إلى اليمين وفقًا لاتجاهها الحالي. وتؤدي القيمة السالبة إلى تحريك الكاميرا إلى اليسار وفقًا لاتجاهها الحالي. |
|---|---|
| yPixel | عدد وحدات البكسل للتمرير رأسيًا. تؤدي القيمة الموجبة إلى تحريك الكاميرا إلى أسفل وفقًا لاتجاهها الحالي. تؤدي القيمة السالبة إلى تحريك الكاميرا إلى الأعلى وفقًا لاتجاهها الحالي. |
المرتجعات
- سمة
CameraUpdateتحتوي على التحويل.
متاح للجميع ثابت CameraUpdate zoomBy (المقدار العائم، تركيز النقطة)
لعرض CameraUpdate لتغيير مستوى التكبير أو التصغير لنقطة العرض الحالية للكاميرا.
وستظل النقطة التي يتم تحديدها بالتركيز ثابتة (أي أنها تتوافق مع خط الطول/خط العرض نفسه قبل عملية التكبير/التصغير وبعدها).
وتختلف هذه الطريقة عن طريقة التكبير أو التصغير zoomTo(float) بالنسبة إلى الكاميرا الحالية.
على سبيل المثال، إذا كان LatLng (الإصدار 11.11 أو 22.22) متوفّرًا حاليًا في موقع الشاشة (23 أو 45). بعد استدعاء هذه الطريقة باستخدام مقدار التكبير/التصغير ورقم LatLng هذا، سيظلّ الموقع الجغرافي للشاشة في LatLng هو (23 أو 45).
المَعلمات
| amount | المبلغ لتغيير مستوى التكبير/التصغير. تشير القيم الموجبة إلى الاقتراب من سطح الأرض، بينما تشير القيم السالبة إلى الاقتراب من سطح الأرض. |
|---|---|
| البؤرة | موقع البكسل على الشاشة والذي يظل ثابتًا بعد عملية التكبير أو التصغير. إنّ خط الطول/خط العرض الذي كان في موقع البكسل هذا قبل تحريك الكاميرا سيظل كما هو بعد تحريك الكاميرا. |
المرتجعات
- سمة
CameraUpdateتحتوي على التحويل.
متاح للجميع ثابت CameraUpdate zoomBy (المقدار العائم)
لعرض CameraUpdate لتغيير مستوى التكبير أو التصغير لنقطة العرض الحالية للكاميرا.
وتختلف هذه الطريقة عن طريقة التكبير أو التصغير zoomTo(float) بالنسبة إلى الكاميرا الحالية.
المَعلمات
| amount | المبلغ لتغيير مستوى التكبير/التصغير. تشير القيم الموجبة إلى الاقتراب من سطح الأرض، بينما تشير القيم السالبة إلى الاقتراب من سطح الأرض. |
|---|
المرتجعات
- سمة
CameraUpdateتحتوي على التحويل.
متاح للجميع ثابت CameraUpdate zoomIn ()
يتم عرض CameraUpdate لتكبير الخريطة من خلال تحريك ارتفاع نقطة العرض إلى مكان أقرب
من سطح الأرض. تبلغ زيادة التكبير أو التصغير 1.0.
المرتجعات
- سمة
CameraUpdateتحتوي على التحويل.
متاح للجميع ثابت CameraUpdate zoomOut ()
لعرض CameraUpdate، يتم تصغير الخريطة من خلال تحريك ارتفاع نقطة العرض
بعيدًا عن سطح الأرض. مقدار التكبير/التصغير هو -1.0.
المرتجعات
- سمة
CameraUpdateتحتوي على التحويل.
متاح للجميع ثابت CameraUpdate zoomTo (تكبير عائم)
لعرض CameraUpdate، يتم تحريك نقطة العرض للكاميرا إلى مستوى تكبير معيّن.
المَعلمات
| تكبير / تصغير | مستوى التكبير المطلوب، في النطاق من 2.0 إلى 21.0. يتم ضبط القيم الموجودة أسفل هذا النطاق على 2.0، والقيم الأعلى منه يتم ضبطها على 21.0. قم بزيادة القيمة للتكبير. لا تحتوي بعض المناطق على مربّعات بأعلى مستويات التكبير. |
|---|