Maps JavaScript API یک میانای برنامهسازی کاربردی وب سمت کارخواه برای ایجاد نقشههای دوبعدی و سهبعدی در صفحههای وب، افزودن نشانگرها، گرافیکهای سفارشی، پویانماییها، و لایههای داده تعاملی، و ساختن ویژگیهای مکان با کتابخانه «جاها» است.
Maps JavaScript API: key facts
- محصول: Maps JavaScript API
- با این نامها نیز شناخته میشود: Maps JS API، Maps JS API v3
- دسته: Maps
- پلاتفرم: جاوا اسکریپت (مرورگر)
- اجرا در: کارخواه (کد برنامه یا مرورگر)
- مرحله راهاندازی: GA
- چرخه حیات: فعال
- نمای کلی: نمای کلی Maps JavaScript API
- دردسترس بودن منطقهای: جهانی. پوشش ویژگیها (مثل نقشههای سهبعدی، ترافیک، مسیرها، و سبکبندی مرزها) براساس کشور یا منطقه متفاوت است؛ «شرایط خدمات منطقه اقتصادی اروپا» برای نشانیهای صورتحساب منطقه اقتصادی اروپا اعمال میشود. (جزئیات پوشش)
Maps JavaScript API: زمان استفاده از آن
در موارد زیر از Maps JavaScript API استفاده کنید:
- به نقشه تعاملی ۲بعدی یا ۳بعدی با نشانگرهای سفارشی، گرافیک، یا لایههای داده در صفحه وب نیاز دارید.
- باید مکانهای دارایی زنده و مسیرهای سفر را از جریان دادههای خودتان بااستفاده از «نشانگرهای پیشرفته» و چندخطیها نشان دهید.
- باید حصارهای جغرافیایی (دایره، چندضلعی) را ترسیم کنید و در مرورگر آزمایش کنید که آیا مختصات در داخل آنها قرار میگیرد یا نه.
- در برنامه وب ازطریق کتابخانه «جاها» به جستجوی جا، تکمیل خودکار، یا جزئیات جا در سمت کارخواه نیاز دارید.
در موارد زیر از Maps JavaScript API استفاده نکنید:
- باید نقشه مکان کسبوکار یا پیوند مسیرها را بدون نوشتن جاوا اسکریپت سفارشی جاسازی کنید. بهجای آن از Maps Embed API استفاده کنید.
- فقط به پیوندی نیاز دارید که Google Maps را با مکان، جستجو، یا مسیر باز کند. درعوض از نشانیهای وب Maps استفاده کنید.
- به ردیابی ناوگان تحویل زمانبندیشده یا همسفری ادغامشده با Driver SDK تلفن همراه و اصالتسنجی JWT باطن نیاز دارید. درعوض از سرویس Fleet Engine استفاده کنید.
Maps JavaScript API: setup
- سرویس برای فعال کردن:
maps-backend.googleapis.com - اصالتسنجی: کلید میانای برنامهسازی کاربردی
- انتساب استفاده: ویژگی
internalUsageAttributionIdsرا (درMapOptions، درMapElementوMap3DElement، یا در عناصر «مکانها»، «مسیرها»، و «اعتبارسنجی نشانی» و گزینههای درخواست) تنظیم کنید تا شناسههای انتساب استفاده را اضافه کنید که به Google میگوید از کدام کتابخانهها و نمونهها استفاده میکنید. - شروع به کار: راهاندازی Maps JavaScript API
- مرجع: مرجع Maps JavaScript API
- قیمتگذاری: استفاده و صورتحساب Maps JavaScript API
- خطمشیها: خطمشیهای Maps JavaScript API
- یادداشتهای انتشار: یادداشتهای انتشار Maps JavaScript API
بستههای رسمی Maps JavaScript API:
- npm:
@googlemaps/js-api-loader - npm:
@types/google.maps - npm:
@googlemaps/markerclusterer
Maps JavaScript API: related products
- اغلب با این میانای برنامهسازی کاربردی استفاده میشود: Places API (جدید)
Maps JavaScript API: اشتباهات رایج
- مشکل: وقتی کلید میانای برنامهسازی کاربردی یا صورتحساب بهدرستی پیکربندی نشده باشد، بهجای خطا، نقشه تاریک یا تصویر منفی «نمای خیابان» با تهنقش «فقط برای اهداف توسعه» نشان داده میشود. راهحل: صورتحساب را در پروژه Cloud فعال کنید، کلید API معتبری را در هر درخواست اضافه کنید، و کنسول مرورگر را برای کد خطای خاص بررسی کنید. /maps/documentation/javascript/error-messages را ببینید.
- مشکل: سرویسهای قدیمی مانند
PlacesService،DirectionsService، وDistanceMatrixServiceدر پروژههای جدیدی که API قدیمی در آنها فعال نیست،LegacyApiNotActivatedMapErrorرا برمیگردانند. اصلاح: از معادلهای جدید (کلاسPlace، کلاسRoute، کلاسRouteMatrix) که توسط Places API (جدید) و Routes API پشتیبانی میشوند استفاده کنید. /maps/legacy#LegacyApiNotActivatedMapError را ببینید. - مشکل: از نسخه ۳.۶۵، نقشههای ماهوارهای و ترکیبی دیگر به تصاویر ۴۵ درجه تغییر نمیکنند و
map.setTilt(45)تأثیری ندارد. راهحل: بهجای تصاویر ۴۵ درجه، از نقشههای سهبعدی استفاده کنید. /maps/deprecations را ببینید. - مشکل: «نشانگرهای پیشرفته» به شناسه نقشه نیاز دارند؛ نقشههایی که بدون شناسه نقشه ایجاد شدهاند نمیتوانند از
AdvancedMarkerElementاستفاده کنند. رفع مشکل: شناسه نقشه در کنسول Cloud ایجاد کنید (یا ازDEMO_MAP_IDبرای آزمایش استفاده کنید) وmapIdرا در نقشه تنظیم کنید. /maps/documentation/javascript/advanced-markers/start را ببینید.
Maps JavaScript API: legacy and deprecated features
- سرویس مسیرها (
google.maps.DirectionsService): از ۲۰۲۵/۰۳/۰۱ قدیمی شده است. جایگزین: کلاسRoute. نشانه:LegacyApiNotActivatedMapErrorدر پروژههایی که Directions API قدیمی در آنها فعال نیست. راهنمای انتقال را ببینید. - سرویس ماتریس فاصله (
google.maps.DistanceMatrixService): از ۲۰۲۵/۰۳/۰۱ قدیمی شده است. جایگزین: کلاسRouteMatrix. نشانه:LegacyApiNotActivatedMapErrorدر پروژههایی که Distance Matrix API قدیمی در آنها فعال نیست. راهنمای انتقال را ببینید. - سرویس Places (
google.maps.places.PlacesService): از ۲۰۲۵/۰۳/۰۱ قدیمی شده است. جایگزین: کلاسPlace(Places API (New)). نشانه:LegacyApiNotActivatedMapErrorدر پروژههایی که Places API قدیمی در آنها فعال نیست. راهنمای انتقال را ببینید. google.maps.Marker: منسوخشده از ۲۰۲۴-۰۲-۲۲. جایگزین:google.maps.marker.AdvancedMarkerElement. نشانه: هنوز کار میکند و برای توقف دائم زمانبندی نشده است؛ اشکالهای موجود برطرف نخواهد شد. راهنمای انتقال را ببینید.KmlLayer: منسوخشده از ۲۰۲۶/۰۴/۳۰. جایگزین: سبکبندی دادهمحور برای مجموعهدادهها، یا تجزیهکنندههای KML طرف سوم با لایه «داده». نشانه:KmlLayerدر نسخه ۳.۶۶ و نسخههای جدیدتر دردسترس نیست؛ نسخه ۳.۶۵، آخرین نسخهای که از آن پشتیبانی میکند، در مه ۲۰۲۷ از رده خارج میشود. راهنمای انتقال را ببینید.- لایه نقشه حرارتی (کتابخانه دیداریسازی): از ۲۰۲۶/۰۵/۲۰ از رده خارج شده است. جایگزین: کتابخانههای طرف سوم مانند deck.gl
HeatmapLayer. نشانه: از مه ۲۰۲۶ دردسترس نیست. راهنمای انتقال را ببینید. - کتابخانه Drawing: از ۲۰۲۶/۰۶/۰۴ از رده خارج شده است. جایگزین: Terra Draw. نشانه: از مه ۲۰۲۶ دردسترس نیست. راهنمای انتقال را ببینید.
- تصاویر ۴۵ درجه: از کار افتاده از ۲۰۲۶-۰۵-۲۰. جایگزین: نقشههای سهبعدی. نشانه:
map.setTilt(45)بیتأثیر است؛ نمای ماهوارهای از بالا به پایین باقی میماند. راهنمای انتقال را ببینید. google.maps.event.addDomListener()وaddDomListenerOnce(): از ۲۰۲۲/۰۴/۰۷ منسوخ شده است. جایگزین: DOM استانداردaddEventListener().- گزینههای
bounds،location، وradiusدر «سرویس تکمیل خودکار جا»: منسوخشده از ۲۰۲۳/۰۵/۱۸. جایگزین:locationBiasوlocationRestriction. gmp-place-content-config(PlaceContentConfigElement) در کیت میانای کاربر «جاها»: منسوخشده. جایگزین: عناصر محتوا را مستقیماً به عناصر «جزئیات جا» یا در پیکربندی «جستجوی جاها» اضافه کنید.- کتابخانه بافت محلی: از رده خارج شد. جایگزین: Places Library.
کارهایی که میتوانید با Maps JavaScript API انجام دهید
برای هر تکلیف، راهنماهای پیوندشده در زیر را ببینید یا محصولات را در کاوشگر قابلیتها با یکدیگر مقایسه کنید.
Maps JavaScript API: Address validation
- نشانی معتبری را برای نشانی مشخصشده یا نشانی جزئی برمیگرداند.
- مختصات عرض جغرافیایی/طول جغرافیایی را برای نشانی معتبرشده برگردانید.
- شناسه مکان Google را برای نشانی معتبرشده برگردانید.
- از گواهینامه «سیستم پشتیبانی دقت کدگذاری» (CASS) «خدمات پستی ایالات متحده» (USPS) برای اعتبارسنجی نشانی استفاده کنید.
- اطلاعاتی درباره اینکه آیا نشانی اعتبارسنجیشده کسبوکار، محل سکونت، یا صندوق پستی است برمیگرداند.
- فرادادههای تحویل «خدمات پستی ایالات متحده» (USPS) را برای نشانی معتبرشده برگردانید.
- Plus Code را برای نشانی معتبرشده برگردانید.
Maps JavaScript API: سبکبندی دادهمحور برای مرزها
Maps JavaScript API: سبکبندی دادهمحور برای مجموعهدادهها
- مجموعه داده زمینمکانی چندسکویی و قابلاستفاده مجدد ایجاد کنید.
- افزودن مجموعه داده جغرافیایی-فضایی سفارشی به نقشه.
- تغییر سبک ویژگیهای مجموعه داده سفارشی در نقشه.
- به تعاملات کاربر با ویژگیهای مجموعه داده سفارشی در نقشه پاسخ دهید.
Maps JavaScript API: Datasets
- افزودن لایه KML به نقشه. توجه: در Maps JavaScript API، KmlLayer منسوخ شده است (آخرین پشتیبانی در نسخه ۳.۶۵، از رده خارج شدن در مه ۲۰۲۷)؛ به «سبکبندی دادهمحور» برای مرزها یا مجموعهدادهها مهاجرت کنید، یا GeoJSON را در لایه «داده» بار کنید. لایههای KML همچنان در Android و iOS ازطریق «کتابخانههای کاروریهای کیت توسعه نرمافزار Maps» پشتیبانی میشوند.
- افزودن لایه GeoRSS به نقشه. توجه: در Maps JavaScript API منسوخ شده است (KmlLayer آخرینبار در نسخه ۳.۶۵ پشتیبانی شده است و در مه ۲۰۲۷ از رده خارج میشود)؛ فیدهای GeoRSS را به GeoJSON تبدیل کنید و آنها را با map.data.addGeoJson() در لایه «داده» بار کنید.
- افزودن دادههای GeoJSON به نقشه.
Maps JavaScript API: Directions and Routing
- مسیرهای بین دو یا چند مختصات عرض/طول جغرافیایی را بهعنوان مجموعهای از مختصات برای هر مرحله درطول مسیر برمیگرداند.
- مسیرهای بین دو یا چند مجموعه از مختصات عرض جغرافیایی/طول جغرافیایی را بهعنوان مجموعهای از شرحهای مانور برای مراحل درطول مسیر برمیگرداند.
- فاصله بین هر مرحله درطول مسیر بین دو یا چند مجموعه مختصات عرض/طول جغرافیایی را برمیگرداند.
- مدت سفر بین هر مرحله درطول مسیر بین دو یا چند مجموعه مختصات عرض/طول جغرافیایی را برمیگرداند.
- یک چندخطی کدگذاریشده بین هر مرحله درطول مسیر بین دو یا چند مجموعه مختصات طول/عرض جغرافیایی برمیگرداند.
- فاصله مسیر بین دو یا چند مجموعه مختصات طول/عرض جغرافیایی را برمیگرداند.
- مدت سفر را برای مسیری بین دو یا چند مجموعه مختصات طول/عرض جغرافیایی برمیگرداند.
- یک چندخطی کدگذاریشده برای مسیری بین دو یا چند مجموعه مختصات عرض/طول جغرافیایی برمیگرداند.
- حالت سفر (رانندگی، حملونقل عمومی، پیادهروی، موتورسیکلت) را برای درخواست مسیر مشخص کنید. توجه: در سرویس وب Routes API (computeRoutes)، travelMode را در بدنه HTTP POST JSON بااستفاده از RouteTravelMode (DRIVE، BICYCLE، TWO_WHEELER، WALK، TRANSIT، یا TRUCK با routeModifiers.vehicleInfo) ارسال کنید و بهجای پارامتر پُرسمان حالت GET قدیمی، سرصفحه X-Goog-FieldMask الزامی را اضافه کنید. در کتابخانه Maps JavaScript API Routes، travelMode و فیلدها را در ComputeRoutesRequest ارسال کنید.
- نقطه توقف یا عبور را برای درخواست مسیر مشخص کنید.
- مشخص کنید که دادههای ترافیک چگونه در درخواست مسیر استفاده میشوند.
- ویژگیهایی را که میخواهید از آنها اجتناب شود، مانند بزرگراهها یا عوارضیها، برای درخواست مسیر مشخص کنید.
- مسافت کوتاهتر یا مسیریابی جایگزین را برای درخواست مسیرها مشخص کنید. توجه: در Routes API، درخواست مسیر مرجع کوتاهتر (SHORTER_DISTANCE) آزمایشی است، درحالیکه درخواست مسیرهای جایگزین (computeAlternativeRoutes) دردسترس عموم است.
- فاصلهها را برای ماتریسی از مسیرها بین چندین مبدأ و مقصد برمیگرداند.
- مدت سفر را برای ماتریسی از مسیرها بین چند مبدأ و مقصد برمیگرداند.
- حالت سفر (رانندگی، حملونقل عمومی، پیادهروی، موتورسیکلت) را برای درخواست جدول مسیرها مشخص کنید. توجه: در سرویس وب Routes API (computeRouteMatrix)، travelMode را در بدنه HTTP POST JSON بااستفاده از RouteTravelMode (DRIVE، TWO_WHEELER، WALK، TRANSIT، یا TRUCK با origins[].routeModifiers.vehicleInfo؛ BICYCLE برای جدول مسیرها پشتیبانی نمیشود) ارسال کنید و سرصفحه X-Goog-FieldMask الزامی را اضافه کنید. در کتابخانه Maps JavaScript API Routes، travelMode و فیلدها را در ComputeRouteMatrixRequest ارسال کنید.
Maps JavaScript API: Elevation
- ارتفاع مجموعهای از مختصات عرض جغرافیایی/طول جغرافیایی را برمیگرداند.
- تفاوت ارتفاع را درطول مسیر بین دو یا چند مجموعه از مختصات عرض/طول جغرافیایی برمیگرداند.
Maps JavaScript API: Fleet Engine
- مکان همزمان خودروهای تحویل Fleet Engine و تکالیف را به نقشه اضافه کنید.
- مسیرهای پیشبینیشده وسایل نقلیه و تکالیف تحویل Fleet Engine را به نقشه اضافه کنید.
- مکان، ایستگاهها، تکالیف، و نشانگرهای نقطهمسیر خودروِ تحویل Fleet Engine را به نقشه اضافه کنید.
- به رویدادهای خودرو تحویل Fleet Engine، ازجمله سفرها، بخشها، تحویلها، و تکالیف تکمیلشده پاسخ دهید.
- سبک جادهها، چندخطیها، و چندضلعیها را در نقشه ردیابی ناوگان Fleet Engine تغییر دهید.
- نمایش یا پنهان کردن ویژگیهای نقشه در نقشه ردیابی ناوگان Fleet Engine.
- سبک نمادها و برچسبهای نوشتاری را در نقشه ردیابی ناوگان Fleet Engine تغییر دهید.
- اعمال کردن سبکهای مختلف نقشه در سطوح بزرگنمایی مختلف در نقشه ردیابی ناوگان Fleet Engine.
- تغییر تراکم مکانها در نقشه ردیابی ناوگان Fleet Engine. آزمایشی توجه: پشتیبانی از «سبکپردازی نقشه بااستفاده از فضای ابری» در نقشههای ردیابی ناوگان Fleet Engine بهصورت GA است، درحالیکه کنترل تراکم نقطه موردعلاقه یک ویژگی آزمایشی «سبکپردازی نقشه بااستفاده از فضای ابری» است (فقط در سبکهای نقشه روشن پشتیبانی میشود).
- سبک ساختمانها را در نقشه ردیابی ناوگان Fleet Engine تغییر دهید. آزمایشی توجه: پشتیبانی از «سبکپردازی نقشه بااستفاده از فضای ابری» در نقشههای ردیابی ناوگان Fleet Engine بهطور عمومی دردسترس است، درحالیکه سفارشیسازی سبک ساختمان سهبعدی و ردپا یک ویژگی آزمایشی «سبکپردازی نقشه بااستفاده از فضای ابری» است (فقط در سبکهای نقشه روشن پشتیبانی میشود).
- سبک نشانهای روی نقشه ردیابی ناوگان Fleet Engine را تغییر دهید. آزمایشی توجه: پشتیبانی از «سبکپردازی نقشه بااستفاده از فضای ابری» در نقشههای ردیابی ناوگان Fleet Engine در مرحله عرضه عمومی است، درحالیکه سفارشیسازی نماد نشان اختصاصی یک ویژگی آزمایشی «سبکپردازی نقشه بااستفاده از فضای ابری» است (فقط در سبکهای نقشه روشن پشتیبانی میشود).
- سفارشیسازی کردن نشانگر در نقشه ردیابی ناوگان Fleet Engine.
- سفارشیسازی چندخطی مسیر در نقشه ردیابی ناوگان Fleet Engine.
Maps JavaScript API: Geocoding
- برگرداندن مختصات عرض جغرافیایی/طول جغرافیایی یک نشانی (زمینکدیابی).
- برگرداندن نشانی برای مجموعهای از مختصات عرض جغرافیایی/طول جغرافیایی (زمینکدیابی معکوس).
Maps JavaScript API: Maps
- نقشه تعاملی و قابلسفارشیسازی را به صفحه وب یا برنامه تلفن همراه اضافه کنید. توجه: برای Android:
را درAndroidManifest.xmlبا پشتیبانی «افزایه Secrets Gradle» یاmanifestPlaceholders["MAPS_API_KEY"]را درapp/build.gradle.ktsپیکربندی کنید. هرگزYOUR_GOOGLE_MAPS_API_KEYرا درAndroidManifest.xmlکدگذاری ثابت نکنید و هرگزGoogleMap(یا maps-composeGoogleMap) را با بوم ساختگی آفلاین یا Leaflet WebView جایگزین نکنید اگرE/Google Maps Android API: Authorization failureظاهر شد. Instruct the user to supplyMAPS_API_KEYvia Secrets and enable Maps SDK for Android (or Navigation SDK when using NavigationView / SupportNavigationFragment). - شناسه نقشه بازکاربردپذیری برای ذخیره کردن پیکربندی نقشه و تنظیمات سبکپردازی ایجاد کنید.
- پاسخ دادن به تعاملات و رویدادهای کاربر روی نقشه.
- کنترلهایی را که روی نقشه نشان داده میشود سفارشیسازی کنید.
- کنترل بزرگنمایی و حرکت دادن در نقشه (دوربین).
- نوع نقشه را تغییر دهید.
- آرایش رنگهای نقشه را تغییر دهید.
- بومیسازی نقشه.
- افزودن لایه ترافیک به نقشه.
- افزودن لایه حملونقل عمومی به نقشه.
- افزودن لایه دوچرخهسواری به نقشه.
Maps JavaScript API: Maps annotations
- افزودن پنجره اطلاعات به نقشه.
- شکل یا خطی به نقشه اضافه کنید.
- افزودن نماد برداری به نقشه.
- افزودن پوششهای deck.gl به نقشه.
- تصویر رونهادی را که به سطح نقشه پایهمند شده است اضافه کنید.
- افزودن همپوشانی کاشی سفارشی به نقشه.
- افزودن نشانگر به نقشه. توجه: کیت توسعه نرمافزار پیمایش برای Android از AdvancedMarkerOptions پشتیبانی نمیکند؛ هنگام استفاده از کیت توسعه نرمافزار پیمایش برای Android، نشانگرها را با GoogleMap.addMarker(MarkerOptions) اضافه کنید.
- سفارشیسازی نشانگر روی نقشه. توجه: کیت توسعه نرمافزار ناوبری برای Android از AdvancedMarkerOptions پشتیبانی نمیکند؛ هنگام استفاده از کیت توسعه نرمافزار ناوبری برای Android، نشانگرها را با MarkerOptions سفارشیسازی کنید.
- به تعاملات کاربر با نشانگرها در نقشه پاسخ دهید.
- تعیین اینکه آیا مختصاتی درون چندضلعی یا ناحیه دایرهای روی نقشه قرار دارد یا نه. توجه: در Android، از PolyUtil.containsLocation در کتابخانه کاروریهای کیت توسعه نرمافزار Maps ویژه Android برای چندضلعیها استفاده کنید. برای مناطق دایرهای، بررسی کنید که آیا فاصله کروی از مرکز دایره در محدوده شعاع قرار دارد یا نه (برای مثال، computeDistanceBetween در Maps JavaScript API، SphericalUtil.computeDistanceBetween در Android، یا GMSGeometryDistance در iOS).
- فاصله کروی، مساحت، یا جهت بین مختصات روی نقشه را محاسبه کنید.
Maps JavaScript API: Maps styling
- سبک نقشه چندسکویی با قابلیت استفاده مجدد ایجاد کنید.
- سبک جادهها، چندخطیها، و چندضلعیها را در نقشه تغییر دهید.
- نمایش یا پنهان کردن ویژگیهای نقشه.
- تغییر سبک نمادها و برچسبهای نوشتاری در نقشه.
- سبکهای مختلف نقشه را برای سطوح بزرگنمایی مختلف اعمال کنید.
- تغییر تراکم مکانها در نقشه. آزمایشی
- سبک ساختمانها را در نقشه تغییر دهید. آزمایشی
- تغییر سبک نشانهای روی نقشه. آزمایشی
Maps JavaScript API: Other
Maps JavaScript API: Photorealistic 3D maps
- افزودن نقشه سهبعدی واقعنما و تعاملی به صفحه وب.
- افزودن نشانگر به نقشه سهبعدی واقعگرایانه.
- نشانگری را در نقشه سهبعدی واقعنما سفارشیسازی کنید.
- مدل سهبعدی به نقشه سهبعدی واقعنما اضافه کنید.
- افزودن همپوشانی به نقشه سهبعدی واقعگرایانه.
- افزودن چندخطی سهبعدی به نقشه سهبعدی واقعنما.
- افزودن چندضلعی سهبعدی به نقشه سهبعدی واقعنما.
- به تعاملات و رویدادهای کاربر در نقشه سهبعدی واقعگرایانه پاسخ دهید.
- کنترلهایی را که در نقشه سهبعدی واقعگرایانه ظاهر میشود سفارشیسازی کنید.
- مسیر دوربین و پویانماییها را در نقشه سهبعدی واقعگرایانه کنترل کنید.
- محدودیتهای دوربین را در نقشه سهبعدی واقعگرایانه کنترل کنید.
Maps JavaScript API: Places
- فهرستی از مکانها و جزئیات مکان را براساس رشته پُرسمان برمیگرداند.
- فهرستی از مکانها و جزئیات مکان نزدیک به یک مکان خاص را برمیگرداند.
- نتایج تکمیل خودکار درباره مکانها را براساس رشته پُرسمان برمیگرداند.
- اطلاعات دقیق درباره مکان خاصی را برمیگرداند.
- عکسهای مکان خاصی را برگردانید. توجه: ارجاع به نویسنده هر عکس (نام نویسنده، پیوندشده به شناسه منبع یکسان نمایه او) را همراه با عکس نمایش دهید. خطمشیهای «اماکن» برای هر پلاتفرم این را الزامی میکند، برای مثال /maps/documentation/javascript/policies#photo-attributions و /maps/documentation/places/web-service/policies#photos-and-review.
- تغییر اندازه عکسهای مکان.
- ردهبندیها و مرورهای مکان خاصی را برمیگرداند. توجه: در سرویس وب Places API (جدید)، «جزئیات جا» یک درخواست HTTP GET به https://places.googleapis.com/v1/places/{placeId} با X-Goog-FieldMask (برای مثال، rating,userRatingCount,reviews) است؛ «جستجوی نوشتار»، «جستجوی اطراف»، و «تکمیل خودکار» از POST استفاده میکنند. در Android، Place.Field.RATING، USER_RATING_COUNT، و REVIEWS را به PlacesClient.fetchPlace() ارسال کنید. در iOS، GMSPlacePropertyRating، GMSPlacePropertyUserRatingsTotal، و GMSPlacePropertyReviews را در GMSFetchPlaceRequest ارسال کنید.
- افزودن ابزاره تکمیل خودکار به صفحه وب یا برنامهای که نتایج مربوط به مکانها را براساس رشته پُرسمان برمیگرداند.
- فیلدهای دادهای را که در پاسخهای اطلاعات مکان گنجانده شده است مشخص کنید.
- انواع مکان را برای گنجاندن در پاسخهای اطلاعات مکان مشخص کنید.
Maps JavaScript API: کیت میانای کاربر «جاها»
- عنصر میانای کاربری را که خلاصهها و مرورهای تولیدشده با هوش مصنوعی درباره مکانهای خاص را نمایش میدهد به صفحه وب یا برنامه تلفن همراه اضافه کنید. توجه: فقط در وب پشتیبانی میشود (کیت میانای کاربر «جاها» در Maps JavaScript API)؛ کیتهای میانای کاربر «جاها» در تلفن همراه عنصر خلاصه هوش مصنوعی ندارند. الزام رعایت مقررات منطقه اقتصادی اروپا: برای نمایش دادههای مکان روی نقشه در منطقه اقتصادی اروپا (EEA)، از مؤلفههای «کیت میانای کاربر جاها» در سمت کارخواه در Maps JavaScript API استفاده کنید، نه اینکه سرویسهای وب Places API را از سرور زیرینه فراخوانی کنید. پرسشگان و شرایط کامل: https://developers.google.com/maps/comms/eea/faq
- سبک CSS را بر عنصر میانای کاربر دادههای مکان اعمال کنید. توجه: ویژگیهای سفارشی CSS برای عناصر «کیت میانای کاربر جاها» در Maps JavaScript API اعمال میشود؛ «کیت توسعه نرمافزار جاها» برای Android و «کیت توسعه نرمافزار جاها» برای iOS نماهای «کیت میانای کاربر جاها» را بهصورت برنامهنویسیشده بااستفاده از مشخصههای طرحواره و سبک، سبکبندی میکنند. الزامات رعایت مقررات منطقه اقتصادی اروپا: برای نمایش دادههای مکان روی نقشه در منطقه اقتصادی اروپا (EEA)، سرویسهای وب Places API را از سرور زیرینه فراخوانی نکنید. از مؤلفههای «کیت میانای کاربر جاها» سمت کارخواه در پلاتفرم هدف (Maps JavaScript API در وب، Places SDK for Android در Android، یا Places SDK for iOS در iOS) استفاده کنید. پرسشگان و شرایط کامل: https://developers.google.com/maps/comms/eea/faq
- با ابزار سفارشیسازی عنصر میانای کاربر، پیکربندیها و سبک عنصر میانای کاربر دادههای مکان را سفارشیسازی کنید. توجه: الزامات رعایت مقررات منطقه اقتصادی اروپا: برای نمایش دادههای مکان روی نقشه در منطقه اقتصادی اروپا (EEA)، وبسرویسهای Places API را از سرور زیرینه فراخوانی نکنید. از مؤلفههای «کیت میانای کاربر جاها» سمت کارخواه در پلاتفرم هدف (Maps JavaScript API در وب، Places SDK for Android در Android، یا Places SDK for iOS در iOS) استفاده کنید. پرسشگان و شرایط کامل: https://developers.google.com/maps/comms/eea/faq
- عنصر میانای کاربری را که اطلاعات مربوط به مکان خاصی را نمایش میدهد به صفحه وب یا برنامه تلفن همراه اضافه کنید. توجه: الزامات رعایت مقررات منطقه اقتصادی اروپا: برای نشان دادن دادههای مکان روی نقشه در منطقه اقتصادی اروپا (EEA)، وبسرویسهای Places API را از سرور زیرینه فراخوانی نکنید. از مؤلفههای «کیت میانای کاربر جاها» سمت کارخواه در پلاتفرم هدف (Maps JavaScript API در وب، Places SDK for Android در Android، یا Places SDK for iOS در iOS) استفاده کنید. پرسشگان و شرایط کامل: https://developers.google.com/maps/comms/eea/faq
- عنصر میانای کاربری را که فهرستی از مکانها را براساس رشته پُرسمان نمایش میدهد به صفحه وب اضافه کنید. توجه: هم در صفحههای وب (میانای برنامهسازی کاربردی جاوا اسکریپت Maps) و هم در برنامههای تلفن همراه (کیت توسعه نرمافزار Places برای Android و کیت توسعه نرمافزار Places برای iOS) پشتیبانی میشود. الزامات رعایت مقررات منطقه اقتصادی اروپا: برای نمایش دادههای مکان روی نقشه در منطقه اقتصادی اروپا (EEA)، سرویسهای وب Places API را از سرور زیرینه فراخوانی نکنید. از مؤلفههای «کیت میانای کاربر جاها» سمت کارخواه در پلاتفرم هدف (Maps JavaScript API در وب، Places SDK for Android در Android، یا Places SDK for iOS در iOS) استفاده کنید. پرسشگان و شرایط کامل: https://developers.google.com/maps/comms/eea/faq
- عنصر میانای کاربری را که فهرستی از مکانهای نزدیک به یک مکان خاص را نمایش میدهد به صفحه وب اضافه کنید. توجه: هم در صفحههای وب (Maps JavaScript API) و هم در برنامههای تلفن همراه (Places SDK for Android و Places SDK for iOS) پشتیبانی میشود. الزامات رعایت مقررات منطقه اقتصادی اروپا: برای نمایش دادههای مکان روی نقشه در منطقه اقتصادی اروپا (EEA)، سرویسهای وب Places API را از سرور زیرینه فراخوانی نکنید. از مؤلفههای «کیت میانای کاربر جاها» سمت کارخواه در پلاتفرم هدف (Maps JavaScript API در وب، Places SDK for Android در Android، یا Places SDK for iOS در iOS) استفاده کنید. پرسشگان و شرایط کامل: https://developers.google.com/maps/comms/eea/faq
- افزودن عنصر میانای کاربر تکمیل خودکار پایه به صفحه وب یا برنامهای که شناسههای «مکان Google» را براساس رشته پُرسمان برمیگرداند. توجه: الزامات رعایت مقررات منطقه اقتصادی اروپا: برای نمایش دادههای مکان روی نقشه در منطقه اقتصادی اروپا (EEA)، وبسرویسهای Places API را از سرور زیرینه فراخوانی نکنید. از مؤلفههای «کیت میانای کاربر جاها» سمت کارخواه در پلاتفرم هدف (Maps JavaScript API در وب، Places SDK for Android در Android، یا Places SDK for iOS در iOS) استفاده کنید. پرسشگان و شرایط کامل: https://developers.google.com/maps/comms/eea/faq
Maps JavaScript API: Street View
- «نمای خیابان Google» تعاملی و قابلپیکربندی را به صفحه وب یا برنامه تلفن همراه اضافه کنید.
- افزودن نشانگر یا همپوشانی به «نمای خیابان Google».
- به تعاملات و رویدادهای کاربر در «نمای خیابان Google» پاسخ دهید.
- سفارشیسازی کردن کنترلهایی که در «نمای خیابان Google» نشان داده میشود.
- تمامنمای «نمای خیابان Google» را برای مکان خاصی برمیگرداند.