نظرة عامة
هذه هي الفئة الرئيسية من حزمة SDK لخرائط Google لنظام التشغيل iOS وهي نقطة الدخول لجميع الطرق ذات الصلة بالخريطة.
يجب إنشاء مثيل للخريطة باستخدام أحد الدالة الإنشائية -init أو -initWithOptions:.
لا يمكن قراءة GMSMapView وتعديله إلا من سلسلة التعليمات الرئيسية، على غرار جميع كائنات UIKit. سيؤدي استدعاء هذه الطرق من سلسلة محادثات أخرى إلى استثناء أو سلوك غير محدد.
الوظائف العامة | |
(instancetype) | - البدء |
يتم إعداده باستخدام CGRectZero والخيارات التلقائية. | |
(instancetype) | - initWithOptions: |
يُنشئ عرض خريطة جديد بالخيارات المحددة. | |
(instancetype) | - initWithFrame: |
(نوع المثيل القابل للقيم الفارغة) | - initWithCoder: |
(instancetype) | - initWithFrame:camera: |
لإنشاء عرض خريطة وإرجاعه، مع إطار وهدف كاميرا. | |
(instancetype) | - initWithFrame:mapID:camera: |
ينشئ طريقة عرض الخريطة ويعرضها مع إطار ومعرّف خريطة وهدف كاميرا. | |
(مُلغاة) | - startRendering |
يخبر هذه الخريطة هذه الخريطة لتشغيل عارضها. | |
(مُلغاة) | - stopRendering |
تخبر هذه الخريطة بإيقاف العارض. | |
(مُلغاة) | - واضح |
يؤدي ذلك إلى محو كل الترميز الذي تمت إضافته إلى الخريطة، بما في ذلك العلامات والخطوط المتعددة وتراكبات الأرض. | |
(مُلغاة) | - setMinZoom:maxZoom: |
يتم ضبط السياسة على minZoom وmaxZoom . | |
(nullable GMSCameraPosition *) | - cameraForBounds:insets: |
أنشِئ GMSCameraPosition الذي يعرض bounds مع padding . | |
(مُلغاة) | - moveCamera: |
يغيّر هذا الزر الكاميرا وفقًا لـ update . | |
(منطقي) | - areEqualForRenderingPosition:position: |
لذلك، تحقَّق مما إذا كانت مواضع الكاميرا المحدّدة ستؤدّي عمليًا إلى عرض الكاميرا بالطريقة نفسها، مع الأخذ في الاعتبار مستوى الدقة والتحولات المستخدَمة داخليًا. | |
(GMSFeatureLayer ) < GMSPlaceFeature * > *) | - featureLayerOfFeatureType: |
لعرض طبقة عناصر من النوع المحدد. | |
(GMSDatasetFeatureLayer *) | - datasetFeatureLayerOfDatasetID: |
تعرض طبقة ميزة مجموعة بيانات لمجموعة البيانات المحددة. | |
(مُلغاة) | - invalidateLayoutForAccessoryView: |
إلغاء عرض الملحق وتشغيل إعادة التنسيق لهذا العرض. | |
(مُلغاة) | - setHeaderAccessoryView: |
لضبط موضع عرض الملحق أسفل العنوان الأساسي لواجهة مستخدم التنقّل. | |
(مُلغاة) | - animateToCameraPosition: |
يحرّك كاميرا هذه الخريطة لـ cameraPosition . | |
(مُلغاة) | - animateToLocation: |
كعنصر animateTo CameraPosition:، ولكنه يغيِّر موقع الكاميرا فقط (أي من الموقع الجغرافي الحالي إلى location ). | |
(مُلغاة) | - animateToZoom: |
كعنصر animateTo CameraPosition:، ولكنه يغيِّر فقط مستوى تكبير/تصغير الكاميرا. | |
(مُلغاة) | - animateToBearing: |
كعنصر animateTo CameraPosition:، ولكنه يغيِّر فقط اتجاه الكاميرا (بالدرجات). | |
(مُلغاة) | - animateToViewingAngle: |
مثل animateTo CameraPosition:، فهي تعمل فقط على تغيير زاوية عرض الكاميرا (بالدرجات). | |
(مُلغاة) | - animateWithCameraUpdate: |
يُطبق cameraUpdate على الكاميرا الحالية، ثم يستخدم النتيجة وفقًا لـ animateTo CameraPosition:. | |
(مُلغاة) | - didBeginPanGesture |
ويجب استدعاء هذه الطريقة من تطبيق التطبيق لطريقة CPMapTemplateDelegate وهي -mapTemplate المرجعيةStartPan شيء (الحركة والحركة): لتنفيذ إيماءات التحريك لنماذج خرائط CarPlay. | |
(مُلغاة) | - didUpdatePanGestureWithTranslation:velocity: |
ويجب استدعاء هذه الطريقة من تطبيق التطبيق لطريقة CPMapTemplateDelegate -mapTemplate:didUpdatePanتواصلWithTranslation: من أجل تنفيذ إيماءات التحريك لنماذج خرائط CarPlay. | |
(مُلغاة) | - didEndPanGestureWithVelocity: |
ويجب استدعاء هذه الطريقة من تطبيق التطبيق لطريقة CPMapTemplateDelegate -mapTemplate:didEndPanOptWithVelocity: من أجل تنفيذ إيماءات التحريك لنماذج خرائط CarPlay. | |
(منطقي) | - enableNavigationWithSession: |
لبدء التنقل في عرض الخريطة هذا باستخدام جلسة التنقل المحددة. | |
الوظائف الأساسية الثابتة للأعضاء | |
(instancetype) | + mapWithFrame:camera: |
لإنشاء عرض خريطة وإرجاعه مع إطار وهدف كاميرا. | |
(instancetype) | + mapWithFrame:mapID:camera: |
أداة إعداد ملائمة لإنشاء عرض الخريطة وعرضه مع إطار ومعرّف خريطة وهدف كاميرا | |
أماكن إقامة | |
معرّف IBOutlet< GMSMapViewDelegate > | تفويض |
تفويض GMSMapView. | |
GMSCameraPosition * | الكاميرا |
التحكم في الكاميرا التي تحدد كيفية توجيه الخريطة. | |
GMSProjection * | الإسقاط |
تعرض كائن GMSProjection الذي يمكنك استخدامه للتحويل بين إحداثيات الشاشة وإحداثيات خطوط الطول/العرض. | |
قيمة منطقية | myLocationEnabled |
تتحكّم هذه السياسة في ما إذا كان سيتم تفعيل نقطة "موقعي" ودائرة الدقة. | |
CLLocation * | myLocation |
عند تمكين ميزة "موقعي"، يتم الكشف عن المكان الذي يتم فيه رسم نقطة موقع الجهاز. | |
GMSMarker * | selectedMarker |
العلامة التي تم اختيارها. | |
قيمة منطقية | trafficEnabled |
للتحكم في ما إذا كانت الخريطة ترسم بيانات حركة المرور، إذا كان ذلك متاحًا. | |
GMSMapViewType | mapType |
تتحكّم هذه السياسة في نوع مربّعات الخرائط التي يجب عرضها. | |
GMSMapStyle * | mapStyle |
تتحكّم هذه السياسة في نمط الخريطة. | |
UIUserInterfaceStyle | overrideUserInterfaceStyle |
غيِّر الخريطة إلى [UIUserInterfaceStyle](https://developer.apple.com/documentation/uikit/uiuserinterfacestyle?language=objc). | |
عدد عائم | minZoom |
الحد الأدنى للتكبير (أبعد مسافة يمكن تصغيرها الكاميرا) | |
عدد عائم | maxZoom |
الحد الأقصى للتكبير (يمكن أن تكون الكاميرا الأقرب إلى الأرض). | |
قيمة منطقية | buildingsEnabled |
وفي حال ضبطها، سيتم عرض المباني الثلاثية الأبعاد أينما توفّرت. | |
قيمة منطقية | indoorEnabled |
يحدد ما إذا كان سيتم عرض الخرائط الداخلية، حيثما كان ذلك متاحًا. | |
GMSIndoorDisplay * | indoorDisplay |
يحصل على مثيل GMSIndoorDisplay الذي يتيح مراقبة جوانب عرض البيانات داخل المنزل أو التحكّم فيها. | |
GMSUISettings * | الإعدادات |
يحصل على الكائن GMSUISettings، الذي يتحكّم في إعدادات واجهة المستخدم للخريطة. | |
UIEdgeInsets | المساحة المتروكة |
يتحكّم في "مرئي" منطقة العرض. | |
GMSMapViewPaddingAdjustmentBehavior | paddingAdjustmentBehavior |
تتحكّم هذه السياسة في كيفية إضافة مساحات التخزين الداخلية في المنطقة الآمنة إلى قيم المساحة المتروكة. | |
قيمة منطقية | accessibilityElementsHidden |
يتم ضبط الإعدادات التلقائية على "نعم". | |
GMSMapLayer * | طبقة |
موصّل لنوع CALayer المخصص المستخدم للطبقة. | |
GMSFrameRate | preferredFrameRate |
تتحكّم هذه السياسة في عدد اللقطات في الثانية للعرض. | |
GMSCoordinateBounds * | cameraTargetBounds |
إذا لم يكن صفرًا، سيتم تقييد هدف الكاميرا بحيث لا يمكن أن تتسبب الإيماءات في ترك الحدود المحددة. | |
GMSMapCapabilityFlags | mapCapabilities |
جميع الإمكانات المتاحة بشكل مشروط (تعتمد على رقم تعريف الخريطة أو إعدادات الخريطة الأخرى) والمتاحة في الوقت الحالي. | |
معرّف 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 |
تحدِّد هذه السياسة تنسيق وسيلة شرح المسار (التلقائي أو الوقت أو المسافة) المطلوب استخدامه. | |
عدد عائم | followingZoomLevel |
مستوى التكبير أو التصغير المخصّص أثناء التنقّل | |
GMSRoadSnappedLocationProvider * | roadSnappedMyLocationSource |
تعيين موفر خدمة "موقعي" لعرض الخريطة هذا. | |
الدوال ذات الصلة | |
(لاحظ أن هذه ليست دوال عضوية.) | |
NSString *const | kGMSAccessibilityCompass |
معرّف تسهيل الاستخدام الخاص بزر البوصلة | |
NSString *const | kGMSAccessibilityMyLocation |
معرّف إمكانية الوصول الخاص بميزة "موقعي" . | |
NSString *const | kGMSAccessibilityOutOfQuota |
معرّف تسهيل الاستخدام "نفد الحصة" تصنيف الخطأ. |
المستندات الخاصة بوظائف الأعضاء
- (instancetype) init |
يتم إعداده باستخدام CGRectZero والخيارات التلقائية.
- (instancetype) initWithOptions: | (nonnull GMSMapViewOptions *) | الخيارات |
يُنشئ عرض خريطة جديد بالخيارات المحددة.
يتم نسخ قيمة كائن الخيارات بهذه الطريقة.
- (instancetype) initWithFrame: | (CGRCT) | إطار |
- (نوع المثيل القابل للقيم الفارغة) initWithCoder: | (NSCoder *) | برنامج الترميز |
+ (instancetype) mapWithFrame: | (CGRCT) | إطار | |
الكاميرا: | (GMSCameraPosition *) | الكاميرا | |
لإنشاء عرض خريطة وإرجاعه مع إطار وهدف كاميرا.
+ (instancetype) mapWithFrame: | (CGRCT) | إطار | |
mapID: | (GMSMapID *) | mapID | |
الكاميرا: | (GMSCameraPosition *) | الكاميرا | |
أداة إعداد ملائمة لإنشاء عرض الخريطة وعرضه مع إطار ومعرّف خريطة وهدف كاميرا
- (instancetype) initWithFrame: | (CGRCT) | إطار | |
الكاميرا: | (GMSCameraPosition *) | الكاميرا | |
لإنشاء عرض خريطة وإرجاعه، مع إطار وهدف كاميرا.
- ملاحظة:
- تم إيقاف هذا نهائيًا. استخدم -init أو -initWithOptions: بدلاً من ذلك.
- (instancetype) initWithFrame: | (CGRCT) | إطار | |
mapID: | (GMSMapID *) | mapID | |
الكاميرا: | (GMSCameraPosition *) | الكاميرا | |
ينشئ طريقة عرض الخريطة ويعرضها مع إطار ومعرّف خريطة وهدف كاميرا.
- ملاحظة:
- تم إيقاف هذا نهائيًا. استخدم -init أو -initWithOptions: بدلاً من ذلك.
- (فارغ) startRendering |
يخبر هذه الخريطة هذه الخريطة لتشغيل عارضها.
هذا اختياري ومجهول.
- ملاحظة:
- تم إيقاف هذا نهائيًا. هذه الطريقة قديمة وستتم إزالتها في إصدار مستقبلي.
- (فارغ) stopRendering |
تخبر هذه الخريطة بإيقاف العارض.
هذا اختياري ومجهول.
- ملاحظة:
- تم إيقاف هذا نهائيًا. هذه الطريقة قديمة وستتم إزالتها في إصدار مستقبلي.
- (ملغى) واضح |
يؤدي ذلك إلى محو كل الترميز الذي تمت إضافته إلى الخريطة، بما في ذلك العلامات والخطوط المتعددة وتراكبات الأرض.
ولن يؤدي هذا إلى محو نقطة الموقع الجغرافي المرئية أو إعادة ضبط نوع الخريطة الحالي.
- (باطل) setMinZoom: | (عائم) | minZoom | |
maxZoom: | (عائم) | maxZoom | |
يتم ضبط السياسة على minZoom
وmaxZoom
.
تتوقع هذه الطريقة أن يكون الحد الأدنى أقل من الحد الأقصى أو مساويًا له، وستعرض استثناء بالاسم NSRangeException بخلاف ذلك.
- (GMSCameraPosition *) قابل للإلغاء: campaignForBounds: | (GMSCoordinateBounds *) | الحدود | |
مواد داخلية: | (UIEdgeInsets) | المجموعات | |
أنشِئ GMSCameraPosition الذي يعرض bounds
مع padding
.
لن يكون للكاميرا اتجاهًا وميلًا (أي مواجهة الشمال والنظر مباشرة إلى الأرض). وهذا يأخذ في الاعتبار الإطار والمساحة المتروكة لـ GMSMapView هذا.
إذا كانت الحدود غير صالحة، فستعرض هذه الطريقة كاميرا فارغة.
- (بدون) moveCamera: | (GMSCameraUpdate *) | تعديل |
يغيّر هذا الزر الكاميرا وفقًا لـ update
.
يتم تغيير الكاميرا بشكل فوري (بدون استخدام رسوم متحركة).
- (BOOL) areEqualForRenderingPosition: | (GMSCameraPosition *) | الموضع | |
الموضع: | (GMSCameraPosition *) | otherPosition | |
لذلك، تحقَّق مما إذا كانت مواضع الكاميرا المحدّدة ستؤدّي عمليًا إلى عرض الكاميرا بالطريقة نفسها، مع الأخذ في الاعتبار مستوى الدقة والتحولات المستخدَمة داخليًا.
- (GMSFeatureLayer<GMSPlaceFeature *> *) featureLayerOfFeatureType:. | (GMSFeatureType) | featureType |
لعرض طبقة عناصر من النوع المحدد.
يجب ضبط طبقات الميزات في Cloud Console.
في حال عدم توفّر طبقة من النوع المحدّد على هذه الخريطة، أو في حال عدم تفعيل نمط مستند إلى البيانات، أو عدم استخدام إطار عرض Metal، ستكون الحالة "isمتاحة" للطبقة الناتجة NO
، ولن تستجيب لأي طلبات.
تتطلب عارض Metal. تعرَّف على كيفية تفعيل تطبيق Metal على الرابط https://developers.google.com/maps/documentation/ios-sdk/config#use-metal.
- (GMSDatasetFeatureLayer *) datasetFeatureLayerOfDatasetID: | (NSString *) | datasetID |
تعرض طبقة ميزة مجموعة بيانات لمجموعة البيانات المحددة.
يجب ضبط أرقام تعريف مجموعات البيانات في Cloud Console.
في حال عدم توفّر مجموعة بيانات للمعرّف المحدّد على هذه الخريطة، أو في حال عدم تفعيل التصميم المستند إلى البيانات، ستكون قيمة "isavailable" للطبقة الناتجة هي NO
، ولن تستجيب لأي طلبات.
- (باطل) invalidateLayoutForAccessoryView: | (UIView< GMSNavigationAccessoryView > *) | accessoryView |
إلغاء عرض الملحق وتشغيل إعادة التنسيق لهذا العرض.
يجب أن تكون طبقة العرض إحدى طرق العرض الحالية للملحقات. إذا لم تكن الإرشادات نشطة، تكون هذه المكالمة تعليمات منع استخدام الطلب.
- (باطل) setHeaderAccessoryView: | (nullable UIView< GMSNavigationAccessoryView > *) | headerAccessoryView |
لضبط موضع عرض الملحق أسفل العنوان الأساسي لواجهة مستخدم التنقّل.
يؤدي تمرير قيمة صفرية إلى إزالة عرض الملحق. إذا لم تكن الإرشادات نشطة، تكون هذه المكالمة تعليمات منع استخدام الطلب.
@note إذا كان عرض الخريطة قصيرًا، تخفي حزمة تطوير البرامج (SDK) عرض الملحق بسبب المساحة المحدودة. تتم إدارة طرق العرض داخليًا لتحسين عرض الخريطة.
- (بدون) animateToCameraPosition: | (GMSCameraPosition *) | cameraPosition |
يحرّك كاميرا هذه الخريطة لـ cameraPosition
.
- (بدون) animateToLocation: | (CLLocationCoordinate2D) | الموقع الجغرافي |
كعنصر animateTo CameraPosition:، ولكنه يغيِّر موقع الكاميرا فقط (أي من الموقع الجغرافي الحالي إلى location
).
- (بدون) animateToZoom: | (عائم) | تكبير/تصغير |
كعنصر animateTo CameraPosition:، ولكنه يغيِّر فقط مستوى تكبير/تصغير الكاميرا.
يتم تثبيت هذه القيمة من خلال [kGMSMinZoomLevel, kGMSMaxZoomLevel].
- (فارغ) animateToBearing: | (CLLocationDirection) | إذًا |
كعنصر animateTo CameraPosition:، ولكنه يغيِّر فقط اتجاه الكاميرا (بالدرجات).
يشير الصفر إلى الشمال الحقيقي.
- (بدون) animateToViewingAngle: | (مزدوج) | viewingAngle |
مثل animateTo CameraPosition:، فهي تعمل فقط على تغيير زاوية عرض الكاميرا (بالدرجات).
وسيتم تثبيت هذه القيمة على صفر على الأقل (أي موجَّهة لأسفل بشكل مستقيم) وباتجاه 30 إلى 45 درجة في الأفق، بناءً على القرب النسبي للأرض.
- (بدون) animateWithCameraUpdate: | (GMSCameraUpdate *) | cameraUpdate |
يُطبق cameraUpdate
على الكاميرا الحالية، ثم يستخدم النتيجة وفقًا لـ animateTo CameraPosition:.
- (فارغ) didBeginPanGesture |
ويجب استدعاء هذه الطريقة من تطبيق التطبيق لطريقة CPMapTemplateDelegate وهي -mapTemplate المرجعيةStartPan شيء (الحركة والحركة): لتنفيذ إيماءات التحريك لنماذج خرائط CarPlay.
- (غير محدد) dUpdatePan للتنزيلWithTranslation: | (CGPoint) | الترجمة | |
السرعة: | (CGPoint) | السرعة | |
ويجب استدعاء هذه الطريقة من تطبيق التطبيق لطريقة CPMapTemplateDelegate -mapTemplate:didUpdatePanتواصلWithTranslation: من أجل تنفيذ إيماءات التحريك لنماذج خرائط CarPlay.
- (فارغ) didEndPanGestureWithVelocity: | (CGPoint) | السرعة |
ويجب استدعاء هذه الطريقة من تطبيق التطبيق لطريقة CPMapTemplateDelegate -mapTemplate:didEndPanOptWithVelocity: من أجل تنفيذ إيماءات التحريك لنماذج خرائط CarPlay.
- (BOOL) enableNavigationWithSession: | (GMSNavigationSession *) | navigationSession |
لبدء التنقل في عرض الخريطة هذا باستخدام جلسة التنقل المحددة.
- ملاحظة:
- لتحقيق الاستخدام الأكثر فعالية للذاكرة ووحدة المعالجة المركزية (CPU)، عليك طلب هذه الطريقة قبل استدعاء أي طرق أخرى متعلقة بالتنقل في عرض الخريطة هذا.
- المرتجعات:
- ما إذا كان قد تم بدء التنقل بنجاح (على سبيل المثال، سيتم عرض "لا" إذا لم يتم قبول الأحكام والشروط بعد).
وثائق الأصدقاء والوظائف ذات الصلة
- (NSString* Const) kGMSAccessibilityCompass [related] |
معرّف تسهيل الاستخدام الخاص بزر البوصلة
- (NSString* Const) kGMSAccessibilityMyLocation [related] |
معرّف إمكانية الوصول الخاص بميزة "موقعي" .
- (NSString* Const) kGMSAccessibilityOutOfQuota [related] |
معرّف تسهيل الاستخدام "نفد الحصة" تصنيف الخطأ.
وثائق العقارات
- (IBOutlet id<GMSMapViewDelegate>) delegate [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] |
العلامة التي تم اختيارها.
يؤدي ضبط هذه السمة إلى اختيار علامة معيّنة، لعرض نافذة معلومات عليها. إذا كانت هذه الخاصية غير فارغة، يؤدي ضبطها على nil إلى إلغاء تحديد العلامة، مما يؤدي إلى إخفاء نافذة المعلومات. يمكن ملاحظة هذه الخاصية باستخدام KVO.
- (BOOL) trafficEnabled [read, write, assign] |
للتحكم في ما إذا كانت الخريطة ترسم بيانات حركة المرور، إذا كان ذلك متاحًا.
ويعتمد ذلك على توفر بيانات حركة المرور. يتم ضبط القيم التلقائية على "لا".
- (GMSMapViewType) mapType [read, write, assign] |
تتحكّم هذه السياسة في نوع مربّعات الخرائط التي يجب عرضها.
القيمة التلقائية هي kGMSTypeExternal.
- (GMSMapStyle*) mapStyle [read, write, assign] |
تتحكّم هذه السياسة في نمط الخريطة.
لن يتم تطبيق نمط الخريطة التي لا يحتوي على ثغرات إلا إذا كان نوع الخريطة "عادي".
- (UIUserInterfaceStyle) overrideUserInterfaceStyle [read, write, assign] |
غيِّر الخريطة إلى [UIUserInterfaceStyle](https://developer.apple.com/documentation/uikit/uiuserinterfacestyle?language=objc).
يؤدي ذلك إلى إلغاء سلوك 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 FitToBounds مراعاة كلٍّ من هذه المساحة المتروكة وأي مساحة متروكة مطلوبة.
قد تكون هذه السمة مُتحركة ضمن كتلة صور متحركة مستندة إلى UIView.
- (GMSMapViewPaddingAdjustmentBehavior) paddingAdjustmentBehavior [read, write, assign] |
تتحكّم هذه السياسة في كيفية إضافة مساحات التخزين الداخلية في المنطقة الآمنة إلى قيم المساحة المتروكة.
على غرار المساحة المتروكة، تُدرج المنطقة الآمنة عناصر التحكّم في خريطة الموقع، مثل البوصلة وزر موقعي الجغرافي وأداة اختيار الطابق في المنطقة الآمنة على الجهاز.
يتم ضبط الإعدادات التلقائية على kGMSMapViewPaddingBehaviorBehaviorدائمًا.
- (BOOL) accessibilityElementsHidden [read, write, assign] |
يتم ضبط الإعدادات التلقائية على "نعم".
وفي حال ضبطها على "لا"، ستنشئ GMSMapView عناصر تسهيل الاستخدام لكائنات التراكب، مثل GMSMarker وGMSPolyline.
تتبع هذه الخاصية بروتوكول UIAccessibility غير الرسمي، باستثناء القيمة التلقائية لـ "نعم".
- (GMSMapLayer*) طبقة [read, retain] |
موصّل لنوع CALayer المخصص المستخدم للطبقة.
- (GMSFrameRate) preferredFrameRate [read, write, assign] |
تتحكّم هذه السياسة في عدد اللقطات في الثانية للعرض.
القيمة التلقائية هي kGMSFrameRateMax.
- (GMSCoordinateBounds*) cameraTargetBounds [read, write, assign] |
إذا لم يكن صفرًا، سيتم تقييد هدف الكاميرا بحيث لا يمكن أن تتسبب الإيماءات في ترك الحدود المحددة.
- (GMSMapCapabilityFlags) mapCapabilities [read, assign] |
جميع الإمكانات المتاحة بشكل مشروط (تعتمد على رقم تعريف الخريطة أو إعدادات الخريطة الأخرى) والمتاحة في الوقت الحالي.
ولا يتضمّن إمكانات متاحة دائمًا.
- (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 NavigationModeFollowing كي يتمّ تطبيق هذا المنظور.
- (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
" لعرض الخريطة هذا.