کلاس LatLng
google.maps.LatLng
کلاس
LatLng نقطهای در مختصات جغرافیایی است: عرض جغرافیایی و طول جغرافیایی.
- عرض جغرافیایی بین ۹۰- و ۹۰ درجه است. مقادیر بالاتر یا پایینتر از این محدوده به محدوده [-90, 90] محدود خواهند شد. این یعنی اگر مقدار مشخصشده کمتر از ۹۰- باشد، روی ۹۰- تنظیم خواهد شد. و اگر مقدار بیشتر از ۹۰ باشد، روی ۹۰ تنظیم میشود.
- طول جغرافیایی بین ۱۸۰- و ۱۸۰ درجه است. مقادیر بالاتر یا پایینتر از این محدوده پیچیده میشوند تا در محدوده قرار گیرند. برای مثال، مقدار -۱۹۰ به ۱۷۰ تبدیل میشود. مقدار ۱۹۰ به ۱۷۰- تبدیل خواهد شد. این نشاندهنده این واقعیت است که طولهای جغرافیایی دور کره زمین میپیچند.
توجه داشته باشید که نمیتوانید مختصات
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 را که نشاندهنده نقطه جغرافیایی است ایجاد میکند. عرض جغرافیایی با درجه در محدوده [۹۰-، ۹۰] مشخص میشود. طول جغرافیایی برحسب درجه در محدوده [-۱۸۰، ۱۸۰) مشخص میشود. برای فعال کردن مقادیر خارج از این محدوده، 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 برمیگرداند. بهطور پیشفرض، مقادیر عرض/طول جغرافیایی را تا ۶ رقم اعشار گرد میکنیم. |
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])پارامترها:
مقدار برگشتی:
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])پارامترها:
|
مشخصات | |
|---|---|
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مختصات X |
y |
نوع:
numberمختصات Y |
روشها | |
|---|---|
equals |
equals(other)پارامترها:
مقدار برگشتی:
booleanدو نقطه را مقایسه میکند |
toString |
toString()پارامترها: هیچ
مقدار برگشتی:
stringنمایش رشتهای این «نقطه» را برمیگرداند. |
کلاس اندازه
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
مشخصات | |
|---|---|
bottom optional |
نوع:
number optionalحاشیه پایین، به پیکسل. |
left optional |
نوع:
number optionalحاشیه داخلی برای سمت چپ، به پیکسل. |
right optional |
نوع:
number optionalحاشیه سمت راست، به پیکسل. |
top optional |
نوع:
number optionalحاشیه داخلی برای بالا، به پیکسل. |
میانای CircleLiteral
میانا
google.maps.CircleLiteral
راستیننماد شیء که نشاندهنده دایره است.
این میانای گسترشیافته
CircleOptions.
مشخصات | |
|---|---|
center |
نوع:
LatLng|LatLngLiteralمرکز «حلقه». |
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 بردار سهبعدی. |