الكاميرا والعرض

اختيار النظام الأساسي: Android iOS JavaScript

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

عيّنات تعليمات برمجية

يتضمّن مستودع ApiDemos على GitHub عينة توضّح ميزات الكاميرا:

• CameraDemoActivity - Kotlin: تغيير موضع الكاميرا
• CameraDemoActivity - Java: تغيير موضع الكاميرا

مقدمة

تمامًا مثل "خرائط Google" على الويب، تمثّل حزمة تطوير البرامج (SDK) لخدمة "خرائط Google" لنظام التشغيل Android سطح العالم (كرة) على شاشة جهازك (مستوى مسطّح) باستخدام إسقاط مركاتور. في الاتجاهين الشرقي والغربي، تتكرر الخريطة بلا حدود لأنّ العالم يلتف حول نفسه بسلاسة. في الاتجاهين الشمالي والجنوبي، تقتصر الخريطة على 85 درجة شمالاً و85 درجة جنوبًا تقريبًا.

ملاحظة: يبلغ عرض إسقاط مركاتور قيمة محدودة طوليًا، بينما يبلغ ارتفاعه قيمة غير محدودة عرضيًا. نستخدم إسقاط مركاتور لـ "قطع" صور الخريطة الأساسية عند حوالي 85 درجة شمالاً أو جنوبًا، وذلك لجعل شكل الخريطة الناتج مربعًا، ما يسهّل عملية اختيار المربّعات.

تتيح لك حزمة تطوير البرامج (SDK) بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل Android تغيير طريقة عرض المستخدم للخريطة من خلال تعديل الكاميرا الخاصة بالخريطة.

لن تؤدي التغييرات التي يتم إجراؤها على الكاميرا إلى أي تغييرات في العلامات أو التراكبات أو الرسومات الأخرى التي أضفتها، ولكن قد تحتاج إلى تغيير إضافاتك لتناسب العرض الجديد بشكل أفضل.

بما أنّه يمكنك الاستماع إلى إيماءات المستخدم على الخريطة، يمكنك تغيير الخريطة استجابةً لطلبات المستخدم. على سبيل المثال، تستجيب طريقة معاودة الاتصال OnMapClickListener.onMapClick() لنقرة واحدة على الخريطة. وبما أنّ الطريقة تتلقّى خطوط الطول والعرض الخاصة بموقع النقر، يمكنك الردّ من خلال تحريك الخريطة أو تكبيرها/تصغيرها إلى تلك النقطة. تتوفّر طرق مشابهة للردّ على النقرات على فقاعة العلامة أو للردّ على إيماءة السحب على العلامة.

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

موضع الكاميرا

يتم تصميم عرض الخريطة على شكل كاميرا تنظر إلى الأسفل على مستوى مسطّح. يتم تحديد موضع الكاميرا (وبالتالي عرض الخريطة) من خلال السمات التالية: الهدف (الموقع الجغرافي لخط العرض/خط الطول) والاتجاه والميل ومستوى التكبير/التصغير.

الهدف (الموقع الجغرافي)

هدف الكاميرا هو موقع مركز الخريطة، ويتم تحديده كإحداثيات خط العرض وخط الطول.

يمكن أن يتراوح خط العرض بين 85- و85 درجة، مع تضمين القيمتين. سيتم تقريب أي قيم أعلى أو أقل من هذا النطاق إلى أقرب قيمة ضمن هذا النطاق. على سبيل المثال، سيؤدي تحديد خط عرض 100 إلى ضبط القيمة على 85. يتراوح خط الطول بين 180- و180 درجة، ضِمنًا. سيتم تضمين القيم التي تزيد عن هذا النطاق أو تقل عنه ضمن النطاق (-180, 180). على سبيل المثال، سيتم تقريب القيم 480 و840 و1200 إلى 120 درجة.

الاتجاه

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

يشير اتجاه 0 إلى أنّ أعلى الخريطة يشير إلى الشمال الحقيقي. تعني قيمة الاتجاه 90 أنّ أعلى الخريطة يشير إلى الشرق (90 درجة على البوصلة). تعني القيمة 180 أنّ أعلى الخريطة يشير إلى الجنوب تمامًا.

تتيح لك Maps API تغيير اتجاه الخريطة. على سبيل المثال، عندما يقود شخص سيارة، غالبًا ما يقلّب خريطة الطريق لتتوافق مع اتجاه تنقّله، بينما يوجّه المتنزّهون الذين يستخدمون خريطة وبوصلة الخريطة عادةً بحيث يشير خط عمودي إلى الشمال.

