Coordinates

کلاس LatLng

google.maps.LatLng کلاس
کتابخانه "core"

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");

سازنده

LatLng

LatLng(latOrLatLngOrLatLngLiteral[, lngOrNoClampNoWrap, noClampNoWrap]) پارامترها: ‫latOrLatLngOrLatLngLiteral:‏ number|LatLngLiteral|LatLng ‫lngOrNoClampNoWrap:‏ number|boolean optional ‫noClampNoWrap:‏ boolean optional شیء LatLng را که نشان‌دهنده نقطه جغرافیایی است ایجاد می‌کند. عرض جغرافیایی با درجه در محدوده [۹۰-، ۹۰] مشخص می‌شود. طول جغرافیایی برحسب درجه در محدوده [-۱۸۰، ۱۸۰) مشخص می‌شود. برای فعال کردن مقادیر خارج از این محدوده، noClampNoWrap را روی true تنظیم کنید. به ترتیب طول و عرض جغرافیایی توجه کنید.

روش‌ها
equals	equals(other) پارامترها: ‫other:‏ LatLng|LatLngLiteral optional مقدار برگشتی: boolean تابع مقایسه برای دو LatLng. اگر مختصات در محدوده 1e-9 از یکدیگر باشند، «درست» و درغیراین‌صورت «نادرست» را برمی‌گرداند.
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 کلاس
کتابخانه "core"

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

const {LatLngBounds} = await google.maps.importLibrary("core");

سازنده
LatLngBounds	LatLngBounds([swOrLatLngBounds, ne]) پارامترها: ‫swOrLatLngBounds:‏ LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral optional ‫ne:‏ LatLng|LatLngLiteral optional مستطیلی را از نقاط گوشه‌های جنوب غربی و شمال شرقی آن می‌سازد.

ثابت‌ها
MAX_BOUNDS	LatLngBounds برای حداکثر مرزهای زمین. این مرزها کل جهان را دربرمی‌گیرد.

روش‌ها
contains	contains(latLng) پارامترها: ‫latLng:‏ LatLng|LatLngLiteral مقدار برگشتی: boolean اگر طول/عرض جغرافیایی داده‌شده در این محدوده باشد، true را برمی‌گرداند.
equals	equals(other) پارامترها: ‫other:‏ LatLngBounds|LatLngBoundsLiteral optional مقدار برگشتی: boolean اگر این مرزها تقریباً با مرزهای داده‌شده برابر باشد، true را برمی‌گرداند.
extend	extend(point) پارامترها: ‫point:‏ LatLng|LatLngLiteral مقدار برگشتی: LatLngBounds این مرزها را گسترش می‌دهد تا نقطه داده‌شده را دربرگیرد.
getCenter	getCenter() پارامترها: هیچ مقدار برگشتی: LatLng مرکز این LatLngBounds را محاسبه می‌کند
getNorthEast	getNorthEast() پارامترها: هیچ مقدار برگشتی: LatLng گوشه شمال شرقی این محدوده را برمی‌گرداند.
getSouthWest	getSouthWest() پارامترها: هیچ مقدار برگشتی: LatLng گوشه جنوب غربی این محدوده را برمی‌گرداند.
intersects	intersects(other) پارامترها: ‫other:‏ LatLngBounds|LatLngBoundsLiteral مقدار برگشتی: 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) پارامترها: ‫other:‏ LatLngBounds|LatLngBoundsLiteral مقدار برگشتی: 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 class
implements LatLngAltitudeLiteral, LatLngLiteral
library "core"

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

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

const {LatLngAltitude} = await google.maps.importLibrary("core");

سازنده

LatLngAltitude

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

مشخصات
altitude readonly	نوع: number ارتفاع را برمی‌گرداند.
lat readonly	نوع: number عرض جغرافیایی را برمی‌گرداند.
lng readonly	نوع: number طول جغرافیایی را برمی‌گرداند.

روش‌ها
equals	equals(other) پارامترها: ‫other: LatLngAltitude|LatLngAltitudeLiteral optional شیء LatLngAltitude دیگر. مقدار برگشتی: boolean اینکه آیا دو شیء برابر هستند یا نه. تابع مقایسه برای دو LatLngAltitude. اگر مختصات در محدوده 1e-9 از یکدیگر باشند، «درست» و درغیراین‌صورت «نادرست» را برمی‌گرداند.
toJSON	toJSON([key]) پارامترها: ‫key:‏ string optional مقدار برگشتی: LatLngAltitudeLiteral به شیء ساده تبدیل می‌کند.

