Maps JavaScript API یک میانای برنامهسازی کاربردی وب سمت کارخواه است که به شما امکان میدهد نقشههایی برای نمایش مکانها در هر نقطهای از جهان ایجاد کنید، گرافیکها، پویانماییها، و لایههای داده سفارشی تعاملی خودتان را اضافه کنید، و بااستفاده از Places API در Maps JavaScript API، ویژگیهای آگاه از مکان ایجاد کنید. با Maps JavaScript API میتوانید:
- نقشههای دوبعدی و سهبعدی ایجاد کنید تا مکانها را در هرجای دنیا نشان دهید.
- نشانگرهای قابلسفارشیسازی را برای نشان دادن مکانها روی نقشه اضافه کنید.
- از کتابخانه «جاها» برای دریافت دادههای مکان بیشاز ۲۰۰ میلیون مکان استفاده کنید.
- سبک و رنگهای نقشه را سفارشیسازی کنید.
- لایههای داده سفارشی تعاملی خودتان را اضافه کنید.
- مرزهای اداری را نمایش دهید و آنها را تعاملی کنید.
- گرافیکهای دوبعدی و سهبعدی سفارشی و محتوای پویانماییشده به نقشههایتان اضافه کنید.
انتخاب میانای برنامهسازی کاربردی مناسب برای مورد استفاده شما
نمونههای زیر نشان میدهند که از کدام محصولات و کتابخانههای Google Maps Platform برای سناریوهای رایج برنامه وب استفاده کنید:
- نقشه تماس و مسیرهای وبسایت: برای جاسازی نقشه مکان کسبوکار یا پیوند مسیرها بدون نوشتن جاوا اسکریپت سفارشی، از Maps Embed API یا Maps URLs استفاده کنید.
- ردیابی دارایی و مکان زنده: برای نمایش مختصات GPS زنده و مسیرهای سفر از پایگاه داده خودتان یا جاریسازی همزمان (مثل Cloud Firestore یا WebSockets)، از Maps JavaScript API با نشانگرهای پیشرفته (مرجع
AdvancedMarkerElement) و چندخطیها (مرجعPolyline) استفاده کنید. Fleet Engine را برای ناوگانهای تحویل زمانبندیشده و همسفری که کیت توسعه نرمافزار Driver تلفن همراه و OAuth یا JSON Web Tokens (JWTs) را ادغام میکنند رزرو کنید. - برنامهریزی و اعزام مسیر: از
کتابخانه
مسیرها استفاده کنید.
- برای محاسبه مسیر با توقفها، مدت سفر، مسافت، و عوارض،
و ترسیم آن روی نقشه، از
Route.computeRoutes()استفاده کنید. - برای پیدا کردن نزدیکترین راننده، خودرو، یا انبار در چندین مبدأ و مقصد، از
RouteMatrix.computeRouteMatrix()استفاده کنید. - برای زمانبندی چندین خودرو با پنجرههای زمانی در سرور خود، از Route Optimization API استفاده کنید.
- برای محاسبه مسیر با توقفها، مدت سفر، مسافت، و عوارض،
و ترسیم آن روی نقشه، از
- مکانیابهای فروشگاه و نقشههای محل: برای نمایش فروشگاهها،
محلها، یا شعبهها روی نقشه با سنجاقها و فیلترهای سفارشی، از
نشانگرهای پیشرفته
(مرجع
AdvancedMarkerElement) با کتابخانه جاها برای یافتن جاها و بار کردن جزئیات آنها استفاده کنید. - شعاع حصار جغرافیایی و منطقه امن روی نقشه: برای ترسیم
محیطهای دایرهای یا چندضلعی و آزمایش اینکه آیا مختصات در داخل
آنها قرار میگیرد یا نه (به مرزهای حصار جغرافیایی و منطقه امن مراجعه کنید)، از
دایرهها
(مرجع
Circle)، چندضلعیها (مرجعPolygon)، و کتابخانه هندسه (containsLocation()برای مهار وcomputeDistanceBetween()برای فاصله به متر) استفاده کنید.
میاناهای برنامهسازی کاربردی قدیمی و جایگزینهای آنها
-
DirectionsServiceوDistanceMatrixServiceاز ۲۵ فوریه ۲۰۲۶ منسوخ شدهاند. درعوض ازRouteوRouteMatrixاستفاده کنید. google.maps.Markerاز ۲۱ فوریه ۲۰۲۴ منسوخ شده است. درعوض ازAdvancedMarkerElementاستفاده کنید.PlacesServiceاز ۱ مارس ۲۰۲۵ برای مشتریان جدید دردسترس نیست. درعوض از کلاسPlaceاستفاده کنید.
قدم بعدی چیست
دیدن کد نمونه برای ویژگیهای Maps