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

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

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

Maps JavaScript API از یک مدل قیمت گذاری پرداختی استفاده می کند. APIها و SDKهای پلتفرم Google Maps توسط SKU صورتحساب می‌شوند. استفاده برای هر SKU ردیابی می‌شود و هر API یا SDK ممکن است بیش از یک SKU محصول داشته باشد. هزینه محاسبه می شود

برای تخمین هزینه استفاده در هر API یا SDK از ماشین حساب قیمت و استفاده ما استفاده کنید. برای SKUهای پلتفرم Google Maps واجد شرایط، هر ماه اعتبار 200 دلاری Google Maps Platform برای هر حساب صورت‌حساب در دسترس است. این اعتبار به طور خودکار به SKUهای واجد شرایط اعمال می شود.

قیمت گذاری برای Maps JavaScript API

SKU: نقشه های پویا

برنامه‌ای که نقشه بارگیری شده با یا بدون شناسه نقشه را با استفاده از Maps JavaScript API ، یا نقشه‌ای بارگذاری شده با شناسه نقشه و با استفاده از Maps SDK برای Android یا Maps SDK برای iOS نمایش می‌دهد.

تعاملات کاربر با نقشه، مانند پاننگ، بزرگنمایی، یا تغییر لایه های نقشه، بارهای نقشه اضافی ایجاد نمی کند.

SKU: نمای خیابان پویا

همه‌نمای نمای خیابان و بارهای نقشه اکنون جداگانه شارژ می‌شوند. برای هر نمونه از یک شی پانوراما در Maps JavaScript API ، Maps SDK برای Android ، Maps SDK برای iOS ، یک پانورامای پویا نمای خیابان هزینه می‌شود.

نمونه ای از یک شی پانوراما رخ می دهد:

• در جاوا اسکریپت ، با کلاس google.maps.StreetViewPanorama() یا متد Map.getStreetView() . نه تجربه داخلی نمای خیابان بر اساس کنترل آدمک خیابان نمای خیابان و نه استفاده از کلاس StreetViewService() شارژ نمی شود.
• در Android ، با یکی از کلاس‌های StreetViewPanoramaFragment ، SupportStreetViewPanoramaFragment ، یا StreetViewPanoramaView . هر بار که متد onCreate() مربوطه فراخوانی می شود، یک پانوراما شمارش می شود.
• در iOS ، با شی GMSPanoramaView .

قیمت گذاری برای Places Library، Maps JavaScript API

SKU: تکمیل خودکار درخواست ها

برای هر درخواست به API تکمیل خودکار (جدید) که شامل رمز جلسه نیست، یک SKU درخواست تکمیل خودکار هزینه می‌شود.

همچنین در صورت استفاده از نشانه های جلسه و یا:

• جلسات را با یک درخواست به جزئیات مکان (جدید) خاتمه دهید که فیلدهای تعریف شده توسط SKU را درخواست می کند: جزئیات مکان (فقط مکان) .
  • هر درخواست تکمیل خودکار (جدید)، حداکثر تا 12 درخواست، با استفاده از SKU صورت‌حساب می‌شود: درخواست‌های تکمیل خودکار .
  • هر درخواست تکمیل خودکار (جدید) بعدی با استفاده از SKU صورت‌حساب می‌شود: استفاده از جلسه تکمیل خودکار .
• جلسه را رها کنید یا با برقراری تماس با SKU، جلسه را پایان دهید: جزئیات مکان (فقط شناسه ها) . تمام درخواست‌های تکمیل خودکار (جدید) سپس با استفاده از SKU صورت‌حساب می‌شوند: درخواست‌های تکمیل خودکار .

SKU: استفاده از جلسه تکمیل خودکار

برای هر درخواست به API تکمیل خودکار (جدید) که شامل یک نشانه جلسه است، یک SKU استفاده از جلسه تکمیل خودکار دریافت می‌شود.

این SKU در این حالات شارژ می شود:

• جلسه تکمیل خودکار با تماس با SKU پایان یافت: جزئیات مکان (فقط مکان) :

  • هر درخواست تکمیل خودکار (جدید)، حداکثر تا 12 درخواست، با استفاده از SKU صورت‌حساب می‌شود: درخواست‌های تکمیل خودکار .
  • هر درخواست تکمیل خودکار (جدید) بعدی با استفاده از SKU صورت‌حساب می‌شود: استفاده از جلسه تکمیل خودکار .

• جلسه تکمیل خودکار با تماس با SKU خاتمه می یابد: جزئیات مکان (پایه، پیشرفته، یا ترجیحی) .

  یک تماس با جزئیات مکان که هر فیلدی را از SKU درخواست می‌کند: جزئیات مکان (پایه، پیشرفته یا ترجیحی) در SKU صورت‌حساب می‌شود: جزئیات مکان (ترجیحا) .

• جلسه تکمیل خودکار با تماس با SKU پایان یافت: اعتبار سنجی آدرس ترجیح داده می شود .

SKU: جزئیات مکان (فقط شناسه ها)

با استفاده از یک ماسک فیلد یا لیست فیلد در درخواست جزئیات مکان (جدید)، می توانید پاسخ را فقط به آن فیلدهای مشخص شده محدود کنید. این SKU زمانی فعال می شود که شما فقط فیلدهای زیر را درخواست کنید:

