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

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

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

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

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

مقدمة

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

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

تتيح لك حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط 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 هو موضع الخريطة الحالي. تظهر الخريطة الناتجة تحتها.

لقطة شاشة لخريطة تم ضبط الكاميرا فيها على زاوية رؤية 0 درجة، وبمستوى تكبير 18
يتم عرض الخريطة بزاوية العرض التلقائية للكاميرا.
مخطّط بياني يعرض الموضع التلقائي للكاميرا مباشرةً فوق موضع الخريطة بزاوية 0 درجة
زاوية العرض التلقائية للكاميرا

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

لقطة شاشة لخريطة تم وضع كاميرا فيها بزاوية عرض 45 درجة، وبمستوى تكبير 18
يتم عرض الخريطة بزاوية عرض 45 درجة.
مخطّط بياني يعرض زاوية عرض الكاميرا مضبوطة على 45 درجة، مع ضبط مستوى التكبير على 18
زاوية عرض الكاميرا 45 درجة

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

Zoom

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

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

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

  • 1: العالم
  • 5: اليابسة/القارة
  • 10: المدينة
  • 15: الشوارع
  • 20: المباني
توضّح الصور التالية المظهر المرئي لمستويات التكبير/التصغير المختلفة:
لقطة شاشة لخريطة بمستوى تكبير 5
خريطة في مستوى التكبير 5
لقطة شاشة لخريطة بمستوى تكبير 15
خريطة في مستوى التكبير 15
لقطة شاشة لخريطة عند مستوى التكبير 20
خريطة بمستوى تكبير 20

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

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

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

لتغيير موضع الكاميرا، عليك تحديد المكان الذي تريد فيه نقل الكاميرا، باستخدام 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));

وضع الخريطة في منتصف منطقة معيّنة

في بعض الحالات، قد تحتاج إلى وضع الكاميرا في منتصف حدود بدلاً من تضمين الحدود القصوى. على سبيل المثال، لضبط الكاميرا في منتصف بلد معيّن مع الحفاظ على تكبير أو تصغير ثابت. في هذه الحالة، يمكنك استخدام طريقة مشابهة، من خلال إنشاء 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);

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

مخطّط بياني يعرض حدود LatLng لكاميرا أكبر من مساحة العرض

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

مخطّط بياني يعرض استهداف الكاميرا في أسفل يسار حدود LatLng للكاميرا

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

مخطّط بياني يعرض حدود LatLng لكاميرا أصغر من مساحة العرض

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

لتطبيق 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));