دستورالعمل مرجع نقشه‌های گوگل

پیشنهاد دوره:

توضیح Map() constructor

ایجاد نقشه گوگل:

var map = new google.maps.Map(mapCanvas, mapOptions);

توضیح و استفاده

ترتیب

new google.maps.Map(HTMLElement,MapOptions)

مقدار پارامتر

پارامترها توضیحات
HTMLElement تعیین اینکه نقشه باید در کدام عنصر HTML قرار گیرد.
MapOptions موضوع MapOptions برای ذخیره متغیرها و تنظیمات ابتدایی نقشه.

روش‌های Map()

روش مقدار بازگردانده شده توضیحات
fitBounds(LatLngBounds) None viewport را تنظیم کنید تا شامل مرزهای داده شده باشد.
getBounds() LatLng,LatLng عرض و طول جغرافیایی نقطه جنوب غربی و نقطه شمال شرقی视‌گاه فعلی را بازگردانید.
getCenter() LatLng عرض و طول جغرافیایی مرکز نقشه را بازگردانید.
getDiv() Node عنصر DOM شامل نقشه را بازگردانید.
getHeading() number

زاویه قطب‌نما برای تصاویر هوایی را بازگردانید.

برای نوعهای نقشه SATELLITE و HYBRID کاربرد دارد.
getMapTypeId()
  • HYBRID
  • ROADMAP
  • SATELLITE
  • TERRAIN
 نوع نقشه فعلی را بازگردانید.
getProjection() Projection پروژه‌ فعلی را بازگردانید.
getStreetView() StreetViewPanorama StreetViewPanorama پیش‌فرضی که به نقشه متصل شده است را بازگردانید.
getTilt() number

زاویه ورودی تصاویر هوایی را (به درجه) بازگردانید.

برای نوعهای نقشه SATELLITE و HYBRID کاربرد دارد.
getZoom() number سطح فعلی زوم نقشه را بازگردانید.
panBy(xnumber,ynumber) None مرکز نقشه را با استفاده از فاصله داده شده (به پیکسل) تغییر دهید.
panTo(LatLng) None مرکز نقشه را به LatLng داده شده تغییر دهید.
panToBounds(LatLngBounds) None با حرکت دادن نقشه به حداقل مقدار لازم برای شامل LatLngBounds داده شده، نقشه را حرکت دهید.
setCenter(LatLng) None تنظیم عرض و طول جغرافیایی مرکز نقشه.
setHeading(number) None

تنظیم جهت قطب‌نما برای تصاویر هوایی.

با استفاده از درجه‌ای که از جهت شمال ساده‌سازی شده اندازه‌گیری می‌شود.
setMapTypeId(MapTypeId) None تنظیم نوع نقشه‌ای که باید نمایش داده شود.
setOptions(MapOptions) None
setStreetView(StreetViewPanorama) None StreetViewPanorama را به نقشه متصل می‌کند.
setTilt(number) None

زاویه ورودی تصویر هوایی را (به درجه) تنظیم می‌کند.

برای نوعهای نقشه SATELLITE و HYBRID کاربرد دارد.
setZoom(number) None سطح بزرگنمایی نقشه را تنظیم می‌کند.

ویژگی‌های Map()

ویژگی‌ها نوع توضیحات
controls Array.<MVCArray.<Node>> کنترل‌های اضافی که به نقشه اضافه می‌شوند.
mapTypes MapTypeRegistry ثبت نمونه‌های MapType بر اساس شناسه توالی.
overlayMapTypes MVCArray.<MapType> نوعهای نقشه دیگری که باید اضافه شوند.

رویدادهای Map()

