google.maps . LatLng
کلاس google.maps . LatLng
LatLng
یک نقطه در مختصات جغرافیایی است: طول و عرض جغرافیایی.
- محدوده عرض جغرافیایی بین -90 تا 90 درجه، شامل. مقادیر بالاتر یا پایین تر از این محدوده به محدوده [90-، 90] گیره داده می شود. یعنی اگر مقدار مشخص شده کمتر از 90- باشد، روی 90- تنظیم می شود. و اگر مقدار بیشتر از 90 باشد روی 90 تنظیم می شود.
- طول جغرافیایی بین -180 و 180 درجه، شامل محدوده است. مقادیر بالاتر یا پایین تر از این محدوده به گونه ای پیچیده می شوند که در محدوده قرار گیرند. به عنوان مثال، مقدار -190 به 170 تبدیل می شود. مقدار 190 به -170 تبدیل می شود. این نشان دهنده این واقعیت است که طول های جغرافیایی به دور کره زمین می پیچند.
توجه داشته باشید که نمی توانید مختصات یک
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]) مولفه های:
یک شی 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]) مولفه های:
مقدار بازگشتی: string رشته ای از شکل "lat,lng" را برای این LatLng برمی گرداند. مقادیر lat/lng را به طور پیش فرض تا 6 رقم اعشار گرد می کنیم. |
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 تبدیل می شود. این نشان دهنده این واقعیت است که طول های جغرافیایی به دور کره زمین می پیچند. |
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]) مولفه های:
مقدار بازگشتی: string رشته ای از شکل "lat_lo,lng_lo,lat_hi,lng_hi" را برای این کران برمی گرداند، که در آن "lo" مربوط به گوشه جنوب غربی کادر مرزی است، در حالی که "hi" مربوط به گوشه شمال شرقی آن کادر است. |
union | union(other) مولفه های:
مقدار بازگشتی: LatLngBounds این کران را گسترش می دهد تا ترکیب این و کران داده شده را در بر گیرد. |
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 تبدیل می شود. این نشان دهنده این واقعیت است که طول های جغرافیایی به دور کره زمین می پیچند. |
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]) مولفه های:
|
altitude | نوع: number ارتفاع را برمی گرداند. |
lat | نوع: number عرض جغرافیایی را برمی گرداند. |
lng | نوع: number طول جغرافیایی را برمی گرداند. |
equals | equals(other) مولفه های:
مقدار بازگشتی: boolean آیا دو شیء برابر هستند یا خیر. تابع مقایسه |
toJSON | toJSON() پارامترها: ندارد مقدار بازگشتی: LatLngAltitudeLiteral یک نمایش JSON از این شی. |
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 مختصات 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]) مولفه های:
اندازه دو بعدی، که در آن عرض فاصله در محور 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 بالشتک برای بالا، در پیکسل. |
google.maps . CircleLiteral
رابط google.maps . CircleLiteral
شی لفظی که نشان دهنده یک دایره است.
این رابط CircleOptions
را گسترش می دهد.
center | نوع: LatLng | LatLngLiteral مرکز دایره. |
radius | نوع: number شعاع بر حسب متر در سطح زمین. |
ارثی: clickable ، draggable ، editable ، fillColor ، fillOpacity ، map ، strokeColor ، strokeOpacity ، strokePosition ، strokeWeight ، visible ، zIndex |