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])
پارامترها: