نظرة عامة
العلامة هي أيقونة موضوعة عند نقطة معينة على سطح الخريطة.
يتم رسم رمز العلامة باتجاه شاشة الجهاز بدلاً من سطح الخريطة، وهذا يعني أنه لن يؤدي بالضرورة إلى تغيير الاتجاه بسبب دوران الخريطة أو إمالتها أو تكبيرها/تصغيرها.
تكتسب GMSتراكب.
مكتسَب من قِبل GMSAdvancedMarker.
دوال الأعضاء العامة الثابتة | |
| (instancetype) | + markerWithالموضع: |
| الدالة الإنشائية المناسبة للعلامة التلقائية. | |
| (صورة واجهة المستخدم *) | + markerImageWithColor: |
| تنشئ نسخة ملوّنة من صورة العلامة التلقائية لاستخدامها كرمز. | |
المواقع | |
| CLLocationCoordente2D | الموضع |
| موضع العلامة | |
| NSString * | مقتطف |
| نص المقتطف، يظهر أسفل العنوان في نافذة المعلومات عند تحديده. | |
| صورة واجهة المستخدم * | رمز |
| رمز العلامة المطلوب عرضه | |
| UIView * | iconView |
| عرض العلامة المطلوب عرضه | |
| BOOL | tracksViewChanges |
| تتحكّم هذه السياسة في ما إذا كان يجب إعادة رسم رمز هذه العلامة في كل إطار. | |
| BOOL | tracksInfoWindowChanges |
| تتحكّم هذه السياسة في ما إذا كان يجب إعادة رسم نافذة المعلومات لهذه العلامة في كل إطار. | |
| نقطة CGPoint | groundAnchor |
| يحدد ارتساء الأرض النقطة في صورة الرمز التي يتم تثبيتها في موضع العلامة على سطح الأرض. | |
| نقطة CGPoint | infoWindowAnchor |
| يحدد ارتساء نافذة المعلومات النقطة الموجودة في صورة الرمز التي يمكن عندها ارتساء نافذة المعلومات، والتي سيتم عرضها أعلى هذه النقطة مباشرة. | |
| GMSMarkerAnimation | SpeakAnimation |
| تتحكّم هذه السمة في الحركة المستخدمة عند وضع هذه العلامة على GMSMapView (القيمة التلقائية kGMSMarkerAnimationNone، بدون رسوم متحركة). | |
| BOOL | يمكن سحبه |
| تتحكّم هذه السياسة في ما إذا كان من الممكن سحب هذه العلامة بشكل تفاعلي (ميزة "لا" التلقائية). | |
| BOOL | مسطح |
| للتحكم في ما إذا كان يجب أن تكون هذه العلامة مسطحة على سطح الأرض (نعم) أو لوحة إعلانات مواجهة للكاميرا (لا، الإعداد التلقائي). | |
| CLLocationDegrees | تدوير |
| لتعيين تدوير العلامة بالدرجات في اتجاه عقارب الساعة حول نقطة ارتساء العلامة. | |
| عدد عائم | تعتيم |
| لتعيين مدى تعتيم العلامة، بين 0 (شفاف تمامًا) و1 (تلقائي) ضمنًا. | |
| GMSMarkerLayer * | طبقة |
| توفر طبقة الرسوم المتحركة الأساسية لـ GMSMarker هذا. | |
| GMSPanoramaView * | عرض بانوراما |
يُحدِّد panoramaView عرض البانوراما الذي سيحاول عرض هذه العلامة. | |
| NSString * | title |
| عنوان، وصف موجز للتراكب. | |
| GMSMapView * | خريطة |
| خريطة يوجد هذا التراكب. | |
| BOOL | قابلة للنقر |
| إذا كان من المفترض أن يتسبب هذا التراكب في تلقّي إشعارات بالنقر | |
| عدد صحيح | zIndex |
سيتم رسم العناصر المركّبة ذات قيمة zIndex الأعلى فوق طبقات وتراكبات العناصر ذات القيمة zIndex الأقل. | |
| id | بيانات المستخدمين |
| بيانات التراكب | |
وثائق دالة العضو
| + (instancetype) markerWithالموضع: | (CLLocationCoordente2D) | الموضع |
الدالة الإنشائية المناسبة للعلامة التلقائية.
| + (UIImage *) markerImageWithColor: | (واجهة مستخدم قابلة للقيم *) | color |
تنشئ نسخة ملوّنة من صورة العلامة التلقائية لاستخدامها كرمز.
وثائق عقارية
- (CLLocationCoordente2D) position [read, write, assign] |
موضع العلامة
صور متحركة.
- (NSString*) مقتطف [read, write, copy] |
نص المقتطف، يظهر أسفل العنوان في نافذة المعلومات عند تحديده.
- (UIImage*) رمز [read, write, assign] |
رمز العلامة المطلوب عرضه
في حال تركها فارغة، يتم استخدام علامة المكان التلقائية لحزمة تطوير البرامج (SDK).
يتيح استخدام الصور المتحركة، ولكن يجب أن يكون كل إطار بنفس الحجم أو أن السلوك غير محدد.
تتيح هذه السياسة استخدام تنسيق shoppingtInsets لتحديد منطقة نقر مخفّضة. يعيد هذا أيضًا تعريف كيفية تحديد علامات الارتساء. بالنسبة إلى الصورة المتحركة، يتم استخدام قيمة الصورة المتحركة، وليس الإطارات الفردية.
- (UIView*) iconView [read, write, assign] |
عرض العلامة المطلوب عرضه
إذا كانت القيمة فارغة، يتم الرجوع إلى السمة icon بدلاً من ذلك.
يتيح استخدام الصور المتحركة لجميع الخصائص المتحركة في UIView، باستثناء frame وcenter. لا يمكن تغيير هذه السمات أو إصدار CALayer المقابل لها، بما في ذلك position.
تجدر الإشارة إلى أنّ طريقة العرض تعمل كما لو كانت clipsToBounds مضبوطة على YES، بغض النظر عن قيمتها الفعلية.
- (BOOL) tracksViewChanges [read, write, assign] |
تتحكّم هذه السياسة في ما إذا كان يجب إعادة رسم رمز هذه العلامة في كل إطار.
لاحظ أنه عند تغيير هذا من لا إلى "نعم"، يمكن ضمان إعادة رسم الرمز في الإطار التالي.
يكون الإعداد التلقائي بالقيمة YES. ليس لها أي تأثير إذا كانت قيمة iconView صفرًا.
- (BOOL) tracksInfoWindowChanges [read, write, assign] |
تتحكّم هذه السياسة في ما إذا كان يجب إعادة رسم نافذة المعلومات لهذه العلامة في كل إطار.
لاحظ أنه عند تغيير هذا من "لا" إلى "نعم"، يمكن ضمان إعادة رسم نافذة المعلومات في الإطار التالي.
يكون الإعداد التلقائي بالقيمة NO.
- (CGPoint) groundAnchor [read, write, assign] |
يحدد ارتساء الأرض النقطة في صورة الرمز التي يتم تثبيتها في موضع العلامة على سطح الأرض.
يتم تحديد هذه النقطة داخل المساحة المستمرة [0.0، 1.0] × [0.0، 1.0]، حيث (0,0) هو الزاوية العلوية اليسرى من الصورة، و (1,1) هو الزاوية اليمنى السفلية.
إذا كانت الصورة تحتوي على محاذاة RectInsets بقيمة غير صفرية، يشير الجزء العلوي الأيسر والسفلي الأيمن المذكور أعلاه إلى القسم الداخلي من الصورة.
- (CGPoint) infoWindowAnchor [read, write, assign] |
يحدد ارتساء نافذة المعلومات النقطة الموجودة في صورة الرمز التي يمكن عندها ارتساء نافذة المعلومات، والتي سيتم عرضها أعلى هذه النقطة مباشرة.
يتم تحديد هذه النقطة داخل نفس مساحة groundAnchor.
- (GMSMarkerAnimation) appearAnimation [read, write, assign] |
تتحكّم هذه السمة في الحركة المستخدمة عند وضع هذه العلامة على GMSMapView (القيمة التلقائية kGMSMarkerAnimationNone، بدون رسوم متحركة).
- (BOOL) قابل للسحب [read, write, assign] |
تتحكّم هذه السياسة في ما إذا كان من الممكن سحب هذه العلامة بشكل تفاعلي (ميزة "لا" التلقائية).
- (BOOL) مسطح [read, write, assign] |
للتحكم في ما إذا كان يجب أن تكون هذه العلامة مسطحة على سطح الأرض (نعم) أو لوحة إعلانات مواجهة للكاميرا (لا، الإعداد التلقائي).
- (CLLocationDegrees) تغيير [read, write, assign] |
لتعيين تدوير العلامة بالدرجات في اتجاه عقارب الساعة حول نقطة ارتساء العلامة.
يكون محور الدوران متعامدًا مع العلامة. يتجاوب تدوير 0 مع الموضع الافتراضي للعلامة. صور متحركة.
عندما يكون محدِّد الموقع مسطحًا على الخريطة، فإن الموضع الافتراضي يكون بمحاذاة الشمال ويكون التدوير هو أن تظل العلامة مسطحة دائمًا على الخريطة. عندما تكون العلامة عبارة عن لوحة إعلانات، فإن الموضع الافتراضي يشير إلى الأعلى ويكون التدوير بشكل يجعل العلامة مواجهة الكاميرا دائمًا.
- تعتيم [read, write, assign] (عائم) |
لتعيين مدى تعتيم العلامة، بين 0 (شفاف تمامًا) و1 (تلقائي) ضمنًا.
- (GMSMarkerLayer*) Layer [read, assign] |
توفر طبقة الرسوم المتحركة الأساسية لـ GMSMarker هذا.
- (GMSPanoramaView*) بانوراماView [read, write, assign] |
يُحدِّد 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 منفصلة مقارنةً بالتراكبات الأخرى.
- (المعرّف) userData [read, write, assign, inherited] |
بيانات التراكب
يمكنك استخدام هذه السمة لربط كائن عشوائي بهذا التراكب. حزمة تطوير البرامج (SDK) في "خرائط Google" لنظام التشغيل iOS لا تقرأ هذه الخاصية ولا تكتبها.
تجدر الإشارة إلى أنّ userData يجب ألا تتضمّن أي إشارات قوية إلى أي كائنات في "خرائط Google"، وإلا قد يتم إنشاء دورة احتفاظ بالبيانات (منع إطلاق العناصر).