Coordinates

کلاس LatLng

‫google.maps.LatLng کلاس

LatLng نقطه‌ای در مختصات جغرافیایی است: عرض جغرافیایی و طول جغرافیایی.

  • عرض جغرافیایی بین ۹۰- و ۹۰ درجه است. مقادیر بالاتر یا پایین‌تر از این محدوده به محدوده [-90, 90] محدود خواهند شد. این یعنی اگر مقدار مشخص‌شده کمتر از ۹۰- باشد، روی ۹۰- تنظیم خواهد شد. و اگر مقدار بیشتر از ۹۰ باشد، روی ۹۰ تنظیم می‌شود.
  • طول جغرافیایی بین ۱۸۰- و ۱۸۰ درجه است. مقادیر بالاتر یا پایین‌تر از این محدوده پیچیده می‌شوند تا در محدوده قرار گیرند. برای مثال، مقدار ‎-۱۹۰ به ۱۷۰ تبدیل می‌شود. مقدار ۱۹۰ به ۱۷۰- تبدیل خواهد شد. این نشان‌دهنده این واقعیت است که طول‌های جغرافیایی دور کره زمین می‌پیچند.
اگرچه تصویر نقشه پیش‌فرض طول جغرافیایی را با مختصات x نقشه و عرض جغرافیایی را با مختصات y مرتبط می‌کند، مختصات عرض جغرافیایی همیشه ابتدا نوشته می‌شود و سپس طول جغرافیایی می‌آید.
توجه داشته باشید که نمی‌توانید مختصات LatLng را تغییر دهید. اگر می‌خواهید نقطه دیگری را محاسبه کنید، باید نقطه جدیدی ایجاد کنید.

اکثر روش‌هایی که اشیاء LatLng را می‌پذیرند، شیء LatLngLiteral را نیز می‌پذیرند، بنابراین موارد زیر معادل هستند:

 map.setCenter(new google.maps.LatLng(-34, 151));
map.setCenter({lat: -34, lng: 151});

سازنده همچنین اشیاء LatLngLiteral و LatLng را می‌پذیرد. اگر نمونه LatLng به سازنده منتقل شود، نسخه‌ای ایجاد می‌شود.

فراخوانی‌های ممکن برای سازنده در زیر آمده است:

 new google.maps.LatLng(-34, 151);
new google.maps.LatLng(-34, 151, true);
new google.maps.LatLng({lat: -34, lng: 151});
new google.maps.LatLng({lat: -34, lng: 151}, true);
new google.maps.LatLng(new google.maps.LatLng(-34, 151));
new google.maps.LatLng(new google.maps.LatLng(-34, 151), true);

با تماس با const {LatLng} = await google.maps.importLibrary("core") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

LatLng
LatLng(latOrLatLngOrLatLngLiteral[, lngOrNoClampNoWrap, noClampNoWrap])
پارامترها: 
  • ‫latOrLatLngOrLatLngLiteral:  number|LatLngLiteral|LatLng
  • ‫lngOrNoClampNoWrap:  number|boolean optional
  • ‫noClampNoWrap:  boolean optional
شیء LatLng را که نشان‌دهنده نقطه جغرافیایی است ایجاد می‌کند. عرض جغرافیایی با درجه در محدوده [۹۰-، ۹۰] مشخص می‌شود. طول جغرافیایی برحسب درجه در محدوده [-۱۸۰، ۱۸۰) مشخص می‌شود. برای فعال کردن مقادیر خارج از این محدوده، noClampNoWrap را روی true تنظیم کنید. به ترتیب طول و عرض جغرافیایی توجه کنید.
equals
equals(other)
پارامترها: 
مقدار برگشتی:  boolean
تابع مقایسه.
lat
lat()
پارامترها:  هیچ
مقدار برگشتی:  number
عرض جغرافیایی را به درجه برمی‌گرداند.
lng
lng()
پارامترها:  هیچ
مقدار برگشتی:  number
طول جغرافیایی را به درجه برمی‌گرداند.
toJSON
toJSON()
پارامترها:  هیچ
مقدار برگشتی:  LatLngLiteral
به نمایش JSON تبدیل می‌کند. این عملکرد برای استفاده ازطریق JSON.stringify درنظر گرفته شده است.
toString
toString()
پارامترها:  هیچ
مقدار برگشتی:  string
به نمایش رشته‌ای تبدیل می‌کند.
toUrlValue
toUrlValue([precision])
پارامترها: 
  • ‫precision:  number optional
