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

کلاس Orientation3D

google.maps . Orientation3D کلاس google.maps . Orientation3D

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

  • عنوان یک زاویه در محدوده [0، 360) درجه است.
  • شیب زاویه ای در محدوده [0، 360) درجه است.
  • رول زاویه ای در محدوده [0، 360) درجه است.

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

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

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

رابط Orientation3DLiteral

google.maps . Orientation3DLiteral رابط google.maps . Orientation3DLiteral

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

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

کلاس Vector3D

google.maps . 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 رابط google.maps . Vector3DLiteral

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

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