استفاده و صورت‌حساب Maps JavaScript API

برای دیدن فهرست مطالب این صفحه، روی نماد اطلاعات اطلاعات کلیک کنید.

درخواست‌های Maps JavaScript API بسته به نوع درخواست، تماس‌هایی با واحدهای نگهداری مختلف ایجاد می‌کنند: برای مثال، بار کردن نقشه باعث راه‌اندازی واحد نگهداری «نقشه‌های پویا» می‌شود و پانوراما باعث راه‌اندازی واحد نگهداری «نمای خیابان پویا» می‌شود. فراخوانی‌های کتابخانه جاها، Maps JavaScript API و دیگر سرویس‌های جاوا اسکریپت به‌طور جداگانه قیمت‌گذاری می‌شوند. برای اطلاعات بیشتر، جزئیات SKU و فهرست‌های قیمت را در جدول زیر ببینید.

جزئیات شناسه کالا و قیمت‌گذاری برای Maps JavaScript API

جدول زیر جزئیات واحد نگهداری کالا و قیمت‌گذاری «میانای برنامه‌سازی کاربردی جاوا اسکریپت در Maps» را نشان می‌دهد.

دسته	جزئیات SKU در Maps	قیمت‌گذاری SKU
Essentials	واحد نگهداری موجودی: نقشه‌های پویا	فهرست قیمت جهانی فهرست قیمت هند
Essentials	SKU: نمای خیابان ثابت	فهرست قیمت‌گذاری جهانی فهرست قیمت‌گذاری هند
Pro	واحد نگهداری کالا: نمای خیابان پویا	فهرست قیمت‌گذاری جهانی فهرست قیمت‌گذاری هند
Pro	SKU: Elevation	فهرست قیمت جهانی فهرست قیمت هند
Pro	واحد نگهداری موجودی: Immersive Maps	فهرست قیمت‌گذاری جهانی فهرست قیمت‌گذاری هند
دسته	جزئیات شناسه کالا برای «کتابخانه جاها»، Maps JavaScript API (جدید)	قیمت‌گذاری واحد نگهداری موجودی
Essentials	واحد نگهداری کالا: درخواست‌های تکمیل خودکار	فهرست قیمت‌گذاری جهانی فهرست قیمت‌گذاری هند
Essentials	واحد نگهداری موجودی: استفاده از جلسه تکمیل خودکار	فهرست قیمت‌گذاری جهانی فهرست قیمت‌گذاری هند
Essentials	واحد نگهداری موجودی: زمین‌کدینگ	فهرست قیمت‌گذاری جهانی فهرست قیمت‌گذاری هند
Essentials	SKU: Place Details Essentials (IDs Only)	فهرست قیمت جهانی فهرست قیمت هند
Essentials	SKU: Place Details Essentials	فهرست قیمت جهانی فهرست قیمت هند
Essentials	SKU: Text Search Essentials (IDs Only)	فهرست قیمت‌گذاری جهانی فهرست قیمت‌گذاری هند
Pro	SKU: Nearby Search Pro	فهرست قیمت‌گذاری جهانی فهرست قیمت‌گذاری هند
Pro	واحد نگهداری کالا: Place Details Pro	فهرست قیمت‌گذاری جهانی فهرست قیمت‌گذاری هند
Pro	واحد نگهداری کالا: Text Search Pro	فهرست قیمت جهانی فهرست قیمت هند
Enterprise	واحد نگهداری موجودی: Nearby Search Enterprise	فهرست قیمت جهانی فهرست قیمت هند
سازمانی	SKU: Place Details Enterprise	فهرست قیمت‌گذاری جهانی فهرست قیمت‌گذاری هند
Enterprise	SKU: Place Details Enterprise + Atmosphere	فهرست قیمت‌گذاری جهانی فهرست قیمت‌گذاری هند
Enterprise	واحد نگهداری کالا: Text Search Enterprise	فهرست قیمت‌گذاری جهانی فهرست قیمت‌گذاری هند
Enterprise	واحد نگهداری کالا: Text Search Enterprise + Atmosphere	فهرست قیمت‌گذاری جهانی فهرست قیمت‌گذاری هند
Enterprise	واحد نگهداری کالا: عکس‌های جزئیات مکان	فهرست قیمت‌گذاری جهانی فهرست قیمت‌گذاری هند
دسته	جزئیات شناسه محصول Places Library, Maps JavaScript API (Legacy)	قیمت‌گذاری SKU
Essentials	SKU: Autocomplete - Per Request	فهرست قیمت‌گذاری جهانی فهرست قیمت‌گذاری هند
Essentials	SKU: تکمیل خودکار (همراه با جزئیات مکان) - هر جلسه	فهرست قیمت‌گذاری جهانی فهرست قیمت‌گذاری هند
Essentials	واحد نگهداری موجودی: داده‌های پایه کسورات اضافی: SKU: Places Details SKU: Find Place واحد نگهداری موجودی: Places - Nearby Search واحد نگهداری موجودی: Places - Text Search	فهرست قیمت جهانی فهرست قیمت هند
Essentials	واحد نگهداری موجودی: Find Place - ID only	فهرست قیمت جهانی فهرست قیمت هند
Essentials	واحد نگهداری کالا: Place Details Essentials- ID Refresh	فهرست قیمت جهانی فهرست قیمت هند
Essentials	SKU: Query Autocomplete - Per Request	فهرست قیمت‌گذاری جهانی فهرست قیمت‌گذاری هند
Pro	واحد نگهداری موجودی: تکمیل خودکار بدون «جزئیات مکان» - به‌ازای هر جلسه	فهرست قیمت جهانی فهرست قیمت هند
Pro	SKU: Find Place هزینه‌های اضافی: واحد نگهداری موجودی: داده‌های اصلی واحد نگهداری کالا: داده‌های مخاطب واحد نگهداری موجودی: داده‌های اتمسفر	فهرست قیمت‌گذاری جهانی فهرست قیمت‌گذاری هند
Pro	واحد نگهداری کالا: مکان‌ها - جستجوی اطراف کسورات اضافی: واحد نگهداری موجودی: داده‌های پایه SKU: Contact Data واحد نگهداری موجودی: داده‌های جوی	فهرست قیمت جهانی فهرست قیمت هند
Pro	واحد نگهداری موجودی: Places - Text Search کسورات اضافی: واحد نگهداری موجودی: داده‌های پایه SKU: Contact Data واحد نگهداری موجودی: داده‌های جوی	فهرست قیمت جهانی فهرست قیمت هند
Pro	SKU: جزئیات مکان‌ها هزینه‌های اضافی: واحد نگهداری موجودی: داده‌های پایه واحد نگهداری کالا: داده‌های مخاطب واحد نگهداری موجودی: داده‌های اتمسفر	فهرست قیمت جهانی فهرست قیمت هند
سازمانی	واحد نگهداری موجودی: داده‌های اتمسفر کسورات اضافی: SKU: جزئیات مکان‌ها SKU: Find Place واحد نگهداری موجودی: Places - Nearby Search واحد نگهداری موجودی: مکان‌ها - جستجوی نوشتاری	فهرست قیمت‌گذاری جهانی فهرست قیمت‌گذاری هند
سازمانی	SKU: Contact Data کسورات اضافی: SKU: جزئیات مکان‌ها SKU: Find Place واحد نگهداری کالا: مکان‌ها - جستجوی اطراف واحد نگهداری موجودی: Places - Text Search	فهرست قیمت‌گذاری جهانی فهرست قیمت‌گذاری هند
Enterprise	واحد نگهداری کالا: عکس‌های مکان‌ها	فهرست قیمت‌گذاری جهانی فهرست قیمت‌گذاری هند
دسته	کیت میانای کاربر «جاها»	قیمت‌گذاری واحد نگهداری موجودی
Essentials	واحد نگهداری موجودی: پرس‌وجوی کیت میانای کاربر «جاها»	فهرست قیمت‌گذاری جهانی فهرست قیمت‌گذاری هند
Essentials	SKU: Places UI Kit - Autocomplete Per Session	فهرست قیمت جهانی فهرست قیمت هند
Pro	SKU: Places UI Kit (Advanced)	فهرست قیمت‌گذاری جهانی فهرست قیمت‌گذاری هند
دسته	جزئیات واحد نگهداری موجودی کتابخانه Routes	قیمت‌گذاری SKU
Essentials	SKU: Routes: Compute Routes Essentials	فهرست قیمت‌گذاری جهانی فهرست قیمت‌گذاری هند
Essentials	واحد نگهداری موجودی: مسیرها: ملزومات ماتریس مسیر محاسباتی	فهرست قیمت‌گذاری جهانی فهرست قیمت‌گذاری هند
Pro	SKU: Routes: Compute Routes Pro	فهرست قیمت‌گذاری جهانی فهرست قیمت‌گذاری هند
Pro	SKU: Routes: Compute Route Matrix Pro	فهرست قیمت‌گذاری جهانی فهرست قیمت‌گذاری هند
Enterprise	SKU: Routes: Compute Routes Enterprise	فهرست قیمت‌گذاری جهانی فهرست قیمت‌گذاری هند
Enterprise	SKU: Routes: Compute Route Matrix Enterprise	فهرست قیمت‌گذاری جهانی فهرست قیمت‌گذاری هند
دسته	جزئیات شناسه محصول Routes API (قدیمی)	قیمت‌گذاری SKU
Essentials	واحد نگهداری کالا: مسیرها	فهرست قیمت جهانی فهرست قیمت هند
Essentials	واحد نگهداری کالا: Distance Matrix	فهرست قیمت‌گذاری جهانی فهرست قیمت‌گذاری هند
Pro	SKU: Directions Advanced	فهرست قیمت‌گذاری جهانی فهرست قیمت‌گذاری هند
Pro	SKU: Distance Matrix Advanced	فهرست قیمت‌گذاری جهانی فهرست قیمت‌گذاری هند