مقدار برگشتی:  string
رشته‌ای از فرم «lat,lng» را برای این LatLng برمی‌گرداند. به‌طور پیش‌فرض، مقادیر عرض/طول جغرافیایی را تا ۶ رقم اعشار گرد می‌کنیم.

LatLngLiteral میان‌نما

میانا google.maps.LatLngLiteral

راستین‌نمادهای شیء در بسیاری از جاها به‌جای اشیاء LatLng پذیرفته می‌شوند. وقتی Maps API با این‌ها مواجه می‌شود، آن‌ها را به اشیاء LatLng تبدیل می‌کند.

مثال‌ها:

 map.setCenter({lat: -34, lng: 151});
new google.maps.Marker({position: {lat: -34, lng: 151}, map: map});

راستین‌نمادهای شیء LatLng در کتابخانه Geometry پشتیبانی نمی‌شود.

lat
نوع:  number
عرض جغرافیایی به درجه. مقادیر به محدوده [-90, 90] متصل خواهند شد. این یعنی اگر مقدار مشخص‌شده کمتر از ۹۰- باشد، روی ۹۰- تنظیم خواهد شد. و اگر مقدار بیشتر از ۹۰ باشد، روی ۹۰ تنظیم می‌شود.
lng
نوع:  number
طول جغرافیایی به درجه. مقادیر خارج از محدوده [-180, 180] به‌گونه‌ای پیچیده می‌شوند که در این محدوده قرار بگیرند. برای مثال، مقدار ‎-۱۹۰ به ۱۷۰ تبدیل می‌شود. مقدار ۱۹۰ به ۱۷۰- تبدیل خواهد شد. این نشان‌دهنده این واقعیت است که طول‌های جغرافیایی دور کره زمین می‌پیچند.

کلاس LatLngBounds

‫google.maps.LatLngBounds کلاس

نمونه LatLngBounds نشان‌دهنده مستطیلی در مختصات جغرافیایی است، ازجمله مستطیلی که از نصف‌النهار ۱۸۰ درجه عبور می‌کند.

با تماس با const {LatLngBounds} = await google.maps.importLibrary("core") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

LatLngBounds
LatLngBounds([swOrLatLngBounds, ne])
پارامترها: 
مستطیلی را از نقاط گوشه‌های جنوب غربی و شمال شرقی آن می‌سازد.
MAX_BOUNDS LatLngBounds برای حداکثر مرزهای زمین. این مرزها کل جهان را دربرمی‌گیرد.
contains
contains(latLng)
پارامترها: 
مقدار برگشتی:  boolean
اگر طول/عرض جغرافیایی داده‌شده در این محدوده باشد، true را برمی‌گرداند.
equals
equals(other)
پارامترها: 
مقدار برگشتی:  boolean
اگر این مرزها تقریباً با مرزهای داده‌شده برابر باشد، true را برمی‌گرداند.
extend
extend(point)
پارامترها: 
مقدار برگشتی:  LatLngBounds
این مرزها را گسترش می‌دهد تا نقطه داده‌شده را دربرگیرد.
getCenter
getCenter()
پارامترها:  هیچ
مقدار برگشتی:  LatLng
مرکز این LatLngBounds را محاسبه می‌کند
getNorthEast
getNorthEast()
پارامترها:  هیچ
مقدار برگشتی:  LatLng
گوشه شمال شرقی این محدوده را برمی‌گرداند.
getSouthWest
getSouthWest()
پارامترها:  هیچ
مقدار برگشتی:  LatLng
گوشه جنوب غربی این محدوده را برمی‌گرداند.
intersects
intersects(other)
پارامترها: 
مقدار برگشتی:  boolean
اگر این مرزها با مرزهای دیگر نقطه مشترکی داشته باشد، true را برمی‌گرداند.
isEmpty
isEmpty()
پارامترها:  هیچ
مقدار برگشتی:  boolean
اگر مرزها خالی باشد، برمی‌گرداند.
toJSON
toJSON()
پارامترها:  هیچ
مقدار برگشتی:  LatLngBoundsLiteral
به نمایش JSON تبدیل می‌کند. این عملکرد برای استفاده ازطریق JSON.stringify درنظر گرفته شده است.
toSpan
toSpan()
پارامترها:  هیچ
مقدار برگشتی:  LatLng
مرزهای نقشه داده‌شده را به محدوده عرض/طول جغرافیایی تبدیل می‌کند.
toString
toString()
پارامترها:  هیچ
مقدار برگشتی:  string
به رشته تبدیل می‌کند.
toUrlValue
toUrlValue([precision])
پارامترها: 
  • ‫precision:  number optional