میانای LatLngAltitudeLiteral

google.maps.LatLngAltitudeLiteral interface
extends LatLngLiteral

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

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

کلاس نقطه‌ای

google.maps.Point کلاس
کتابخانه "core"

const {Point} = await google.maps.importLibrary("core");

سازنده
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 کلاس
کتابخانه "core"

const {Size} = await google.maps.importLibrary("core");

سازنده
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 اختیاری	نوع: number optional حاشیه پایین، به پیکسل.
left اختیاری	نوع: number optional حاشیه داخلی برای سمت چپ، به پیکسل.
right اختیاری	نوع: number optional حاشیه سمت راست، به پیکسل.
top اختیاری	نوع: number optional حاشیه داخلی برای بالا، به پیکسل.

میانای CircleLiteral

google.maps.CircleLiteral interface
extends CircleOptions

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

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

کلاس Orientation3D

google.maps.Orientation3D class
implements Orientation3DLiteral
library "core"

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

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

const {Orientation3D} = await google.maps.importLibrary("core");

سازنده
Orientation3D	Orientation3D(value) پارامترها: value: Orientation3D|Orientation3DLiteral مقدار مقداردهی اولیه.

مشخصات
heading readonly	نوع: number پیش‌فرض: 0 چرخش حول محور z (عمود بر سطح زمین). مقدار ۰ (پیش‌فرض) برابر با شمال است. چرخش مثبت در جهت عقربه‌های ساعت حول محور z است و با درجه از ۰ تا ۳۶۰ مشخص می‌شود. مقادیر بالاتر یا پایین‌تر از این محدوده پیچیده می‌شوند تا در محدوده قرار گیرند. برای مثال، مقدار ‎-۱۹۰ به ۱۷۰ تبدیل می‌شود. مقدار ۵۳۰ نیز به ۱۷۰ تبدیل خواهد شد.
roll readonly	نوع: number پیش‌فرض: 0 چرخش حول محور y. چرخش مثبت در جهت عقربه‌های ساعت حول محور y است و با درجه از ۰ تا ۳۶۰ مشخص می‌شود. مقادیر بالاتر یا پایین‌تر از این محدوده پیچیده می‌شوند تا در محدوده قرار گیرند. برای مثال، مقدار ‎-۱۹۰ به ۱۷۰ تبدیل می‌شود. مقدار ۵۳۰ نیز به ۱۷۰ تبدیل خواهد شد.
tilt readonly	نوع: number پیش‌فرض: 0 چرخش حول محور x. چرخش مثبت در جهت عقربه‌های ساعت حول محور x است و با درجه از ۰ تا ۳۶۰ مشخص می‌شود. مقادیر بالاتر یا پایین‌تر از این محدوده پیچیده می‌شوند تا در محدوده قرار گیرند. برای مثال، مقدار ‎-۱۹۰ به ۱۷۰ تبدیل می‌شود. مقدار ۵۳۰ نیز به ۱۷۰ تبدیل خواهد شد.

روش‌ها
equals	equals(other) پارامترها: ‫other: Orientation3D|Orientation3DLiteral optional شیء Orientation3D دیگر. مقدار برگشتی: boolean اینکه آیا دو شیء برابر هستند یا نه. تابع مقایسه.
toJSON	toJSON([key]) پارامترها: ‫key:‏ string optional مقدار برگشتی: Orientation3DLiteral به شیء ساده تبدیل می‌کند.

Orientation3DLiteral میانای

میانا google.maps.Orientation3DLiteral

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

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

کلاس Vector3D

google.maps.Vector3D class
implements Vector3DLiteral
library "core"

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

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

const {Vector3D} = await google.maps.importLibrary("core");

سازنده
Vector3D	Vector3D(value) پارامترها: value: Vector3D|Vector3DLiteral مقدار مقداردهی اولیه.

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

روش‌ها
equals	equals(other) پارامترها: ‫other: Vector3D|Vector3DLiteral optional شیء Vector3D یا Vector3DLiteral دیگر. مقدار برگشتی: boolean تابع مقایسه.
toJSON	toJSON([key]) پارامترها: ‫key:‏ string optional مقدار برگشتی: Vector3DLiteral به شیء ساده تبدیل می‌کند.

میانای Vector3DLiteral

میانا google.maps.Vector3DLiteral

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

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