درجة الإمالة (زاوية العرض)

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

في الصور أدناه، تبلغ زاوية العرض 0 درجة. تعرض الصورة الأولى مخططًا توضيحيًا لذلك، حيث يمثّل الموضع 1 موضع الكاميرا، ويمثّل الموضع 2 موضع الخريطة الحالي. تظهر الخريطة الناتجة أدناه.

الخريطة المعروضة بزاوية العرض التلقائية للكاميرا

زاوية العرض التلقائية للكاميرا:

في الصور أدناه، تبلغ زاوية العرض 45 درجة. لاحظ أنّ الكاميرا تتحرّك في منتصف قوس بين الوضع العمودي تمامًا (0 درجة) والأرض (90 درجة)، للوصول إلى الموضع 3. لا تزال الكاميرا موجّهة إلى نقطة مركز الخريطة، ولكن أصبحت المنطقة الممثّلة بالخط في الموضع 4 مرئية الآن.

الخريطة المعروضة بزاوية عرض تبلغ 45 درجة.

زاوية عرض الكاميرا 45 درجة

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

Zoom

يحدّد مستوى التكبير/التصغير للكاميرا مقياس الخريطة. عند استخدام مستويات تكبير أعلى، يمكن رؤية المزيد من التفاصيل على الشاشة، بينما عند استخدام مستويات تكبير أقل، يمكن رؤية المزيد من العالم على الشاشة. عند مستوى التكبير/التصغير 0، يكون مقياس الخريطة على نحو يبلغ فيه عرض العالم بأكمله 256 وحدة بكسل مستقلة الكثافة (dp) تقريبًا.

تؤدي زيادة مستوى التكبير بمقدار 1 إلى مضاعفة عرض العالم على الشاشة. وبالتالي، عند مستوى التكبير/التصغير N، يبلغ عرض العالم حوالي 256 * 2^N بكسل غير مرتبط بالكثافة. على سبيل المثال، عند مستوى التكبير 2، يبلغ عرض العالم بأسره حوالي 1024 وحدة بكسل مستقلة الكثافة.

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

• ‫1: العالم
• ‫5: كتلة أرضية/قارة
• ‫10: المدينة
• ‫15: الشوارع
• ‫20: المباني

ملاحظة: بسبب حجم الشاشة وكثافتها، قد لا تتوافق بعض الأجهزة مع أدنى مستويات التكبير. استخدِم GoogleMap.getMinimumZoomLevel() للحصول على أدنى مستوى تكبير/تصغير ممكن للخريطة. إذا كنت بحاجة إلى عرض العالم بأكمله في إطار العرض، قد يكون من الأفضل استخدام الوضع البسيط.

تعرض الصور التالية المظهر المرئي لمستويات التكبير المختلفة:

خريطة بمستوى تكبير 5

خريطة بمستوى تكبير 15

خريطة بمستوى تكبير/تصغير 20

تحريك الكاميرا

تتيح لك Maps API تغيير الجزء المرئي من العالم على الخريطة. ويتم ذلك من خلال تغيير موضع الكاميرا (بدلاً من تحريك الخريطة).

عند تغيير الكاميرا، يمكنك تحريك الكاميرا الناتجة. تُجري الحركة الانتقالية استيفاءً بين سمات الكاميرا الحالية وسمات الكاميرا الجديدة. يمكنك أيضًا التحكّم في مدة الرسوم المتحركة.

ملاحظة: يتم احتساب جميع حركات الكاميرا الآلية استنادًا إلى حجم العنصر GoogleMap بعد أخذ أي مساحة فارغة تمت إضافتها إلى الخريطة في الاعتبار أولاً. على سبيل المثال، ستؤدي إضافة 100 بكسل من المساحة المتروكة إلى الحافة اليسرى من خريطتك إلى نقل مركز خريطتك إلى اليمين بمقدار 50 بكسل. يتوفّر المزيد من المعلومات في المستندات حول المسافة الفاصلة عن حافة الخريطة.

لتغيير موضع الكاميرا، يجب تحديد المكان الذي تريد نقل الكاميرا إليه باستخدام CameraUpdate. تتيح لك واجهة برمجة التطبيقات Maps API إنشاء العديد من أنواع CameraUpdate المختلفة باستخدام CameraUpdateFactory. تتوفّر الخيارات التالية:

تغيير مستوى التكبير/التصغير وضبط الحد الأدنى/الأقصى للتكبير/التصغير

