بررسی اجمالی
این کلاس اصلی Google Maps SDK برای iOS است و نقطه ورود همه روش‌های مربوط به نقشه است.
نقشه باید از طریق یکی از سازنده های -init یا -initWithOptions: نمونه سازی شود.
GMSMapView را فقط می توان از رشته اصلی خواند و تغییر داد، مشابه همه اشیاء UIKit. فراخوانی این روش ها از یک رشته دیگر منجر به یک استثنا یا رفتار تعریف نشده می شود.
توابع اعضای عمومی | |
| (نوع نمونه) | - شروع |
| با CGRectZero و گزینه های پیش فرض راه اندازی می شود. | |
| (نوع نمونه) | - initWithOptions: |
| یک نمای نقشه جدید با گزینه های داده شده ایجاد می کند. | |
| (نوع نمونه) | - initWithFrame: |
| (نوع نمونه) | - initWithCoder: |
| (نوع نمونه) | - initWithFrame:camera: |
| نمای نقشه را با کادر و هدف دوربین می سازد و برمی گرداند. | |
| (نوع نمونه) | - initWithFrame:mapID:camera: |
| نمای نقشه را با کادر، شناسه نقشه و هدف دوربین می سازد و برمی گرداند. | |
| (خالی) | - شروع رندرینگ |
| به این نقشه می‌گوید رندر خود را روشن کند. | |
| (خالی) | - توقف رندرینگ |
| به این نقشه می‌گوید رندر خود را خاموش کند. | |
| (خالی) | - روشن |
| تمام نشانه‌گذاری‌هایی که به نقشه اضافه شده‌اند، از جمله نشانگرها، چند خطوط و پوشش‌های زمین را پاک می‌کند. | |
| (خالی) | - setMinZoom:maxZoom: |
minZoom و maxZoom را تنظیم می کند. | |
| ( GMSCameraPosition قابل تهی *) | - cameraForBounds:insets: |
یک GMSCameraPosition بسازید که bounds با padding ارائه می کند. | |
| (خالی) | - حرکت دوربین: |
دوربین را مطابق به update تغییر می دهد. | |
| (بول) | - areEqualForRenderingPosition:position: |
| بررسی کنید که آیا موقعیت های دوربین داده شده عملاً باعث می شود که دوربین یکسان شود، با در نظر گرفتن سطح دقت و دگرگونی های استفاده شده در داخل. | |
| ( GMSFeatureLayer < GMSPlaceFeature * > *) | - featureLayerOfFeatureType: |
| یک لایه ویژگی از نوع مشخص شده را برمی گرداند. | |
| (خالی) | - animateToCameraPosition: |
دوربین این نقشه را به cameraPosition متحرک می کند. | |
| (خالی) | - animateToLocation: |
به عنوان animateToCameraPosition:، اما فقط مکان دوربین را تغییر می دهد (یعنی از مکان فعلی به location ). | |
| (خالی) | - animateToZoom: |
| به عنوان animateToCameraPosition:، اما فقط سطح زوم دوربین را تغییر می دهد. | |
| (خالی) | - animateToBearing: |
| به عنوان animateToCameraPosition:، اما فقط بلبرینگ دوربین را تغییر می‌دهد (بر حسب درجه). | |
| (خالی) | - animateToViewingAngle: |
| به عنوان animateToCameraPosition:، اما فقط زاویه دید دوربین را تغییر می دهد (بر حسب درجه). | |
| (خالی) | - animateWithCamera Update: |
cameraUpdate را روی دوربین فعلی اعمال می کند و سپس از نتیجه مطابق با animateToCameraPosition: استفاده می کند. | |
توابع اعضای عمومی استاتیک | |
| (نوع نمونه) | + mapWithFrame:camera: |
| نمای نقشه را با کادر و هدف دوربین می سازد و برمی گرداند. | |
| (نوع نمونه) | + mapWithFrame:mapID:camera: |
| اولیه ساز راحت برای ساخت و بازگرداندن نمای نقشه با کادر، شناسه نقشه و هدف دوربین. | |
خواص | |
| IBOutlet id< GMSMapViewDelegate > | نماینده |
| نماینده GMSMapView . | |
| موقعیت GMSCamera * | دوربین |
| دوربین را کنترل می کند که نحوه جهت گیری نقشه را مشخص می کند. | |
| GMSProjection * | طرح ریزی |
| یک شی GMSProjection را برمی گرداند که می توانید از آن برای تبدیل بین مختصات صفحه و مختصات طول و عرض جغرافیایی استفاده کنید. | |
| BOOL | myLocationEnabled |
| فعال بودن دایره دقت و نقطه موقعیت مکانی من را کنترل می کند. | |
| مکان CLL * | محل من |
| اگر موقعیت مکانی من فعال باشد، نشان می دهد که نقطه مکان دستگاه در کجا کشیده می شود. | |
| GMSMarker * | نشانگر انتخاب شده |
| نشانگری که انتخاب شده است. | |
| BOOL | ترافیک فعال شد |
| در صورت وجود، کنترل می‌کند که آیا نقشه داده‌های ترافیکی را ترسیم می‌کند. | |
| GMSMapViewType | نوع نقشه |
| نوع کاشی های نقشه را که باید نمایش داده شوند را کنترل می کند. | |
| GMSMapStyle * | نقشه سبک |
| سبک نقشه را کنترل می کند. | |
| شناور | minZoom |
| حداقل زوم (بیشترین فاصله ای که دوربین ممکن است کوچکنمایی شود). | |
| شناور | maxZoom |
| حداکثر زوم (نزدیک ترین فاصله ممکن دوربین به زمین). | |
| BOOL | ساختمانها فعال شده است |
| در صورت تنظیم، ساختمان‌های سه بعدی در صورت وجود نشان داده می‌شوند. | |
| BOOL | indoorEnabled |
| تعیین می‌کند که آیا نقشه‌های داخلی در صورت وجود نشان داده شوند یا خیر. | |
| GMSIndoorDisplay * | صفحه نمایش داخلی |
| نمونه GMSIndoorDisplay را دریافت می کند که امکان مشاهده یا کنترل جنبه های نمایش داده های داخلی را فراهم می کند. | |
| تنظیمات GMSUIS * | تنظیمات |
| شی GMSUISettings را دریافت می کند که تنظیمات رابط کاربر را برای نقشه کنترل می کند. | |
| UIEdgeInsets | لایه گذاری |
| ناحیه "مرئی" نما را کنترل می کند. | |
| GMSMapViewPaddingAdjustmentBehavior | paddingAdjustmentBehavior |
| نحوه افزودن قسمت‌های ناحیه امن به مقادیر بالشتک را کنترل می‌کند. | |
| BOOL | accessibilityElementsHidden |
| به طور پیش فرض بله. | |
| GMSMapLayer * | لایه |
| Accessor برای نوع CALayer سفارشی مورد استفاده برای لایه. | |
| GMSFrameRate | preferredFrameRate |
| نرخ فریم رندر را کنترل می کند. | |
| GMSCoordinateBounds * | cameraTargetBounds |
| اگر صفر نباشد، هدف دوربین را محدود می کند تا حرکات نتواند باعث شود که از محدوده های مشخص شده خارج شود. | |
| GMSMapCapabilityFlags | قابلیت های نقشه |
| همه قابلیت های مشروط در دسترس (وابسته به mapID یا سایر تنظیمات نقشه) که در لحظه فعلی در دسترس هستند. | |
توابع مرتبط | |
(توجه داشته باشید که اینها توابع عضو نیستند.) | |
| NSString *const | kGMSAccessibilityCompass |
| شناسه دسترسی برای دکمه قطب نما. | |
| NSString *const | kGMSAccessibilityMyLocation |
| شناسه دسترس‌پذیری برای دکمه "مکان من". | |
| NSString *const | دسترسی kGMSOutOfQuota |
| شناسه دسترس‌پذیری برای برچسب خطای "خارج از سهمیه". | |
مستندات عملکرد اعضا
| - (نمونه) init |
با CGRectZero و گزینه های پیش فرض راه اندازی می شود.
| - (نوع نمونه) initWithOptions: | ( گزینه های GMSMapView غیر تهی *) | گزینه ها |
یک نمای نقشه جدید با گزینه های داده شده ایجاد می کند.
مقدار شی گزینه توسط این روش کپی می شود.
| - (نوع نمونه) initWithFrame: | (CGRect) | قاب |
| - (نوع نمونه) initWithCoder: | (NSCoder *) | رمزگذار |
| + (نمونه) mapWithFrame: | (CGRect) | قاب | |
| دوربین: | ( GMSCameraPosition *) | دوربین | |
نمای نقشه را با کادر و هدف دوربین می سازد و برمی گرداند.
| + (نمونه) mapWithFrame: | (CGRect) | قاب | |
| شناسه نقشه: | ( GMSMapID *) | شناسه نقشه | |
| دوربین: | ( GMSCameraPosition *) | دوربین | |
اولیه ساز راحت برای ساخت و بازگرداندن نمای نقشه با کادر، شناسه نقشه و هدف دوربین.
| - (نوع نمونه) initWithFrame: | (CGRect) | قاب | |
| دوربین: | ( GMSCameraPosition *) | دوربین | |
نمای نقشه را با کادر و هدف دوربین می سازد و برمی گرداند.
- توجه داشته باشید:
- این منسوخ شده است. به جای آن از -init یا -initWithOptions استفاده کنید.
| - (نوع نمونه) initWithFrame: | (CGRect) | قاب | |
| شناسه نقشه: | ( GMSMapID *) | شناسه نقشه | |
| دوربین: | ( GMSCameraPosition *) | دوربین | |
نمای نقشه را با کادر، شناسه نقشه و هدف دوربین می سازد و برمی گرداند.
- توجه داشته باشید:
- این منسوخ شده است. به جای آن از -init یا -initWithOptions استفاده کنید.
| - (باطل) startRendering |
به این نقشه می‌گوید رندر خود را روشن کند.
این اختیاری و غیرقابل قبول است.
- توجه داشته باشید:
- این منسوخ شده است. این روش منسوخ شده است و در نسخه های بعدی حذف خواهد شد.
| - (باطل) stopRendering |
به این نقشه می‌گوید رندر خود را خاموش کند.
این اختیاری و غیرقابل قبول است.
- توجه داشته باشید:
- این منسوخ شده است. این روش منسوخ شده است و در نسخه های بعدی حذف خواهد شد.
| - (باطل) روشن |
تمام نشانه‌گذاری‌هایی که به نقشه اضافه شده‌اند، از جمله نشانگرها، چند خطوط و پوشش‌های زمین را پاک می‌کند.
با این کار، نقطه قابل مشاهده مکان پاک نمی شود یا mapType فعلی بازنشانی می شود.
| - (باطل) setMinZoom: | (شناور) | minZoom | |
| maxZoom: | (شناور) | maxZoom | |
minZoom و maxZoom را تنظیم می کند.
این روش انتظار دارد که حداقل کمتر یا مساوی با حداکثر باشد و در غیر این صورت یک استثنا با نام NSRangeException ایجاد می کند.
| - ( GMSCameraPosition *) cameraForBounds: | ( GMSCoordinateBounds *) | محدوده | |
| درونی: | (UIEdgeInsets) | درونی ها | |
یک GMSCameraPosition بسازید که bounds با padding ارائه می کند.
دوربین دارای یک یاتاقان و شیب صفر خواهد بود (یعنی رو به شمال و به طور مستقیم به زمین نگاه می کند). این قاب و بالشتک این GMSMapView را در نظر می گیرد.
اگر محدوده نامعتبر باشد، این روش یک دوربین صفر را برمی گرداند.
| - (باطل) moveCamera: | ( GMSCamera Update *) | به روز رسانی |
دوربین را مطابق به update تغییر می دهد.
تغییر دوربین آنی است (بدون انیمیشن).
| - (BOOL) areEqualForRenderingPosition: | ( GMSCameraPosition *) | موقعیت | |
| موقعیت: | ( GMSCameraPosition *) | موقعیت دیگر | |
بررسی کنید که آیا موقعیت های دوربین داده شده عملاً باعث می شود که دوربین یکسان شود، با در نظر گرفتن سطح دقت و دگرگونی های استفاده شده در داخل.
| - ( GMSFeatureLayer < GMSPlaceFeature *> *) featureLayerOfFeatureType: | ( GMSFeatureType ) | نوع ویژگی |
یک لایه ویژگی از نوع مشخص شده را برمی گرداند.
لایه های ویژگی باید در Cloud Console پیکربندی شوند.
اگر لایه ای از نوع مشخص شده در این نقشه وجود نداشته باشد، یا اگر استایل مبتنی بر داده فعال نباشد، یا اگر از چارچوب رندر فلزی استفاده نشود، لایه حاصل isAvailable NO خواهد بود و به هیچ تماسی پاسخ نخواهد داد.
به رندر فلزی نیاز دارد. نحوه فعال کردن Metal را در https://developers.google.com/maps/documentation/ios-sdk/config#use-metal بیاموزید
| - (void) animateToCameraPosition: | ( GMSCameraPosition *) | موقعیت دوربین |
دوربین این نقشه را به cameraPosition متحرک می کند.
| - (void) animateToLocation: | (CLLlocationCoordinate2D) | محل |
به عنوان animateToCameraPosition:، اما فقط مکان دوربین را تغییر می دهد (یعنی از مکان فعلی به location ).
| - (void) animateToZoom: | (شناور) | بزرگنمایی |
به عنوان animateToCameraPosition:، اما فقط سطح زوم دوربین را تغییر می دهد.
این مقدار توسط [kGMSMinZoomLevel, kGMSMaxZoomLevel] بسته می شود.
| - (void) animateToBearing: | (CLLocationDirection) | یاتاقان |
به عنوان animateToCameraPosition:، اما فقط بلبرینگ دوربین را تغییر می‌دهد (بر حسب درجه).
صفر نشان دهنده شمال واقعی است.
| - (void) animateToViewingAngle: | (دو برابر) | زاویه دید |
به عنوان animateToCameraPosition:، اما فقط زاویه دید دوربین را تغییر می دهد (بر حسب درجه).
این مقدار بسته به نزدیکی نسبی به زمین، به حداقل صفر (یعنی رو به پایین) و بین 30 تا 45 درجه به سمت افق بسته می شود.
| - (باطل) animateWithCameraUpdate: | ( GMSCamera Update *) | به روز رسانی دوربین |
cameraUpdate را روی دوربین فعلی اعمال می کند و سپس از نتیجه مطابق با animateToCameraPosition: استفاده می کند.
دوستان و مستندات عملکرد مرتبط
- (NSString* const) kGMSAccessibilityCompass [related] |
شناسه دسترسی برای دکمه قطب نما.
- (NSString* const) 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] |
فعال بودن دایره دقت و نقطه موقعیت مکانی من را کنترل می کند.
پیش‌فرض NO است.
- (CLLocation*) myLocation [read, assign] |
اگر موقعیت مکانی من فعال باشد، نشان می دهد که نقطه مکان دستگاه در کجا کشیده می شود.
اگر غیرفعال باشد، یا فعال باشد اما هیچ داده موقعیت مکانی در دسترس نباشد، صفر خواهد بود. این ویژگی با استفاده از KVO قابل مشاهده است.
- ( GMSMarker *) SelectMarker [read, write, assign] |
نشانگری که انتخاب شده است.
تنظیم این ویژگی یک نشانگر خاص را انتخاب می کند و یک پنجره اطلاعات روی آن نشان می دهد. اگر این ویژگی غیر صفر باشد، با تنظیم آن بر روی nil، نشانگر از حالت انتخاب خارج می شود و پنجره اطلاعات پنهان می شود. این ویژگی با استفاده از KVO قابل مشاهده است.
- ترافیک (BOOL) فعال شده [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] |
در صورت تنظیم، ساختمان‌های سه بعدی در صورت وجود نشان داده می‌شوند.
به طور پیش فرض بله.
این ممکن است هنگام افزودن یک لایه کاشی سفارشی به نقشه مفید باشد تا در سطوح زوم بالا واضح‌تر شود. تغییر این مقدار باعث می شود که تمام کاشی ها برای مدت کوتاهی باطل شوند.
- (BOOL) indoorEnabled [read, write, assign] |
تعیین می‌کند که آیا نقشه‌های داخلی در صورت وجود نشان داده شوند یا خیر.
به طور پیش فرض بله.
اگر روی NO تنظیم شود، حافظه پنهان برای داده های داخلی ممکن است پاک شود و هر طبقه ای که در حال حاضر توسط کاربر نهایی انتخاب شده است، بازنشانی شود.
- ( GMSIndoorDisplay *) indoorDisplay [read, assign] |
نمونه GMSIndoorDisplay را دریافت می کند که امکان مشاهده یا کنترل جنبه های نمایش داده های داخلی را فراهم می کند.
- تنظیمات ( GMSUISettings *) [read, assign] |
شی GMSUISettings را دریافت می کند که تنظیمات رابط کاربر را برای نقشه کنترل می کند.
- (UIEdgeInsets) بالشتک [read, write, assign] |
ناحیه "مرئی" نما را کنترل می کند.
با اعمال padding می توان ناحیه ای در اطراف لبه نما ایجاد کرد که حاوی داده های نقشه باشد اما شامل کنترل های UI نباشد.
اگر بالشتک متعادل نباشد، مرکز بصری نما به اندازه مناسب حرکت می کند. padding نیز بر ویژگی projection تأثیر می‌گذارد، بنابراین ناحیه قابل مشاهده شامل ناحیه بالشتک نمی‌شود. GMSCameraUpdate fitToBounds اطمینان حاصل می کند که هم این بالشتک و هم هر بالشتکی درخواستی در نظر گرفته می شود.
این ویژگی ممکن است در یک بلوک انیمیشن مبتنی بر UIView متحرک شود.
- ( GMSMapViewPaddingAdjustmentBehavior ) paddingAdjustmentBehavior [read, write, assign] |
نحوه افزودن قسمت‌های ناحیه امن به مقادیر بالشتک را کنترل می‌کند.
مانند بالشتک، منطقه امن کنترل‌های نقشه موقعیت مانند قطب‌نما، دکمه مکان من و انتخابگر طبقه را در منطقه امن دستگاه قرار می‌دهد.
پیش‌فرض kGMSMapViewPaddingAdjustmentBehaviorAlways.
- (BOOL) accessibilityElementsHidden [read, write, assign] |
به طور پیش فرض بله.
اگر روی NO تنظیم شود، GMSMapView عناصر دسترسی را برای اشیاء همپوشانی، مانند GMSMarker و GMSPolyline ایجاد می‌کند.
این ویژگی از پروتکل غیررسمی UIAccessibility پیروی می کند، به جز مقدار پیش فرض YES.
- ( GMSMapLayer *) لایه [read, retain] |
Accessor برای نوع CALayer سفارشی مورد استفاده برای لایه.
- ( GMSFrameRate ) preferredFrameRate [read, write, assign] |
نرخ فریم رندر را کنترل می کند.
مقدار پیش‌فرض kGMSFrameRateMaximum است.
- ( GMSCoordinateBounds *) cameraTargetBounds [read, write, assign] |
اگر صفر نباشد، هدف دوربین را محدود می کند تا حرکات نتواند باعث شود که از محدوده های مشخص شده خارج شود.
- ( GMSMapCapabilityFlags ) mapCapabilities [read, assign] |
همه قابلیت های مشروط در دسترس (وابسته به mapID یا سایر تنظیمات نقشه) که در لحظه فعلی در دسترس هستند.
شامل قابلیت های همیشه در دسترس نمی شود.