جزئیات قیمت‌گذاری کتابخانه مسیرها

کلاس‌های Route و RouteMatrix هرکدام سه SKU دارند که هزینه درخواست را تعیین می‌کنند. «واحد نگهداری موجودی» مورداستفاده برای تعیین هزینه براساس سرویسی است که استفاده می‌کنید، کلاس Route یا کلاس RouteMatrix، و ویژگی‌هایی که در درخواست استفاده می‌کنید. برای مثال:

• هزینه درخواست‌های محاسبه مسیر برای هر درخواست محاسبه می‌شود.

• درخواست‌های محاسبه ماتریس مسیر به‌ازای هر عنصر برگشتی از درخواست صورت‌حساب می‌شود. تعداد عناصر برابر است با تعداد مبدأها ضرب در تعداد مقصدها. برای مثال، اگر درخواستی حاوی دو مبدأ و سه مقصد باشد، هزینه شش عنصر برای آن درخواست صورت‌حساب می‌شود.

ویژگی‌هایی که استفاده می‌کنید تعیین می‌کند کدام دسته SKU صورت‌حساب دریافت کند:

• Essentials: برای درخواست‌هایی که فقط از ویژگی‌های پایه با حداکثر ۱۰ نقطه‌مسیر میانی استفاده می‌کنند صورت‌حساب صادر می‌شود.