مقدار برگشتی:  string
رشته‌ای از فرم «lat_lo,lng_lo,lat_hi,lng_hi» را برای این مرزها برمی‌گرداند، که در آن «lo» با گوشه جنوب غربی چارگوش مرزبندی مطابقت دارد، درحالی‌که «hi» با گوشه شمال شرقی آن چارگوش مطابقت دارد.
union
union(other)
پارامترها: 
مقدار برگشتی:  LatLngBounds
این مرزها را گسترش می‌دهد تا شامل اجتماع این مرزها و مرزهای داده‌شده باشد.

LatLngBoundsLiteral میانای

میانا google.maps.LatLngBoundsLiteral

راستین‌نمادهای شیء به‌جای اشیاء LatLngBounds در سراسر میانای برنامه‌سازی کاربردی پذیرفته می‌شوند. این‌ها به‌طور خودکار به اشیاء LatLngBounds تبدیل می‌شوند. همه south،‏ west،‏ north، و east باید تنظیم شوند، درغیراین‌صورت استثنا ایجاد می‌شود.

east
نوع:  number
طول جغرافیایی شرق به درجه. مقادیر خارج از محدوده [-180, 180] به محدوده [-180, 180) پیچیده خواهند شد. برای مثال، مقدار ‎-۱۹۰ به ۱۷۰ تبدیل می‌شود. مقدار ۱۹۰ به ۱۷۰- تبدیل خواهد شد. این نشان‌دهنده این واقعیت است که طول‌های جغرافیایی دور کره زمین می‌پیچند.
north
نوع:  number
عرض جغرافیایی شمال به درجه. مقادیر به محدوده [-90, 90] متصل خواهند شد. این یعنی اگر مقدار مشخص‌شده کمتر از ۹۰- باشد، روی ۹۰- تنظیم خواهد شد. و اگر مقدار بیشتر از ۹۰ باشد، روی ۹۰ تنظیم می‌شود.
south
نوع:  number
عرض جغرافیایی جنوب به درجه. مقادیر به محدوده [-90, 90] متصل خواهند شد. این یعنی اگر مقدار مشخص‌شده کمتر از ۹۰- باشد، روی ۹۰- تنظیم خواهد شد. و اگر مقدار بیشتر از ۹۰ باشد، روی ۹۰ تنظیم می‌شود.
west
نوع:  number
طول جغرافیایی غرب به درجه. مقادیر خارج از محدوده [-180, 180] به محدوده [-180, 180) پیچیده خواهند شد. برای مثال، مقدار ‎-۱۹۰ به ۱۷۰ تبدیل می‌شود. مقدار ۱۹۰ به ۱۷۰- تبدیل خواهد شد. این نشان‌دهنده این واقعیت است که طول‌های جغرافیایی دور کره زمین می‌پیچند.

کلاس LatLngAltitude

‫google.maps.LatLngAltitude کلاس

