نظرة عامة
العلامة المتقدمة هي أيقونة موضوعة عند نقطة معينة على سطح الخريطة.
يكتسب GMSMarker.
دوال الأعضاء العامة الثابتة | |
| (instancetype) | + markerWithPosition: |
| دالة الإنشائية المناسبة لعلامة تلقائية. | |
| (UIImage *) | + markerImageWithColor: |
| لإنشاء نسخة ملونة من صورة العلامة التلقائية لاستخدامها كأيقونة. | |
المواقع | |
| GMSCollisionBehavior | collisionBehavior |
| سلوك تصادم العلامة، والذي يحدد ما إذا كان ظهور العلامة يمكن أن يتأثر بعلامات أخرى أو محتوى مصنف على الخريطة أم لا. | |
| CLLocationCoordinate2D | الموضع |
| موضع العلامة: | |
| NSString * | مقتطف |
| نص المقتطف، يظهر أسفل العنوان في نافذة المعلومات عند تحديده. | |
| UIImage * | رمز |
| رمز العلامة المطلوب عرضه | |
| UIView * | iconView |
| عرض العلامة للعرض. | |
| قيمة منطقية | tracksViewChanges |
| تتحكّم هذه السياسة في ما إذا كان يجب إعادة رسم رمز هذه العلامة كل إطار. | |
| قيمة منطقية | tracksInfoWindowChanges |
| تتحكّم هذه السياسة في ما إذا كان يجب إعادة رسم نافذة المعلومات لهذه العلامة كل إطار. | |
| نقطة CGPoint | groundAnchor |
| يحدد ارتساء الأرض النقطة في صورة الرمز التي يتم تثبيتها في موضع العلامة على سطح الأرض. | |
| نقطة CGPoint | infoWindowAnchor |
| تحدد علامة ارتساء نافذة المعلومات النقطة في صورة الرمز التي سيتم عندها إرساء نافذة المعلومات، والتي سيتم عرضها أعلى هذه النقطة مباشرةً. | |
| GMSMarkerAnimation | appearAnimation |
| تتحكّم هذه السمة في الحركة المستخدمة عند وضع هذه العلامة على GMSMapView (دالة kGMSMarkerAnimationNone، بدون حركة). | |
| قيمة منطقية | قابلة للسحب |
| تتحكّم هذه السمة في إمكانية سحب هذه العلامة بشكل تفاعلي (ميزة "لا" تلقائية). | |
| قيمة منطقية | مسطّح |
| للتحكم في ما إذا كان يجب أن تكون هذه العلامة مسطحة على سطح الأرض (نعم) أو لوحة إعلانات مواجهة للكاميرا (لا، الإعداد التلقائي). | |
| CLLocationDegrees | تدوير |
| لضبط دوران العلامة بالدرجات في اتجاه عقارب الساعة حول نقطة ارتساء العلامة. | |
| float | معدل الشفافية |
| لضبط مدى تعتيم العلامة، بين 0 (شفاف تمامًا) و1 (تلقائي) بشكل شامل. | |
| GMSMarkerLayer * | الطبقة |
| توفّر طبقة الحركة الأساسية لـ GMSMarker هذا. | |
| GMSPanoramaView * | panoramaView |
يحدد panoramaView عرض البانوراما الذي سيحاول عرض هذه العلامة. | |
| NSString * | title |
| العنوان، وصف موجز للتراكب. | |
| GMSMapView * | خريطة |
| الخريطة التي يظهر عليها هذا التراكب. | |
| قيمة منطقية | قابلة للنقر |
| ما إذا كان من المفترض أن يؤدي هذا التراكب إلى تلقّي إشعارات النقر | |
| int | zIndex |
سيتم رسم العناصر المركّبة ذات قيمة zIndex الأعلى فوق طبقات التجانب والتراكبات ذات قيمة zIndex الأقل. | |
| id | userData |
| بيانات التراكب | |
وثائق وظائف الأعضاء
| + (instancetype) markerWithPosition: | (CLLocationCoordinate2D) | الموضع |
دالة الإنشائية المناسبة لعلامة تلقائية.
| + (UIImage *) markerImageWithColor: | (nullable UIColor *) | color (اللون) |
لإنشاء نسخة ملونة من صورة العلامة التلقائية لاستخدامها كأيقونة.
وثائق العقارات
- (GMSCollisionBehavior) collisionBehavior [read, write, assign] |
سلوك تصادم العلامة، والذي يحدد ما إذا كان ظهور العلامة يمكن أن يتأثر بعلامات أخرى أو محتوى مصنف على الخريطة أم لا.
- الموضع (CLLocationCoordinate2D) [read, write, assign, inherited] |
موضع العلامة:
صور متحركة.
- مقتطف [read, write, copy, inherited] (NSString*) |
نص المقتطف، يظهر أسفل العنوان في نافذة المعلومات عند تحديده.
- (UIImage*) رمز [read, write, assign, inherited] |
رمز العلامة المطلوب عرضه
في حال تركها فارغة، يتم استخدام محدّد الموقع التلقائي لحزمة تطوير البرامج (SDK).
يدعم الصور المتحركة، ولكن يجب أن يكون كل إطار بنفس الحجم وإلا فإن السلوك غير محدد.
تتيح هذه الميزة استخدام محاذاةconsoleRectInsets لتحديد منطقة نقر مخفّضة. يعيد هذا أيضًا تعريف كيفية تحديد علامات الارتساء. بالنسبة إلى الصورة المتحركة، يتم استخدام قيمة الصورة المتحركة، وليس الإطارات الفردية.
- (UIView*) iconView [read, write, assign, inherited] |
عرض العلامة للعرض.
في حال ترك الحقل صفريًا، سيتم الرجوع إلى السمة icon بدلاً من ذلك.
يوفّر الصور المتحركة لجميع خصائص UIView المتحركة، باستثناء frame وcenter. لا يمكن تغيير هذه السمات أو إصدار CALayer المقابل لها، بما في ذلك position.
تجدر الإشارة إلى أنّ طريقة العرض تعمل كما لو تم ضبط clipsToBounds على "نعم"، بصرف النظر عن قيمتها الفعلية.
- (BOOL) tracksViewChanges [read, write, assign, inherited] |
تتحكّم هذه السياسة في ما إذا كان يجب إعادة رسم رمز هذه العلامة كل إطار.
تجدر الإشارة إلى أنّه عند تغيير هذا الخيار من "لا" إلى "نعم"، يمكن أن نضمن إعادة رسم الرمز في الإطار التالي.
يكون الإعداد التلقائي بالقيمة "نعم". ولن يكون لذلك أي تأثير إذا كانت قيمة iconView صفرًا.
- (BOOL) tracksInfoWindowChanges [read, write, assign, inherited] |
تتحكّم هذه السياسة في ما إذا كان يجب إعادة رسم نافذة المعلومات لهذه العلامة كل إطار.
تجدر الإشارة إلى أنّه عند تغيير هذه النسبة من "لا" إلى "نعم"، يمكن ضمان إعادة رسم نافذة المعلومات في الإطار التالي.
يتم ضبط الإعدادات التلقائية على "لا".
- (CGPoint) groundAnchor [read, write, assign, inherited] |
يحدد ارتساء الأرض النقطة في صورة الرمز التي يتم تثبيتها في موضع العلامة على سطح الأرض.
يتم تحديد هذه النقطة داخل المساحة المستمرة [0.0، 1.0] x [0.0، 1.0]، حيث يكون (0,0) هو الزاوية العلوية اليسرى من الصورة، و (1,1) هو الركن الأيمن السفلي.
إذا كانت الصورة تحتوي على محاذاة فارغة بقيمة غير صفرية، فإن الجزء العلوي الأيسر وأسفل اليمين المذكور أعلاه يشيران إلى القسم الداخلي من الصورة.
- (CGPoint) infoWindowAnchor [read, write, assign, inherited] |
تحدد علامة ارتساء نافذة المعلومات النقطة في صورة الرمز التي سيتم عندها إرساء نافذة المعلومات، والتي سيتم عرضها أعلى هذه النقطة مباشرةً.
هذه النقطة محددة داخل نفس مساحة groundAnchor.
- (GMSMarkerAnimation) appearAnimation [read, write, assign, inherited] |
تتحكّم هذه السمة في الحركة المستخدمة عند وضع هذه العلامة على GMSMapView (دالة kGMSMarkerAnimationNone، بدون حركة).
- (BOOL) قابلة للسحب [read, write, assign, inherited] |
تتحكّم هذه السمة في إمكانية سحب هذه العلامة بشكل تفاعلي (ميزة "لا" تلقائية).
- (BOOL) مسطح [read, write, assign, inherited] |
للتحكم في ما إذا كان يجب أن تكون هذه العلامة مسطحة على سطح الأرض (نعم) أو لوحة إعلانات مواجهة للكاميرا (لا، الإعداد التلقائي).
- تدوير (CLLocationDegrees) [read, write, assign, inherited] |
لضبط دوران العلامة بالدرجات في اتجاه عقارب الساعة حول نقطة ارتساء العلامة.
ومحور الدوران عمودي للعلامة. يتجاوب التدوير 0 مع الموضع الافتراضي للعلامة. صور متحركة.
عندما يكون محدّد الموقع مسطّحًا على الخريطة، يكون الموضع الافتراضي محاذاةً إلى الشمال ويكون التدوير بحيث يظل محدّد الموقع مستويًا دائمًا على الخريطة. عندما تكون العلامة عبارة عن لوحة إعلانات، فإن الموضع الافتراضي يشير إلى الأعلى وأن التدوير بحيث تكون العلامة مواجهة للكاميرا دائمًا.
- معدل الشفافية (عائم) [read, write, assign, inherited] |
لضبط مدى تعتيم العلامة، بين 0 (شفاف تمامًا) و1 (تلقائي) بشكل شامل.
- (GMSMarkerLayer*) Layer [read, assign, inherited] |
توفّر طبقة الحركة الأساسية لـ GMSMarker هذا.
- (GMSPanoramaView*) panoramaView [read, write, assign, inherited] |
يحدد panoramaView عرض البانوراما الذي سيحاول عرض هذه العلامة.
لاحظ أنه إذا كان position محدّد الموقع بعيدًا جدًا عن موقع البانوراما الحالي لـ panoramaView، فلن يتم عرضه لأنه سيكون صغيرًا جدًا.
يمكن ضبطها على صفر لإزالة العلامة من أي عرض بانوراما حالي تم إرفاقها به.
يمكن عرض محدّد موقع على كل من صورة بانوراما وخريطة في الوقت نفسه.
- (NSString*) title [read, write, copy, inherited] |
العنوان، وصف موجز للتراكب.
ستعرض بعض التراكبات، مثل العلامات، العنوان على الخريطة. العنوان هو أيضًا نص تسهيل الاستخدام التلقائي.
- (GMSMapView*) خريطة [read, write, assign, inherited] |
الخريطة التي يظهر عليها هذا التراكب.
سيؤدي ضبط هذا الموقع إلى إضافة التراكب إلى الخريطة. وعند ضبطه على "لا"، يؤدي ذلك إلى إزالة هذا التراكب من الخريطة. يمكن أن يكون التراكب نشطًا على خريطة واحدة كحد أقصى في أي وقت معين.
- (BOOL) قابل للنقر [read, write, assign, inherited] |
ما إذا كان من المفترض أن يؤدي هذا التراكب إلى تلقّي إشعارات النقر
يتم تلقائيًا النقر على بعض العناصر المركّبة، مثل العلامات.
- (int) zIndex [read, write, assign, inherited] |
سيتم رسم العناصر المركّبة ذات قيمة zIndex الأعلى فوق طبقات التجانب والتراكبات ذات قيمة zIndex الأقل.
ينتج عن القيم المتساوية ترتيب رسم غير محدّد. وتُعدّ العلامات استثناءً، وبصرف النظر عن zIndex، سيتم رسمها دائمًا فوق طبقات مربّعة وتراكبات أخرى لا تمثّل علامات؛ ويتم اعتبارها فعليًا في مجموعة فهرسة z منفصلة مقارنةً بالتراكبات الأخرى.
- (id) userData [read, write, assign, inherited] |
بيانات التراكب
يمكنك استخدام هذه السمة لربط كائن عشوائي بهذا التراكب. إنّ حزمة تطوير البرامج (SDK) في "خرائط Google" لنظام التشغيل iOS لا تقرأ هذه السمة ولا تكتبها.
تجدر الإشارة إلى أنّه يجب ألا تتضمّن بيانات المستخدم أي مراجع قوية لأي عناصر في "خرائط Google"، وإلا قد يتم إنشاء دورة احتفاظ (منع إطلاق العناصر).