نظرة عامة
هذه هي الفئة الرئيسية من خرائط Google لنظام التشغيل iOS وهي نقطة الدخول لجميع الطرق ذات الصلة بالخريطة.
يجب إنشاء مثيل للخريطة باستخدام الدالة الإنشائية الملائمة [GMSMapView mapWithFrame:camera:]. ويمكن أيضًا إنشاؤه باستخدام طريقة [[GMSMapView alloc] initWithFrame:] التلقائية (حيث سيتم ضبط الكاميرا على موقع تلقائي).
لا يمكن قراءة وتعديل GMSMapView إلا من سلسلة التعليمات الرئيسية، على غرار جميع كائنات UIKit. وسيؤدي استدعاء هذه الطرق من سلسلة محادثات أخرى إلى حدوث استثناء أو سلوك غير معروف.
دوال الأعضاء العامة | |
| (instancetype) | - initWithFrame:camera: |
| إنشاء وعرض خريطة باستخدام إطار وهدف كاميرا. | |
| (instancetype) | - initWithFrame:mapID:camera: |
| إنشاء عرض خريطة وإرجاعه باستخدام إطار ومعرّف خريطة وهدف كاميرا. | |
| (باطل) | - startRendering |
| تطلب من هذه الخريطة تشغيل عارضها. | |
| (باطل) | - stopRendering |
| تطلب هذه الخريطة إيقاف العارض. | |
| (باطل) | - واضح |
| يؤدي إلى محو جميع الترميزات التي تمت إضافتها إلى الخريطة، بما في ذلك العلامات والخطوط المتعددة وتراكبات الأرض. | |
| (باطل) | - setMinZoom:maxZoom: |
ضبط minZoom وmaxZoom | |
| (GMScameraPosition *) قابل للقيم | - cameraForBounds:insets: |
أنشئ GMS CameraPosition يقدّم bounds مع padding. | |
| (باطل) | - movecamera: |
تغيّر الكاميرا حسب update. | |
| (BOOL) | - areEqualForRenderingPosition:position: |
| تحقّق مما إذا كانت مواضع الكاميرا المحدّدة تؤدي عمليًا إلى عرض الكاميرا بالشكل نفسه، مع الأخذ في الاعتبار مستوى الدقة وعمليات التحويل المستخدمة داخليًا. | |
| (GMSFeatureLayer < GMSPlaceFeature * > *) | - featureLayerOfFeatureType: |
| لعرض طبقة ميزة من النوع المحدد. | |
| (باطل) | - animateToCameraPosition: |
سيتم تحريك كاميرا هذه الخريطة إلى cameraPosition. | |
| (باطل) | - animateToLocation: |
كـ animateTo CameraPosition:، ولكن يغيّر موقع الكاميرا فقط (أي من الموقع الحالي إلى location). | |
| (باطل) | - animateToZoom: |
| كـ animateTo CameraPosition:، ولكن مع تغيير مستوى تكبير/تصغير الكاميرا فقط. | |
| (باطل) | - animateToBearing: |
| بتنسيق animateTo CameraPosition:، ولكنه يغيّر اتجاه الكاميرا فقط (بالدرجات). | |
| (باطل) | - animateToDisplayAngle: |
| كـ animateTo CameraPosition:، ولكنه يغيّر زاوية عرض الكاميرا فقط (بالدرجات). | |
| (باطل) | - animateWithCameraUpdate: |
تطبيق cameraUpdate على الكاميرا الحالية، ثم يستخدم النتيجة وفقًا لـ animateTo CameraPosition: | |
دوال الأعضاء العامة الثابتة | |
| (instancetype) | + mapWithFrame:كاميرا: |
| إنشاء وعرض خريطة باستخدام إطار وهدف كاميرا. | |
| (instancetype) | + mapWithFrame:mapID:camera: |
| أداة تهيئة مريحة لإنشاء عرض خريطة وإرجاعه مع إطار ورقم تعريف خريطة وهدف كاميرا. | |
المواقع | |
| معرّف IBOutlet< GMSMapView المرسَلة > | تفويض |
| تفويض GMSMapView. | |
| GMSCameraPosition * | كاميرا |
| تتحكّم هذه السياسة في الكاميرا التي تحدّد طريقة توجيه الخريطة. | |
| GMSProjection * | التوقّع |
| تعرض كائن GMSProjection الذي يمكنك استخدامه للتحويل بين إحداثيات الشاشة وإحداثيات خطوط الطول والعرض. | |
| BOOL | myLocationEnabled |
| يتحكّم هذا الإعداد في تفعيل نقطة موقعي الجغرافي ودائرة الدقة. | |
| CLLocation * | موقعي الجغرافي |
| إذا تم تمكين ميزة "موقعي"، فإنها توضح المكان الذي يتم فيه رسم نقطة موقع الجهاز. | |
| GMSMarker * | selectMarker |
| العلامة التي تم اختيارها. | |
| BOOL | trafficEnabled |
| للتحكم في ما إذا كانت الخريطة ترسم بيانات حركة المرور، إذا توفرت. | |
| GMSMapViewType | mapType |
| تتحكم في نوع مربعات الخرائط التي يجب عرضها. | |
| GMSMapStyle * | نمط الخريطة |
| التحكم في نمط الخريطة. | |
| عدد عائم | minZoom |
| الحد الأدنى للتكبير/التصغير (يمكن تصغير أبعد الكاميرا) | |
| عدد عائم | maxZoom |
| الحد الأقصى للتكبير/التصغير (قد تكون أقرب الكاميرا من الأرض). | |
| BOOL | buildingsEnabled |
| وفي حال ضبطها، سيتم عرض المباني الثلاثية الأبعاد في حال توفّرها. | |
| BOOL | indoorEnabled |
| تحدِّد هذه السياسة ما إذا كان سيتم عرض الخرائط الداخلية، متى توفّرت. | |
| GMSIndoorDisplay * | العرض الداخلي |
| الحصول على مثيل GMSIndoorDisplay الذي يسمح بمراقبة جوانب عرض البيانات في الأماكن الداخلية أو التحكّم فيها | |
| GMSUISettings * | الإعدادات |
| احصل على الكائن GMSUISettings الذي يتحكّم في إعدادات واجهة المستخدم للخريطة. | |
| UIEdgeInsets | المساحة المتروكة |
| تتحكم هذه السياسة في المنطقة "المرئية" من العرض. | |
| GMSMapViewPaddingExtensionBehavior | iPodتعديلBehavior |
| تتحكّم هذه السياسة في كيفية إضافة الإدخالات الداخلية للمنطقة الآمنة إلى قيم المساحة المتروكة. | |
| BOOL | accessibilityElementsHidden |
| يكون الإعداد التلقائي بالقيمة YES. | |
| GMSMapLayer * | طبقة |
| موصّل لنوع CALayer المخصّص المستخدم للطبقة. | |
| GMSFrameRate | PreferredFrameRate |
| تتحكّم هذه السياسة في عدد اللقطات في الثانية عند العرض. | |
| GMSCoordenteBounds * | cameraTargetBounds |
| إذا لم يكن صفرًا، يتم تقييد هدف الكاميرا بحيث لا يمكن أن تؤدي الإيماءات إلى ترك الحدود المحددة. | |
| GMSMapCapabilityFlags | mapCapability |
| جميع الإمكانات المتاحة بشروط (تعتمد على mapID أو إعدادات الخريطة الأخرى) التي تتوفّر في الوقت الحالي. | |
الدوال ذات الصلة | |
(لاحظ أن هذه ليست دوال أساسية). | |
| التباين في سلسلة NSString | kGMSAccessibilityCompass |
| معرّف تسهيل الاستخدام لزر البوصلة | |
| التباين في سلسلة NSString | kGMSAccessibilityMyLocation |
| معرّف إمكانية الوصول للزر "موقعي الجغرافي" | |
| التباين في سلسلة NSString | kGMSAccessibilityOutOfQuota |
| معرِّف تسهيل الاستخدام لتصنيف الخطأ "نفد الحصة". | |
وثائق دالة العضو
| + (instancetype) mapWithFrame: | (CGRect) | إطار | |
| كاميرا: | (GMS CameraPosition *) | الكاميرا | |
إنشاء وعرض خريطة باستخدام إطار وهدف كاميرا.
| + (instancetype) mapWithFrame: | (CGRect) | إطار | |
| mapID: | (GMSMapID *) | mapID | |
| كاميرا: | (GMS CameraPosition *) | الكاميرا | |
أداة تهيئة مريحة لإنشاء عرض خريطة وإرجاعه مع إطار ورقم تعريف خريطة وهدف كاميرا.
| - (instancetype) initWithFrame: | (CGRect) | إطار | |
| كاميرا: | (GMS CameraPosition *) | الكاميرا | |
إنشاء وعرض خريطة باستخدام إطار وهدف كاميرا.
| - (instancetype) initWithFrame: | (CGRect) | إطار | |
| mapID: | (GMSMapID *) | mapID | |
| كاميرا: | (GMS CameraPosition *) | الكاميرا | |
إنشاء عرض خريطة وإرجاعه باستخدام إطار ومعرّف خريطة وهدف كاميرا.
| - (باطل) بدء العرض |
تطلب من هذه الخريطة تشغيل عارضها.
وهذا أمر اختياري ولا رجعة فيه.
- ملاحظة:
- تم إيقاف هذا الإجراء نهائيًا. هذه الطريقة قديمة وستتم إزالتها في إصدار مستقبلي.
| - (باطل) إيقاف العرض |
تطلب هذه الخريطة إيقاف العارض.
وهذا أمر اختياري ولا رجعة فيه.
- ملاحظة:
- تم إيقاف هذا الإجراء نهائيًا. هذه الطريقة قديمة وستتم إزالتها في إصدار مستقبلي.
| - (باطل) محو |
يؤدي إلى محو جميع الترميزات التي تمت إضافتها إلى الخريطة، بما في ذلك العلامات والخطوط المتعددة وتراكبات الأرض.
لن يؤدي هذا إلى محو نقطة الموقع المرئية أو إعادة ضبط نوع الخريطة الحالي.
| - (void) setMinZoom: | (عدد عائم) | minZoom | |
| maxZoom: | (عدد عائم) | maxZoom | |
ضبط minZoom وmaxZoom
تتوقع هذه الطريقة أن يكون الحد الأدنى أقل من أو يساوي الحد الأقصى، وستطرح استثناء مع الاسم NSRangeException في الحالات الأخرى.
| - (GMS CameraPosition *) CameraForBounds: | (GMSCoordenteBounds *) | الحدود | |
| الإدخالات: | (UIEdgeInsets) | المجموعات | |
أنشئ GMS CameraPosition يقدّم bounds مع padding.
سيكون هناك اتجاه صفري وإمالة للكاميرا (أي أنها موجهة للشمال والنظر مباشرةً إلى الأرض). هذا يأخذ في الاعتبار الإطار والمساحة المتروكة لـ GMSMapView.
إذا كانت الحدود غير صالحة، ستعرض هذه الطريقة كاميرا صفر.
| - (void) movecamera: | (GMS CameraUpdate *) | تعديل |
تغيّر الكاميرا حسب update.
يكون تغيير الكاميرا فوريًا (بدون رسوم متحركة).
| - (BOOL) areEqualForRenderingPosition: | (GMS CameraPosition *) | الموضع | |
| الموضع: | (GMS CameraPosition *) | otherالموضع | |
تحقّق مما إذا كانت مواضع الكاميرا المحدّدة تؤدي عمليًا إلى عرض الكاميرا بالشكل نفسه، مع الأخذ في الاعتبار مستوى الدقة وعمليات التحويل المستخدمة داخليًا.
| - (GMSFeatureLayer<GMSPlaceFeature *> *) featureLayerOfFeatureType: | (GMSFeatureType) | نوع الميزة |
لعرض طبقة ميزة من النوع المحدد.
يجب إعداد طبقات الميزات في Cloud Console.
في حال عدم توفّر طبقة من النوع المحدّد على هذه الخريطة، أو عدم تفعيل التصميم المستند إلى البيانات، أو في حال عدم استخدام إطار عمل عرض "المعدن"، ستكون الطبقة الناتجة هي "NO"، ولن تستجيب لأي استدعاءات.
يجب استخدام عارض المعادن. اطّلع على كيفية تفعيل Metal من خلال الرابط https://developers.google.com/maps/documentation/ios-sdk/config#use-metal.
| - (void) animateToCameraPosition: | (GMS CameraPosition *) | cameraPosition |
سيتم تحريك كاميرا هذه الخريطة إلى cameraPosition.
| - (باطل) animateToLocation: | (CLLocationCoordente2D) | الموقع الجغرافي |
كصيغة animateTo CameraPosition:، ولكن مع تغيير موقع الكاميرا فقط (أي من الموقع الحالي إلى location)
| - (ملء) animateToZoom: | (عدد عائم) | تكبير/تصغير |
كـ animateTo CameraPosition:، ولكن مع تغيير مستوى تكبير/تصغير الكاميرا فقط.
يتم تثبيت هذه القيمة بواسطة [kGMSMinZoomLevel, kGMSMaxZoomLevel].
| - (void) animateToBearing: | (CLLocationDirection) | تحمل |
بتنسيق animateTo CameraPosition:، ولكنه يغيّر اتجاه الكاميرا فقط (بالدرجات).
يشير الصفر إلى الشمال الحقيقي.
| - (void) animateToDisplayAngle: | (مزدوج) | زاوية العرض |
كـ animateTo CameraPosition:، ولكنه يغيّر زاوية عرض الكاميرا فقط (بالدرجات).
سيتم تثبيت هذه القيمة على صفر (أي، موجَّهًا لأسفل مباشرةً) وتتراوح بين 30 و45 درجة باتجاه الأفق، استنادًا إلى القرب النسبي للأرض.
| - (void) animateWithCameraUpdate: | (GMS CameraUpdate *) | cameraUpdate |
تطبيق cameraUpdate على الكاميرا الحالية، ثم يستخدم النتيجة وفقًا لـ animateTo CameraPosition:
وثائق الأصدقاء والدوال ذات الصلة
- (NSString* Cont) kGMSAccessibilityCompass [related] |
معرّف تسهيل الاستخدام لزر البوصلة
- (NSString* Cont) kGMSAccessibilityMyLocation [related] |
معرّف إمكانية الوصول للزر "موقعي الجغرافي"
- (NSString* Cont) kGMSAccessibilityOutOfQuota [related] |
معرِّف تسهيل الاستخدام لتصنيف الخطأ "نفد الحصة".
وثائق عقارية
- (IBOutlet id<GMSMapView المرسَلة>) delegate [read, write, assign] |
تفويض GMSMapView.
- (GMSCameraPosition*) camera [read, write, copy] |
تتحكّم هذه السياسة في الكاميرا التي تحدّد طريقة توجيه الخريطة.
يكون التعديل في هذه السمة فوريًا.
- (GMSProjection*) توقع [read, assign] |
تعرض كائن GMSProjection الذي يمكنك استخدامه للتحويل بين إحداثيات الشاشة وإحداثيات خطوط الطول والعرض.
هذه لقطة للإسقاط الحالي، ولن يتم تحديثها تلقائيًا عندما تتحرك الكاميرا. ويمثل هذا العنصر إما إسقاط آخر إطار GMSMapView مرسوم، أو مكان ضبط الكاميرا بوضوح أو الخريطة التي تم إنشاؤها للتو، الإطار القادم. لن يكون معدومًا أبدًا.
- (BOOL) myLocationEnabled [read, write, assign] |
يتحكّم هذا الإعداد في تفعيل نقطة موقعي الجغرافي ودائرة الدقة.
يكون الإعداد التلقائي بالقيمة NO.
- (CLLocation*) myLocation [read, assign] |
إذا تم تمكين ميزة "موقعي"، فإنها توضح المكان الذي يتم فيه رسم نقطة موقع الجهاز.
أما إذا تم إيقافه أو تم تفعيله ولكن لا تتوفّر أي بيانات للموقع الجغرافي، فلن يكون هناك أي بيانات. يمكن ملاحظة هذه الخاصية باستخدام KVO.
- (GMSMarker*) selectMarker [read, write, assign] |
العلامة التي تم اختيارها.
يؤدي ضبط هذه الخاصية إلى اختيار علامة معيّنة، مع عرض نافذة معلومات عليها. إذا لم تكن هذه السمة معدومة، يؤدي ضبطها على صفر إلى إلغاء تحديد العلامة، ما يؤدي إلى إخفاء نافذة المعلومات. يمكن ملاحظة هذه الخاصية باستخدام KVO.
- (BOOL) trafficEnabled [read, write, assign] |
للتحكم في ما إذا كانت الخريطة ترسم بيانات حركة المرور، إذا توفرت.
ويعتمد ذلك على مدى توفّر بيانات حركة المرور. يكون الإعداد التلقائي بالقيمة NO.
- (GMSMapViewType) mapType [read, write, assign] |
تتحكم في نوع مربعات الخرائط التي يجب عرضها.
تكون الإعدادات التلقائية إلى kGMSTypenormal.
- (GMSMapStyle*) mapStyle [read, write, assign] |
التحكم في نمط الخريطة.
لن يتم تطبيق mapStyle بدون قيمة إلا إذا كان mapType هو "عادي".
- (عدد عائم) minZoom [read, assign] |
الحد الأدنى للتكبير/التصغير (يمكن تصغير أبعد الكاميرا)
يتم ضبط السياسة تلقائيًا على kGMSMinZoomLevel. تم التعديل باستخدام -setMinZoom:maxZoom:.
- (عدد عائم) maxZoom [read, assign] |
الحد الأقصى للتكبير/التصغير (قد تكون أقرب الكاميرا من الأرض).
يتم ضبط السياسة تلقائيًا على kGMSMaxZoomLevel. تم التعديل باستخدام -setMinZoom:maxZoom:.
- (BOOL) buildingsEnabled [read, write, assign] |
وفي حال ضبطها، سيتم عرض المباني الثلاثية الأبعاد في حال توفّرها.
يكون الإعداد التلقائي بالقيمة YES.
قد يكون هذا مفيدًا عند إضافة طبقة تجانب مخصصة إلى الخريطة، وذلك لجعلها أكثر وضوحًا عند مستويات تكبير/تصغير عالية. سيؤدي تغيير هذه القيمة إلى إلغاء صلاحية جميع المربّعات لفترة قصيرة.
- (BOOL) indoorEnabled [read, write, assign] |
تحدِّد هذه السياسة ما إذا كان سيتم عرض الخرائط الداخلية، متى توفّرت.
يكون الإعداد التلقائي بالقيمة YES.
في حال ضبط هذه السياسة على "لا"، قد تتم إزالة ذاكرات التخزين المؤقت للبيانات الداخلية ويمكن إعادة ضبط أي طابق تم اختياره حاليًا من قِبل المستخدم النهائي.
- (GMSIndoorDisplay*) indoorDisplay [read, assign] |
الحصول على مثيل GMSIndoorDisplay الذي يسمح بمراقبة جوانب عرض البيانات في الأماكن الداخلية أو التحكّم فيها
- (GMSUISettings*) الإعدادات [read, assign] |
احصل على الكائن GMSUISettings الذي يتحكّم في إعدادات واجهة المستخدم للخريطة.
- (UIEdgeInsets) المساحة المتروكة [read, write, assign] |
تتحكم هذه السياسة في المنطقة "المرئية" من العرض.
من خلال تطبيق المساحة المتروكة على منطقة حول حافة العرض، يمكن إنشاء مساحة تحتوي على بيانات خريطة ولكنها لن تحتوي على عناصر تحكم في واجهة المستخدم.
إذا كانت المساحة المتروكة غير متوازنة، فسيتم نقل المركز المرئي للعرض حسب الحاجة. ستؤثر المساحة المتروكة أيضًا في سمة projection، وبالتالي لن تشمل المنطقة المرئية مساحة المساحة المتروكة. سيضمن GMS CameraUpdate أن يتم وضع هذه المساحة المتروكة وأي مساحة متروكة مطلوبة في الاعتبار.
قد يكون هذا الموقع متحركًا ضمن كتلة صور متحركة مستندة إلى UIView.
- (GMSMapViewPadding AdjustBehavior) uff عديدةBehavior [read, write, assign] |
تتحكّم هذه السياسة في كيفية إضافة الإدخالات الداخلية للمنطقة الآمنة إلى قيم المساحة المتروكة.
مثل المساحة المتروكة، تؤدي المنطقة الآمنة إلى إدراج عناصر تحكّم في خريطة الموضع، مثل البوصلة وزر الموقع الجغرافي ومنتقي الأرضية داخل المنطقة الآمنة للجهاز.
يتم ضبط السياسة تلقائيًا على kGMSMapViewPaddingBehaviorBehavior.
- (BOOL) accessibilityElementsHidden [read, write, assign] |
يكون الإعداد التلقائي بالقيمة YES.
في حال ضبط السياسة على "لا"، ستنشئ GMSMapView عناصر إمكانية الوصول لكائنات التراكب، مثل GMSMarker وGMSPolyline.
تتّبع هذه السمة بروتوكول UIAccessibility غير الرسمي، باستثناء القيمة التلقائية YES.
- (GMSMapLayer*) طبقة [read, retain] |
موصّل لنوع CALayer المخصّص المستخدم للطبقة.
- (GMSFrameRate) PreferredFrameRate [read, write, assign] |
تتحكّم هذه السياسة في عدد اللقطات في الثانية عند العرض.
القيمة التلقائية هي kGMSFrameRateالحد الأقصى.
- (GMSCoordenteBounds*) cameraTargetBounds [read, write, assign] |
إذا لم يكن صفرًا، يتم تقييد هدف الكاميرا بحيث لا يمكن أن تؤدي الإيماءات إلى ترك الحدود المحددة.
- (GMSMapCapabilityFlags) mapCapغنيs [read, assign] |
جميع الإمكانات المتاحة بشروط (تعتمد على mapID أو إعدادات الخريطة الأخرى) التي تتوفّر في الوقت الحالي.
لا تتضمن الإمكانات المتاحة دائمًا.