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

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

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

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

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

دسته	جزئیات SKU در Maps	قیمت‌گذاری SKU
Essentials	واحد نگهداری موجودی: Dynamic Maps	فهرست قیمت جهانی فهرست قیمت هند
Essentials	SKU: Static Street View	فهرست قیمت جهانی فهرست قیمت هند
Pro	SKU: Dynamic Street View	فهرست قیمت جهانی فهرست قیمت هند
Pro	SKU: Elevation	فهرست قیمت جهانی فهرست قیمت هند
Pro	SKU: Immersive Maps	فهرست قیمت جهانی فهرست قیمت هند
دسته	جزئیات شناسه کالا برای «کتابخانه جاها»، Maps JavaScript API (جدید)	قیمت‌گذاری SKU
Essentials	واحد نگهداری موجودی: درخواست‌های تکمیل خودکار	فهرست قیمت جهانی فهرست قیمت هند
Essentials	واحد نگهداری موجودی: Autocomplete Session Usage	فهرست قیمت جهانی فهرست قیمت هند
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	SKU: Place Details Pro	فهرست قیمت جهانی فهرست قیمت هند
Pro	SKU: Text Search Pro	فهرست قیمت جهانی فهرست قیمت هند
Enterprise	واحد نگهداری موجودی: Nearby Search Enterprise	فهرست قیمت جهانی فهرست قیمت هند
Enterprise	SKU: Place Details Enterprise	فهرست قیمت جهانی فهرست قیمت هند
Enterprise	SKU: Place Details Enterprise + Atmosphere	فهرست قیمت جهانی فهرست قیمت هند
Enterprise	SKU: Text Search Enterprise	فهرست قیمت جهانی فهرست قیمت هند
Enterprise	SKU: Text Search Enterprise + Atmosphere	فهرست قیمت جهانی فهرست قیمت هند
Enterprise	SKU: Place Details Photos	فهرست قیمت جهانی فهرست قیمت هند
دسته	جزئیات شناسه محصول Places Library،‏ Maps JavaScript API (قدیمی)	قیمت‌گذاری SKU
Essentials	SKU: Autocomplete - Per Request	فهرست قیمت جهانی فهرست قیمت هند
Essentials	SKU: Autocomplete (included with Place Details) - Per Session	فهرست قیمت جهانی فهرست قیمت هند
Essentials	واحد نگهداری موجودی: داده‌های پایه هزینه‌های اضافی: SKU: Places Details SKU: Find Place SKU: Places - Nearby Search واحد نگهداری موجودی: مکان‌ها - جستجوی نوشتار	فهرست قیمت جهانی فهرست قیمت هند
Essentials	واحد نگهداری موجودی: Find Place - ID only	فهرست قیمت جهانی فهرست قیمت هند
Essentials	SKU: Place Details Essentials- ID Refresh	فهرست قیمت جهانی فهرست قیمت هند
Essentials	SKU: Query Autocomplete - Per Request	فهرست قیمت جهانی فهرست قیمت هند
Pro	SKU: Autocomplete without Place Details - Per Session	فهرست قیمت جهانی فهرست قیمت هند
Pro	SKU: Find Place هزینه‌های اضافی: واحد نگهداری موجودی: داده‌های پایه SKU: Contact Data واحد نگهداری موجودی: داده‌های جوی	فهرست قیمت جهانی فهرست قیمت هند
Pro	SKU: Places - Nearby Search هزینه‌های اضافی: واحد نگهداری موجودی: داده‌های پایه SKU: Contact Data واحد نگهداری موجودی: داده‌های جوی	فهرست قیمت جهانی فهرست قیمت هند
Pro	واحد نگهداری موجودی: مکان‌ها - جستجوی نوشتار هزینه‌های اضافی: واحد نگهداری موجودی: داده‌های پایه SKU: Contact Data واحد نگهداری موجودی: داده‌های جوی	فهرست قیمت جهانی فهرست قیمت هند
Pro	SKU: Places Details هزینه‌های اضافی: واحد نگهداری موجودی: داده‌های پایه SKU: Contact Data واحد نگهداری موجودی: داده‌های جوی	فهرست قیمت جهانی فهرست قیمت هند
Enterprise	واحد نگهداری موجودی: داده‌های جوی هزینه‌های اضافی: SKU: Places Details SKU: Find Place SKU: Places - Nearby Search واحد نگهداری موجودی: مکان‌ها - جستجوی نوشتار	فهرست قیمت جهانی فهرست قیمت هند
Enterprise	SKU: Contact Data هزینه‌های اضافی: SKU: Places Details SKU: Find Place SKU: Places - Nearby Search واحد نگهداری موجودی: مکان‌ها - جستجوی نوشتار	فهرست قیمت جهانی فهرست قیمت هند
Enterprise	SKU: Places Photos	فهرست قیمت جهانی فهرست قیمت هند
دسته	کیت میانای کاربر «جاها»	قیمت‌گذاری SKU
Essentials	واحد نگهداری موجودی: پرس‌وجوی کیت میانای کاربر «جاها»	فهرست قیمت جهانی فهرست قیمت هند
Essentials	واحد نگهداری موجودی: کیت میانای کاربر «جاها» - تکمیل خودکار در هر جلسه	فهرست قیمت جهانی فهرست قیمت هند
Pro	SKU: Places UI Kit (Advanced)	فهرست قیمت جهانی فهرست قیمت هند
دسته	جزئیات واحد نگهداری موجودی کتابخانه Routes	قیمت‌گذاری SKU
Essentials	SKU: Routes: Compute Routes Essentials	فهرست قیمت‌گذاری جهانی فهرست قیمت‌گذاری هند
Essentials	SKU: Routes: Compute Route Matrix 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	SKU: Directions	فهرست قیمت جهانی فهرست قیمت هند
Essentials	SKU: Distance Matrix	فهرست قیمت جهانی فهرست قیمت هند
Pro	SKU: Directions Advanced	فهرست قیمت جهانی فهرست قیمت هند
Pro	SKU: Distance Matrix Advanced	فهرست قیمت جهانی فهرست قیمت هند

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

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

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

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

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

• 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 توصیه می‌کند از جلسات با «تکمیل خودکار (جدید)» استفاده کنید. جلسه‌ها به ساده‌سازی قیمت‌گذاری کمک می‌کنند و مدل قیمت‌گذاری ثابتی را برای استفاده با «تکمیل خودکار (جدید)» ارائه می‌دهند.

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

تنظیم سهمیه

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

برای تغییر دادن مقدار سهمیه برای میانای برنامه‌سازی کاربردی‌تان، این مراحل را دنبال کنید:

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

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

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

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

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

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