کتابخانه مکان‌ها، Maps JavaScript API : id ، photos

SKU: جزئیات مکان (فقط مکان)

با استفاده از یک ماسک فیلد یا لیست فیلد در درخواست جزئیات مکان (جدید)، می توانید پاسخ را فقط به آن فیلدهای مشخص شده محدود کنید. این SKU زمانی فعال می شود که شما فقط فیلدهای زیر را درخواست کنید:

کتابخانه مکان‌ها، Maps JavaScript API : addressComponents ، adrFormatAddress ، formattedAddress ، location ، plusCode ، types ، viewport

SKU: جزئیات مکان (اصلی)

با استفاده از یک ماسک فیلد یا لیست فیلد در درخواست جزئیات مکان (جدید)، می توانید پاسخ را فقط به آن فیلدهای مشخص شده محدود کنید. این SKU زمانی فعال می شود که شما فقط فیلدهای زیر را درخواست کنید:

کتابخانه مکان‌ها، Maps JavaScript API : accessibilityOptions ، businessStatus ، displayName ، googleMapsUri ، iconBackgroundColor ، primaryTypeDisplayName ، svgIconMaskURI ، types ، utcOffsetMinutes

SKU: جزئیات مکان (پیشرفته)

با استفاده از یک ماسک فیلد یا لیست فیلد در درخواست جزئیات مکان (جدید)، می توانید پاسخ را فقط به آن فیلدهای مشخص شده محدود کنید. این SKU زمانی فعال می شود که شما فقط فیلدهای زیر را درخواست کنید:

کتابخانه مکان‌ها، Maps JavaScript API : internationalPhoneNumber ، nationalPhoneNumber ، priceLevel ، rating ، regularOpeningHours ، userRatingCount ، websiteUri

SKU: جزئیات مکان (ترجیحا)

با استفاده از یک ماسک فیلد یا لیست فیلد در درخواست جزئیات مکان (جدید)، می توانید پاسخ را فقط به آن فیلدهای مشخص شده محدود کنید. این SKU زمانی فعال می شود که شما فقط فیلدهای زیر را درخواست کنید:

Places Library، Maps JavaScript API : allowsDogs ، editorialSummary ، evChargeOptions ، fuelOptions ، hasCurbsidePickup ، hasDelivery ، hasDineIn ، hasLiveMusic ، hasMenuForChildren ، hasRestroom hasOutdoorSeating hasTakeout ، hasWifi استراحت isGoodForChildren , isGoodForGroups servesCoffee isGoodForWatchingSports , isReservable , parkingOptions , paymentOptions , priceLevel , reviews , servesBeer , servesBreakfast , servesBrunch servesLunch , servesCocktails servesDessert , servesDinner , servesVegetarianFood , servesWine

SKU: جستجوی نزدیک (اصلی)

با استفاده از ماسک فیلد یا لیست فیلد در درخواست جستجوی نزدیک (جدید)، می‌توانید پاسخ را فقط به آن قسمت‌های مشخص شده محدود کنید. این SKU زمانی فعال می شود که شما فقط فیلدهای زیر را درخواست کنید:

کتابخانه مکان‌ها، Maps JavaScript API : accessibilityOptions ، addressComponents ، adrFormatAddress ، businessStatus ، displayName ، formattedAddress ، googleMapsUri ، iconBackgroundColor ، id ، location ، photos ، plusCode ، svgIconMaskURI ، types مشاهده، utcOffsetMinutes viewport

SKU: جستجوی نزدیک (پیشرفته)

با استفاده از ماسک فیلد یا لیست فیلد در درخواست جستجوی نزدیک (جدید)، می‌توانید پاسخ را فقط به آن قسمت‌های مشخص شده محدود کنید. این SKU زمانی فعال می شود که شما فقط فیلدهای زیر را درخواست کنید:

کتابخانه مکان‌ها، Maps JavaScript API : internationalPhoneNumber ، nationalPhoneNumber ، priceLevel ، rating ، regularOpeningHours ، userRatingCount ، websiteUri

SKU: جستجوی نزدیک (ترجیحا)

با استفاده از ماسک فیلد یا لیست فیلد در درخواست جستجوی نزدیک (جدید)، می‌توانید پاسخ را فقط به آن قسمت‌های مشخص شده محدود کنید. این SKU زمانی فعال می شود که شما فقط فیلدهای زیر را درخواست کنید:

Places Library، Maps JavaScript API : allowsDogs ، editorialSummary ، evChargeOptions ، fuelOptions ، hasCurbsidePickup ، hasDelivery ، hasDineIn ، hasLiveMusic ، hasMenuForChildren ، hasRestroom hasOutdoorSeating hasTakeout ، hasWifi استراحت isGoodForChildren , isGoodForGroups servesCoffee isGoodForWatchingSports , isReservable , parkingOptions , paymentOptions , priceLevel , reviews , servesBeer , servesBreakfast , servesBrunch servesLunch , servesCocktails servesDessert , servesDinner , servesVegetarianFood , servesWine

SKU: جستجوی متن (فقط شناسه)

با استفاده از ماسک فیلد یا لیست فیلد در درخواست جستجوی متن (جدید)، می‌توانید پاسخ را فقط به آن قسمت‌های مشخص شده محدود کنید. این SKU زمانی فعال می شود که شما فقط فیلدهای زیر را درخواست کنید:

