public class

MapView

extends GLSurfaceView
java.lang.Object
   ↳ GLSurfaceView
     ↳ org.neshan.ui.MapView

Class Overview

این کلاس در واقع یک view class می‌باشد که تعاملات، ترسیم و کلیه‌ی عملیات‌های مرتبط با نقشه را پشتیبانی می‌کند.

Summary

Public Constructors
MapView(Context context)
یک مپ ویو جدید می سازد
MapView(Context context, AttributeSet attrs)
سازنده مپ ویو از روی مقادیر موجود در فایل xml ‌
Public Methods
float getBearing()
چرخش نقشه را برمی‌گرداند.
LngLat getFocalPointPosition()
موقعیتی را که دوربین درحال حاضر به سمت آن است را برمی‌گرداند.
Layers getLayers()
شی لایه‌ها را برمی‌گرداند.
MapEventListener getMapEventListener()
شی listener رویداد نقشه را برمی‌گرداند.
Options getOptions()
تنظیمات مرتبط با شی نقشه را برمی‌گرداند.
float getTilt()
زاویه tilt را برمی‌گرداند.
float getZoom()
سطح بزرگنمایی را برمی‌گرداند.
void moveToCameraBounds(Bounds bounds, ViewportBounds viewportBounds, boolean integerZoom, float durationSeconds)
تغییر پارامترهای نمایش (tilt، چرخش، بزرگنمایی و ...) برای اینکه در محدوده مشخص‌شده به طور کامل قابل نمایش شود.
static boolean registerLicense(String licenseKey, Context context)
مجوز SDK را رجیستر می‌کند.
void setBearing(float angle, float durationSeconds)
مقدار جدید چرخش را تنظیم می‌کند.
void setFocalPointPosition(LngLat pos, float durationSeconds)
موقعیت نقطه فوکوس جدید که بصورت مطلق می‌باشد را تنظیم می‌کند.
void setMapEventListener(MapEventListener mapEventListener)
listener رویداد نقشه را تنظیم می‌کند.
void setTilt(float tilt, float durationSeconds)
مقدار خوابدین نقشه به وضعیت دید پرنده را تنظیم می‌کند.0 به معنای همسطح بودن با افق،۹۰ به معنای عمود بون نقشه مي‌باشد.حداقل مقدار شیب نقشه 30 و حداکثر مقدار 90 درجه می‌باشد.
void setZoom(float zoom, float durationSeconds)
مقدار جدید بزرگنمایی را تنظیم می‌کند.حداقل مقدار 0 و حداکثر مقدار ۲۴ می باشد.
[Expand]
Inherited Methods
From class java.lang.Object

Public Constructors

public MapView (Context context)

یک مپ ویو جدید می سازد

Parameters
context The context object.

public MapView (Context context, AttributeSet attrs)

سازنده مپ ویو از روی مقادیر موجود در فایل xml ‌

Parameters
context The context object.
attrs The attributes.

Public Methods

public float getBearing ()

چرخش نقشه را برمی‌گرداند. 0: شمال،90: غرب،-90:شرق و 180: جنوب.

Returns
  • چرخش نقشه با مقیاس درجه

public LngLat getFocalPointPosition ()

موقعیتی را که دوربین درحال حاضر به سمت آن است را برمی‌گرداند.

Returns
  • موقعیت فعلی در سیستم مختصات پایه

public Layers getLayers ()

شی لایه‌ها را برمی‌گرداند. از طریق این شی می‌توان لایه‌های نقشه را حذف یا اضافه کرد.

Returns
  • شی لایه

public MapEventListener getMapEventListener ()

شی listener رویداد نقشه را برمی‌گرداند. این مقدار ممکن است null باشد.

Returns
  • شی listener ‌نقشه را بر می گرداند.

public Options getOptions ()

تنظیمات مرتبط با شی نقشه را برمی‌گرداند.

Returns
  • شی Option.

public float getTilt ()

زاویه tilt را برمی‌گرداند. 0 به معنای نگاه مستقیم افقی‌باشد و 90 به معنای نگاه مستقیم به پایین می‌باشد.

Returns
  • زاویه tilt با مقیاس درجه

public float getZoom ()

سطح بزرگنمایی را برمی‌گرداند. مقدار نامنفی است.حداقل مقدار 0 می‌باشد.

Returns
  • سطح بزرگنمایی.

public void moveToCameraBounds (Bounds bounds, ViewportBounds viewportBounds, boolean integerZoom, float durationSeconds)

تغییر پارامترهای نمایش (tilt، چرخش، بزرگنمایی و ...) برای اینکه در محدوده مشخص‌شده به طور کامل قابل نمایش شود. این متد قبل از تنظیم ابعاد صفحه کار نمی‌کند.

Parameters
bounds bound نقشه قابل رویت در سیستم مختصات پروجکشن پایه
integerZoom اگر صحیح باشد. نزدیک‌ترین عدد صحیح بزرگنمایی مورد استفاده قرار می‌گیرد.
durationSeconds مدت زمانی اتمام عملیات.

public static boolean registerLicense (String licenseKey, Context context)

مجوز SDK را رجیستر می‌کند. قبل ساخت هر شی از MapView باید فراخوانی شود.

Parameters
licenseKey کلید مجوز و لایسنس که برای این application در نظر گرفته شده است.
Returns
  • True اگر لایسنس معتبر یاشد و False هنگامی که لایسنس نامعتبر باشد.

public void setBearing (float angle, float durationSeconds)

مقدار جدید چرخش را تنظیم می‌کند. 0 جهت شمال ، 90 جهت غرب، -90 جهت شرق و 180 جنوب را نشان می‌دهد. اگر durationSeconds بزرگتر از صفر باشد چرخش در این زمان ادامه پیدا می‌کند.

Parameters
angle مقدار زاویه برای چرخش.
durationSeconds مدت زمانی که عملیات چرخش باید تکمیل شود بر حسب ثانیه.

public void setFocalPointPosition (LngLat pos, float durationSeconds)

موقعیت نقطه فوکوس جدید که بصورت مطلق می‌باشد را تنظیم می‌کند.

Parameters
pos موقعیت نقطه فوکوس جدید
durationSeconds مدت زمانی که عملیات panning کامل می‌شود

public void setMapEventListener (MapEventListener mapEventListener)

listener رویداد نقشه را تنظیم می‌کند.

Parameters
mapEventListener رویداد نقشه listener

public void setTilt (float tilt, float durationSeconds)

مقدار خوابدین نقشه به وضعیت دید پرنده را تنظیم می‌کند.0 به معنای همسطح بودن با افق،۹۰ به معنای عمود بون نقشه مي‌باشد.حداقل مقدار شیب نقشه 30 و حداکثر مقدار 90 درجه می‌باشد. اگر durationSeconds بزرگتر از صفر باشد.عملکرد دید پرنده در طی زمان مشخص شده به حالت انیمیشن اجرا می‌شود.

Parameters
tilt مقدار جدید دید پرنده برحسب درجه.
durationSeconds مدت زمان طی شدن عملکرد دید پرنده بر حسب ثانیه.

public void setZoom (float zoom, float durationSeconds)

مقدار جدید بزرگنمایی را تنظیم می‌کند.حداقل مقدار 0 و حداکثر مقدار ۲۴ می باشد. اگر durationSeconds بزرگتر از صفر باشد. عملکرد بزرگنمایی در طی زمان مشخص شده به حالت انیمیشن اجرا می‌شود.

Parameters
zoom مقدار جدید بزرگنمایی.
durationSeconds مدت زمان طی شدن عملکرد بزرگنمایی برحسب ثانیه.