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

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

مصنع تحديثات الكاميرا

حصة نهائية علنية CameraUpdateFactory توسيع Object

فئة تحتوي على طرق لإنشاء عناصر 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) لعرض `CameraUpdate` التي تنقل الكاميرا إلى `CameraPosition` محدّد.
ثابتة CameraUpdate	newLatLng(LatLng latLng) تعرض علامة `CameraUpdate` التي تنقل وسط الشاشة إلى خط عرض وخط طول المحددة بواسطة كائن `LatLng`.
ثابتة CameraUpdate	newLatLngBounds(حدود LatLngBounds وعرض int العرض وارتفاع int الطول والمساحة المتروكة int) تعرض `CameraUpdate` تحوّل الكاميرا بحيث توسيط حدود خطوط الطول/العرض على الشاشة داخل مربع إحاطة بأبعاد محددة بأعلى مستوى ممكن من التكبير.
ثابتة CameraUpdate	newLatLngBounds(حدود LatLngBounds، المساحة المتروكة int) تعرض `CameraUpdate` تحوّل الكاميرا بحيث توسيط حدود خطوط الطول/العرض على الشاشة في أعلى مستوى ممكن من التكبير.
ثابتة CameraUpdate	newLatLngZoom(LatLng 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` تنقل نقطة عرض الكاميرا إلى مستوى تكبير/تصغير معيّن.

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

من الصف java.lang.Object

منطقي	يساوي(Object arg0)
النِّهَائِي الصف<?>	getClass()
int	hashCode()
النِّهَائِي فراغ	notify()
النِّهَائِي فراغ	notifyAll()
سلسلة	toString()
النِّهَائِي فراغ	wait(long arg0, int arg1)
النِّهَائِي فراغ	wait(long arg0)
النِّهَائِي فراغ	wait()

الطرق العامة

علنية ثابتة CameraUpdate newCameraPosition (CameraPosition موضع الكاميرا)

لعرض CameraUpdate التي تنقل الكاميرا إلى CameraPosition محدّد. ضِمن يؤدي ذلك إلى إنشاء تحويل من خط عرض الكائن CameraPosition، خط الطول، ومستوى التكبير/التصغير، والاتجاه والإمالة.

المعلمات

cameraPosition

المرتجعات

CameraUpdate تحتوي على التحويل.

علنية ثابتة CameraUpdate newLatLng (LatLng خط الطول والعرض)

تعرض علامة CameraUpdate التي تنقل وسط الشاشة إلى خط عرض وخط طول المحددة بواسطة كائن LatLng. يؤدي هذا إلى تركيز الكاميرا على الجسم LatLng.

المعلمات

latLng	عنصر `LatLng` يحتوي على خط العرض وخط الطول المطلوبين.

المرتجعات

CameraUpdate تحتوي على التحويل.

علنية ثابتة CameraUpdate newLatLngBounds (LatLngBounds حدود، عرض int، ارتفاع int، مساحة متروكة int)

تعرض CameraUpdate تحوّل الكاميرا بحيث توسيط حدود خطوط الطول/العرض على الشاشة داخل مربع إحاطة بأبعاد محددة بأعلى مستوى ممكن من التكبير. يمكنك تحديد مساحة متروكة إضافية لفرض قيود إضافية. حجم المربع المحيط. اتجاه CameraUpdate المعروض 0 وإمالة من 0.

على عكس newLatLngBounds(LatLngBounds, int)، يمكنك استخدام CameraUpdate. الذي تم إرجاعه بهذه الطريقة لتغيير الكاميرا قبل مرحلة التخطيط، بسبب تحدد الوسائط الحجم المطلوب لمربع الإحاطة.

المعلمات

حدود	المنطقة التي تريد وضعها في مربع الإحاطة
العرض	عرض المربع المحيط بالبكسل (بكسل)
الطول	ارتفاع المربع المحيط بالبكسل (بكسل)
padding	قيود الحجم الإضافية (بالبكسل) لمربع الإحاطة

المرتجعات

CameraUpdate تحتوي على التحويل.

علنية ثابتة CameraUpdate newLatLngBounds (LatLngBounds حدود، المساحة المتروكة الصحيحة)

تعرض CameraUpdate تحوّل الكاميرا بحيث توسيط حدود خطوط الطول/العرض على الشاشة في أعلى مستوى ممكن من التكبير. يمكنك تحديد المساحة المتروكة، لإدراج مربع الإحاطة من حواف عرض الخريطة. تم إرجاع اتجاه CameraUpdate هو 0 والإمالة 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 تحتوي على التحويل.

علنية ثابتة CameraUpdate scrollBy (العدد العشري xPixel، العدد العشري 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).

المعلمات

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

المرتجعات

CameraUpdate تحتوي على التحويل.

علنية ثابتة CameraUpdate zoomBy (المبلغ العائم)

عرض CameraUpdate يغيِّر مستوى التكبير أو التصغير لنقطة عرض الكاميرا الحالية

تختلف هذه الطريقة عن طريقة zoomTo(float) في أن مستوى التكبير أو التصغير نسبةً إلى العرض الحالي والكاميرا.

المعلمات

المبلغ	الإلكتروني لتغيير مستوى التكبير/التصغير. تشير القيم الموجبة إلى التكبير الأقرب من سطح الأرض بينما تشير القيم السالبة إلى التكبير بعيدًا عن سطح Google Earth

المرتجعات

CameraUpdate تحتوي على التحويل.

علنية ثابتة CameraUpdate zoomIn ()

عرض CameraUpdate لتكبير الخريطة من خلال تحريك ارتفاع نقطة العرض بشكل أقرب على سطح الأرض. زيادة التكبير أو التصغير هي 1.0.

المرتجعات

CameraUpdate تحتوي على التحويل.

علنية ثابتة CameraUpdate zoomOut ()

عرض CameraUpdate يتم تصغير الخريطة من خلال تحريك ارتفاع نقطة العرض بعيدًا عن سطح الأرض. زيادة التكبير/التصغير هي -1.0.

المرتجعات

CameraUpdate تحتوي على التحويل.

علنية ثابتة CameraUpdate zoomTo (تكبير عائم)

تعرض درجة CameraUpdate تنقل نقطة عرض الكاميرا إلى مستوى تكبير/تصغير معيّن.

المعلمات

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