کتابخانه مکان‌ها، Maps JavaScript API : id

SKU: جستجوی متن (پایه)

با استفاده از ماسک فیلد یا لیست فیلد در درخواست جستجوی متن (جدید)، می‌توانید پاسخ را فقط به آن قسمت‌های مشخص شده محدود کنید. این SKU زمانی فعال می شود که شما فقط فیلدهای زیر را درخواست کنید:

کتابخانه مکان‌ها، Maps JavaScript API : accessibilityOptions ، addressComponents ، adrFormatAddress ، businessStatus ، displayName ، formattedAddress ، googleMapsUri ، iconBackgroundColor viewport location ، photos ، plusCode ، svgIconMaskURI utcOffsetMinutes types

SKU: جستجوی متن (پیشرفته)

با استفاده از ماسک فیلد یا لیست فیلد در درخواست جستجوی متن (جدید)، می‌توانید پاسخ را فقط به آن قسمت‌های مشخص شده محدود کنید. این SKU زمانی فعال می شود که شما فقط فیلدهای زیر را درخواست کنید:

کتابخانه مکان‌ها، Maps JavaScript API : internationalPhoneNumber ، nationalPhoneNumber ، priceLevel ، rating ، regularOpeningHours ، userRatingCount ، websiteUri

SKU: جستجوی متن (ترجیحا)

با استفاده از ماسک فیلد یا لیست فیلد در درخواست جستجوی متن (جدید)، می‌توانید پاسخ را فقط به آن قسمت‌های مشخص شده محدود کنید. این SKU زمانی فعال می شود که شما فقط فیلدهای زیر را درخواست کنید:

Places Library، Maps JavaScript API : allowsDogs ، editorialSummary ، evChargeOptions ، fuelOptions ، hasCurbsidePickup ، hasDelivery ، hasDineIn ، hasLiveMusic ، hasMenuForChildren ، hasRestroom hasOutdoorSeating hasTakeout ، hasWifi استراحت isGoodForChildren , isGoodForGroups servesCoffee isGoodForWatchingSports , isReservable , parkingOptions , paymentOptions , priceLevel , reviews , servesBeer , servesBreakfast , servesBrunch servesLunch , servesCocktails servesDessert , servesDinner , servesVegetarianFood , servesWine

SKU: عکس مکان

برای هر درخواست به API یک Place Photo SKU دریافت می‌شود.

درباره جلسات تکمیل خودکار

یک جلسه تکمیل خودکار شامل برخی از درخواست‌های تکمیل خودکار (برای بازیابی پیشنهادات در یک مکان همانطور که کاربر تایپ می‌کند)، و حداکثر یک درخواست Places Details (برای بازیابی جزئیات مکان انتخاب شده توسط کاربر) است. همان نشانه جلسه به درخواست تکمیل خودکار و متعاقباً درخواست جزئیات مکان ارسال می شود. یک جلسه با اولین درخواست تکمیل خودکار شروع می شود (که معمولاً زمانی اتفاق می افتد که کاربر شروع به تایپ می کند). زمانی که کاربر یکی از پیشنهادات تکمیل خودکار را انتخاب کرده باشد، تماس جزئیات مکان ها برقرار می شود. اگر کاربر پیشنهادی را انتخاب نکند، تماسی با Places Details برقرار نمی‌شود.

پس از اینکه کاربر یک مکان را انتخاب کرد (یعنی تماس جزئیات مکان ها برقرار شد)، باید یک جلسه جدید را با استفاده از یک نشانه جلسه جدید شروع کنید.

جلسات تکمیل خودکار را می توان از API های زیر ایجاد کرد:

• سرویس تکمیل خودکار مکان API Places یا سرویس تکمیل خودکار مکان‌ها در Maps JavaScript API . شما باید برنامه خود را طوری طراحی کنید که نشانه های جلسه ارائه دهد (شاید نیاز باشد کد موجود خود را تغییر دهید).
• ویجت تکمیل خودکار Maps JavaScript API . صورت‌حساب مبتنی بر جلسه به‌طور خودکار در آن ویجت‌ها فعال می‌شود، بدون نیاز به تغییر کد.

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

درخواست‌های تکمیل خودکار و درخواست‌های جزئیات مکان‌ها با استفاده از جلسات در SKUهای مختلف صورت‌حساب می‌شوند.

درباره SKUهای داده مکان‌ها

یک یا چند SKU داده برای:

• Android: هر درخواست برای fetchPlace() یا findCurrentPlace()
• iOS: هر تماس برای fetchPlaceFromPlaceID: یا findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
• وب سرویس: هر درخواست Places بسته به فیلدهای مشخص شده در درخواست

SKUهای داده همیشه علاوه بر SKU پایه برای درخواستی که آنها را راه اندازی می کند، شارژ می شوند. به عنوان مثال، درخواست جزئیات مکان شامل فیلدهای Basic Data هم در زیر SKU داده پایه و هم در SKU جزئیات مکان محاسبه می شود.

برای سرویس وب، این مکان‌های API از تماس‌هایی پشتیبانی می‌کنند که فیلدهای داده برای بازگشت را مشخص می‌کنند:

• جزئیات مکان ها
• مکان را پیدا کنید