رویداد پارامترها توضیحات
bounds_changed None وقتی که مرزهای منظره تغییر می‌کنند، فعال می‌شود.
center_changed None وقتی که ویژگی مرکز نقشه تغییر می کند، فعال می‌شود.
click MouseEvent وقتی که کاربر روی نقشه کلیک می‌کند، فعال می‌شود.
dblclick MouseEvent وقتی که کاربر روی نقشه دوبار کلیک می کند، فعال می‌شود.
drag None وقتی که کاربر نقشه را می‌کشد، به طور مداوم فعال می‌شود.
dragend None وقتی که کاربر حرکت دادن نقشه را متوقف می کند، فعال می شود.
dragstart None وقتی که کاربر شروع به حرکت دادن نقشه می کند، فعال می شود.
heading_changed None وقتی که ویژگی عنوان نقشه تغییر می کند، فعال می شود.
idle None وقتی که نقشه پس از حرکت یا بزرگنمایی به حالت استراحت در می‌آید، فعال می شود.
maptypeid_changed None وقتی که ویژگی mapTypeId تغییر می کند، فعال می شود.
mousemove MouseEvent هر بار که موس کاربر روی جعبه نقشه حرکت می کند، فعال می شود.
mouseout MouseEvent وقتی که موس کاربر از جعبه نقشه خارج می شود، فعال می شود.
mouseover MouseEvent وقتی که موس کاربر به درون جعبه نقشه حرکت می کند، فعال می شود.
projection_changed None وقتی که پروژهکشی تغییر می کند، فعال می شود.
resize None وقتی که اندازه (div) نقشه تغییر می کند، فعال می شود.
rightclick MouseEvent وقتی که کاربر با راست کلیک روی نقشه کلیک می کند، فعال می شود.
tilesloaded None وقتی که بلوک‌های قابل مشاهده کامل بارگذاری شدند، فعال می شود.
tilt_changed None وقتی که ویژگی کجی نقشه تغییر می کند، فعال می شود.
zoom_changed None وقتی که ویژگی بزرگنمایی نقشه تغییر می کند، فعال می شود.

لایه اضافی

ساخته‌کننده/شیء توضیحات
Marker نشانگر ایجاد می کند. (توجه داشته باشید که باید مکان نمایش نشانگر تنظیم شود)
MarkerOptions اختیاراتی برای رندر کردن نشانگر.
MarkerImage نمایندگی از ساختار علامت نماد یا تصویر سایه.
MarkerShape تعریف شکل نشانگر برای تعیین منطقه قابل کلیک (نوع و مختصات) نشانگر.
Animation تعیین آنیمیشنی که می‌تواند روی مارک‌ها پخش شود (بالا رفتن یا پایین رفتن).
InfoWindow ایجاد پنجره‌ی اطلاعاتی.
InfoWindowOptions گزینه‌هایی برای رندر کردن پنجره‌ی اطلاعاتی.
Polyline ایجاد خطوط چندگانه (شامل مسیرها و سبک خط).
PolylineOptions گزینه‌هایی برای رندر کردن خطوط.
Polygon ایجاد چندضلعی (شامل مسیرها و خط+سبک پر کردن).
PolygonOptions گزینه‌هایی برای رندر کردن چندضلعی.
Rectangle ایجاد مستطیل (شامل مرزها و خط+سبک پر کردن).
RectangleOptions گزینه‌هایی برای رندر کردن مستطیل.
Circle ایجاد دایره (شامل مرکز+شعاع و خط+سبک پر کردن).
CircleOptions گزینه‌هایی برای رندر کردن دایره.
GroundOverlay
GroundOverlayOptions
OverlayView
MapPanes
MapCanvasProjection

رویداد

ساخته‌کننده/شیء توضیحات
MapsEventListener

این هیچ روشی ندارد و هیچ سازنده‌ای ندارد.

مثال‌های آن از addListener()، addDomListener() برگشت دارند و در نهایت به removeListener() بازمی‌گردند.
رویداد افزودن/حذف/انواع رویدادهای شنونده.
MouseEvent برگشت به کلیه رویدادهای ماوس از روی نقشه و لایه‌ها.

کنترل

کنترل/شیء توضیحات
MapTypeControlOptions ذخیره گزینه‌هایی که برای تغییر کنترل‌ها استفاده می‌شوند (موقعیت و سبک).
MapTypeControlStyle تعیین نوع کنترل نقشه‌ای که نمایش داده شود (لیست کشویی یا دکمه).
OverviewMapControlOptions برای رندر کردن گزینه‌های کنترل نقشه‌ی کلی (گسترش یا تا کردن).
PanControlOptions برای رندر کردن گزینه‌های کنترل حرکت (موقعیت).
RotateControlOptions برای رندر کردن گزینه‌های کنترل چرخش (موقعیت).
ScaleControlOptions برای رندر کردن گزینه‌های کنترل مقیاس (موقعیت و سبک).
ScaleControlStyle تعیین می‌کند که کدام نوع کنترل مقیاس نمایش داده شود.
StreetViewControlOptions برای رندر کردن گزینه‌های کنترل پگمن جاده‌ای (موقعیت).
ZoomControlOptions برای رندر کردن گزینه‌های کنترل بزرگنمایی (موقعیت و سبک).
ZoomControlStyle تعیین اینکه کدام نوع کنترل بزرگ یا کوچک نمایش داده شود.
ControlPosition تعیین مکان کنترل‌ها روی نقشه.