• Pro: برای درخواست‌هایی که از ویژگی پیشرفته‌ای مثل TRAFFIC_AWARE یا TRAFFIC_AWARE_OPTIMAL اصلاح‌کننده‌های مسیر استفاده می‌کنند صورت‌حساب صادر می‌شود.

• سازمانی: برای درخواست‌هایی که از ویژگی سازمانی استفاده می‌کنند، مثل مسیریابی دوچرخه، صورت‌حساب صادر می‌شود.

محدودیت‌های استفاده زیر برای «جاوا اسکریپت» اعمال می‌شود.

محاسبه کردن مسیرها

• محدودیت نرخ ۳٬۰۰۰ پُرسمان در دقیقه.

• حداکثر تعداد مجاز نقطه‌مسیرهای میانی برای هر درخواست computeRoutes ۲۵ است.

محاسبه ماتریس مسیر

• حد نرخ ۳٬۰۰۰ عنصر در دقیقه است که ازطریق تعداد مبدأها ضربدر تعداد مقصدها محاسبه می‌شود.

• حداکثر تعداد مجاز مبدأ و مقصدی که می‌توانید بااستفاده از شناسه یا نشانی مکان مشخص کنید ۵۰ است.

• حداکثر تعداد مجاز کل عناصر در هر درخواست computeRouteMatrix با routingPreference تنظیم‌شده روی TRAFFIC_AWARE_OPTIMAL برابر با ۱۰۰ است.

• حداکثر تعداد کل مجاز عناصر برای هر درخواست computeRouteMatrix با travelMode تنظیم‌شده روی TRANSIT،‏ ۱۰۰ است.

• حداکثر تعداد مجاز کل عناصر در هر درخواست computeRouteMatrix درغیراین‌صورت ۶۲۵ است.

سهمیه‌ها و حدود استفاده

برای مرور و مدیریت سهمیه‌ها و حدود استفاده برای Maps JavaScript API، به سهمیه‌ها و هشدارهای سهمیه مراجعه کنید.

سهمیه‌های بار نقشه

سهمیه‌های زیر برای بارگیری‌های نقشه سه‌بعدی و دوبعدی Maps JavaScript API اعمال می‌شود:

• ۳۰٬۰۰۰ بارگیری نقشه در دقیقه برای هر پروژه
• ۳۰۰ بارگیری نقشه در دقیقه برای هر IP

حدود استفاده از کیت میانای کاربر «جاها»

«کیت میانای کاربر جاها» مشمول حدود استفاده زیر است:

• پرسشگان کیت واسط کاربر «مکان‌ها»: درخواست‌های عناصر جزئیات مکان و جستجوی مکان به ۶٬۰۰۰ پُرسمان در دقیقه در هر پروژه محدود می‌شود.

• جلسه کیت واسط کاربر «مکان‌ها»: درخواست‌های عنصر تکمیل خودکار به ۶٬۰۰۰ پُرسمان در دقیقه برای هر پروژه محدود می‌شود.

درخواست‌های اساسی به Places API و Geocoding API سهمیه پروژه Cloud شما را مصرف نمی‌کنند.

استراتژی‌های مقرون‌به‌صرفه برای Places API

این بخش روش‌هایی برای بهینه‌سازی استفاده شما و کاهش هزینه‌های مرتبط با Places API ارائه می‌دهد.

استفاده از پوشش فیلد

استفاده از پوشش فیلد تضمین می‌کند که داده‌های غیرضروری درخواست نمی‌کنید، که به کاهش تأخیر و هزینه‌های صورت‌حساب کمک می‌کند.

برای درخواست‌های «جزئیات مکان (جدید)»، «جستجوی اطراف (جدید)»، و «جستجوی نوشتاری (جدید)»، از ماسک فیلد برای مشخص کردن فهرست فیلدهایی که باید در پاسخ برگردانده شوند استفاده کنید.

سپس هزینه بالاترین SKU قابل‌اعمال برای درخواستتان از شما کسر می‌شود. برای مثال، اگر فیلدهایی را از هر دو SKU «اصول اولیه» و Pro انتخاب کنید، براساس SKU‏ Pro صورت‌حساب دریافت می‌کنید.

استفاده از قیمت‌گذاری جلسه با «جزئیات مکان (جدید)»

اگر برنامه‌های شما حجم تماس ماهانه ۱۰۰٬۰۰۱ تا ۵۰۰٬۰۰۰ یا بیشتر دارند، یا اگر کاربران بیش‌از ۱۲ درخواست تکمیل خودکار در هر جلسه ایجاد می‌کنند، Google توصیه می‌کند از جلسات با «تکمیل خودکار (جدید)» استفاده کنید. جلسه‌ها به ساده‌سازی قیمت‌گذاری کمک می‌کنند و مدل قیمت‌گذاری ثابتی برای استفاده با «تکمیل خودکار (جدید)» ارائه می‌دهند.

برای اطلاعات بیشتر، تکمیل خودکار (جدید) و قیمت‌گذاری جلسه را ببینید.

تنظیم سهمیه

محدودیت‌های سهمیه حداکثر تعداد درخواست‌های مجاز برای یک میانای برنامه‌سازی کاربردی یا سرویس خاص را در یک بازه زمانی مشخص تعریف می‌کنند. وقتی تعداد درخواست‌ها در پروژه شما به حد مجاز سهمیه می‌رسد، سرویس شما دیگر به درخواست‌ها پاسخ نمی‌دهد.

برای اصلاح مقدار سهمیه برای API خود، این مراحل را دنبال کنید:

1. در کنسول Cloud، به Google Maps Platform > سهمیه‌ها بروید.
2. میانای برنامه‌سازی کاربردی‌ای را که می‌خواهید سهمیه آن را اصلاح کنید انتخاب کنید.
3. مقدار سهمیه‌ای را که می‌خواهید تغییر دهید شناسایی کنید و آن را بااستفاده از چارگوش انتخاب انتخاب کنید.
4. روی ویرایش کلیک کنید، مقدار سهمیه جدیدی وارد کنید، و روی ارسال درخواست کلیک کنید.

مشاهده درخواست‌های افزایش سهمیه

برای مشاهده همه درخواست‌های افزایش سهمیه، ازجمله درخواست‌های قبلی و معلقه:

1. در کنسول Cloud، به Google Maps Platform > سهمیه‌ها بروید.
2. میانای برنامه‌سازی کاربردی‌ای را که می‌خواهید درخواست افزایش سهمیه آن را مشاهده کنید انتخاب کنید.
3. روی درخواست‌های افزایش کلیک کنید.

محدودیت‌های «شرایط خدمات»

برای جزئیات کامل درباره استفاده مجاز، به بخش محدودیت‌های پروانه در «شرایط خدمات Google Maps Platform» مراجعه کنید.