این کلاس اصلی Google Maps SDK برای اندروید است و نقطه ورود همه روش های مربوط به نقشه است. شما نمیتوانید مستقیماً یک شی GoogleMap
را نمونهسازی کنید، بلکه باید آن را از getMapAsync()
در MapFragment
یا MapView
که به برنامه خود اضافه کردهاید، دریافت کنید.
توجه: مشابه یک شی View
، GoogleMap
را فقط می توان از رشته رابط کاربری Android خوانده و اصلاح کرد. فراخوانی متدهای GoogleMap
از یک رشته دیگر منجر به استثنا می شود.
می توانید با تغییر موقعیت دوربین (برخلاف حرکت دادن نقشه) دیدگاه یک نقشه را تنظیم کنید. می توانید از دوربین نقشه برای تنظیم پارامترهایی مانند مکان، سطح زوم، زاویه شیب و یاتاقان استفاده کنید. برای اطلاعات بیشتر، دوربین و مشاهده را ببینید.
راهنمای توسعه دهنده
برای شروع، راهنمای توسعه دهندگان Google Maps SDK for Android را بخوانید.
خلاصه کلاس تودرتو
رابط | GoogleMap.CancelableCallback | یک رابط پاسخ به تماس برای گزارش زمانی که یک کار کامل یا لغو شد. | |
رابط | GoogleMap.InfoWindowAdapter | نماهایی را برای نمایش سفارشی پنجره های اطلاعات ارائه می دهد. | |
رابط | GoogleMap.OnCameraChangeListener | این رابط منسوخ شده است. با GoogleMap.OnCameraMoveStartedListener ، GoogleMap.OnCameraMoveListener و GoogleMap.OnCameraIdleListener جایگزین شد. ترتیب فراخوانی روش منسوخ شده onCameraChange در رابطه با روشهای موجود در شنوندههای جدید تغییر دوربین، تعریف نشده است. | |
رابط | GoogleMap.OnCameraIdleListener | رابط تماس برای زمانی که حرکت دوربین به پایان رسیده است. | |
رابط | GoogleMap.OnCameraMoveCanceledListener | رابط تماس برای زمانی که حرکت دوربین متوقف شده است یا زمانی که دوربین به دلیل جدیدی شروع به حرکت می کند. | |
رابط | GoogleMap.OnCameraMoveListener | رابط پاسخ به تماس برای زمانی که دوربین موقعیت خود را تغییر می دهد. | |
رابط | GoogleMap.OnCameraMoveStartedListener | رابط پاسخ به تماس برای زمانی که حرکت دوربین شروع می شود. | |
رابط | GoogleMap.OnCircleClickListener | رابط پاسخ به تماس برای زمانی که روی یک دایره کلیک می شود. | |
رابط | GoogleMap.OnGroundOverlayClickListener | رابط پاسخ به تماس برای زمانی که روی همپوشانی زمین کلیک می شود. | |
رابط | GoogleMap.OnIndoorStateChangeListener | یک شنونده برای زمانی که وضعیت داخلی تغییر می کند. | |
رابط | GoogleMap.OnInfoWindowClickListener | رابط پاسخ به تماس برای رویدادهای کلیک/ضربه در پنجره اطلاعات نشانگر. | |
رابط | GoogleMap.OnInfoWindowCloseListener | رابط پاسخ به تماس برای بستن رویدادها در پنجره اطلاعات نشانگر. | |
رابط | GoogleMap.OnInfoWindowLongClickListener | رابط پاسخ به تماس برای زمانی که کاربر به مدت طولانی روی پنجره اطلاعات نشانگر فشار می دهد. | |
رابط | GoogleMap.OnMapClickListener | رابط پاسخ به تماس برای زمانی که کاربر روی نقشه ضربه می زند. | |
رابط | GoogleMap.OnMapLoadedCallback | رابط پاسخ به تماس برای زمانی که نقشه به پایان رسید. | |
رابط | GoogleMap.OnMapLongClickListener | رابط پاسخ به تماس برای زمانی که کاربر به مدت طولانی روی نقشه فشار می آورد. | |
رابط | GoogleMap.OnMarkerClickListener | امضاها را برای روش هایی تعریف می کند که با کلیک یا ضربه زدن روی یک نشانگر فراخوانی می شوند. | |
رابط | GoogleMap.OnMarkerDragListener | رابط پاسخ به تماس برای کشیدن رویدادها روی نشانگرها. | |
رابط | GoogleMap.OnMyLocationButtonClickListener | رابط پاسخ به تماس برای زمانی که دکمه موقعیت مکانی من کلیک می شود. | |
رابط | GoogleMap.OnMyLocationChangeListener | این رابط منسوخ شده است. به جای آن از com.google.android.gms.location.FusedLocationProviderApi استفاده کنید. FusedLocationProviderApi مکان یابی و مصرف انرژی را بهبود می بخشد و توسط نقطه آبی "My Location" استفاده می شود. آموزش انتخاب مکان فعلی را ببینید که از FusedLocationProviderApi یا راهنمای برنامهنویس مکان استفاده میکند. | |
رابط | GoogleMap.OnMyLocationClickListener | رابط پاسخ به تماس برای زمانی که روی نقطه My Location (که نشان دهنده مکان کاربر است) کلیک می شود. | |
رابط | GoogleMap.OnPoiClickListener | شنونده برای ضربه های POI. | |
رابط | GoogleMap.OnPolygonClickListener | رابط پاسخ به تماس برای زمانی که روی چند ضلعی کلیک می شود. | |
رابط | GoogleMap.OnPolylineClickListener | رابط پاسخ به تماس برای زمانی که روی چند خط کلیک می شود. | |
رابط | GoogleMap.SnapshotReadyCallback | رابط پاسخ به تماس برای اطلاع از زمانی که عکس فوری گرفته شده است. |
خلاصه ثابت
بین المللی | MAP_TYPE_HYBRID | نقشه های ماهواره ای با یک لایه شفاف از خیابان های اصلی. |
بین المللی | MAP_TYPE_NONE | بدون کاشی نقشه پایه. |
بین المللی | MAP_TYPE_NORMAL | نقشه های اساسی |
بین المللی | MAP_TYPE_SATELLITE | نقشه های ماهواره ای بدون برچسب |
بین المللی | MAP_TYPE_TERRAIN | نقشه های زمین |
خلاصه روش عمومی
دایره | |
روکش زمین | |
نشانگر | |
چند ضلعی | |
پلی لاین | |
TileOverlay | |
خالی | animateCamera (به روز رسانی CameraUpdate ) حرکت دوربین را از موقعیت فعلی به موقعیت تعریف شده در به روز رسانی متحرک می کند. |
خالی | animateCamera (به روز رسانی CameraUpdate ، GoogleMap.CancelableCallback callback) حرکت دوربین را از موقعیت فعلی به موقعیتی که در به روز رسانی تعریف شده است متحرک می کند و پس از اتمام یک تماس اختیاری را فراخوانی می کند. |
خالی | animateCamera (بهروزرسانی CameraUpdate ، int interrationMs، GoogleMap.Cancelable Callback callback) نقشه را مطابق به روز رسانی با یک انیمیشن در مدت زمان مشخصی حرکت می دهد و پس از تکمیل، یک تماس اختیاری را فراخوانی می کند. |
خالی | روشن () تمام نشانگرها، چند خطوط، چند ضلعی ها، همپوشانی ها و غیره را از نقشه حذف می کند. |
موقعیت دوربین | getCameraPosition () موقعیت فعلی دوربین را دریافت می کند. |
IndoorBuilding | getFocusedBuilding () ساختمان متمرکز فعلی را دریافت می کند. |
بین المللی | getMapType () نوع نقشه ای را که در حال حاضر نمایش داده می شود دریافت می کند. |
شناور | getMaxZoomLevel () حداکثر سطح زوم را برای موقعیت فعلی دوربین برمیگرداند. |
شناور | getMinZoomLevel () حداقل سطح بزرگنمایی را برمیگرداند. |
محل | getMyLocation () این روش منسوخ شده است. به جای آن از com.google.android.gms.location.FusedLocationProviderApi استفاده کنید. FusedLocationProviderApi مکان یابی و مصرف انرژی را بهبود می بخشد و توسط نقطه آبی "My Location" استفاده می شود. به MyLocationDemoActivity در پوشه نمونه برنامهها برای مثال کد یا راهنمای برنامهنویس مکان مراجعه کنید. |
فرافکنی | getProjection () یک شی Projection را برمیگرداند که میتوانید از آن برای تبدیل بین مختصات صفحه و مختصات طول و عرض جغرافیایی استفاده کنید. |
UiSettings | getUiSettings () تنظیمات رابط کاربری نقشه را دریافت می کند. |
بولی | isBuildingsEnabled () نشان می دهد که آیا لایه ساختمان های سه بعدی فعال است یا خیر. |
بولی | isIndoorEnabled () دریافت می کند که آیا نقشه های داخلی در حال حاضر فعال هستند یا خیر. |
بولی | isMyLocationEnabled () وضعیت لایه my-location را دریافت می کند. |
بولی | isTrafficEnabled () بررسی می کند که آیا نقشه داده های ترافیک را ترسیم می کند یا خیر. |
خالی | moveCamera (به روز رسانی CameraUpdate ) دوربین را مطابق دستورالعمل های تعریف شده در به روز رسانی تغییر مکان می دهد. |
خالی | resetMinMaxZoomPreference () هر گونه محدوده زوم بالا و پایین مشخص شده قبلی را حذف می کند. |
خالی | setBuildingsEnabled (بولی فعال) لایه ساختمان های سه بعدی را روشن یا خاموش می کند. |
خالی | setContentDescription (شرح رشته) یک ContentDescription برای نقشه تنظیم می کند. |
بولی | setIndoorEnabled (بولی فعال) تنظیم میکند که آیا نقشههای داخلی باید فعال شوند یا خیر. |
خالی | setInfoWindowAdapter (آداپتور GoogleMap.InfoWindowAdapter ) یک رندر سفارشی برای محتویات پنجره های اطلاعات تنظیم می کند. |
خالی | setLatLngBoundsForCameraTarget ( حدود LatLngBounds ) یک LatLngBounds را برای محدود کردن هدف دوربین مشخص می کند، به طوری که وقتی کاربران نقشه را اسکرول و حرکت می دهند، هدف دوربین خارج از این محدوده حرکت نکند. |
خالی | |
بولی | |
خالی | setMapType (نوع int) نوع کاشی های نقشه را که باید نمایش داده شوند را تعیین می کند. |
خالی | setMaxZoomPreference (float maxZoomPreference) یک کران بالای ترجیحی برای بزرگنمایی دوربین تنظیم می کند. |
خالی | setMinZoomPreference (float minZoomPreference) یک کران پایین ترجیحی برای بزرگنمایی دوربین تنظیم می کند. |
خالی | setMyLocationEnabled (بولی فعال) لایه my-location را فعال یا غیرفعال می کند. |
خالی | |
خالی | setOnCameraIdleListener (شنونده GoogleMap.OnCameraIdleListener ) تماس برگشتی را تنظیم می کند که با پایان حرکت دوربین فراخوانی می شود. |
خالی | setOnCameraMoveCanceledListener (شنونده GoogleMap.OnCameraMoveCanceledListener ) تماس برگشتی را تنظیم می کند که هنگامی که حرکت دوربین توسط نوع جدیدی از انیمیشن متوقف یا قطع می شود، فراخوانی می شود. |
خالی | setOnCameraMoveListener (شنونده GoogleMap.OnCameraMoveListener ) تماس برگشتی را تنظیم می کند که در حین حرکت دوربین به طور مکرر فراخوانی شود. |
خالی | setOnCameraMoveStartedListener (شنونده GoogleMap.OnCameraMoveStartedListener ) تماسی را تنظیم می کند که وقتی دوربین شروع به حرکت می کند یا دلیل حرکت دوربین تغییر کرده است، فراخوانی می شود. |
خالی | setOnCircleClickListener (شنونده GoogleMap.OnCircleClickListener ) پاسخ تماسی را تنظیم می کند که با کلیک روی یک دایره فراخوانی می شود. |
خالی | setOnGroundOverlayClickListener (شنونده GoogleMap.OnGroundOverlayClickListener ) تماس برگشتی را تنظیم میکند که با کلیک روی همپوشانی زمین فراخوانی میشود. |
خالی | setOnIndoorStateChangeListener (شنونده GoogleMap.OnIndoorStateChangeListener ) شنونده را برای رویدادهای داخلی تنظیم یا پاک می کند. |
خالی | setOnInfoWindowClickListener (شنونده GoogleMap.OnInfoWindowClickListener ) پاسخ تماسی را تنظیم می کند که با کلیک روی پنجره اطلاعات نشانگر فراخوانی می شود. |
خالی | setOnInfoWindowCloseListener (شنونده GoogleMap.OnInfoWindowCloseListener ) پاسخ تماسی را تنظیم می کند که هنگام بسته شدن پنجره اطلاعات نشانگر فراخوانی می شود. |
خالی | setOnInfoWindowLongClickListener (شنونده GoogleMap.OnInfoWindowLongClickListener ) پاسخ تماسی را تنظیم میکند که وقتی پنجره اطلاعات نشانگر فشار داده میشود، فراخوانی میشود. |
خالی | setOnMapClickListener (شنونده GoogleMap.OnMapClickListener ) تماس برگشتی را تنظیم می کند که هنگام ضربه زدن به نقشه فراخوانی می شود. |
خالی | setOnMapLoadedCallback ( GoogleMap.OnMapLoadedCallback ) تماس برگشتی را تنظیم میکند که پس از اتمام رندر این نقشه فراخوانی میشود. |
خالی | setOnMapLongClickListener (شنونده GoogleMap.OnMapLongClickListener ) تماس برگشتی را تنظیم میکند که وقتی نقشه طولانی فشار داده میشود، فراخوانی میشود. |
خالی | setOnMarkerClickListener (شنونده GoogleMap.OnMarkerClickListener ) پاسخ تماسی را تنظیم می کند که با کلیک روی نشانگر فراخوانی می شود. |
خالی | setOnMarkerDragListener (شنونده GoogleMap.OnMarkerDragListener ) تماس برگشتی را تنظیم می کند که هنگام کشیدن نشانگر فراخوانی می شود. |
خالی | setOnMyLocationButtonClickListener (شنونده GoogleMap.OnMyLocationButtonClickListener ) پاسخ تماسی را تنظیم می کند که با کلیک روی دکمه موقعیت مکانی من فراخوانی می شود. |
خالی | setOnMyLocationChangeListener (شنونده GoogleMap.OnMyLocationChangeListener ) این روش منسوخ شده است. به جای آن از com.google.android.gms.location.FusedLocationProviderApi استفاده کنید. FusedLocationProviderApi مکان یابی و مصرف انرژی را بهبود می بخشد و توسط نقطه آبی "My Location" استفاده می شود. به MyLocationDemoActivity در پوشه نمونه برنامهها برای مثال کد یا راهنمای برنامهنویس مکان مراجعه کنید. |
خالی | setOnMyLocationClickListener (شنونده GoogleMap.OnMyLocationClickListener ) پاسخ تماسی را تنظیم می کند که با کلیک روی نقطه My Location (که نشان دهنده مکان کاربر است) فراخوانی می شود. |
خالی | setOnPoiClickListener (شنونده GoogleMap.OnPoiClickListener ) شنونده ای را تنظیم می کند که با کلیک یا ضربه زدن روی یک POI فعال شود. |
خالی | setOnPolygonClickListener (شنونده GoogleMap.OnPolygonClickListener ) یک تماس برگشتی را تنظیم می کند که با کلیک روی چند ضلعی فراخوانی می شود. |
خالی | setOnPolylineClickListener (شنونده GoogleMap.OnPolylineClickListener ) یک تماس برگشتی را تنظیم می کند که با کلیک روی چند خط فراخوانی می شود. |
خالی | setPadding (int چپ، int بالا، int سمت راست، int پایین) بالشتک را روی نقشه تنظیم می کند. |
خالی | setTrafficEnabled (بولی فعال) لایه ترافیک را روشن یا خاموش می کند. |
خالی | |
خالی | |
خالی | توقف انیمیشن () اگر انیمیشن دوربین در حال انجام باشد، انیمیشن دوربین را متوقف می کند. |
خلاصه روش ارثی
ثابت ها
عمومی استاتیک نهایی int MAP_TYPE_HYBRID
نقشه های ماهواره ای با یک لایه شفاف از خیابان های اصلی.
عمومی استاتیک نهایی int MAP_TYPE_NONE
بدون کاشی نقشه پایه.
MAP_TYPE_NORMAL نهایی استاتیک عمومی
نقشه های اساسی
عمومی استاتیک نهایی int MAP_TYPE_SATELLITE
نقشه های ماهواره ای بدون برچسب
نهایی استاتیک عمومی MAP_TYPE_TERRAIN
نقشه های زمین
روش های عمومی
دایره عمومی addCircle (گزینه های CircleOptions )
یک دایره به این نقشه اضافه کنید.
مولفه های
گزینه ها | یک شی گزینه دایره که نحوه رندر کردن دایره را تعریف می کند |
---|
برمی گرداند
- شی
Circle
که به نقشه اضافه می شود
عمومی GroundOverlay addGroundOverlay (گزینه های GroundOverlayOptions )
یک تصویر به این نقشه اضافه می کند.
مولفه های
گزینه ها | یک شی گزینه های همپوشانی زمین که نحوه رندر همپوشانی را تعریف می کند. گزینه ها باید دارای یک تصویر (AnchoredBitmap) و موقعیت مشخص شده باشند. |
---|
برمی گرداند
-
GroundOverlay
که به نقشه اضافه شد.
پرتاب می کند
IllegalArgumentException | اگر تصویر یا موقعیت در گزینه ها مشخص نشده باشد. |
---|
نشانگر عمومی addMarker (گزینه های MarkerOptions )
یک نشانگر به این نقشه اضافه می کند.
نماد نشانگر روی نقشه در موقعیت Marker.position نشان داده می شود. با کلیک بر روی نشانگر، دوربین روی نشانگر وسط قرار می گیرد. اگر Marker.title تعریف شده باشد، نقشه یک جعبه اطلاعات با عنوان و قطعه نشانگر را نشان می دهد. اگر نشانگر قابل کشیدن باشد، با کلیک طولانی و سپس کشیدن نشانگر، آن را جابه جا می کنیم.
مولفه های
گزینه ها | یک شیء گزینه های نشانگر که نحوه ارائه نشانگر را تعریف می کند. |
---|
برمی گرداند
-
Marker
که به نقشه اضافه شد.
چند ضلعی عمومی addPolygon (گزینه های PolygonOptions )
یک چند ضلعی به این نقشه اضافه می کند.
مولفه های
گزینه ها | یک شی گزینه چند ضلعی که نحوه نمایش چند ضلعی را تعریف می کند. |
---|
برمی گرداند
- شی
Polygon
که به نقشه اضافه می شود.
عمومی Polyline addPolyline (گزینه های PolylineOptions )
یک چند خط به این نقشه اضافه می کند.
مولفه های
گزینه ها | یک شی گزینه چند خطی که نحوه رندر کردن Polyline را تعریف می کند. |
---|
برمی گرداند
- شی
Polyline
که به نقشه اضافه شد.
عمومی TileOverlay addTileOverlay (گزینه های TileOverlayOptions )
یک پوشش کاشی به این نقشه اضافه می کند. برای اطلاعات بیشتر به TileOverlay
مراجعه کنید.
توجه داشته باشید که بر خلاف سایر همپوشانی ها، اگر نقشه دوباره ایجاد شود، پوشش های کاشی به طور خودکار بازیابی نمی شوند و باید دوباره به صورت دستی اضافه شوند.
مولفه های
گزینه ها | یک شی گزینه tile-overlay که نحوه رندر همپوشانی را تعریف می کند. گزینه ها باید یک TileProvider مشخص داشته باشند، در غیر این صورت یک IllegalArgumentException پرتاب می شود. |
---|
برمی گرداند
-
TileOverlay
که به نقشه اضافه شد.
پرتاب می کند
IllegalArgumentException | اگر TileProvider در گزینه ها مشخص نشده باشد. |
---|
public void animateCamera (به روز رسانی CameraUpdate )
حرکت دوربین را از موقعیت فعلی به موقعیت تعریف شده در به روز رسانی متحرک می کند. در طول انیمیشن، تماسی با getCameraPosition()
یک مکان میانی از دوربین را برمیگرداند.
برای مجموعه ای از به روز رسانی ها CameraUpdateFactory
را ببینید.
مولفه های
به روز رسانی | تغییری که باید روی دوربین اعمال شود. |
---|
عمومی void animateCamera (به روز رسانی CameraUpdate ، GoogleMap.Cancelable Callback callback)
حرکت دوربین را از موقعیت فعلی به موقعیتی که در به روز رسانی تعریف شده است متحرک می کند و پس از اتمام یک تماس اختیاری را فراخوانی می کند. برای مجموعه ای از به روز رسانی ها CameraUpdateFactory
را ببینید.
در طول انیمیشن، تماسی با getCameraPosition()
یک مکان میانی از دوربین را برمیگرداند.
مولفه های
به روز رسانی | تغییری که باید روی دوربین اعمال شود. |
---|---|
پاسخ به تماس | تماس برگشتی برای فراخوانی از رشته رابط کاربری Android هنگامی که انیمیشن متوقف می شود. اگر انیمیشن به طور معمول کامل شود، onFinish() فراخوانی می شود. در غیر این صورت، onCancel() فراخوانی می شود. دوربین را از داخل onCancel() آپدیت یا متحرک نکنید. |
عمومی void animateCamera (به روز رسانی CameraUpdate ، int durationMs، GoogleMap.Cancelable Callback callback)
نقشه را مطابق به روز رسانی با یک انیمیشن در مدت زمان مشخصی حرکت می دهد و پس از تکمیل، یک تماس اختیاری را فراخوانی می کند. برای مجموعه ای از به روز رسانی ها CameraUpdateFactory
را ببینید.
اگر getCameraPosition()
در طول انیمیشن فراخوانی شود، مکان فعلی دوربین در پرواز را برمیگرداند.
مولفه های
به روز رسانی | |
---|---|
مدت زمان خانم | مدت زمان انیمیشن بر حسب میلی ثانیه این باید کاملاً مثبت باشد، در غیر این صورت یک IllegalArgumentException پرتاب خواهد شد. |
پاسخ به تماس | یک تماس اختیاری برای اطلاع از رشته رابط کاربری Android هنگامی که انیمیشن متوقف می شود. اگر انیمیشن به دلیل تکمیل طبیعی آن متوقف شود، پاسخ تماس با onFinish() اطلاع داده می شود. اگر انیمیشن به دلیل وقفه توسط حرکت بعدی دوربین یا حرکت کاربر متوقف شود، onCancel() فراخوانی می شود. تماس برگشتی نباید سعی کند دوربین را در روش لغو آن حرکت دهد یا متحرک کند. اگر نیازی به تماس مجدد نیست، آن را null بگذارید. |
خلأ عمومی روشن ()
تمام نشانگرها، چند خطوط، چند ضلعی ها، همپوشانی ها و غیره را از نقشه حذف می کند.
عمومی CameraPosition getCameraPosition ()
موقعیت فعلی دوربین را دریافت می کند.
CameraPosition
برگردانده شده یک عکس فوری از موقعیت فعلی است و هنگامی که دوربین حرکت می کند به طور خودکار به روز نمی شود.
برای اطلاعات بیشتر در مورد تغییر موقعیت دوربین، به دوربین و مشاهده مراجعه کنید.
برمی گرداند
- موقعیت فعلی دوربین
عمومی IndoorBuilding getFocusedBuilding ()
ساختمان متمرکز فعلی را دریافت می کند.
برمی گرداند
- ساختمان متمرکز فعلی یا اگر هیچ ساختمانی متمرکز نشده باشد،
null
است.
عمومی int getMapType ()
نوع نقشه ای را که در حال حاضر نمایش داده می شود دریافت می کند. برای مقادیر احتمالی به MAP_TYPE_NORMAL
، MAP_TYPE_SATELLITE
، MAP_TYPE_TERRAIN
مراجعه کنید.
برمی گرداند
- نوع نقشه
شناور عمومی getMaxZoomLevel ()
حداکثر سطح زوم را برای موقعیت فعلی دوربین برمیگرداند. این امر نوع نقشه ای را که در حال حاضر استفاده می شود، در نظر می گیرد، به عنوان مثال، ماهواره یا زمین ممکن است سطح زوم حداکثر کمتری نسبت به کاشی های نقشه پایه داشته باشد.
برای اطلاعات بیشتر در مورد تغییر سطح زوم دوربین، به دوربین و مشاهده مراجعه کنید.
برمی گرداند
- حداکثر سطح زوم موجود در موقعیت فعلی دوربین.
شناور عمومی getMinZoomLevel ()
حداقل سطح بزرگنمایی را برمیگرداند. این برای هر مکان یکسان است (برخلاف حداکثر سطح زوم) اما ممکن است بین دستگاه ها و اندازه نقشه متفاوت باشد.
برای اطلاعات بیشتر در مورد تغییر سطح زوم دوربین، به دوربین و مشاهده مراجعه کنید.
برمی گرداند
- حداقل سطح بزرگنمایی موجود.
مکان عمومی getMyLocation ()
این روش منسوخ شده است.
به جای آن از com.google.android.gms.location.FusedLocationProviderApi استفاده کنید. FusedLocationProviderApi مکان یابی و مصرف انرژی را بهبود می بخشد و توسط نقطه آبی "My Location" استفاده می شود. به MyLocationDemoActivity در پوشه نمونه برنامهها برای مثال کد یا راهنمای برنامهنویس مکان مراجعه کنید.
مکان نمایش داده شده کاربر در حال حاضر را برمیگرداند یا اگر دادههای موقعیت مکانی موجود نباشد، null
است.
برمی گرداند
-
user location
در حال حاضر نمایش داده شده است.
پرتاب می کند
IllegalStateException | اگر لایه my-location فعال نباشد. |
---|
طرح عمومی getProjection ()
یک شی Projection
را برمیگرداند که میتوانید از آن برای تبدیل بین مختصات صفحه و مختصات طول و عرض جغرافیایی استفاده کنید.
Projection
بازگشتی یک عکس فوری از طرح ریزی فعلی است و با حرکت دوربین به طور خودکار به روز نمی شود. از آنجایی که این عملیات گران است، شما باید فقط یک بار در هر صفحه نمایش را دریافت کنید. Google Maps از طرح Mercator برای ایجاد نقشه های خود از داده های جغرافیایی و تبدیل نقاط روی نقشه به مختصات جغرافیایی استفاده می کند.
برمی گرداند
-
Projection
نقشه در وضعیت فعلی.
UiSettings عمومی getUiSettings ()
تنظیمات رابط کاربری نقشه را دریافت می کند.
برمی گرداند
-
UiSettings
برای این نقشه.
عمومی boolean isBuildingsEnabled ()
نشان می دهد که آیا لایه ساختمان های سه بعدی فعال است یا خیر.
برمی گرداند
-
true
اگر ساختمان ها فعال باشند.false
در غیر این صورت
بولین عمومی isIndoorEnabled ()
دریافت می کند که آیا نقشه های داخلی در حال حاضر فعال هستند یا خیر.
برمی گرداند
-
true
اگر نقشه های داخلی فعال باشند. اگر نقشههای داخلی غیرفعال باشد،false
است.
بولین عمومی isMyLocationEnabled ()
وضعیت لایه my-location را دریافت می کند.
برمی گرداند
-
true
اگر لایه my-location فعال باشد.false
در غیر این صورت
بولین عمومی isTrafficEnabled ()
بررسی می کند که آیا نقشه داده های ترافیک را ترسیم می کند یا خیر. این منوط به در دسترس بودن داده های ترافیکی است.
برمی گرداند
-
true
اگر داده های ترافیک فعال باشد.false
در غیر این صورت
public void moveCamera (به روز رسانی CameraUpdate )
دوربین را مطابق دستورالعمل های تعریف شده در به روز رسانی تغییر مکان می دهد. حرکت آنی است، و getCameraPosition()
بعدی موقعیت جدید را منعکس می کند. برای مجموعه ای از به روز رسانی ها CameraUpdateFactory
را ببینید.
مولفه های
به روز رسانی | تغییری که باید روی دوربین اعمال شود. |
---|
تنظیم مجدد خلأ عمومی MinMaxZoomPreference ()
هر گونه محدوده زوم بالا و پایین مشخص شده قبلی را حذف می کند.
public void setBuildingsEnabled (بولی فعال)
لایه ساختمان های سه بعدی را روشن یا خاموش می کند.
مولفه های
فعال شد | true برای فعال کردن لایه ساختمان های سه بعدی. false برای غیرفعال کردن ساختمان های سه بعدی |
---|
عمومی void setContentDescription (توضیح رشته)
یک ContentDescription برای نقشه تنظیم می کند.
این برای ارائه توضیحات گفتاری از نقشه در حالت دسترسی استفاده می شود. مقدار پیش فرض "Google Map" است
مولفه های
شرح | یک رشته برای استفاده به عنوان توضیحات |
---|
بولین عمومی setIndoorEnabled (بولی فعال)
تنظیم میکند که آیا نقشههای داخلی باید فعال شوند یا خیر. در حال حاضر، نقشههای داخلی را میتوان هر بار تنها بر روی یک نقشه نشان داد و بهطور پیشفرض، این اولین نقشهای است که به برنامه شما اضافه میشود. برای فعال کردن نقشههای داخلی روی نقشه دیگر، ابتدا باید نقشههای داخلی را روی نقشه اصلی غیرفعال کنید. اگر سعی کنید نقشههای داخلی را در زمانی که روی نقشه دیگری فعال است فعال کنید، هیچ اتفاقی نمیافتد و false
. وقتی Indoor برای نقشه فعال نباشد، تمام روشهای مربوط به indoor null
یا false
.
مولفه های
فعال شد | true که سعی کنید نقشه های داخلی را فعال کنید. false برای غیرفعال کردن نقشه های داخلی |
---|
برمی گرداند
- آیا امکان فعال کردن نقشه های داخلی وجود دارد یا خیر.
public void setInfoWindowAdapter (آداپتور GoogleMap.InfoWindowAdapter )
یک رندر سفارشی برای محتویات پنجره های اطلاعات تنظیم می کند.
مانند شنوندگان رویداد نقشه، این حالت با نقشه سریالی نیست. اگر نقشه دوباره ایجاد شد (مثلاً به دلیل تغییر پیکربندی)، باید اطمینان حاصل کنید که برای حفظ سفارشیسازی دوباره این روش را فراخوانی میکنید.
مولفه های
آداپتور | آداپتوری که برای محتویات پنجره اطلاعات استفاده میشود، یا برای استفاده از نمایش محتوای پیشفرض در پنجرههای اطلاعات، null است. |
---|
public void setLatLngBoundsForCameraTarget ( حدود LatLngBounds )
یک LatLngBounds را برای محدود کردن هدف دوربین مشخص می کند، به طوری که وقتی کاربران نقشه را اسکرول و حرکت می دهند، هدف دوربین خارج از این محدوده حرکت نکند.
برای پاک کردن کامل کادر محدود کننده را روی null قرار دهید. کران های جدید جایگزین هر جعبه مرزی مشخص شده قبلی می شود.
وقتی LatLngBounds تغییر میکند، SDK همه بهروزرسانیهای بعدی دوربین را تنظیم میکند تا در صورت امکان به آن محدودیتها احترام بگذارد. توجه داشته باشید که ملاحظات فنی وجود دارد که ممکن است SDK را از نگه داشتن هدف دوربین کاملاً در محدوده جلوگیری کند. به عنوان مثال، خطاهای گرد کردن دقیق نقطه شناور یا سطح زوم بسیار پایین.
مولفه های
محدوده | محدودیت هایی که هدف دوربین را در داخل محدود می کند. |
---|
public void setLocationSource (منبع LocationSource )
منبع مکان لایه my-location را جایگزین می کند.
مولفه های
منبع | منبع مکان برای استفاده در لایه my-location. برای استفاده از منبع موقعیت مکانی پیش فرض، روی null تنظیم کنید. |
---|
setMapStyle بولی عمومی (سبک MapStyleOptions )
استایل نقشه پایه را تنظیم می کند.
با استفاده از گزینه های سبک، می توانید سبک های سفارشی را برای ویژگی ها و عناصر روی نقشه اعمال کنید. برای جزئیات تعریف سبک به MapStyleOptions
مراجعه کنید.
برای پاک کردن استایل سفارشی قبلی، روی null تنظیم کنید.
مولفه های
سبک |
---|
برمی گرداند
-
true
اگر سبک با موفقیت تجزیه شود. اگر مشکلاتی باfalse
تشخیص داده شد، از جمله، به عنوان مثال، JSON استایل غیرقابل تجزیه، نوع ویژگی ناشناخته، نوع عنصر ناشناخته، یا کلیدهایMapStyleOptions
نامعتبر، نادرست است. اگر مقدار بازگشتیfalse
، سبک فعلی بدون تغییر باقی میماند.
public void setMapType (نوع int)
نوع کاشی های نقشه را که باید نمایش داده شوند را تعیین می کند. مقادیر مجاز عبارتند از:
-
MAP_TYPE_NORMAL
: نقشه اصلی. -
MAP_TYPE_SATELLITE
: تصاویر ماهواره ای. -
MAP_TYPE_HYBRID
: تصاویر ماهواره ای با جاده ها و برچسب ها. -
MAP_TYPE_TERRAIN
: داده های توپوگرافی. -
MAP_TYPE_NONE
: هیچ کاشی نقشه پایه وجود ندارد.
مولفه های
نوع | نوع نقشه برای نمایش |
---|
setMaxZoomPreference public void (float maxZoomPreference)
یک کران بالای ترجیحی برای بزرگنمایی دوربین تنظیم می کند.
وقتی حداکثر زوم تغییر می کند، SDK همه به روز رسانی های بعدی دوربین را تنظیم می کند تا در صورت امکان به حداکثر آن احترام بگذارد. توجه داشته باشید که ملاحظات فنی وجود دارد که ممکن است مانع از این شود که SDK به کاربران اجازه بزرگنمایی بیش از حد عمیق در نقشه را بدهد. برای مثال، ماهواره یا زمین ممکن است حداکثر زوم کمتری نسبت به کاشی های نقشه پایه داشته باشد.
SDK هرگونه تضاد در مقادیر حداقل و حداکثر را حل می کند. اگر حداقل زوم را روی سطح بزرگنمایی بالاتر از حداکثر فعلی تنظیم کنید، SDK از مقدار حداقل جدید برای حداقل و حداکثر استفاده می کند. اگر حداکثر بزرگنمایی را روی سطح بزرگنمایی کمتر از حداقل تنظیم کنید، SDK از مقدار حداکثر جدید برای حداقل و حداکثر استفاده می کند. به عنوان مثال: فرض کنید حداقل زوم فعلی 8 و حداکثر 14 است. سپس حداکثر بزرگنمایی را روی 6 تنظیم می کنید. SDK از حداقل بزرگنمایی 6 و حداکثر بزرگنمایی 6 استفاده می کند.
مولفه های
maxZoomPreference | کران بالای ترجیحی |
---|
setMinZoomPreference خالی عمومی (float minZoomPreference)
یک کران پایین ترجیحی برای بزرگنمایی دوربین تنظیم می کند.
هنگامی که حداقل زوم تغییر می کند، SDK همه به روز رسانی های بعدی دوربین را تنظیم می کند تا در صورت امکان به آن حداقل احترام بگذارد. توجه داشته باشید که ملاحظات فنی وجود دارد که ممکن است از SDK جلوگیری کند که به کاربران اجازه بزرگنمایی بسیار کم را بدهد.
SDK هرگونه تضاد در مقادیر حداقل و حداکثر را حل می کند. اگر حداقل زوم را روی سطح بزرگنمایی بالاتر از حداکثر فعلی تنظیم کنید، SDK از مقدار حداقل جدید برای حداقل و حداکثر استفاده می کند. اگر حداکثر بزرگنمایی را روی سطح بزرگنمایی کمتر از حداقل تنظیم کنید، SDK از مقدار حداکثر جدید برای حداقل و حداکثر استفاده می کند. به عنوان مثال: فرض کنید حداقل زوم فعلی 8 و حداکثر 14 باشد. سپس حداقل زوم را روی 16 تنظیم کنید. SDK از حداقل بزرگنمایی 16 و حداکثر بزرگنمایی 16 استفاده می کند.
مولفه های
minZoomPreference | کران تحتانی ترجیحی |
---|
public void setMyLocationEnabled (بولی فعال)
لایه my-location را فعال یا غیرفعال می کند.
در حالی که فعال است و مکان در دسترس است، لایه my-location به طور مداوم نشانی از موقعیت مکانی و یاتاقان فعلی کاربر را ترسیم می کند و کنترل های رابط کاربری را نشان می دهد که به کاربر اجازه می دهد با موقعیت مکانی خود تعامل داشته باشد (به عنوان مثال، برای فعال یا غیرفعال کردن ردیابی دوربین خود. محل و تحمل).
برای استفاده از ویژگی my-location-layer باید برای ACCESS_COARSE_LOCATION
یا ACCESS_FINE_LOCATION
مجوز درخواست کنید، مگر اینکه یک منبع مکان سفارشی تنظیم کرده باشید.
اگر منبع موقعیت مکانی سفارشی را از طریق setLocationSource(LocationSource)
تنظیم کرده باشید، Google Maps SDK برای Android بررسی نمیکند که آیا مجوزهای فوق اعطا شده است یا خیر. با این حال، هنوز باید مطمئن شوید که کاربر تمام مجوزهای مورد نیاز برای منبع موقعیت مکانی سفارشی شما را اعطا کرده است.
مولفه های
فعال شد | true برای فعال کردن false برای غیرفعال کردن |
---|
پرتاب می کند
Security Exception | اگر مجوز مکان اعطا نشود. |
---|
مجموعه خالی عمومی OnCameraChangeListener (شنونده GoogleMap.OnCameraChangeListener )
این روش منسوخ شده است.
جایگزین شده توسط setOnCameraMoveStartedListener(GoogleMap.OnCameraMoveStartedListener)
، setOnCameraMoveListener(GoogleMap.OnCameraMoveListener)
، setOnCameraMoveCanceledListener(GoogleMap.OnCameraMoveCanceledListener)
setOnCameraIdleListener(GoogleMap.OnCameraIdleListener)
.
تماس برگشتی را تنظیم می کند که هنگام تغییر دوربین فراخوانی می شود.
مولفه های
شنونده | تماس برگشتی که هنگام تغییر دوربین فراخوانی می شود. برای لغو تنظیم تماس، از null استفاده کنید. |
---|
public void setOnCameraIdleListener (شنونده GoogleMap.OnCameraIdleListener )
تماس برگشتی را تنظیم می کند که با پایان حرکت دوربین فراخوانی می شود.
مولفه های
شنونده | پاسخ تماسی که فراخوانی شده است. برای لغو تنظیم تماس، از null استفاده کنید. |
---|
مجموعه خالی عمومی OnCameraMoveCanceledListener (شنونده GoogleMap.OnCameraMoveCanceledListener )
تماس برگشتی را تنظیم می کند که هنگامی که حرکت دوربین توسط نوع جدیدی از انیمیشن متوقف یا قطع می شود، فراخوانی می شود.
مولفه های
شنونده | پاسخ تماسی که فراخوانی شده است. برای لغو تنظیم تماس، از null استفاده کنید. دوربین را از داخل onCameraMoveCanceled() بهروزرسانی یا متحرک نکنید. |
---|
public void setOnCameraMoveListener (شنونده GoogleMap.OnCameraMoveListener )
تماس برگشتی را تنظیم می کند که در حین حرکت دوربین به طور مکرر فراخوانی شود. تماس برگشتی ممکن است به اندازه یک بار در هر فریم فراخوانی شود و نباید عملیات گران قیمت را انجام دهد.
مولفه های
شنونده | پاسخ تماسی که فراخوانی شده است. برای لغو تنظیم تماس، از null استفاده کنید. |
---|
مجموعه خالی عمومی OnCameraMoveStartedListener (شنونده GoogleMap.OnCameraMoveStartedListener )
تماسی را تنظیم می کند که وقتی دوربین شروع به حرکت می کند یا دلیل حرکت دوربین تغییر کرده است، فراخوانی می شود.
مولفه های
شنونده | پاسخ تماسی که فراخوانی شده است. برای لغو تنظیم تماس، از null استفاده کنید. دوربین را از داخل onCameraMoveStarted() آپدیت یا متحرک نکنید. |
---|
public void setOnCircleClickListener (شنونده GoogleMap.OnCircleClickListener )
پاسخ تماسی را تنظیم می کند که با کلیک روی یک دایره فراخوانی می شود.
مولفه های
شنونده | پاسخ تماسی که با کلیک روی یک دایره فراخوانی می شود. برای لغو تنظیم تماس، از null استفاده کنید. |
---|
set void عمومی OnGroundOverlayClickListener ( GoogleMap.OnGroundOverlayClickListener )
تماس برگشتی را تنظیم میکند که با کلیک روی همپوشانی زمین فراخوانی میشود.
مولفه های
شنونده | تماس برگشتی که هنگام کلیک روی همپوشانی زمین فراخوانی می شود. برای لغو تنظیم تماس، از null استفاده کنید. |
---|
مجموعه خالی عمومی OnIndoorStateChangeListener (شنونده GoogleMap.OnIndoorStateChangeListener )
شنونده را برای رویدادهای داخلی تنظیم یا پاک می کند. فقط یک شنونده را می توان تنظیم کرد. با تنظیم یک شنونده جدید، شنونده قبلی حذف می شود.
مولفه های
شنونده | شنونده برای رویدادهای داخل ساختمان اگر تهی نباشد. در غیر این صورت، شنونده را پاک می کند |
---|
public void setOnInfoWindowClickListener ( GoogleMap.OnInfoWindowClickListener )
پاسخ تماسی را تنظیم می کند که با کلیک روی پنجره اطلاعات نشانگر فراخوانی می شود.
مولفه های
شنونده | پاسخ تماسی که با کلیک روی پنجره اطلاعات نشانگر فراخوانی می شود. برای لغو تنظیم تماس، از null استفاده کنید. |
---|
public void setOnInfoWindowCloseListener (شنونده GoogleMap.OnInfoWindowCloseListener )
پاسخ تماسی را تنظیم می کند که هنگام بسته شدن پنجره اطلاعات نشانگر فراخوانی می شود.
مولفه های
شنونده | پاسخ تماسی که هنگام بسته شدن پنجره اطلاعات نشانگر فراخوانی می شود. برای لغو تنظیم تماس، از null استفاده کنید. |
---|
مجموعه خالی عمومی OnInfoWindowLongClickListener (شنونده GoogleMap.OnInfoWindowLongClickListener )
پاسخ تماسی را تنظیم میکند که وقتی پنجره اطلاعات نشانگر فشار داده میشود، فراخوانی میشود.
مولفه های
شنونده | پاسخ تماسی که هنگام فشار دادن طولانی پنجره اطلاعات نشانگر فراخوانی می شود. برای لغو تنظیم تماس، از null استفاده کنید. |
---|
public void setOnMapClickListener (شنونده GoogleMap.OnMapClickListener )
تماس برگشتی را تنظیم می کند که هنگام ضربه زدن به نقشه فراخوانی می شود.
مولفه های
شنونده | تماس برگشتی که هنگام ضربه زدن به نقشه فراخوانی می شود. برای لغو تنظیم تماس، از null استفاده کنید. |
---|
مجموعه خالی عمومی OnMapLoadedCallback ( GoogleMap.OnMapLoadedCallback )
تماس برگشتی را تنظیم میکند که پس از اتمام رندر این نقشه فراخوانی میشود. تماس پاسخ تنها یک بار فراخوانی می شود.
اگر این روش زمانی فراخوانی شود که نقشه به طور کامل رندر شده است، پاسخ تماس بلافاصله فراخوانی می شود. اگر نقشه به دلیل مشکلات اتصال هرگز بارگیری نشود، یا اگر نقشه به طور مداوم در حال تغییر باشد و به دلیل تعامل دائم کاربر با نقشه، هرگز بارگیری کامل نشود، این رویداد فعال نمی شود.
مولفه های
پاسخ به تماس | پس از اتمام رندر نقشه، تماس برگشتی فراخوانی می شود. برای لغو تنظیم تماس، از null استفاده کنید. |
---|
public void setOnMapLongClickListener (شنونده GoogleMap.OnMapLongClickListener )
تماس برگشتی را تنظیم میکند که وقتی نقشه طولانی فشار داده میشود، فراخوانی میشود.
مولفه های
شنونده | تماس برگشتی که هنگام فشار دادن طولانی نقشه فراخوانی می شود. برای لغو تنظیم تماس، از null استفاده کنید. |
---|
public void setOnMarkerClickListener (شنونده GoogleMap.OnMarkerClickListener )
پاسخ تماسی را تنظیم می کند که با کلیک روی نشانگر فراخوانی می شود.
مولفه های
شنونده | پاسخ تماسی که با کلیک روی نشانگر فراخوانی می شود. برای لغو تنظیم تماس، از null استفاده کنید. |
---|
set public void setOnMarkerDragListener ( GoogleMap.OnMarkerDragListener شنونده)
تماس برگشتی را تنظیم می کند که هنگام کشیدن نشانگر فراخوانی می شود.
مولفه های
شنونده | تماس برگشتی که در رویدادهای کشیدن نشانگر فراخوانی می شود. برای لغو تنظیم تماس، از null استفاده کنید. |
---|
setOnMyLocationButtonClickListener عمومی void ( GoogleMap.OnMyLocationButtonClickListener )
پاسخ تماسی را تنظیم می کند که با کلیک روی دکمه موقعیت مکانی من فراخوانی می شود.
If the listener
returns true
, the event is consumed and the default behavior will not occur. If it returns false
, the default behavior will occur (ie The camera moves such that it is centered on the user's location).
مولفه های
listener | The callback that's invoked when the My Location button is clicked. |
---|
public void setOnMyLocationChangeListener ( GoogleMap.OnMyLocationChangeListener listener)
This method is deprecated.
use com.google.android.gms.location.FusedLocationProviderApi instead. FusedLocationProviderApi provides improved location finding and power usage and is used by the "My Location" blue dot. See the MyLocationDemoActivity in the sample applications folder for example code, or the Location Developer Guide .
Sets a callback that's invoked when the My Location dot changes location.
مولفه های
listener | The callback that's invoked when the My Location dot changes. |
---|
public void setOnMyLocationClickListener ( GoogleMap.OnMyLocationClickListener listener)
Sets a callback that's invoked when the My Location dot (which signifies the user's location) is clicked.
مولفه های
listener | The callback that's invoked when the My Location dot is clicked. |
---|
public void setOnPoiClickListener ( GoogleMap.OnPoiClickListener listener)
Sets a listener which will be triggered when a POI is clicked or tapped.
Pass null
to clear the listener.
مولفه های
listener |
---|
public void setOnPolygonClickListener ( GoogleMap.OnPolygonClickListener listener)
Sets a callback that's invoked when a polygon is clicked.
مولفه های
listener | The callback that's invoked when a polygon is clicked. To unset the callback, use null . |
---|
public void setOnPolylineClickListener ( GoogleMap.OnPolylineClickListener listener)
Sets a callback that's invoked when a polyline is clicked.
مولفه های
listener | The callback that's invoked when a polyline is clicked. To unset the callback, use null . |
---|
public void setPadding (int left, int top, int right, int bottom)
Sets padding on the map.
This method allows you to define a visible region on the map, to signal to the map that portions of the map around the edges may be obscured, by setting padding on each of the four edges of the map. Map functions will be adapted to the padding. For example, the zoom controls, compass, copyright notices and Google logo will be moved to fit inside the defined region, camera movements will be relative to the center of the visible region, etc.
مولفه های
left | the number of pixels of padding to be added on the left of the map. |
---|---|
top | the number of pixels of padding to be added on the top of the map. |
right | the number of pixels of padding to be added on the right of the map. |
bottom | the number of pixels of padding to be added on the bottom of the map. |
public void setTrafficEnabled (boolean enabled)
Turns the traffic layer on or off.
مولفه های
enabled |
---|
public void snapshot ( GoogleMap.SnapshotReadyCallback callback)
Takes a snapshot of the map.
You can use snapshots within your application when an interactive map would be difficult, or impossible, to use. For example, images produced with the snapshot()
method can be used to display a thumbnail of the map in your app, or a snapshot in the notification center.
Note: Images of the map must not be transmitted to your servers, or otherwise used outside of the application. If you need to send a map to another application or user, send data that allows them to reconstruct the map for the new user instead of a snapshot.
مولفه های
callback | Callback method invoked when the snapshot is taken. |
---|
public void snapshot ( GoogleMap.SnapshotReadyCallback callback, Bitmap bitmap)
Takes a snapshot of the map.
This method is equivalent to snapshot(SnapshotReadyCallback)
but lets you provide a preallocated Bitmap
. If the bitmap does not match the current dimensions of the map, another bitmap will be allocated that fits the map's dimensions.
Although in most cases the object passed by the callback method is the same as the one given in the parameter to this method, in some cases the returned object can be different (eg, if the view's dimensions have changed by the time the snapshot is actually taken). Thus, you should only trust the content of the bitmap passed by the callback method.
مولفه های
callback | Callback method invoked when the snapshot is taken. |
---|---|
bitmap | A preallocated bitmap. If null , behaves like snapshot(SnapshotReadyCallback) . |
public void stopAnimation ()
Stops the camera animation if there is one in progress. When the method is called, the camera stops moving immediately and remains in that position.