نظرة عامة
هذه هي الفئة الرئيسية من حزمة SDK لخرائط Google لنظام التشغيل iOS وهي نقطة الدخول لجميع الطرق ذات الصلة بالخريطة.
يجب إنشاء مثيل للخريطة باستخدام إحدى الأدوات الإنشائية -init أو -initWithOptions:.
لا يمكن قراءة دالة GMSMapView وتعديلها إلا من سلسلة التعليمات الرئيسية، على غرار جميع كائنات UIKit. سيؤدي استدعاء هذه الطرق من سلسلة محادثات أخرى إلى حدوث استثناء أو سلوك غير معروف.
وظائف الأعضاء العامة | |
(instancetype) | - init |
يتم إعداده باستخدام CGRectZero والخيارات التلقائية. | |
(instancetype) | - initWithOptions: |
لإنشاء عرض خريطة جديد باستخدام الخيارات المحددة. | |
(instancetype) | - initWithFrame: |
(نوع المثيل القابل للقيم الفارغة) | - initWithCoder: |
(instancetype) | - initWithFrame:camera: |
إنشاء وعرض خريطة عرض، مع إطار وهدف كاميرا. | |
(instancetype) | - initWithFrame:mapID:camera: |
لإنشاء عرض خريطة وإرجاعه باستخدام إطار ومعرّف خريطة وهدف الكاميرا. | |
(void) | - startRendering |
يطلب هذه الخريطة تعزيز جهاز العرض. | |
(void) | - stopRendering |
يطلب هذه الخريطة إيقاف العارض الخاص بها. | |
(void) | - واضحة |
يؤدي إلى محو كل الترميز الذي تمت إضافته إلى الخريطة، بما في ذلك العلامات والخطوط المتعددة وتراكبات الأرض. | |
(void) | - setMinZoom:maxZoom: |
ضبط minZoom وmaxZoom | |
(nullable GMSCameraPosition *) | - cameraForBounds:insets: |
أنشئ GMSCameraPosition الذي يعرض bounds مع padding . | |
(void) | - moveالكاميرا: |
سيتم تغيير الكاميرا وفقًا لـ update . | |
(BOOL) | - areEqualForRenderingPosition:position: |
تحقَّق مما إذا كانت أوضاع الكاميرا المحدّدة تؤدي عمليًا إلى عرض الكاميرا بالطريقة نفسها، مع الأخذ في الاعتبار مستوى الدقة والتحولات المستخدَمة داخليًا. | |
(GMSFeatureLayer < GMSPlaceFeature * > *) | - featureLayerOfFeatureType: |
لعرض طبقة عناصر من النوع المحدد. | |
(GMSDatasetFeatureLayer *) | - datasetFeatureLayerOfDatasetID: |
تعرض طبقة عناصر مجموعة بيانات لمجموعة البيانات المحددة. | |
(void) | - inassessLayoutForAccessoryView: |
يؤدي هذا الإجراء إلى إلغاء صلاحية طريقة عرض ملحقة وبدء إعادة تنسيق هذا الملف الشخصي. | |
(void) | - setHeaderAccessoryView: |
لضبط موضع عرض الملحق أسفل الرأس الأساسي لواجهة مستخدم التنقل. | |
(void) | - animateToCameraPosition: |
ستتحرك كاميرا هذه الخريطة إلى cameraPosition . | |
(void) | - animateToLocation: |
مثل animateTo CameraPosition: ولكن يتم تغيير موقع الكاميرا فقط (أي من الموقع الحالي إلى location ). | |
(void) | - animateToZoom: |
مثل animateTo CameraPosition: ولكن يغير مستوى تكبير/تصغير الكاميرا فقط. | |
(void) | - animateToBearing: |
مثل animateTo CameraPosition: ولكن يتم تغيير اتجاه الكاميرا فقط (بالدرجات). | |
(void) | - animateToDisplayAngle: |
مثل animateTo CameraPosition:، ولكن يغير زاوية عرض الكاميرا فقط (بالدرجات). | |
(void) | - animateWithCameraUpdate: |
ينطبق cameraUpdate على الكاميرا الحالية، ثم يستخدم النتيجة وفقًا لـ animateTo CameraPosition:. | |
(void) | - didBeginPanGesture |
يجب استدعاء هذه الطريقة من خلال تنفيذ التطبيق لطريقة CPMapTemplateDelegate -mapTemplate DidstarterPan البدء في تنفيذ إيماءات العرض الشامل لنماذج خرائط CarPlay. | |
(void) | - didUpdatePanالإيماءاتWithTranslation:velocity: |
يجب استدعاء هذه الطريقة عند تنفيذ التطبيق لطريقة CPMapTemplateDelegate -mapTemplate:didUpdatePan المحدَّدWithTranslation: لتنفيذ إيماءات العرض الشامل لنماذج الخرائط في CarPlay. | |
(void) | - didEndPanالإيماءاتWithVelocity: |
يجب استدعاء هذه الطريقة عند تنفيذ التطبيق لطريقة CPMapTemplateDelegate -mapTemplate:didEndPan المحدَّدWithVelocity: وذلك من أجل تنفيذ إيماءات العرض الشامل لنماذج الخرائط في CarPlay. | |
(BOOL) | - enablenavigationWithSession: |
لبدء التنقل في عرض الخريطة هذا باستخدام جلسة التنقّل المحددة. | |
دوال الأعضاء العامة الثابتة | |
(instancetype) | + mapWithFrame:الكاميرا: |
لإنشاء عرض خريطة وإرجاعه باستخدام إطار وهدف كاميرا. | |
(instancetype) | + mapWithFrame:mapID:camera: |
أداة إعداد مريحة تتيح إنشاء وعرض خريطة باستخدام إطار ومعرّف الخريطة وهدف الكاميرا. | |
المواقع | |
معرّف IBOutlet< GMSMapViewDelegate > | تفويض |
المستخدم المفوَّض GMSMapView. | |
GMSCameraPosition * | كاميرا |
تتحكّم هذه السياسة في الكاميرا التي تحدِّد كيفية توجيه الخريطة. | |
GMSProjection * | التوقع |
تعرض كائن GMSProjection الذي يمكنك استخدامه للتحويل بين إحداثيات الشاشة وإحداثيات خطوط الطول/العرض. | |
قيمة منطقية | myLocationEnabled |
تتحكَّم هذه السياسة في ما إذا كان سيتم تفعيل نقطة "موقعي" ودائرة الدقة. | |
CLLocation * | myLocation |
في حالة تمكين ميزة "موقعي"، فإنه تكشف عن المكان الذي يتم فيه رسم نقطة موقع الجهاز. | |
GMSMarker * | selectedMarker |
العلامة التي تم اختيارها. | |
قيمة منطقية | trafficEnabled |
تتحكّم هذه السياسة في ما إذا كانت الخريطة ترسم بيانات حركة المرور، إذا كان ذلك متاحًا. | |
GMSMapViewType | mapType |
تتحكّم هذه السياسة في نوع مربّعات الخرائط التي يجب عرضها. | |
GMSMapStyle * | mapStyle |
تتحكّم هذه السياسة في نمط الخريطة. | |
نمط واجهة مستخدم واجهة المستخدم | overrideUserInterfaceStyle |
غيِّر الخريطة إلى [UIUserInterfaceStyle](https://developer.apple.com/documentation/uikit/uiuserinterfacestyle?language=objc). | |
float | minZoom |
الحد الأدنى للتكبير/التصغير (أبعد مسافة يمكن تصغير الكاميرا فيها). | |
float | maxZoom |
الحد الأقصى للتكبير أو التصغير (أقرب مسافة قد تكون فيها الكاميرا من الأرض). | |
قيمة منطقية | buildingsEnabled |
في حال ضبطها، ستظهر المباني الثلاثية الأبعاد أينما توفّرت. | |
قيمة منطقية | indoorEnabled |
تحدد ما إذا كان سيتم عرض الخرائط الداخلية، حيثما كانت متاحة. | |
GMSIndoorDisplay * | indoorDisplay |
للحصول على مثيل GMSIndoorDisplay الذي يسمح بمراقبة جوانب عرض البيانات في الداخل أو التحكّم فيها. | |
GMSUISettings * | الإعدادات |
الحصول على الكائن GMSUISettings الذي يتحكّم في إعدادات واجهة المستخدم للخريطة | |
UIEdgeInsets | المساحة المتروكة |
التحكم في المنطقة "المرئية" من العرض. | |
GMSMapViewPaddingAdjustmentBehavior | paddingAdjustmentBehavior |
تتحكّم هذه السياسة في كيفية إضافة المساحات الداخلية في المنطقة الآمنة إلى قيم المساحة المتروكة. | |
قيمة منطقية | accessibilityElementsHidden |
يكون الإعداد التلقائي بالقيمة "نعم". | |
GMSMapLayer * | الطبقة |
موصّل لنوع CALayer المخصص المستخدم للطبقة. | |
GMSFrameRate | preferredFrameRate |
تتحكّم هذه السياسة في عدد اللقطات في الثانية أثناء العرض. | |
GMSCoordinateBounds * | cameraTargetBounds |
وإذا لم تكن قيمة فارغة، يتم تقييد هدف الكاميرا بحيث لا يمكن للإيماءات أن تتسبب في خروج الحدود المحددة. | |
GMSMapCapabilityFlags | mapCapabilities |
جميع الإمكانات المتاحة بشروط (تعتمد على mapID أو إعدادات الخريطة الأخرى) المتاحة في الوقت الحالي | |
معرّف IBOutlet < GMSMapViewNavigationUIDelegate > | navigationUIDelegate |
مفوَّض GMSMapView الذي يتلقى استدعاءات لأحداث واجهة المستخدم للتنقُّل. | |
قيمة منطقية | navigationEnabled |
ما إذا كانت وظيفة التنقّل في هذه الخريطة مفعَّلة. | |
GMSNavigator * | أداة التنقّل |
أداة التنقّل في GMSMapView هذا الذي يسمح بطلب المسارات وبدء استخدام الإرشادات التفصيلية | |
GMSRoadSnappedLocationProvider * | roadSnappedLocationProvider |
السماح بالاشتراك في تحديثات الموقع الجغرافي التي تم التقاطها على الطريق. | |
GMSLocationSimulator * | locationSimulator |
تسمح لك هذه الميزة بمحاكاة الموقع الجغرافي للجهاز. | |
GMSNavigationCameraMode | cameraMode |
وضع الكاميرا الذي يحدد سلوكها عند ضبط الخاصية NavigationEnabled على "نعم". | |
GMSNavigationCameraPerspective | followingPerspective |
منظور الكاميرا الذي سيتم استخدامه عند متابعة الموقع الجغرافي للجهاز | |
GMSNavigationTravelMode | travelMode |
وضع السفر الذي يحدد نوع المسارات التي سيتم جلبها والطريقة التي يتم بها تحديد مسار الجهاز. | |
GMSNavigationLightingMode | lightingMode |
يحدد وضع الإضاءة نظام الألوان الذي يجب استخدامه لعرض الخريطة. | |
قيمة منطقية | shouldDisplaySpeedLimit |
تحدِّد ما إذا كان يجب عرض حد السرعة عندما يكون التوجيه نشطًا وتوفُّر بيانات حدود السرعة. | |
قيمة منطقية | shouldDisplaySpeedometer |
تحدِّد هذه السياسة ما إذا كان سيتم عرض رمز عدّاد السرعة. | |
UILayoutGuide * | navigationHeaderLayoutGuide |
المستطيل الذي يغطيه عنوان التنقل. | |
UILayoutGuide * | navigationFooterLayoutGuide |
المستطيل الذي يغطيه تذييل التنقل. | |
GMSNavigationRouteCalloutFormat | routeCalloutFormat |
يحدد تنسيق وسيلة شرح المسار (التلقائي أو الوقت أو المسافة) المطلوب استخدامه. | |
float | followingZoomLevel |
مستوى التكبير/التصغير المخصص أثناء التنقل. | |
GMSRoadSnappedLocationProvider * | roadSnappedMyLocationSource |
تعيين مزوِّد خدمة "موقعي" لعرض الخريطة هذا. | |
الدوال ذات الصلة | |
(يُرجى العلم أنّ هذه الدوال ليست أعضاء.) | |
NSString *const | kGMSAccessibilityCompass |
معرّف تسهيل الاستخدام لزر البوصلة | |
NSString *const | kGMSAccessibilityMyLocation |
معرّف إمكانية الوصول لزر "موقعي". | |
NSString *const | kGMSAccessibilityOutOfQuota |
معرّف إمكانية الوصول لتصنيف الخطأ "انتهت الحصة". |
وثائق وظائف الأعضاء
- (instancetype) init |
يتم إعداده باستخدام CGRectZero والخيارات التلقائية.
- (instancetype) initWithOptions: | (GMSMapViewOptions غير فارغة *) | خيارات |
لإنشاء عرض خريطة جديد باستخدام الخيارات المحددة.
يتم نسخ قيمة كائن الخيارات بهذه الطريقة.
- (instancetype) initWithFrame: | (CGRect) | إطار |
- (نوع المثيل القابل للقيم الفارغة) initWithCoder: | (NSCoder *) | برنامج ترميز |
+ (instancetype) mapWithFrame: | (CGRect) | إطار | |
الكاميرا: | (GMSCameraPosition *) | كاميرا | |
لإنشاء عرض خريطة وإرجاعه باستخدام إطار وهدف كاميرا.
+ (instancetype) mapWithFrame: | (CGRect) | إطار | |
معرف الخريطة: | (GMSMAPID *) | mapID | |
الكاميرا: | (GMSCameraPosition *) | كاميرا | |
أداة إعداد مريحة تتيح إنشاء وعرض خريطة باستخدام إطار ومعرّف الخريطة وهدف الكاميرا.
- (instancetype) initWithFrame: | (CGRect) | إطار | |
الكاميرا: | (GMSCameraPosition *) | كاميرا | |
إنشاء وعرض خريطة عرض، مع إطار وهدف كاميرا.
- ملاحظة:
- تم إيقاف هذا الإجراء نهائيًا. استخدم -init أو -initWithOptions: بدلاً من ذلك.
- (instancetype) initWithFrame: | (CGRect) | إطار | |
معرف الخريطة: | (GMSMAPID *) | mapID | |
الكاميرا: | (GMSCameraPosition *) | كاميرا | |
لإنشاء عرض خريطة وإرجاعه باستخدام إطار ومعرّف خريطة وهدف الكاميرا.
- ملاحظة:
- تم إيقاف هذا الإجراء نهائيًا. استخدم -init أو -initWithOptions: بدلاً من ذلك.
- (إبطال) startRendering |
يطلب هذه الخريطة تعزيز جهاز العرض.
وهذه الخطوة اختيارية.
- ملاحظة:
- تم إيقاف هذا الإجراء نهائيًا. هذه الطريقة قديمة وستتم إزالتها في إصدار مستقبلي.
- (إبطال) stopRendering |
يطلب هذه الخريطة إيقاف العارض الخاص بها.
وهذه الخطوة اختيارية.
- ملاحظة:
- تم إيقاف هذا الإجراء نهائيًا. هذه الطريقة قديمة وستتم إزالتها في إصدار مستقبلي.
- (باطل) واضح |
يؤدي إلى محو كل الترميز الذي تمت إضافته إلى الخريطة، بما في ذلك العلامات والخطوط المتعددة وتراكبات الأرض.
لن يؤدي هذا إلى محو نقطة الموقع المرئية أو إعادة ضبط نوع الخريطة الحالي.
- (صيغة فارغة) setMinZoom: | (float) | minZoom | |
maxZoom: | (float) | maxZoom | |
ضبط minZoom
وmaxZoom
تتوقع هذه الطريقة أن يكون الحد الأدنى أقل من أو يساوي الحد الأقصى، وستطرح استثناء باسم NSRangeException في الحالات الأخرى.
- (nullable GMSCameraPosition *) cameraForBounds: | (GMSCoordinateBounds *) | الحدود | |
المساحات الداخلية: | (UIEdgeInsets) | الروابط | |
أنشئ GMSCameraPosition الذي يعرض bounds
مع padding
.
سيكون هناك انعطاف وإمالة للكاميرا (أي أنها متجهة إلى الشمال وتنظر مباشرة إلى الأرض). يأخذ ذلك الإطار والمساحة المتروكة في عنصر GMSMapView هذا في الاعتبار.
إذا كانت الحدود غير صالحة، ستعرض هذه الطريقة كاميرا فارغة.
- (إبطال) movecam: | (GMSCameraUpdate *) | تعديل |
سيتم تغيير الكاميرا وفقًا لـ update
.
يحدث تغيير الكاميرا بشكل لحظي (بدون رسوم متحركة).
- (BOOL) areEqualForRenderingPosition: | (GMSCameraPosition *) | الموضع | |
الموضع: | (GMSCameraPosition *) | otherPosition | |
تحقَّق مما إذا كانت أوضاع الكاميرا المحدّدة تؤدي عمليًا إلى عرض الكاميرا بالطريقة نفسها، مع الأخذ في الاعتبار مستوى الدقة والتحولات المستخدَمة داخليًا.
- (GMSFeatureLayer<GMSPlaceFeature *> *) featureLayerOfFeatureType: | (GMSFeatureType) | featureType |
لعرض طبقة عناصر من النوع المحدد.
يجب إعداد طبقات الميزات في Cloud Console.
في حال عدم توفّر طبقة من النوع المحدّد على هذه الخريطة، أو في حال عدم تفعيل التصميم المستند إلى البيانات، أو في حال عدم استخدام إطار عمل عرض المعدن، ستكون isAvailable
للطبقة الناتجة NO
، ولن تستجيب لأي طلبات.
تتطلب عارض Metal. تعرّف على كيفية تفعيل Metal من خلال الانتقال إلى https://developers.google.com/maps/documentation/ios-sdk/config#use-metal
- (GMSDatasetFeatureLayer *) datasetFeatureLayerOfDatasetID: | (NSString *) | datasetID |
تعرض طبقة عناصر مجموعة بيانات لمجموعة البيانات المحددة.
يجب إعداد أرقام تعريف مجموعات البيانات في Cloud Console.
إذا لم تتوفّر مجموعة بيانات للمعرّف المحدّد على هذه الخريطة، أو إذا لم يتم تفعيل التصميم المستند إلى البيانات، ستكون قيمة isAvailable
للطبقة الناتجة هي NO
، ولن تستجيب لأي طلبات.
- (لِتَنْفِيذْ رَفْطْ) inفائدةLayoutForAccessoryView: | (UIView< GMSNavigationAccessoryView > *) | accessoryView |
يؤدي هذا الإجراء إلى إلغاء صلاحية طريقة عرض ملحقة وبدء إعادة تنسيق هذا الملف الشخصي.
يجب أن تكون طريقة العرض إحدى طرق العرض الحالية للملحقات. إذا كانت هذه المكالمة غير نشطة، تكون هذه المكالمة بمثابة تعليمات لا يمكن استخدامها.
- (إبطال) setHeaderAccessoryView: | (UIView قابلة للقيم< GMSNavigationAccessoryView > *) | headerAccessoryView |
لضبط موضع عرض الملحق أسفل الرأس الأساسي لواجهة مستخدم التنقل.
يؤدي تمرير قيمة خالية إلى إزالة عرض الملحق. إذا كانت هذه المكالمة غير نشطة، تكون هذه المكالمة بمثابة تعليمات لا يمكن استخدامها.
@note إذا كان عرض الخريطة قصيرًا، فإن حزمة SDK تُخفي عرض الملحق بسبب المساحة المحدودة. تتم إدارة طرق العرض داخليًا لتحسين عرض الخريطة.
- (فارغ) animateTo CameraPosition: | (GMSCameraPosition *) | cameraPosition |
ستتحرك كاميرا هذه الخريطة إلى cameraPosition
.
- (ملء) animateToLocation: | (CLLocationCoordinate2D) | الموقع الجغرافي |
مثل animateTo CameraPosition: ، إلا أنّه يغير موقع الكاميرا فقط (أي من الموقع الحالي إلى location
).
- (ملء) animateToZoom: | (float) | تكبير/تصغير |
مثل animateTo CameraPosition: ولكن يغير مستوى تكبير/تصغير الكاميرا فقط.
يتم تثبيت هذه القيمة بواسطة [kGMSMinZoomLevel, kGMSMaxZoomLevel].
- (خالية) animateToBearing: | (CLLocationDirection) | تحمل |
مثل animateTo CameraPosition: ولكن يتم تغيير اتجاه الكاميرا فقط (بالدرجات).
يشير الصفر إلى الشمال الحقيقي.
- (ملء) animateToDisplayAngle: | (مزدوج) | viewingAngle |
مثل animateTo CameraPosition:، ولكن يغير زاوية عرض الكاميرا فقط (بالدرجات).
سيتم تثبيت هذه القيمة على صفر كحد أدنى (أي تكون موجهة نحو الأسفل) وما بين 30 و45 درجة باتجاه الأفق، وذلك بناءً على القرب النسبي من الأرض.
- (فارغ) animateWith CameraUpdate: | (GMSCameraUpdate *) | cameraUpdate |
ينطبق cameraUpdate
على الكاميرا الحالية، ثم يستخدم النتيجة وفقًا لـ animateTo CameraPosition:.
- (إبطال) didBeginPanGesture |
يجب استدعاء هذه الطريقة من خلال تنفيذ التطبيق لطريقة CPMapTemplateDelegate -mapTemplate DidstarterPan البدء في تنفيذ إيماءات العرض الشامل لنماذج خرائط CarPlay.
- (ملء) doUpdatePan المحدَّدWithTranslation: | (CGPoint) | الترجمة | |
السرعة: | (CGPoint) | السرعة | |
يجب استدعاء هذه الطريقة عند تنفيذ التطبيق لطريقة CPMapTemplateDelegate -mapTemplate:didUpdatePan المحدَّدWithTranslation: لتنفيذ إيماءات العرض الشامل لنماذج الخرائط في CarPlay.
- (إبطال) didEndPan المحدَّدWithVelocity: | (CGPoint) | السرعة |
يجب استدعاء هذه الطريقة عند تنفيذ التطبيق لطريقة CPMapTemplateDelegate -mapTemplate:didEndPan المحدَّدWithVelocity: وذلك من أجل تنفيذ إيماءات العرض الشامل لنماذج الخرائط في CarPlay.
- (BOOL) enableNavigationWithSession: | (GMSNavigationSession *) | navigationSession |
لبدء التنقل في عرض الخريطة هذا باستخدام جلسة التنقّل المحددة.
- ملاحظة:
- للاستخدام الأكثر فعالية للذاكرة ووحدة المعالجة المركزية (CPU)، استدعِ هذه الطريقة قبل استدعاء أي طرق أخرى ذات صلة بالتنقّل في عرض الخريطة هذا.
- المرتجعات:
- ما إذا كان قد بدأ التنقّل بنجاح (على سبيل المثال، سيتم عرض "لا" إذا لم يتم قبول الأحكام والشروط بعد)
وثائق الأصدقاء والوظائف ذات الصلة
- (NSString* Cont) kGMSAccessibilityCompass [related] |
معرّف تسهيل الاستخدام لزر البوصلة
- (NSString* Cont) kGMSAccessibilityMyLocation [related] |
معرّف إمكانية الوصول لزر "موقعي".
- (NSString* Const) kGMSAccessibilityOutOfQuota [related] |
معرّف إمكانية الوصول لتصنيف الخطأ "انتهت الحصة".
وثائق العقارات
- (IBOutlet id<GMSMapViewDelegate>) تفويض [read, write, assign] |
المستخدم المفوَّض GMSMapView.
- (GMSCameraPosition*) الكاميرا [read, write, copy] |
تتحكّم هذه السياسة في الكاميرا التي تحدِّد كيفية توجيه الخريطة.
يتم إجراء أي تعديل على هذا الموقع الإلكتروني بشكل فوري.
- (GMSProjection*) التوقع [read, assign] |
تعرض كائن GMSProjection الذي يمكنك استخدامه للتحويل بين إحداثيات الشاشة وإحداثيات خطوط الطول/العرض.
هذه لقطة للإسقاط الحالي، ولن يتم تحديثها تلقائيًا عندما تتحرك الكاميرا. وهو يمثّل إما إسقاط آخر إطار مرسوم بتنسيق GMSMapView، أو الإطار القادم حيث تم ضبط الكاميرا بشكل واضح أو الخريطة التي تم إنشاؤها للتو. لن تكون معدومة أبدًا.
- (BOOL) myLocationEnabled [read, write, assign] |
تتحكَّم هذه السياسة في ما إذا كان سيتم تفعيل نقطة "موقعي" ودائرة الدقة.
يتم ضبط الإعدادات التلقائية على "لا".
- (CLLocation*) myLocation [read, assign] |
في حالة تمكين ميزة "موقعي"، فإنه تكشف عن المكان الذي يتم فيه رسم نقطة موقع الجهاز.
أما إذا تم إيقافه أو تم تفعيله، ولكن لا تتوفّر أي بيانات للموقع الجغرافي، سيكون ذلك معدومًا. يمكن ملاحظة هذه الخاصية باستخدام KVO.
- (GMSMarker*) selectedMarker [read, write, assign] |
العلامة التي تم اختيارها.
يؤدي ضبط هذه الخاصية إلى اختيار علامة معيّنة مع عرض نافذة معلومات عليها. إذا كانت هذه السمة خالية من القيم، يؤدي ضبطها على "صفر" إلى إلغاء اختيار العلامة، ما يؤدي إلى إخفاء نافذة المعلومات. يمكن ملاحظة هذه الخاصية باستخدام KVO.
- (BOOL) trafficEnabled [read, write, assign] |
تتحكّم هذه السياسة في ما إذا كانت الخريطة ترسم بيانات حركة المرور، إذا كان ذلك متاحًا.
ويعتمد ذلك على مدى توفُّر بيانات حركة المرور. يتم ضبط الإعدادات التلقائية على "لا".
- (GMSMapViewType) mapType [read, write, assign] |
تتحكّم هذه السياسة في نوع مربّعات الخرائط التي يجب عرضها.
وتكون القيم التلقائية kGMSTyperegex.
- (GMSMapStyle*) mapStyle [read, write, assign] |
تتحكّم هذه السياسة في نمط الخريطة.
لن يتم تطبيق mapStyle بدون قيمة إلا إذا كان نوع خريطة الموقع "عادي".
- (UIUserInterfaceStyle) overrideUserInterfaceStyle [read, write, assign] |
غيِّر الخريطة إلى واجهة UIUserInterfaceStyle المطلوبة.
يؤدي هذا إلى إلغاء سلوك UIKit التلقائي والإعداد التلقائي لـ UIUserInterfaceStyleLight مصمم بالتوافق مع الأنظمة القديمة. يؤثر هذا في نظام ألوان أنواع خرائط "عادي" و"تضاريس".
- (عائم) minZoom [read, assign] |
الحد الأدنى للتكبير/التصغير (أبعد مسافة يمكن تصغير الكاميرا فيها).
يتم ضبط السياسة تلقائيًا على kGMSMinZoomLevel. تم التعديل باستخدام -setMinZoom:maxZoom:.
- (عائم) maxZoom [read, assign] |
الحد الأقصى للتكبير أو التصغير (أقرب مسافة قد تكون فيها الكاميرا من الأرض).
يتم الضبط تلقائيًا على kGMSMaxZoomLevel. تم التعديل باستخدام -setMinZoom:maxZoom:.
- (BOOL) buildingsEnabled [read, write, assign] |
في حال ضبطها، ستظهر المباني الثلاثية الأبعاد أينما توفّرت.
يكون الإعداد التلقائي بالقيمة "نعم".
قد يكون هذا مفيدًا عند إضافة طبقة تجانب مخصصة إلى الخريطة، لجعلها أكثر وضوحًا في مستويات التكبير/التصغير العالية. سيؤدي تغيير هذه القيمة إلى إلغاء صلاحية جميع المربّعات لفترة قصيرة.
- (BOOL) indoorEnabled [read, write, assign] |
تحدد ما إذا كان سيتم عرض الخرائط الداخلية، حيثما كانت متاحة.
يكون الإعداد التلقائي بالقيمة "نعم".
في حال ضبط ذلك على "لا"، قد تتم إزالة ذاكرات التخزين المؤقت للبيانات الداخلية نهائيًا وقد تتم إعادة ضبط أي طابق تم اختياره حاليًا من قِبل المستخدم النهائي.
- (GMSIndoorDisplay*) indoorDisplay [read, assign] |
للحصول على مثيل GMSIndoorDisplay الذي يسمح بمراقبة جوانب عرض البيانات في الداخل أو التحكّم فيها.
- (GMSUISettings*) الإعدادات [read, assign] |
الحصول على الكائن GMSUISettings الذي يتحكّم في إعدادات واجهة المستخدم للخريطة
- المساحة المتروكة (UIEdgeInsets) [read, write, assign] |
التحكم في المنطقة "المرئية" من العرض.
من خلال تطبيق المساحة المتروكة حول حافة العرض، يمكن إنشاء مساحة تحتوي على بيانات الخريطة ولكنها لن تحتوي على عناصر تحكم واجهة المستخدم.
إذا كانت المساحة المتروكة غير متوازنة، فسيتم نقل المركز المرئي للعرض حسب الحاجة. ستؤثر المساحة المتروكة أيضًا في السمة projection
، وبالتالي لن تشمل المنطقة المرئية مساحة المساحة المتروكة. تضمن أداة GMSCameraUpdate أن يتم وضع هذه المساحة المتروكة وأي مساحة متروكة مطلوبة في الاعتبار.
قد تكون هذه الخاصية متحركة في كتلة صور متحركة مستندة إلى UIView.
- (GMSMapViewPaddingAdjustmentBehavior) paddingAdjustmentBehavior [read, write, assign] |
تتحكّم هذه السياسة في كيفية إضافة المساحات الداخلية في المنطقة الآمنة إلى قيم المساحة المتروكة.
مثل المساحة المتروكة، تتيح العناصر الداخلية للتحكم في تحديد الموضع مثل البوصلة وزر الموقع ومنتقي الطابق ضمن المنطقة الآمنة للجهاز.
يتم الضبط تلقائيًا على kGMSMapViewPaddingAdjustBehaviorدائمًا.
- (BOOL) accessibilityElementsHidden [read, write, assign] |
يكون الإعداد التلقائي بالقيمة "نعم".
في حال ضبط السياسة على "لا"، ستنشئ GMSMapView عناصر تسهيل الاستخدام لكائنات التراكب، مثل GMSMarker وGMSPolyline.
تتّبع هذه السمة بروتوكول UIAccessibility غير الرسمي، باستثناء القيمة التلقائية "نعم".
- (GMSMapLayer*) الطبقة [read, retain] |
موصّل لنوع CALayer المخصص المستخدم للطبقة.
- (GMSFrameRate) preferredFrameRate [read, write, assign] |
تتحكّم هذه السياسة في عدد اللقطات في الثانية أثناء العرض.
القيمة التلقائية هي kGMSFrameRate كحد أقصى.
- (GMSCoordinateBounds*) cameraTargetBounds [read, write, assign] |
وإذا لم تكن قيمة فارغة، يتم تقييد هدف الكاميرا بحيث لا يمكن للإيماءات أن تتسبب في خروج الحدود المحددة.
- (GMSMapCapabilityFlags) mapCapabilities [read, assign] |
جميع الإمكانات المتاحة بشروط (تعتمد على mapID أو إعدادات الخريطة الأخرى) المتاحة في الوقت الحالي
لا يشمل ذلك الإمكانيات المتاحة دائمًا.
- (IBOutlet id<GMSMapViewNavigationUIDelegate>) navigationUIDelegate [read, write, assign] |
مفوَّض GMSMapView الذي يتلقى استدعاءات لأحداث واجهة المستخدم للتنقُّل.
- (BOOL) navigationEnabled [read, write, assign] |
ما إذا كانت وظيفة التنقّل في هذه الخريطة مفعَّلة.
إذا كانت الإجابة "نعم"، يمكن عرض المسارات والاتجاهات المفصّلة على الخريطة، ويمكن للكاميرا الدخول إلى الوضع التالي، وسيظهر زر إعادة التوسيط عندما لا تتّبع الكاميرا الموقع الجغرافي للجهاز.
إذا لم يقبل المستخدم أحكام وشروط ميزة "التنقل في Google"، لن يكون لتعيين هذه الخاصية أي تأثير. لعرض مربّع حوار الأحكام والشروط، يمكنك الاطّلاع على الطرق في GMSNavigationServices.
- (GMSNavigator*) أداة التنقّل [read, assign] |
أداة التنقّل في GMSMapView هذا الذي يسمح بطلب المسارات وبدء استخدام الإرشادات التفصيلية
إذا لم يقبل المستخدم أحكام وشروط ميزة "التنقل في Google"، سيكون ذلك لا شيء. لعرض مربّع حوار الأحكام والشروط، يمكنك الاطّلاع على الطرق في GMSNavigationServices.
- (GMSRoadSnappedLocationProvider*) roadSnappedLocationProvider [read, assign] |
السماح بالاشتراك في تحديثات الموقع الجغرافي التي تم التقاطها على الطريق.
إذا لم يقبل المستخدم أحكام وشروط ميزة "التنقل في Google"، سيكون ذلك لا شيء. لعرض مربّع حوار الأحكام والشروط، يمكنك الاطّلاع على الطرق في GMSNavigationServices.
- (GMSLocationSimulator*) locationSimulator [read, assign] |
تسمح لك هذه الميزة بمحاكاة الموقع الجغرافي للجهاز.
يؤثر الموقع المحاكي على موضع شارة الرتبة على الخريطة، ومستوى تقدم التوجيه منعطف بمنعطف، والتحديثات التي يوفرها مقدم خدمة الموقع الملتقط على الطريق.
إذا لم يقبل المستخدم أحكام وشروط ميزة "التنقل في Google"، سيكون ذلك لا شيء. لعرض مربّع حوار الأحكام والشروط، يمكنك الاطّلاع على الطرق في GMSNavigationServices.
- (GMSNavigationCameraMode) cameraMode [read, write, assign] |
وضع الكاميرا الذي يحدد سلوكها عند ضبط الخاصية NavigationEnabled على "نعم".
يمكنك الانتقال إلى GMSNavigationCameraMode
للاطّلاع على وسائل النقل المتوفّرة.
- (GMSNavigationCameraPerspective) followingPerspective [read, write, assign] |
منظور الكاميرا الذي سيتم استخدامه عند متابعة الموقع الجغرافي للجهاز
يجب ضبط السمة navigationEnabled
على "نعم"، ويجب ضبط السمة cameraMode
على GMS Navigation CameraModeFollowing لكي يتم تفعيل هذا المنظور.
- (GMSNavigationTravelMode) travelMode [read, write, assign] |
وضع السفر الذي يحدد نوع المسارات التي سيتم جلبها والطريقة التي يتم بها تحديد مسار الجهاز.
في وضع القيادة، يعتمد مسار الجهاز على اتجاه الحركة، بينما في وضع ركوب الدراجات أو المشي، يعتمد المسار على اتجاه البوصلة الذي يواجهه الجهاز. يتم تمثيل مسار الجهاز باتجاه علامة موقع الجهاز ويتم الإبلاغ عنه من خلال GMSRoadSnappedLocationProvider.
- (GMSNavigationLightingMode) lightingMode [read, write, assign] |
يحدد وضع الإضاءة نظام الألوان الذي يجب استخدامه لعرض الخريطة.
كما أنها تُستخدم لتحديد الألوان الافتراضية لعناصر الواجهة المختلفة.
- (BOOL) shouldDisplaySpeedLimit [read, write, assign] |
تحدِّد ما إذا كان يجب عرض حد السرعة عندما يكون التوجيه نشطًا وتوفُّر بيانات حدود السرعة.
القيمة الافتراضية هي NO.
- (BOOL) shouldDisplaySpeedometer [read, write, assign] |
تحدِّد هذه السياسة ما إذا كان سيتم عرض رمز عدّاد السرعة.
عند تفعيل هذه الميزة، يظهر رمز عدّاد السرعة يشير إلى سرعة المركبة في الزاوية السفلية أثناء تنفيذ الإرشادات. وعند توفُّر بيانات موثوق بها حول حدود السرعة، يظهر رمز حد السرعة أيضًا، ويتم إرفاقه برمز عدّاد السرعة. يمكن أن يكون رمز عدّاد السرعة بألوان مختلفة للنص والخلفية، استنادًا إلى درجة خطورة تنبيه السرعة.
في حال تفعيل زر إعادة ضبط الإطار، يكون الحدّ الأقصى للسرعة ورمز عدّاد السرعة مخفيَين مؤقتًا عند عرض زر إعادة ضبط الإطار.
- (UILayoutGuide*) navigationHeaderLayoutGuide [read, assign] |
المستطيل الذي يغطيه عنوان التنقل.
يكون الارتفاع صفرًا عندما يكون العنوان مخفيًا.
- (UILayoutGuide*) navigationFooterLayoutGuide [read, assign] |
المستطيل الذي يغطيه تذييل التنقل.
يكون الارتفاع صفرًا عندما يكون التذييل مخفيًا.
- (GMSNavigationRouteCalloutFormat) routeCalloutFormat [read, write, assign] |
يحدد تنسيق وسيلة شرح المسار (التلقائي أو الوقت أو المسافة) المطلوب استخدامه.
- (عائم) followingZoomLevel [read, write, assign] |
مستوى التكبير/التصغير المخصص أثناء التنقل.
سيؤدي ضبط هذه القيمة إلى إلغاء مستوى التكبير أو التصغير التلقائي في حزمة تطوير البرامج (SDK) الخاصة بالتنقل عندما تتّبع الكاميرا الموقع الجغرافي للجهاز (أي cameraMode
يساوي GMSNavigationCameraModeFollowing
). ويمكن ضبطها على GMSNavigationNoFollowingZoomLevel
في حال عدم استخدام إلغاء مستوى التكبير أو التصغير.
- (GMSRoadSnappedLocationProvider*) roadSnappedMyLocationSource [read, write, assign] |
تعيين مزوِّد خدمة "موقعي" لعرض الخريطة هذا.
عادةً ما يستند الموقع الفعلي للجهاز إلى نقطة "موقعي" ودائرة الدقة لعرض الخريطة. من خلال تعيين هذه الخاصية، سيتم تحديد نقطة "موقعي" ودائرة الدقة بواسطة الموقع الذي تم التقاطه على الطريق من مزود الموقع المحدد بدلاً من ذلك. للعودة إلى السلوك العادي، اضبط هذه السمة على nil.
ليس لهذا أي تأثير عند تشغيل navigationEnabled
لعرض الخريطة هذا.