برای سرویس وب، این فراخوان‌های Places API از تعیین فیلدهای برگشتی پشتیبانی نمی‌کنند . این تماس‌ها همیشه همه داده‌های Places را برمی‌گردانند، و علاوه بر هزینه هر درخواست API، از سه SKU داده مکان‌ها نیز هزینه می‌گیرند:

• مکان‌ها - جستجوی نزدیک
• مکان ها - جستجوی متن

SKU: داده های پایه

با استفاده از پارامتر فیلدها در درخواست جزئیات مکان یا یافتن مکان، می‌توانید پاسخ را فقط به آن فیلدهای مشخص شده محدود کنید. فیلدهای دسته Basic در هزینه پایه درخواست Places گنجانده شده است و هزینه اضافی دریافت نمی کند. هنگامی که هر یک از این فیلدها درخواست شود، SKU داده های پایه فعال می شود:

• Android: Place.Field.ACCESSIBILITY_OPTIONS , Place.Field.ADDRESS_COMPONENTS , Place.Field.BUSINESS_STATUS , Place.Field.DISPLAY_NAME , Place.Field.FORMATTED_ADDRESS , Place.Field.ICON_BACKGROUND_COLOR ,ICON_COLOROU Place.Field.ICON_MASK_URL ، Place.Field.ID ، Place.Field.LOCATION ، Place.Field.PHOTO_METADATAS ، Place.Field.PLUS_CODE ، Place.Field.TYPES ، Place.Field.VIEWPORT ، یا Place.Field.UTC_OFFSET .
• iOS: GMSPlaceFieldFormattedAddress , GMSPlaceFieldBusinessStatus , GMSPlaceFieldID , GMSPlaceFieldCoordinate , GMSPlaceFieldName , GMSPlaceFieldPhotos , GMSPlaceFieldPlusCode , GMSPlaceFieldTypes GMSPlaceFieldViewport
• سرویس وب: address_component ، adr_address ، business_status ، formatted_address ، geometry ، icon ، name ، permanently_closed ، photo ، place_id id، plus_code ، type ، url ، utc_offset ، vicinity ، یا wheelchair_accessible_entrance

SKU: اطلاعات تماس

با استفاده از پارامتر فیلدها در جزئیات مکان یا درخواست Find Place برای سرویس‌های وب، یا آرایه‌ای از Place.Field برای Android یا iOS، می‌توانید پاسخ را فقط به آن فیلدهای مشخص شده محدود کنید. فیلدهای دسته تماس با هزینه اضافی همراه هستند. هنگامی که هر یک از این فیلدها درخواست شود، SKU اطلاعات تماس فعال می شود:

• Android: Place.Field.CURRENT_OPENING_HOURS ، Place.Field.INTERNATIONAL_PHONE_NUMBER ، Place.Field.OPENING_HOURS ، Place.Field.SECONDARY_OPENING_HOURS ، یا Place.Field.WEBSITE_URI
• iOS: GMSPlaceFieldOpeningHours ، GMSPlaceFieldPhoneNumber ، یا GMSPlaceFieldWebsite
• سرویس وب: formatted_phone_number , international_phone_number , opening_hours , current_opening_hours , secondary_opening_hours , or website

SKU: داده های جو

با استفاده از پارامتر فیلدها در درخواست جزئیات مکان یا یافتن مکان، می‌توانید پاسخ را فقط به آن فیلدهای مشخص شده محدود کنید. زمینه های موجود در رده اتمسفر هزینه اضافی دریافت می کنند. هنگامی که هر یک از این فیلدها درخواست شود، SKU Data Atmosphere فعال می شود:

• Android: Place.Field.CURBSIDE_PICKUP , Place.Field.DELIVERY , Place.Field.EDITORIAL_SUMMARY , Place.Field.DINE_IN , Place.Field.PRICE_LEVEL , Place.Field.RATING , Place.Field.RESERVABLE , Place.Field.SERVES_BEER . Place.Field.SERVES_BREAKFAST ، Place.Field.SERVES_BRUNCH ، Place.Field.SERVES_DINNER ، Place.Field.SERVES_LUNCH Place.Field.SERVES_WINE Place.Field.SERVES_VEGETARIAN_FOOD Place.Field.TAKEOUT . Place.Field.USER_RATING_COUNT
  
• iOS: GMSPlaceFieldPriceLevel ، GMSPlaceFieldRating ، GMSPlaceFieldUserRatingsTotal ، GMSPlaceFieldTakeout ، GMSPlaceFieldDelivery ، GMSPlaceFieldDineIn ، GMSPlaceFieldCurbsidePickup GMSPlaceFieldReservable GMSPlaceFieldServesBreakfast , GMSPlaceFieldServesLunch , GMSPlaceFieldServesDinner , GMSPlaceFieldServesBeer , GMSPlaceFieldServesWine , GMSPlaceFieldServesBrunch یا GMSPlaceFieldServesVegetarianFood
• جاوا اسکریپت : فیلدها را ببینید (جزئیات مکان)
• وب سرویس : curbside_pickup ، delivery ، dine_in ، editorial_summary ، price_level ، rating ، reservable ، reviews ، serves_beer ، serves_breakfast ، serves_brunch ، serves_lunch takeout serves_dinner ، سروهای_گیاهی_غذای_غذایی، serves_vegetarian_food ، serves_wine user_ratings_total .

