Geometry Library

فضای نام رمزگذاری

google.maps.geometry . encoding فضای نام google.maps.geometry . encoding

ابزارهای کاربردی برای رمزگذاری و رمزگشایی چند خطی.

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

decodePath
decodePath(encodedPath)
مولفه های:
  • encodedPath : string
مقدار بازگشتی: Array < LatLng >
یک رشته مسیر کدگذاری شده را به دنباله ای از LatLngs رمزگشایی می کند.
encodePath
encodePath(path)
مولفه های:
مقدار بازگشتی: string
دنباله ای از LatLngs را در یک رشته مسیر کدگذاری شده رمزگذاری می کند.

فضای نام کروی

google.maps.geometry . spherical فضای نام google.maps.geometry . spherical

توابع کاربردی برای محاسبه زوایا، فواصل و مساحت های ژئودزیکی. شعاع پیش فرض شعاع زمین 6378137 متر است.

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

computeArea
computeArea(path[, radiusOfSphere])
مولفه های:
مقدار برگشتی: number
ناحیه بدون علامت یک مسیر بسته را در محدوده [0, 2×pi×radius²] برمی‌گرداند. ناحیه محاسبه شده از واحدهای مشابه شعاع استفاده می کند. radiusOfSphere به طور پیش فرض شعاع زمین بر حسب متر است که در این صورت مساحت بر حسب متر مربع است. عبور از یک Circle مستلزم تنظیم radius روی یک مقدار غیر منفی است. علاوه بر این، دایره نباید بیش از 100٪ از کره را پوشش دهد. و هنگام عبور از LatLngBounds ، LatLng جنوبی نمی تواند شمالی تر از LatLng شمالی باشد.
computeDistanceBetween
computeDistanceBetween(from, to[, radius])
مولفه های:
مقدار برگشتی: number
فاصله بین دو LatLng را بر حسب متر برمی گرداند. شما می توانید به صورت اختیاری یک شعاع سفارشی را مشخص کنید. شعاع به طور پیش فرض بر روی شعاع زمین است.
computeHeading
computeHeading(from, to)
مولفه های:
مقدار برگشتی: number
عنوان را از یک LatLng به LatLng دیگر برمی گرداند. سرفصل ها بر حسب درجه در جهت عقربه های ساعت از شمال در محدوده [-180,180) بیان می شوند.
computeLength
computeLength(path[, radius])
مولفه های:
مقدار برگشتی: number
طول مسیر داده شده را برمی گرداند.
computeOffset
computeOffset(from, distance, heading[, radius])
مولفه های:
ارزش بازگشتی: LatLng
LatLng حاصل از جابجایی فاصله از مبدأ در عنوان مشخص شده (به درجه در جهت عقربه های ساعت از شمال) را برمی گرداند.
computeOffsetOrigin
computeOffsetOrigin(to, distance, heading[, radius])
مولفه های:
مقدار بازگشتی: LatLng |null
هنگامی که مقصد LatLng، مترهای طی شده و عنوان اصلی ارائه شده باشد، مکان مبدا را برمی گرداند. سرفصل ها بر حسب درجه در جهت عقربه های ساعت از شمال بیان می شوند. این تابع زمانی که هیچ راه حلی در دسترس نباشد، null برمی گرداند.
computeSignedArea
computeSignedArea(loop[, radius])
مولفه های:
مقدار برگشتی: number
ناحیه علامت گذاری شده یک مسیر بسته را برمی گرداند، جایی که خلاف جهت عقربه های ساعت مثبت است، در محدوده [-2×pi×radius²، 2×pi×radius²]. ناحیه محاسبه شده از واحدهای مشابه شعاع استفاده می کند. شعاع به طور پیش فرض روی شعاع زمین بر حسب متر است که در این صورت مساحت بر حسب متر مربع است.

مساحت با استفاده از روش حمل و نقل موازی محاسبه می شود. حمل و نقل موازی در اطراف یک مسیر بسته در کره واحد با زاویه ای که برابر با مساحت محصور در مسیر است می پیچد. این ساده‌تر، دقیق‌تر و قوی‌تر از مثلث‌سازی با استفاده از Girard، l'Huilier یا Eriksson در هر مثلث است. به ویژه، از آنجایی که مثلثی نمی شود، به جز در موارد اجتناب ناپذیر زمانی که یک لبه (نه مورب) از چند ضلعی 180 درجه باز می شود، از بی ثباتی رنج نمی برد.
interpolate
interpolate(from, to, fraction)
مولفه های:
ارزش بازگشتی: LatLng
LatLng را برمی‌گرداند که کسری معین از راه بین مبدا LatLng و LatLng مقصد قرار دارد.

فضای نام پلی

google.maps.geometry . poly فضای نام google.maps.geometry . poly

توابع مفید برای محاسبات شامل چند ضلعی و چند خطی.

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

containsLocation
containsLocation(point, polygon)
مولفه های:
مقدار بازگشتی: boolean
محاسبه می کند که آیا نقطه داده شده در داخل چند ضلعی مشخص شده قرار دارد یا خیر.
isLocationOnEdge
isLocationOnEdge(point, poly[, tolerance])
مولفه های:
مقدار بازگشتی: boolean
محاسبه می کند که آیا نقطه داده شده روی یک چند خط یا نزدیک به یک چند ضلعی قرار دارد یا نه، در یک تلورانس مشخص. زمانی که اختلاف بین طول و عرض جغرافیایی نقطه ارائه شده، و نزدیکترین نقطه در لبه، کمتر از تلورانس باشد، true برمی گردد. تلورانس پیش فرض روی 10-9 درجه است.