يمنحك CameraUpdateFactory.zoomIn() وCameraUpdateFactory.zoomOut() CameraUpdate يغيّر مستوى التكبير/التصغير بمقدار 1.0، مع الحفاظ على جميع الخصائص الأخرى كما هي.

يمنحك CameraUpdateFactory.zoomTo(float) CameraUpdate يغيّر مستوى التكبير/التصغير إلى القيمة المحدّدة، مع الحفاظ على جميع الخصائص الأخرى كما هي.

تمنحك السمتان CameraUpdateFactory.zoomBy(float) وCameraUpdateFactory.zoomBy(float, Point) CameraUpdate التي تزيد (أو تنقص، إذا كانت القيمة سالبة) مستوى التكبير/التصغير بالقيمة المحدّدة. يؤدي الخيار الأخير إلى تثبيت النقطة المحدّدة على الشاشة بحيث تبقى في الموقع الجغرافي نفسه (خط العرض/خط الطول)، وبالتالي قد يغيّر موقع الكاميرا لتحقيق ذلك.

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

Kotlin

private lateinit var map: GoogleMap

    map.setMinZoomPreference(6.0f)
    map.setMaxZoomPreference(14.0f)

      

Java

private GoogleMap map;
    map.setMinZoomPreference(6.0f);
    map.setMaxZoomPreference(14.0f);

      

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

تغيير موضع الكاميرا

هناك طريقتان مناسبتان لإجراء تغييرات الموضع الشائعة. يمنحك CameraUpdateFactory.newLatLng(LatLng) CameraUpdate يغيّر خطوط الطول والعرض للكاميرا، مع الحفاظ على جميع السمات الأخرى. يمنحك CameraUpdateFactory.newLatLngZoom(LatLng, float) CameraUpdate يغيّر خط العرض وخط الطول ومستوى التكبير/التصغير للكاميرا، مع الحفاظ على جميع السمات الأخرى.

للحصول على مرونة كاملة في تغيير موضع الكاميرا، استخدِم CameraUpdateFactory.newCameraPosition(CameraPosition) الذي يمنحك CameraUpdate ينقل الكاميرا إلى الموضع المحدّد. يمكن الحصول على CameraPosition إما مباشرةً باستخدام new CameraPosition() أو باستخدام CameraPosition.Builder من خلال new CameraPosition.Builder().

التحريك (التمرير)

يمنحك CameraUpdateFactory.scrollBy(float, float) CameraUpdate الذي يغيّر خط العرض وخط الطول للكاميرا، ما يؤدي إلى تحرّك الخريطة بمقدار عدد وحدات البكسل المحدّد. تتسبّب قيمة x الموجبة في تحريك الكاميرا إلى اليمين، وبالتالي تبدو الخريطة وكأنّها تحرّكت إلى اليسار. تؤدي القيمة الموجبة لـ y إلى تحريك الكاميرا للأسفل، وبالتالي يبدو أنّ الخريطة قد تحرّكت للأعلى. في المقابل، تؤدي قيم x السالبة إلى تحرّك الكاميرا إلى اليسار، ما يجعل الخريطة تبدو وكأنّها تحرّكت إلى اليمين، وتؤدي قيم y السالبة إلى تحرّك الكاميرا إلى الأعلى. ويكون التمرير بالنسبة إلى الاتجاه الحالي للكاميرا. على سبيل المثال، إذا كانت الكاميرا تحمل زاوية اتجاه تبلغ 90 درجة، يكون الشرق هو "الأعلى".

وضع الحدود

ضبط حدود الخريطة

في بعض الأحيان، يكون من المفيد تحريك الكاميرا بحيث تكون منطقة الاهتمام بأكملها مرئية بأكبر مستوى تكبير ممكن. على سبيل المثال، إذا كنت تعرض جميع محطات الوقود التي تقع على بُعد أقل من خمسة أميال من الموقع الجغرافي الحالي للمستخدم، قد تحتاج إلى تحريك الكاميرا بحيث تكون جميع المحطات مرئية على الشاشة. لإجراء ذلك، عليك أولاً احتساب LatLngBounds الذي تريد أن يظهر على الشاشة. يمكنك بعد ذلك استخدام CameraUpdateFactory.newLatLngBounds(LatLngBounds bounds, int padding) للحصول على CameraUpdate يغيّر موضع الكاميرا بحيث يتناسب LatLngBounds المحدّد تمامًا مع الخريطة، مع الأخذ في الاعتبار المساحة المتروكة (بالبكسل) المحدّدة. يضمن CameraUpdate الذي يتم عرضه أن تكون الفجوة (بالبكسل) بين الحدود المحدّدة وحافة الخريطة على الأقل بقدر المساحة المتروكة المحدّدة. يُرجى العِلم أنّ ميل الخريطة واتجاهها سيكونان 0.

Kotlin

val australiaBounds = LatLngBounds(
    LatLng((-44.0), 113.0),  // SW bounds
    LatLng((-10.0), 154.0) // NE bounds
)
map.moveCamera(CameraUpdateFactory.newLatLngBounds(australiaBounds, 0))

      

Java

LatLngBounds australiaBounds = new LatLngBounds(
    new LatLng(-44, 113), // SW bounds
    new LatLng(-10, 154)  // NE bounds
);
map.moveCamera(CameraUpdateFactory.newLatLngBounds(australiaBounds, 0));

      

ملاحظة: لا يمكنك تفعيل newLatLngBounds(boundary, padding) لتغيير الكاميرا إلا بعد اكتمال تخطيط الخريطة. ويرجع ذلك إلى أنّ واجهة برمجة التطبيقات تحتسب حدود العرض للخريطة أثناء التخطيط. إذا أردت استدعاء newLatLngBounds() قبل حدوث التنسيق، يمكنك استخدام newLatLngBounds(boundary, width, height, padding) الموضّحة أدناه.

توسيط الخريطة ضمن منطقة

في بعض الحالات، قد تحتاج إلى توسيط الكاميرا ضمن حدود معيّنة بدلاً من تضمين الحدود القصوى. على سبيل المثال، لتوسيط الكاميرا على بلد مع الحفاظ على مستوى تكبير/تصغير ثابت. في هذه الحالة، يمكنك استخدام طريقة مشابهة، من خلال إنشاء LatLngBounds واستخدام CameraUpdateFactory.newLatLngZoom(LatLng latLng, float zoom) مع LatLngBounds.طريقة getCenter() ستعرض الطريقة getCenter() المركز الجغرافي LatLngBounds.

Kotlin

val australiaBounds = LatLngBounds(
    LatLng((-44.0), 113.0),  // SW bounds
    LatLng((-10.0), 154.0) // NE bounds
)
map.moveCamera(CameraUpdateFactory.newLatLngZoom(australiaBounds.center, 10f))

      

Java

LatLngBounds australiaBounds = new LatLngBounds(
    new LatLng(-44, 113), // SW bounds
    new LatLng(-10, 154)  // NE bounds
);
map.moveCamera(CameraUpdateFactory.newLatLngZoom(australiaBounds.getCenter(), 10));

      

يتيح لك التحميل الزائد للطريقة newLatLngBounds(boundary, width, height, padding) تحديد العرض والارتفاع بالبكسل لمستطيل، مع مراعاة أن تتطابق هذه القيم مع أبعاد الخريطة. يتم وضع المستطيل بحيث يكون مركزه هو نفسه مركز عرض الخريطة (وبالتالي، إذا كانت الأبعاد المحدّدة هي نفسها أبعاد عرض الخريطة، سيتطابق المستطيل مع عرض الخريطة). سيؤدي CameraUpdate الذي تم عرضه إلى تحريك الكاميرا بحيث يتم توسيط LatLngBounds المحدّد على الشاشة ضمن المستطيل المحدّد بأكبر مستوى تكبير ممكن، مع الأخذ في الاعتبار المساحة المتروكة المطلوبة.

ملاحظة: لا تستخدِم الطريقة الأبسط newLatLngBounds(boundary, padding) لإنشاء CameraUpdate إلا إذا كان سيتم استخدامها لتحريك الكاميرا بعد أن يتم تخطيط الخريطة. أثناء التخطيط، تحسب واجهة برمجة التطبيقات حدود العرض للخريطة اللازمة لعرض المربّع المحيط بشكل صحيح. في المقابل، يمكنك استخدام CameraUpdate التي تعرضها الطريقة الأكثر تعقيدًا newLatLngBounds(boundary, width, height, padding) في أي وقت، حتى قبل أن يتم تخطيط الخريطة، لأنّ واجهة برمجة التطبيقات تحسب حدود العرض من الوسيطات التي تمرّرها.

حصر تحريك المستخدم إلى منطقة معيّنة

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

Kotlin

// Create a LatLngBounds that includes the city of Adelaide in Australia.
val adelaideBounds = LatLngBounds(
    LatLng(-35.0, 138.58),  // SW bounds
    LatLng(-34.9, 138.61) // NE bounds
)

// Constrain the camera target to the Adelaide bounds.
map.setLatLngBoundsForCameraTarget(adelaideBounds)

      