SKU: تکمیل خودکار - به ازای هر درخواست

SKU تکمیل خودکار – به ازای هر درخواست برای هر یک از این تماس‌ها یا درخواست‌هایی که شامل نشانه جلسه نیستند، هزینه می‌شود:

• Android: findAutocompletePredictions()
• iOS: findAutocompletePredictionsFromQuery:
• جاوا اسکریپت: سرویس تکمیل خودکار مکان Maps JavaScript API
• وب سرویس: Places API Place Autocomplete Service

برای تماس‌هایی که از یک جلسه تکمیل خودکار نامعتبر انجام می‌شود (به عنوان مثال، جلسه‌ای که از یک نشانه جلسه مجددا استفاده می‌کند) هزینه تکمیل خودکار – به ازای هر درخواست SKU نیز دریافت می‌شود.

درخواست‌های تکمیل خودکار از ابزارک تکمیل خودکار مکان Maps JavaScript API ممکن است در صورت برقراری تماس از یک جلسه تکمیل خودکار نامعتبر، یک SKU تکمیل خودکار - به ازای هر درخواست دریافت شود. این ممکن است زمانی اتفاق بیفتد که کاربر چندین آدرس مختلف را تایپ می‌کند یا آدرس‌های مختلف را در ویجت کپی/پیست می‌کند و همیشه یک پیش‌بینی تکمیل خودکار را انتخاب نمی‌کند.

SKU: تکمیل خودکار بدون جزئیات مکان - در هر جلسه

تکمیل خودکار بدون جزئیات مکان – SKU در هر جلسه برای یک جلسه تکمیل خودکار که شامل درخواست جزئیات مکان نیست (در عرض چند دقیقه پس از شروع جلسه) هزینه دریافت می‌شود.

مثال

اگر برنامه شما این دو تماس را در یک جلسه صادر کرد:

اندروید

• findAutocompletePredictions() (.setQuery("par")، .setSessionToken(XYZ))
• findAutocompletePredictions() (.setQuery("paris")، .setSessionToken(XYZ))

iOS