LatLngAltitude نقطه‌ای سه‌بعدی در مختصات جغرافیایی است: عرض جغرافیایی، طول جغرافیایی، و ارتفاع.

  • عرض جغرافیایی بین ۹۰- و ۹۰ درجه است. مقادیر بالاتر یا پایین‌تر از این محدوده به محدوده [-90, 90] محدود خواهند شد. این یعنی اگر مقدار مشخص‌شده کمتر از ۹۰- باشد، روی ۹۰- تنظیم خواهد شد. و اگر مقدار بیشتر از ۹۰ باشد، روی ۹۰ تنظیم می‌شود.
  • طول جغرافیایی بین ۱۸۰- و ۱۸۰ درجه است. مقادیر بالاتر یا پایین‌تر از این محدوده پیچیده می‌شوند تا در محدوده قرار گیرند. برای مثال، مقدار ‎-۱۹۰ به ۱۷۰ تبدیل می‌شود. مقدار ۱۹۰ به ۱۷۰- تبدیل خواهد شد. این نشان‌دهنده این واقعیت است که طول‌های جغرافیایی دور کره زمین می‌پیچند.
  • ارتفاع برحسب متر اندازه‌گیری می‌شود. مقادیر مثبت نشان‌دهنده ارتفاع بالاتر از سطح زمین و مقادیر منفی نشان‌دهنده ارتفاع پایین‌تر از سطح زمین است.

این کلاس LatLngAltitudeLiteral را پیاده‌سازی می‌کند.

این کلاس LatLngLiteral را پیاده‌سازی می‌کند.

با تماس با const {LatLngAltitude} = await google.maps.importLibrary("core") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

LatLngAltitude
LatLngAltitude(value[, noClampNoWrap])
پارامترها: 
  • value:  LatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral مقدار مقداردهی اولیه.
  • noClampNoWrap:  boolean optional اینکه آیا مقادیر مقداردهی اولیه حفظ شوند، حتی اگر لزوماً مقادیر عرض جغرافیایی معتبر در محدوده [۹۰-، ۹۰] یا مقادیر طول جغرافیایی معتبر در محدوده [۱۸۰-، ۱۸۰] نباشند. پیش‌فرض false است که محدود کردن عرض جغرافیایی و پیچیدن طول جغرافیایی را فعال می‌کند.
altitude
نوع:  number
ارتفاع را برمی‌گرداند.
lat
نوع:  number
عرض جغرافیایی را برمی‌گرداند.
lng
نوع:  number
طول جغرافیایی را برمی‌گرداند.
equals
equals(other)
پارامترها: 
مقدار برگشتی:  boolean اینکه آیا دو شیء برابر هستند یا نه.
تابع مقایسه.
toJSON
toJSON()
پارامترها:  هیچ
مقدار برگشتی:  LatLngAltitudeLiteral نمایش JSON این شیء.

میانای LatLngAltitudeLiteral

میانا google.maps.LatLngAltitudeLiteral

راستین‌نمادهای شیء در بسیاری از جاها به‌جای اشیاء LatLngAltitude پذیرفته می‌شوند. وقتی Maps API با این‌ها مواجه می‌شود، آن‌ها را به اشیاء LatLngAltitude تبدیل می‌کند.

این میانای گسترش‌یافته LatLngLiteral.

lat
نوع:  number
عرض جغرافیایی به درجه. مقادیر به محدوده [-90, 90] متصل خواهند شد. این یعنی اگر مقدار مشخص‌شده کمتر از ۹۰- باشد، روی ۹۰- تنظیم خواهد شد. و اگر مقدار بیشتر از ۹۰ باشد، روی ۹۰ تنظیم می‌شود.
lng
نوع:  number
طول جغرافیایی به درجه. مقادیر خارج از محدوده [-180, 180] به‌گونه‌ای پیچیده می‌شوند که در این محدوده قرار بگیرند. برای مثال، مقدار ‎-۱۹۰ به ۱۷۰ تبدیل می‌شود. مقدار ۱۹۰ به ۱۷۰- تبدیل خواهد شد. این نشان‌دهنده این واقعیت است که طول‌های جغرافیایی دور کره زمین می‌پیچند.
altitude optional
نوع:  number optional
پیش‌فرض: 0
فاصله (به متر) از سطح زمین. مقدار منفی یعنی زیر سطح زمین.

کلاس نقطه‌ای

‫google.maps.Point کلاس