Java

// Create a LatLngBounds that includes the city of Adelaide in Australia.
LatLngBounds adelaideBounds = new LatLngBounds(
    new LatLng(-35.0, 138.58), // SW bounds
    new LatLng(-34.9, 138.61)  // NE bounds
);

// Constrain the camera target to the Adelaide bounds.
map.setLatLngBoundsForCameraTarget(adelaideBounds);

      

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

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

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

تعديل طريقة عرض الكاميرا

لتطبيق CameraUpdate على الخريطة، يمكنك إما تحريك الكاميرا على الفور أو تحريكها بسلاسة. لنقل الكاميرا على الفور باستخدام CameraUpdate المحدّد، يمكنك طلب GoogleMap.moveCamera(CameraUpdate).

يمكنك جعل تجربة المستخدم أكثر إرضاءً، خاصةً في الحركات القصيرة، من خلال تحريك التغيير. لإجراء ذلك بدلاً من الاتصال، انقر على GoogleMap.moveCamera اتصال GoogleMap.animateCamera. ستنتقل الخريطة بسلاسة إلى السمات الجديدة. يتضمّن الشكل الأكثر تفصيلاً لهذه الطريقة، GoogleMap.animateCamera(cameraUpdate, duration, callback)، ثلاث وسيطات:

cameraUpdate

CameraUpdate: يصف هذا الحقل المكان الذي يجب نقل الكاميرا إليه.

callback

كائن ينفّذ GoogleMap.CancellableCallback تحدّد هذه الواجهة العامة للتعامل مع المهام طريقتَين، هما `onCancel()` و `onFinished()`. بالنسبة إلى الرسوم المتحركة، يتم استدعاء الطريقتَين في الحالات التالية:

onFinish()

يتم استدعاؤه إذا اكتملت الحركة بدون انقطاع.

onCancel()

يتم استدعاء هذه الطريقة إذا تم إيقاف الحركة بشكل غير متوقّع من خلال استدعاء stopAnimation() أو بدء حركة كاميرا جديدة.

بدلاً من ذلك، يمكن أن يحدث ذلك أيضًا إذا استدعيت GoogleMap.stopAnimation().

duration

تمثّل هذه السمة المدة المطلوبة للحركة، بالمللي ثانية، كـ int.

توضّح مقتطفات الرموز البرمجية التالية بعض الطرق الشائعة لتحريك الكاميرا.

Kotlin

val sydney = LatLng(-33.88, 151.21)
val mountainView = LatLng(37.4, -122.1)

// Move the camera instantly to Sydney with a zoom of 15.
map.moveCamera(CameraUpdateFactory.newLatLngZoom(sydney, 15f))

// Zoom in, animating the camera.
map.animateCamera(CameraUpdateFactory.zoomIn())

// Zoom out to zoom level 10, animating with a duration of 2 seconds.
map.animateCamera(CameraUpdateFactory.zoomTo(10f), 2000, null)

// Construct a CameraPosition focusing on Mountain View and animate the camera to that position.
val cameraPosition = CameraPosition.Builder()
    .target(mountainView) // Sets the center of the map to Mountain View
    .zoom(17f)            // Sets the zoom
    .bearing(90f)         // Sets the orientation of the camera to east
    .tilt(30f)            // Sets the tilt of the camera to 30 degrees
    .build()              // Creates a CameraPosition from the builder
map.animateCamera(CameraUpdateFactory.newCameraPosition(cameraPosition))

      

Java

LatLng sydney = new LatLng(-33.88,151.21);
LatLng mountainView = new LatLng(37.4, -122.1);

// Move the camera instantly to Sydney with a zoom of 15.
map.moveCamera(CameraUpdateFactory.newLatLngZoom(sydney, 15));

// Zoom in, animating the camera.
map.animateCamera(CameraUpdateFactory.zoomIn());

// Zoom out to zoom level 10, animating with a duration of 2 seconds.
map.animateCamera(CameraUpdateFactory.zoomTo(10), 2000, null);

// Construct a CameraPosition focusing on Mountain View and animate the camera to that position.
CameraPosition cameraPosition = new CameraPosition.Builder()
    .target(mountainView )      // Sets the center of the map to Mountain View
    .zoom(17)                   // Sets the zoom
    .bearing(90)                // Sets the orientation of the camera to east
    .tilt(30)                   // Sets the tilt of the camera to 30 degrees
    .build();                   // Creates a CameraPosition from the builder
map.animateCamera(CameraUpdateFactory.newCameraPosition(cameraPosition));