هشدار امنیتی : ما از یک مشکل امنیتی آگاه شده‌ایم که ممکن است وب‌سایت‌هایی را که از کتابخانه‌های شخص ثالث خاصی استفاده می‌کنند (از جمله polyfill.io) تحت تأثیر قرار دهد. این مشکل گاهی اوقات می‌تواند بازدیدکنندگان را بدون اطلاع یا اجازه صاحب وب‌سایت از وب‌سایت مورد نظر دور کند. بسیاری از نمونه‌های جاوا اسکریپت ما قبلاً شامل اعلان اسکریپت polyfill.io بودند. ما این را از نمونه های خود حذف کرده ایم. اگر از نمونه های جاوا اسکریپت ما که حاوی این اعلان هستند استفاده کرده اید، توصیه می کنیم اعلان را حذف کنید.

اطلاعیه : سبک نقشه پایه جدید به زودی به پلتفرم نقشه های گوگل می آید. این به‌روزرسانی برای استایل نقشه شامل یک پالت رنگی پیش‌فرض جدید، پین‌های مدرن شده و بهبودهایی در تجربه‌ها و قابلیت استفاده از نقشه است. همه سبک‌های نقشه به‌طور خودکار در مارس 2025 به‌روزرسانی می‌شوند. برای اطلاعات بیشتر در مورد در دسترس بودن و نحوه انتخاب زودتر، به سبک نقشه جدید برای پلتفرم Google Maps مراجعه کنید.

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

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)` مولفه های: `path` : `Array < LatLng \| LatLngLiteral >\| MVCArray < LatLng \| LatLngLiteral >` مقدار بازگشتی: `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])` مولفه های: `path` : `Array < LatLng \| LatLngLiteral >\| MVCArray < LatLng \| LatLngLiteral >\| Circle \| CircleLiteral \| LatLngBounds \| LatLngBoundsLiteral` `radiusOfSphere` : `number optional` مقدار برگشتی: `number` ناحیه بدون علامت یک مسیر بسته را در محدوده [0, 2×pi×radius²] برمی‌گرداند. ناحیه محاسبه شده از واحدهای مشابه شعاع استفاده می کند. `radiusOfSphere` به طور پیش فرض شعاع زمین بر حسب متر است که در این صورت مساحت بر حسب متر مربع است. عبور از یک `Circle` مستلزم تنظیم `radius` روی یک مقدار غیر منفی است. علاوه بر این، دایره نباید بیش از 100٪ از کره را پوشش دهد. و هنگام عبور از `LatLngBounds` ، LatLng جنوبی نمی تواند شمالی تر از LatLng شمالی باشد.
`computeDistanceBetween`	`computeDistanceBetween(from, to[, radius])` مولفه های: `from` : `LatLng \| LatLngLiteral` `to` : `LatLng \| LatLngLiteral` `radius` : `number optional` مقدار برگشتی: `number` فاصله بین دو LatLng را بر حسب متر برمی گرداند. شما می توانید به صورت اختیاری یک شعاع سفارشی را مشخص کنید. شعاع به طور پیش فرض بر روی شعاع زمین است.
`computeHeading`	`computeHeading(from, to)` مولفه های: `from` : `LatLng \| LatLngLiteral` `to` : `LatLng \| LatLngLiteral` مقدار برگشتی: `number` عنوان را از یک LatLng به LatLng دیگر برمی گرداند. سرفصل ها بر حسب درجه در جهت عقربه های ساعت از شمال در محدوده [-180,180) بیان می شوند.
`computeLength`	`computeLength(path[, radius])` مولفه های: `path` : `Array < LatLng \| LatLngLiteral >\| MVCArray < LatLng \| LatLngLiteral >` `radius` : `number optional` مقدار برگشتی: `number` طول مسیر داده شده را برمی گرداند.
`computeOffset`	`computeOffset(from, distance, heading[, radius])` مولفه های: `from` : `LatLng \| LatLngLiteral` `distance` : `number` `heading` : `number` `radius` : `number optional` ارزش بازگشتی: `LatLng` LatLng حاصل از جابجایی فاصله از مبدأ در عنوان مشخص شده (به درجه در جهت عقربه های ساعت از شمال) را برمی گرداند.
`computeOffsetOrigin`	`computeOffsetOrigin(to, distance, heading[, radius])` مولفه های: `to` : `LatLng \| LatLngLiteral` `distance` : `number` `heading` : `number` `radius` : `number optional` مقدار بازگشتی: `LatLng \|null` هنگامی که مقصد LatLng، مترهای طی شده و عنوان اصلی ارائه شده باشد، مکان مبدا را برمی گرداند. سرفصل ها بر حسب درجه در جهت عقربه های ساعت از شمال بیان می شوند. این تابع زمانی که هیچ راه حلی در دسترس نباشد، `null` برمی گرداند.
`computeSignedArea`	`computeSignedArea(loop[, radius])` مولفه های: `loop` : `Array < LatLng \| LatLngLiteral >\| MVCArray < LatLng \| LatLngLiteral >` `radius` : `number optional` مقدار برگشتی: `number` ناحیه علامت گذاری شده یک مسیر بسته را برمی گرداند، جایی که خلاف جهت عقربه های ساعت مثبت است، در محدوده [-2×pi×radius²، 2×pi×radius²]. ناحیه محاسبه شده از واحدهای مشابه شعاع استفاده می کند. شعاع به طور پیش فرض روی شعاع زمین بر حسب متر است که در این صورت مساحت بر حسب متر مربع است. مساحت با استفاده از روش حمل و نقل موازی محاسبه می شود. حمل و نقل موازی در اطراف یک مسیر بسته در کره واحد با زاویه ای که برابر با مساحت محصور در مسیر است می پیچد. این ساده‌تر، دقیق‌تر و قوی‌تر از مثلث‌سازی با استفاده از Girard، l'Huilier یا Eriksson در هر مثلث است. به ویژه، از آنجایی که مثلثی نمی شود، به جز در موارد اجتناب ناپذیر زمانی که یک لبه (نه مورب) از چند ضلعی 180 درجه باز می شود، از بی ثباتی رنج نمی برد.
`interpolate`	`interpolate(from, to, fraction)` مولفه های: `from` : `LatLng \| LatLngLiteral` `to` : `LatLng \| LatLngLiteral` `fraction` : `number` ارزش بازگشتی: `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)` مولفه های: `point` : `LatLng \| LatLngLiteral` `polygon` : `Polygon` مقدار بازگشتی: `boolean` محاسبه می کند که آیا نقطه داده شده در داخل چند ضلعی مشخص شده قرار دارد یا خیر.
`isLocationOnEdge`	`isLocationOnEdge(point, poly[, tolerance])` مولفه های: `point` : `LatLng \| LatLngLiteral` `poly` : `Polygon \| Polyline` `tolerance` : `number optional` مقدار بازگشتی: `boolean` محاسبه می کند که آیا نقطه داده شده روی یک چند خط یا نزدیک به یک چند ضلعی قرار دارد یا نه، در یک تلورانس مشخص. زمانی که اختلاف بین طول و عرض جغرافیایی نقطه ارائه شده، و نزدیکترین نقطه در لبه، کمتر از تلورانس باشد، `true` برمی گردد. تلورانس پیش فرض روی ^10-9 درجه است.

روش های استاتیک

containsLocation

containsLocation(point, polygon)

مولفه های:

point : LatLng | LatLngLiteral
polygon : Polygon

مقدار بازگشتی: boolean

محاسبه می کند که آیا نقطه داده شده در داخل چند ضلعی مشخص شده قرار دارد یا خیر.

isLocationOnEdge

isLocationOnEdge(point, poly[, tolerance])

مولفه های:

point : LatLng | LatLngLiteral
poly : Polygon | Polyline
tolerance : number optional

مقدار بازگشتی: boolean

محاسبه می کند که آیا نقطه داده شده روی یک چند خط یا نزدیک به یک چند ضلعی قرار دارد یا نه، در یک تلورانس مشخص. زمانی که اختلاف بین طول و عرض جغرافیایی نقطه ارائه شده، و نزدیکترین نقطه در لبه، کمتر از تلورانس باشد، true برمی گردد. تلورانس پیش فرض روی ^10-9 درجه است.