با تماس با const {Point} = await google.maps.importLibrary("core") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

Point
Point(x, y)
پارامترها: 
  • ‫x:  number
  • ‫y:  number
نقطه‌ای در صفحه دوبعدی.
x
نوع:  number
مختصات X
y
نوع:  number
مختصات Y
equals
equals(other)
پارامترها: 
  • ‫other:  Point optional
مقدار برگشتی:  boolean
دو نقطه را مقایسه می‌کند
toString
toString()
پارامترها:  هیچ
مقدار برگشتی:  string
نمایش رشته‌ای این «نقطه» را برمی‌گرداند.

کلاس اندازه

‫google.maps.Size کلاس

با تماس با const {Size} = await google.maps.importLibrary("core") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

Size
Size(width, height[, widthUnit, heightUnit])
پارامترها: 
  • ‫width:  number
  • ‫height:  number
  • ‫widthUnit:  string optional
  • ‫heightUnit:  string optional
اندازه دوبعدی، که در آن عرض فاصله در محور x و ارتفاع فاصله در محور y است.
height
نوع:  number
ارتفاع در امتداد محور y، به پیکسل.
width
نوع:  number
عرض در امتداد محور x، به پیکسل.
equals
equals(other)
پارامترها: 
  • ‫other:  Size optional
مقدار برگشتی:  boolean
دو اندازه را مقایسه می‌کند.
toString
toString()
پارامترها:  هیچ
مقدار برگشتی:  string
نمایش رشته‌ای این «اندازه» را برمی‌گرداند.

رابط حاشیه درونی

میانا google.maps.Padding

bottom optional
نوع:  number optional
حاشیه پایین، به پیکسل.
left optional
نوع:  number optional
حاشیه داخلی برای سمت چپ، به پیکسل.
right optional
نوع:  number optional
حاشیه سمت راست، به پیکسل.
top optional
نوع:  number optional
حاشیه داخلی برای بالا، به پیکسل.

میانای CircleLiteral

میانا google.maps.CircleLiteral

راستین‌نماد شیء که نشان‌دهنده دایره است.

این میانای گسترش‌یافته CircleOptions.

center
مرکز «حلقه».
radius
نوع:  number
شعاع به متر در سطح زمین.
به‌ارث‌رسیده: clickable، draggable، editable، fillColor، fillOpacity، map، strokeColor، strokeOpacity، strokePosition، strokeWeight، visible، zIndex

کلاس Orientation3D

‫google.maps.Orientation3D کلاس

Orientation3D برداری سه‌بعدی است که برای تبدیل‌های چرخش ریاضی استاندارد در امتداد جهت، شیب، و چرخش استفاده می‌شود.

  • heading زاویه‌ای در محدوده [0, 360) درجه است.
  • شیب زاویه‌ای در محدوده [۰، ۳۶۰) درجه است.
  • چرخش زاویه‌ای در محدوده [۰، ۳۶۰) درجه است.

این کلاس Orientation3DLiteral را پیاده‌سازی می‌کند.

با تماس با const {Orientation3D} = await google.maps.importLibrary("core") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