• placeClient?.findAutocompletePredictions(fromQuery: "par" ...
• placeClient?.findAutocompletePredictions(fromQuery: "paris" ...

وب سرویس

• درخواست تکمیل خودکار (input=”par”، session_token: XYZ)
• درخواست تکمیل خودکار (input=”paris”, session_token: XYZ)

در صورتحساب خود، این SKU را در لیست خواهید دید (هنگام مشاهده صورتحساب خود توسط SKU ):

• تکمیل خودکار بدون جزئیات مکان - در هر جلسه (قیمت از 0.017 دلار در هر جلسه شروع می شود)

SKU: تکمیل خودکار (شامل جزئیات مکان) - در هر جلسه

تکمیل خودکار (شامل جزئیات مکان) - SKU هر جلسه برای یک جلسه تکمیل خودکار که شامل یکی از موارد زیر است هزینه می شود:

• Android: تماسی با fetchPlace()
• iOS: تماسی برای fetchPlaceFromPlaceID:
• وب سرویس: درخواست جزئیات مکان

درخواست تکمیل خودکار بدون هیچ هزینه ای در دسترس است، و هزینه تماس بعدی با جزئیات مکان بر اساس قیمت معمولی جزئیات مکان محاسبه می شود.

درخواست جزئیات مکان، SKUهای داده ( اصلی ، تماس ، و/یا جو ) را ایجاد می کند - بسته به فیلدهایی که در درخواست مشخص شده است.

اگر فیلدهایی را در درخواست جزئیات مکان مشخص نکنید، همه SKUهای داده فعال می شوند (Basic، Contact، و Atmosphere).

درخواست‌های تازه‌سازی شناسه جزئیات مکان (درخواست‌هایی که فقط قسمت place_id را مشخص می‌کنند) در طول جلسه تکمیل خودکار به‌عنوان SKU صورت‌حساب می‌شوند: تکمیل خودکار بدون جزئیات مکان – در هر جلسه .

مثال

اگر برنامه شما سه تماس زیر را در یک جلسه صادر کرد:

اندروید

• findAutocompletePredictions() (.setQuery("par")، .setSessionToken(XYZ))
• findAutocompletePredictions() (.setQuery("paris")، .setSessionToken(XYZ))
• fetchPlace() (با FetchPlaceRequest شامل شناسه مکان و فیلد ADDRESS)

iOS

• placeClient?.findAutocompletePredictions(fromQuery: "par" ...
• placeClient?.findAutocompletePredictions(fromQuery: "paris" ...
• fetchPlaceFromPlaceID: (شامل شناسه مکان و فیلد GMSPlaceFieldFormattedAddress )

وب سرویس

• درخواست تکمیل خودکار مکان‌ها (input=”par”، session_token: XYZ)
• درخواست تکمیل خودکار مکان‌ها (input=”paris”, session_token: XYZ)
• جزئیات مکان ها (place_id، session_token: XYZ، فیلدها:formatted_address)

در صورتحساب خود، این SKUها را مشاهده خواهید کرد (هنگام مشاهده صورتحساب خود توسط SKU ):

• تکمیل خودکار (شامل جزئیات مکان) - در هر جلسه (صورت‌حساب 0.00 USD)
• جزئیات مکان (قیمت از 0.017 دلار در هر جلسه شروع می شود)
• داده های پایه (صورتحساب 0.00 USD)

SKU: پرس و جو تکمیل خودکار - در هر درخواست

یک درخواست تکمیل خودکار - SKU به ازای هر درخواست برای هر درخواست به:

• جاوا اسکریپت: سرویس تکمیل خودکار مکان‌های Maps JavaScript API ( getQueryPredictions() ) و استفاده از ابزارک SearchBox Maps JavaScript API (درخواست‌های تکمیل خودکار Query به عنوان نوع کاربر ایجاد می‌شوند).
• وب سرویس: سرویس تکمیل خودکار Query Places API

قیمت گذاری بر اساس جلسه تکمیل خودکار با استفاده از تکمیل خودکار Query پشتیبانی نمی شود. هزینه تماس‌های بعدی Places Details بر اساس قیمت معمولی Places Details محاسبه می‌شود.

SKU: جزئیات مکان ها

هزینه تماس‌های جزئیات مکان‌ها به شرح زیر است:

Places Details SKU از این APIها ایجاد می شود:

• Android: Places SDK برای Android ( fetchPlace() )
• iOS: مکان‌های SDK برای iOS ( fetchPlaceFromPlaceID: :)
• JavaScript: Maps JavaScript's Place Details Service ( getDetails )
• جاوا اسکریپت: ویجت تکمیل خودکار مکان ( getPlace ) در API جاوا اسکریپت Maps
• جاوا اسکریپت: نقشه جاوا اسکریپت جاوا اسکریپت ابزارک SearchBox مکان : متد getPlaces() پس از انتخاب یک نتیجه مکان (نماد: پین)، *نه* یک پرس و جو (نماد: ذره بین)، همانطور که در اینجا نشان داده شده است:

  

• وب سرویس: Places API خدمات جزئیات مکان

با وب API و سرویس‌ها، SKU جزئیات مکان هزینه می‌شود، چه نشانه جلسه ارائه شود یا نه.

یک تماس یا درخواست جزئیات مکان نیز بسته به فیلدهایی که در تماس یا درخواست مشخص شده‌اند، SKUهای داده ( اصلی ، تماس ، و/یا جو ) ایجاد می‌کند. اگر هیچ فیلدی در تماس یا درخواست جزئیات مکان مشخص نشده باشد، همه SKUهای داده فعال می شوند و هزینه تماس یا درخواست جزئیات مکان به اضافه هزینه تمام داده ها از شما دریافت می شود.

نمونه ها

1. یکی از این تماس ها یا درخواست ها را انجام دهید:
   • تلفن همراه: با fetchPlace() در Android یا fetchPlaceFromPlaceID: در iOS تماس بگیرید و فقط قسمت ADDRESS را مشخص کنید
   • Web API یا سرویس: درخواست جزئیات مکان را انجام دهید و فقط فیلد آدرس را مشخص کنید: getPlaceDetails(fields: formatted_address)
   در صورتحساب خود، این SKUها را مشاهده خواهید کرد (هنگام مشاهده صورتحساب خود توسط SKU ):
   • جزئیات مکان (قیمت از 0.017 دلار در هر جلسه شروع می شود)
   • داده های پایه (صورتحساب 0.00 USD)
2. یکی از این تماس ها یا درخواست ها را انجام دهید:
   • تلفن همراه: با fetchPlace() در Android یا fetchPlaceFromPlaceID: در iOS تماس بگیرید و فقط فیلد PHONE_NUMBER را مشخص کنید
   • Web API یا سرویس: درخواست جزئیات مکان و فیلد شماره تلفن را مشخص کنید: getPlaceDetails(fields: formatted_phone_number)
   در صورتحساب خود، این SKUها را مشاهده خواهید کرد (هنگام مشاهده صورتحساب خود توسط SKU ):
   • جزئیات مکان (قیمت از 0.017 دلار در هر جلسه شروع می شود)
   • اطلاعات تماس (قیمت از 0.003 دلار در هر درخواست شروع می شود)
3. یکی از این تماس ها یا درخواست ها را انجام دهید:
   • تلفن همراه: با fetchPlace() در Android یا fetchPlaceFromPlaceID: در iOS تماس بگیرید و تمام فیلدها را مشخص کنید
   • Web API یا سرویس: یک درخواست Place Details ایجاد کنید و همه فیلدها را مشخص کنید (اگر هیچ فیلدی را مشخص نکنید این نوع درخواست پیش‌فرض است): getPlaceDetails() .
   در صورتحساب خود، این SKUها را مشاهده خواهید کرد (هنگام مشاهده صورتحساب خود توسط SKU ):
   • جزئیات مکان (قیمت از 0.017 دلار در هر جلسه شروع می شود)
   • داده های پایه (صورتحساب 0.00 USD)
   • اطلاعات تماس (قیمت از 0.003 دلار در هر درخواست شروع می شود)
   • داده های جوی (قیمت از 0.005 دلار در هر درخواست شروع می شود)

SKU: جزئیات مکان‌ها – ID Refresh

از درخواست جزئیات مکان برای بازخوانی شناسه‌های مکان قدیمی استفاده کنید. این نوع درخواست ها بدون هزینه در دسترس هستند.

مثال

درخواست جزئیات مکان را انجام دهید و فقط قسمت شناسه مکان را مشخص کنید: getPlaceDetails(fields: place_id) . در صورتحساب خود ، این SKU ذکر شده را مشاهده خواهید کرد (هنگام مشاهده صورتحساب خود توسط SKU ):

• جزئیات مکان - تازه سازی شناسه (صورتحساب با 0.00 دلار)

SKU: مکان را پیدا کنید

Find Place برای درخواست مکان Find شارژ می شود.

بسته به زمینه هایی که در درخواست مشخص شده است ، درخواست های مکان را نیز پیدا کنید که SKU داده ( اساسی ، مخاطب و/یا جو ) ایجاد می کند. مانند درخواست های جزئیات مکان ، می توانید از پارامتر Fields در درخواست Find Place خود استفاده کنید تا پاسخ فقط به قسمتهای مشخص شده محدود شود. شما برای درخواست Find Place و همچنین داده های درخواست شده صورتحساب می شوید. به طور پیش فرض ، اگر هیچ زمینه ای درخواست نشده باشد ، فقط شناسه مکان بازگردانده می شود ، بنابراین هیچ هزینه داده اضافی متحمل نمی شود.

نمونه ها

1. شما یک درخواست مکان پیدا می کنید و فقط قسمت آدرس را مشخص می کنید: FindPlace(fields: formatted_address) . در صورتحساب خود ، این SKU های ذکر شده را مشاهده خواهید کرد (هنگام مشاهده صورتحساب خود توسط SKU ):
   • مکان را پیدا کنید (قیمت شروع از 0.017 دلار در هر تماس)
   • داده های اساسی (صورتحساب با 0.00 دلار)
2. شما یک درخواست مکان پیدا می کنید و قسمت شماره تلفن را مشخص می کنید: FindPlace(fields: formatted_phone_number) . در صورتحساب خود ، این SKU های ذکر شده را مشاهده خواهید کرد (هنگام مشاهده صورتحساب خود توسط SKU ):
   • مکان را پیدا کنید (قیمت شروع از 0.017 دلار در هر تماس)
   • با داده های تماس (قیمت شروع از 0.003 دلار در هر درخواست)
3. شما یک درخواست مکان پیدا می کنید و زمینه هایی را از هر سه سطل از نوع داده ها مشخص می کنید: FindPlace(fields: formatted_address, opening_hours, price_level) . در صورتحساب خود ، این SKU های ذکر شده را مشاهده خواهید کرد (هنگام مشاهده صورتحساب خود توسط SKU ):
   • مکان را پیدا کنید (قیمت شروع از 0.017 دلار در هر تماس)
   • داده های اساسی (صورتحساب با 0.00 دلار)
   • با داده های تماس (قیمت شروع از 0.003 دلار در هر درخواست)
   • داده های جو (قیمت شروع از 0.005 دلار در هر درخواست)

SKU: مکان را پیدا کنید - فقط شناسه

Find Place - ID فقط برای یافتن درخواست های مکان که فقط شناسه مکان را برای بازگشت مشخص می کند ، شارژ می شود. به طور پیش فرض ، اگر هیچ زمینه ای در درخواست Find Place مشخص نشده باشد ، فقط شناسه مکان بازگردانده می شود.

مثال

شما یک درخواست مکان پیدا می کنید و فقط قسمت place_id را مشخص می کنید: FindPlace(fields: place_id) . در صورتحساب خود ، این SKU ذکر شده را مشاهده خواهید کرد (هنگام مشاهده صورتحساب خود توسط SKU ):

• Find Place - ID فقط (صورتحساب با 0.00 دلار)

SKU: مکان ها - جستجوی مجاور

مکان ها - جستجوی مجاور برای درخواست به نقشه های JavaScript API در نزدیکی سرویس جستجو در نزدیکی ( nearbySearch() ) یا به مکان های API در نزدیکی سرویس پرداخت می شود.

درخواست های جستجو در نزدیکی لیستی از مکان ها را برمی گردانند ، اما از مشخص کردن اینکه کدام قسمت ها بازگردانده می شوند ، پشتیبانی نمی کنند. درخواست های جستجو در نزدیکی زیر مجموعه ای از زمینه های داده پشتیبانی شده را برمی گرداند. شما برای درخواست جستجوی مجاور در هر یک از 0.032 USD و همچنین کلیه SKU های نوع داده ( داده های اساسی ، داده های تماس و داده های جو ) استفاده می شود.

مثال

شما یک درخواست جستجوی در نزدیکی ، مانند NearbySearch (San Francisco, 100 meters) ایجاد می کنید. در صورتحساب خود ، این SKU های ذکر شده را مشاهده خواهید کرد (هنگام مشاهده صورتحساب خود توسط SKU ):

• مکان - جستجوی نزدیک (قیمت شروع از 0.032 دلار در هر تماس)
• داده های اساسی (صورتحساب با 0.00 دلار)
• با داده های تماس (قیمت شروع از 0.003 دلار در هر درخواست)
• داده های جو (قیمت شروع از 0.005 دلار در هر درخواست)

SKU: مکان ها - جستجوی متن

مکان ها - جستجوی متن برای درخواست های مربوط به نقشه های جستجوی متن JavaScript API ( textSearch() ) یا سرویس جستجوی متن API به نقشه ها پرداخت می شود.

درخواست های جستجوی متن لیستی از مکان ها را برمی گرداند ، اما از مشخص کردن کدام قسمت ها پشتیبانی نمی کند. درخواست های جستجوی متن زیر مجموعه ای از قسمتهای داده پشتیبانی شده را برمی گرداند. شما برای درخواست جستجوی متن از هر یک از 0.032 USD و همچنین کلیه SKU های نوع داده ( داده های اساسی ، داده های تماس و داده های جو ) استفاده می کنید.

مکان - جستجوی متن SKU همچنین توسط Widget Widget Widget Widget : getPlaces() پس از انتخاب کاربر یک پرس و جو مکان (نماد: بزرگنمایی) ، نه نتیجه (نماد: پین) ، همانطور که در اینجا نشان داده شده است ، روش GetPlaces () روش getPlaces () ایجاد می شود: همانطور که در اینجا نشان داده شده است:

مثال

شما یک درخواست جستجوی متن مانند TextSearch(123 Main Street) ایجاد می کنید. در صورتحساب خود ، این SKU های ذکر شده را مشاهده خواهید کرد (هنگام مشاهده صورتحساب خود توسط SKU ):

• مکان - جستجوی متن (قیمت شروع از 0.032 دلار در هر تماس)
• داده های اساسی (صورتحساب با 0.00 دلار)
• با داده های تماس (قیمت شروع از 0.003 دلار در هر درخواست)
• داده های جو (قیمت شروع از 0.005 دلار در هر درخواست)

SKU: عکس مکان

یک عکس SKU برای:

• Android: تماس با fetchPhoto()
• iOS: تماس با loadPlacePhoto:
• JavaScript: به کتابخانه به مکان ، نقشه های عکس های مکان API JavaScript API هنگام درخواست داده از URL های برگرفته شده توسط PlacePhoto.getUrl() برای بارگیری داده های پیکسل تصویر
• سرویس وب: درخواست به مکان های API Place Service Photos

برای سرویس JavaScript ، استناد به روش PlacePhoto.getUrl() تا زمانی که URL برای به دست آوردن داده های پیکسل استفاده نشود ، باعث صورتحساب نمی شود.

قیمت گذاری برای خدمات JavaScript

خدمات JavaScript به طور جداگانه قیمت گذاری می شوند. برای اطلاعات بیشتر به صفحه استفاده و صورتحساب خدمات مراجعه کنید:

• خدمات مسیرها - استفاده و صورتحساب API را راهنمایی می کند
• سرویس ماتریس فاصله - استفاده از API ماتریس فاصله و صورتحساب
• خدمات ارتفاع - استفاده و صورتحساب API ارتفاع
• سرویس GeoCoding - استفاده و صورتحساب API GeoCoding
• سرویس نمای خیابان - استفاده از API نمای خیابان و صورتحساب

محدودیت های دیگر استفاده

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

• 30،000 QPM (درخواست در دقیقه).
• 300 QPM (درخواست در هر دقیقه) در هر آدرس IP. در کنسول Google Cloud ، این سهمیه به عنوان بارهای نقشه در هر دقیقه در هر کاربر گفته می شود.

نقشه های سه بعدی عکسبرداری در نقشه ها محدودیت های استفاده جاوا اسکریپت

محدودیت های استفاده زیر برای نقشه های سه بعدی عکسبرداری در نقشه های JavaScript وجود دارد

• 100 QPM (درخواست در هر دقیقه).
• 10 QPM (درخواست در هر دقیقه) در هر آدرس IP.

شرایط استفاده محدودیت

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

هزینه استفاده خود را مدیریت کنید

برای مدیریت هزینه استفاده خود از نقشه های JavaScript API یا برآورده کردن خواسته های ترافیک تولید خود ، محدودیت های سهمیه روزانه را برای کلیه درخواست ها به هر API تعیین کنید. سهمیه روزانه در نیمه شب اقیانوس آرام تنظیم می شود.

برای مشاهده یا تغییر محدودیت سهمیه برای نقشه های JavaScript API:

1. در کنسول ابری ، صفحه سهمیه پلت فرم Google Maps را باز کنید.
2. روی کشویی APIS کلیک کنید و نقشه های JavaScript API را انتخاب کنید.
3. برای مشاهده محدوده سهمیه ، به کارت درخواست ها بروید.
   یک جدول نام و محدودیت های سهمیه را ذکر کرده است.
4. برای تغییر حد سهمیه ، برای آن حد بر روی نماد ویرایش کلیک کنید.
   در گفتگوی که ظاهر می شود ، در قسمت Lota Limit ، محدوده سهمیه روزانه قابل پرداخت را وارد کنید (تا حد سهمیه ، در صورت وجود ، توسط Google مشخص شده است) و Save را انتخاب کنید.

اگر استفاده از API شما در هر روز به حد سهمیه قابل پرداخت شما برسد ، درخواست شما قادر به دسترسی به API برای باقی مانده آن روز نخواهد بود.

منابع مدیریت هزینه مرتبط

• Google Maps صورتحساب و قیمت گذاری پلتفرم
• Google Maps Reporting & Monitoring Platform