Coordinates

کلاس LatLng

google.maps . LatLng کلاس google.maps . LatLng

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

  • محدوده عرض جغرافیایی بین -90 تا 90 درجه، شامل. مقادیر بالاتر یا پایین تر از این محدوده به محدوده [90-، 90] گیره داده می شود. یعنی اگر مقدار مشخص شده کمتر از 90- باشد، روی 90- تنظیم می شود. و اگر مقدار بیشتر از 90 باشد روی 90 تنظیم می شود.
  • طول جغرافیایی بین -180 و 180 درجه، شامل محدوده است. مقادیر بالاتر یا پایین تر از این محدوده به گونه ای پیچیده می شوند که در محدوده قرار گیرند. به عنوان مثال، مقدار -190 به 170 تبدیل می شود. مقدار 190 به -170 تبدیل می شود. این نشان دهنده این واقعیت است که طول های جغرافیایی به دور کره زمین می پیچند.
اگرچه پیش‌بینی نقشه پیش‌فرض طول جغرافیایی را با مختصات 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 ایجاد می کند که یک نقطه جغرافیایی را نشان می دهد. عرض جغرافیایی بر حسب درجه در محدوده [90-، 90] مشخص می شود. طول جغرافیایی بر حسب درجه در محدوده [-180، 180) مشخص می شود. برای فعال کردن مقادیر خارج از این محدوده 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 برمی گرداند. مقادیر lat/lng را به طور پیش فرض تا 6 رقم اعشار گرد می کنیم.

رابط LatLngLiteral

google.maps . 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 در کتابخانه هندسه پشتیبانی نمی شود.

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

کلاس LatLngBounds

google.maps . LatLngBounds کلاس google.maps . LatLngBounds

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

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

LatLngBounds
LatLngBounds([swOrLatLngBounds, ne])
مولفه های:
از نقاط زوایای جنوب غربی و شمال شرقی خود مستطیل می سازد.
MAX_BOUNDS LatLngBounds برای حداکثر مرزهای زمین. این محدوده ها کل کره زمین را در بر می گیرد.
contains
contains(latLng)
مولفه های:
مقدار بازگشتی: boolean
اگر lat/lng داده شده در این کران باشد، 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
کرانه های نقشه داده شده را به دهانه lat/lng تبدیل می کند.
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 رابط google.maps . LatLngBoundsLiteral

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

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

کلاس LatLngAltitude

google.maps . LatLngAltitude کلاس google.maps . LatLngAltitude

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

  • محدوده عرض جغرافیایی بین -90 تا 90 درجه، شامل. مقادیر بالاتر یا پایین تر از این محدوده به محدوده [90-، 90] گیره داده می شود. یعنی اگر مقدار مشخص شده کمتر از 90- باشد، روی 90- تنظیم می شود. و اگر مقدار بیشتر از 90 باشد روی 90 تنظیم می شود.
  • طول جغرافیایی بین -180 و 180 درجه، شامل محدوده است. مقادیر بالاتر یا پایین تر از این محدوده به گونه ای پیچیده می شوند که در محدوده قرار گیرند. به عنوان مثال، مقدار -190 به 170 تبدیل می شود. مقدار 190 به -170 تبدیل می شود. این نشان دهنده این واقعیت است که طول های جغرافیایی به دور کره زمین می پیچند.
  • ارتفاع بر حسب متر اندازه گیری می شود. مقادیر مثبت نشان دهنده ارتفاع بالاتر از سطح زمین و مقادیر منفی نشان دهنده ارتفاعات زیر سطح زمین است.

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

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

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

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

رابط LatLngAltitudeLiteral

google.maps . LatLngAltitudeLiteral رابط google.maps . LatLngAltitudeLiteral

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

این رابط LatLngLiteral را گسترش می دهد.

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

کلاس امتیاز

google.maps . Point کلاس 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)
مولفه های:
مقدار بازگشتی: boolean
دو نقطه را با هم مقایسه می کند
toString
toString()
پارامترها: ندارد
مقدار بازگشتی: string
نمایش رشته ای از این نقطه را برمی گرداند.

کلاس اندازه

google.maps . Size کلاس 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)
مولفه های:
مقدار بازگشتی: boolean
مقایسه دو سایز
toString
toString()
پارامترها: ندارد
مقدار بازگشتی: string
نمایش رشته ای از این اندازه را برمی گرداند.

رابط پد

google.maps . Padding رابط google.maps . Padding

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

رابط CircleLiteral

google.maps . CircleLiteral رابط google.maps . CircleLiteral

شی لفظی که نشان دهنده یک دایره است.

این رابط CircleOptions را گسترش می دهد.

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