Orientation3D
Orientation3D(value)
پارامترها: 
heading
نوع:  number
پیش‌فرض: 0
چرخش حول محور z (عمود بر سطح زمین). مقدار ۰ (پیش‌فرض) برابر با شمال است. چرخش مثبت در جهت عقربه‌های ساعت حول محور z است و با درجه از ۰ تا ۳۶۰ مشخص می‌شود. مقادیر بالاتر یا پایین‌تر از این محدوده پیچیده می‌شوند تا در محدوده قرار گیرند. برای مثال، مقدار ‎-۱۹۰ به ۱۷۰ تبدیل می‌شود. مقدار ۵۳۰ نیز به ۱۷۰ تبدیل خواهد شد.
roll
نوع:  number
پیش‌فرض: 0
چرخش حول محور y. چرخش مثبت در جهت عقربه‌های ساعت حول محور y است و با درجه از ۰ تا ۳۶۰ مشخص می‌شود. مقادیر بالاتر یا پایین‌تر از این محدوده پیچیده می‌شوند تا در محدوده قرار گیرند. برای مثال، مقدار ‎-۱۹۰ به ۱۷۰ تبدیل می‌شود. مقدار ۵۳۰ نیز به ۱۷۰ تبدیل خواهد شد.
tilt
نوع:  number
پیش‌فرض: 0
چرخش حول محور x. چرخش مثبت در جهت عقربه‌های ساعت حول محور x است و با درجه از ۰ تا ۳۶۰ مشخص می‌شود. مقادیر بالاتر یا پایین‌تر از این محدوده پیچیده می‌شوند تا در محدوده قرار گیرند. برای مثال، مقدار ‎-۱۹۰ به ۱۷۰ تبدیل می‌شود. مقدار ۵۳۰ نیز به ۱۷۰ تبدیل خواهد شد.
equals
equals(other)
پارامترها: 
مقدار برگشتی:  boolean اینکه آیا دو شیء برابر هستند یا نه.
تابع مقایسه.
toJSON
toJSON()
پارامترها:  هیچ
مقدار برگشتی:  Orientation3DLiteral
به نمایش JSON تبدیل می‌کند. این تابع برای استفاده ازطریق JSON.stringify درنظر گرفته شده است.

Orientation3DLiteral میانای

میانا google.maps.Orientation3DLiteral

راستین‌نمادهای شیء در بسیاری از جاها به‌جای اشیاء Orientation3D پذیرفته می‌شوند. وقتی Maps API با این‌ها مواجه می‌شود، آن‌ها را به اشیاء Orientation3D تبدیل می‌کند.

heading optional
نوع:  number optional
چرخش حول محور z (عمود بر سطح زمین). مقدار ۰ (پیش‌فرض) برابر با شمال است. چرخش مثبت در جهت عقربه‌های ساعت حول محور z است و با درجه از ۰ تا ۳۶۰ مشخص می‌شود.
roll optional
نوع:  number optional
چرخش حول محور y. چرخش مثبت در جهت عقربه‌های ساعت حول محور y است و با درجه از ۰ تا ۳۶۰ مشخص می‌شود.
tilt optional
نوع:  number optional
چرخش حول محور x. چرخش مثبت در جهت عقربه‌های ساعت حول محور x است و با درجه از ۰ تا ۳۶۰ مشخص می‌شود.

کلاس Vector3D

‫google.maps.Vector3D کلاس

Vector3D برداری سه‌بعدی است که برای عملیات ریاضی استاندارد مانند مقیاس‌بندی مرزهای شیء سه‌بعدی در امتداد محورهای x، y، و z محلی استفاده می‌شود.

  • x یک عدد حقیقی است.
  • y یک عدد حقیقی است.
  • z یک عدد حقیقی است.

این کلاس Vector3DLiteral را پیاده‌سازی می‌کند.

با تماس با const {Vector3D} = await google.maps.importLibrary("core") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

Vector3D
Vector3D(value)
پارامترها: 
x
نوع:  number
مؤلفه X بردار سه‌بعدی.
y
نوع:  number
مؤلفه Y بردار سه‌بعدی.
z
نوع:  number
مؤلفه Z بردار سه‌بعدی.
equals
equals(other)
پارامترها: 
مقدار برگشتی:  boolean
تابع مقایسه.
toJSON
toJSON()
پارامترها:  هیچ
مقدار برگشتی:  Vector3DLiteral
به نمایش JSON تبدیل می‌کند. این تابع برای استفاده ازطریق JSON.stringify درنظر گرفته شده است.

میانای Vector3DLiteral

میانا google.maps.Vector3DLiteral

راستین‌نمادهای شیء در بسیاری از جاها به‌جای اشیاء Vector3D پذیرفته می‌شوند. وقتی Maps API با این‌ها مواجه می‌شود، آن‌ها را به اشیاء Vector3D تبدیل می‌کند.

x
نوع:  number
مؤلفه X بردار سه‌بعدی.
y
نوع:  number
مؤلفه Y بردار سه‌بعدی.
z
نوع:  number
مؤلفه Z بردار سه‌بعدی.