نحوه صورتحساب Places API
Places API (جدید) و Places API از یک مدل قیمت گذاری پرداختی استفاده می کند. APIها و SDKهای پلتفرم Google Maps توسط SKU صورتحساب میشوند. استفاده برای هر SKU ردیابی میشود و هر API یا SDK ممکن است بیش از یک SKU محصول داشته باشد. هزینه توسط:
برای تخمین هزینه استفاده در هر API یا SDK از ماشین حساب قیمت و استفاده ما استفاده کنید. برای SKUهای پلتفرم Google Maps واجد شرایط، هر ماه اعتبار 200 دلاری Google Maps Platform برای هر حساب صورتحساب در دسترس است. این اعتبار به طور خودکار به SKUهای واجد شرایط اعمال می شود.
قیمت گذاری برای Places API (جدید)
درباره ماسک های میدانی
برای جزئیات مکان (جدید)، جستجوی نزدیک (جدید)، و جستجوی متن (جدید)، از هدر FieldMask
در درخواستهای API استفاده کنید تا لیست فیلدهایی را که باید در پاسخ بازگردانده شوند، مشخص کنید. سپس با بالاترین SKU مربوط به درخواست شما صورتحساب دریافت می کنید. این بدان معناست که اگر فیلدهایی را در SKU (پایه) و SKU (پیشرفته) انتخاب کنید، بر اساس SKU (پیشرفته) صورتحساب دریافت می کنید.
استفاده از پوشاندن میدان یک روش طراحی خوب است تا اطمینان حاصل شود که دادههای غیرضروری درخواست نمیکنید، که به جلوگیری از زمان پردازش غیر ضروری و هزینههای صورتحساب کمک میکند.
درباره جلسات تکمیل خودکار (جدید).
یک جلسه تکمیل خودکار (جدید) شامل یک یا چند درخواست تکمیل خودکار (جدید) و یک درخواست جزئیات مکان (جدید) یا درخواست اعتبار سنجی آدرس است. همان نشانه جلسه به درخواست تکمیل خودکار (جدید) و به درخواست بعدی جزئیات مکان (جدید) یا درخواست اعتبار سنجی آدرس ارسال می شود.
یک جلسه با اولین درخواست تکمیل خودکار (جدید) شروع می شود. زمانی که کاربر یکی از پیشنهادات تکمیل خودکار (جدید) را انتخاب کرد، درخواست جزئیات مکان (جدید) یا درخواست اعتبار سنجی آدرس داده می شود. اگر جلسه رها شود، به این معنی که هیچ درخواستی برای جزئیات مکان (جدید) یا درخواست اعتبار سنجی آدرس انجام نشود، درخواستهای تکمیل خودکار (جدید) بهگونهای محاسبه میشوند که گویی هیچ نشانه جلسه ارائه نشده است.
پس از اینکه کاربر یک مکان را انتخاب کرد (به این معنی که درخواست جزئیات مکان (جدید) یا درخواست اعتبار سنجی آدرس انجام شد)، باید یک جلسه جدید را با استفاده از یک نشانه جلسه جدید شروع کنید.
نشانه جلسه برای یک جلسه مناسب است و نمی توان برای بیش از یک جلسه از آن استفاده کرد. اگر از یک نشانه جلسه استفاده مجدد کنید، جلسه نامعتبر تلقی می شود و درخواست ها به گونه ای محاسبه می شوند که گویی نشانه جلسه ارائه نشده است.
SKU: تکمیل خودکار درخواست ها
برای هر درخواست به API تکمیل خودکار (جدید) که شامل رمز جلسه نیست، یک SKU درخواست تکمیل خودکار هزینه میشود.
همچنین در صورت استفاده از نشانه های جلسه و یا:
- جلسات را با یک درخواست به جزئیات مکان (جدید) خاتمه دهید که فیلدهای تعریف شده توسط SKU را درخواست می کند: جزئیات مکان (فقط مکان) .
- هر درخواست تکمیل خودکار (جدید)، حداکثر تا 12 درخواست، با استفاده از SKU صورتحساب میشود: درخواستهای تکمیل خودکار .
- هر درخواست تکمیل خودکار (جدید) بعدی با استفاده از SKU صورتحساب میشود: استفاده از جلسه تکمیل خودکار .
- جلسه را رها کنید یا با برقراری تماس با SKU، جلسه را پایان دهید: جزئیات مکان (فقط شناسه ها) . تمام درخواستهای تکمیل خودکار (جدید) سپس با استفاده از SKU صورتحساب میشوند: درخواستهای تکمیل خودکار .
محدوده حجم ماهانه (قیمت هر تماس) | ||
---|---|---|
| | |
0.00283 USD به ازای هر (2.83 دلار در هر 1000) | 0.00227 USD به ازای هر (2.27 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
SKU: استفاده از جلسه تکمیل خودکار
برای هر درخواست به API تکمیل خودکار (جدید) که شامل یک نشانه جلسه است، یک SKU استفاده از جلسه تکمیل خودکار دریافت میشود.
این SKU در این حالات شارژ می شود:
جلسه تکمیل خودکار با تماس با SKU پایان یافت: جزئیات مکان (فقط مکان) :
- هر درخواست تکمیل خودکار (جدید)، حداکثر تا 12 درخواست، با استفاده از SKU صورتحساب میشود: درخواستهای تکمیل خودکار .
- هر درخواست تکمیل خودکار (جدید) بعدی با استفاده از SKU صورتحساب میشود: استفاده از جلسه تکمیل خودکار .
جلسه تکمیل خودکار با تماس با SKU خاتمه می یابد: جزئیات مکان (پایه، پیشرفته، یا ترجیحی) .
یک تماس با جزئیات مکان که هر فیلدی را از SKU درخواست میکند: جزئیات مکان (پایه، پیشرفته یا ترجیحی) در SKU صورتحساب میشود: جزئیات مکان (ترجیحا) .
جلسه تکمیل خودکار با تماس با SKU پایان یافت: اعتبار سنجی آدرس ترجیح داده می شود .
برای اطلاعات بیشتر، تکمیل خودکار (جدید) و قیمت جلسه را ببینید.
محدوده حجم ماهانه (قیمت هر تماس) | ||
---|---|---|
| | |
0.00 دلار برای هر کدام (0.00 دلار در هر 1000) | 0.00 دلار برای هر کدام (0.00 دلار در هر 1000) | 0.00 دلار برای هر کدام (0.00 دلار در هر 1000) |
SKU: جزئیات مکان (فقط شناسه ها)
با استفاده از یک ماسک فیلد یا لیست فیلد در درخواست جزئیات مکان (جدید)، می توانید پاسخ را فقط به آن فیلدهای مشخص شده محدود کنید. این SKU زمانی فعال می شود که شما فقط فیلدهای زیر را درخواست کنید:
وب سرویس : attributions
، id
، name
* ، photos
* فیلد name
حاوی نام منبع مکان به شکل است: places/ PLACE_ID
. از displayName
برای دسترسی به نام متنی مکان استفاده کنید.
محدوده حجم ماهانه (قیمت هر تماس) | ||
---|---|---|
| | |
0.0 دلار برای هر کدام (0.00 دلار در هر 1000) | 0.0 دلار برای هر کدام (0.00 دلار در هر 1000) | 0.0 دلار برای هر کدام (0.00 دلار در هر 1000) |
SKU: جزئیات مکان (فقط مکان)
با استفاده از یک ماسک فیلد یا لیست فیلد در درخواست جزئیات مکان (جدید)، می توانید پاسخ را فقط به آن فیلدهای مشخص شده محدود کنید. این SKU زمانی فعال می شود که شما فقط فیلدهای زیر را درخواست کنید:
وب سرویس : addressComponents
، adrFormatAddress
، formattedAddress
، location
، plusCode
، shortFormattedAddress
، types
، viewport
محدوده حجم ماهانه (قیمت هر تماس) | ||
---|---|---|
| | |
0.005 دلار برای هر کدام (5.00 دلار در هر 1000) | 0.004 دلار برای هر کدام (4.00 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
SKU: جزئیات مکان (اصلی)
با استفاده از یک ماسک فیلد یا لیست فیلد در درخواست جزئیات مکان (جدید)، می توانید پاسخ را فقط به آن فیلدهای مشخص شده محدود کنید. این SKU زمانی فعال می شود که شما فقط فیلدهای زیر را درخواست کنید:
سرویس وب : accessibilityOptions
، businessStatus
، containingPlaces
، displayName
subDestinations
googleMapsLinks
* ، googleMapsUri
، iconBackgroundColor
utcOffsetMinutes
iconMaskBaseUri
، primaryType
، primaryTypeDisplayName
، pureServiceAreaBusiness
.
* فیلد googleMapsLinks
در مرحله پیشنمایش پیشنمایش GA است و هزینهای دریافت نمیکند، به این معنی که صورتحساب 0 دلار برای استفاده در حین پیشنمایش است.
اگر یک جلسه تکمیل خودکار با یک تماس جزئیات مکان که هر فیلدی را از SKU درخواست میکند خاتمه مییابد: جزئیات مکان (پایه، پیشرفته یا ترجیحی) ، آنگاه صورتحساب تماس در SKU: جزئیات مکان (ترجیحدهی) انجام میشود. برای اطلاعات بیشتر، SKU: تکمیل خودکار جلسه استفاده را ببینید.
محدوده حجم ماهانه (قیمت هر تماس) | ||
---|---|---|
| | |
0.0170 دلار برای هر کدام (17.00 دلار در هر 1000) | 0.0136 دلار برای هر کدام (13.60 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
SKU: جزئیات مکان (پیشرفته)
با استفاده از یک ماسک فیلد یا لیست فیلد در درخواست جزئیات مکان (جدید)، می توانید پاسخ را فقط به آن فیلدهای مشخص شده محدود کنید. این SKU زمانی فعال می شود که شما فقط فیلدهای زیر را درخواست کنید:
وب سرویس : currentOpeningHours
، currentSecondaryOpeningHours
، internationalPhoneNumber
، nationalPhoneNumber
، priceLevel
، priceRange
، rating
، regularOpeningHours
، regularSecondaryOpeningHours
، userRatingCount
، websiteUri
اگر یک جلسه تکمیل خودکار با یک تماس جزئیات مکان که هر فیلدی را از SKU درخواست میکند خاتمه مییابد: جزئیات مکان (پایه، پیشرفته یا ترجیحی) ، آنگاه صورتحساب تماس در SKU: جزئیات مکان (ترجیحدهی) انجام میشود. برای اطلاعات بیشتر، SKU: تکمیل خودکار جلسه استفاده را ببینید.
محدوده حجم ماهانه (قیمت هر تماس) | ||
---|---|---|
| | |
0.020 دلار برای هر کدام (20.00 دلار در هر 1000) | 0.016 دلار برای هر کدام (16.00 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
SKU: جزئیات مکان (ترجیحا)
با استفاده از یک ماسک فیلد یا لیست فیلد در درخواست جزئیات مکان (جدید)، می توانید پاسخ را فقط به آن فیلدهای مشخص شده محدود کنید. این SKU زمانی فعال می شود که شما فقط فیلدهای زیر را درخواست کنید:
وب سرویس : allowsDogs
، curbsidePickup
، delivery
، dineIn
، editorialSummary
، evChargeOptions
، fuelOptions
، goodForChildren
، goodForGroups
، goodForWatchingSports
، liveMusic
، menuForChildren
، گزینه parkingOptions
، paymentOptions
outdoorSeating
، reservable
restroom
reviews
, routingSummaries
, * servesBeer
, servesBreakfast
, servesBrunch
, servesCocktails
, servesCoffee
قهوه , servesDessert
, servesDinner
, servesLunch
, servesVegetarianFood
, servesWine
, takeout
* فقط جستجوی متن و جستجوی نزدیک
اگر یک جلسه تکمیل خودکار با یک تماس جزئیات مکان که هر فیلدی را از SKU درخواست میکند خاتمه مییابد: جزئیات مکان (پایه، پیشرفته یا ترجیحی) ، آنگاه صورتحساب تماس در SKU: جزئیات مکان (ترجیحدهی) انجام میشود. برای اطلاعات بیشتر، SKU: تکمیل خودکار جلسه استفاده را ببینید.
محدوده حجم ماهانه (قیمت هر تماس) | ||
---|---|---|
| | |
0.025 دلار برای هر کدام (25.00 دلار در هر 1000) | 0.020 دلار برای هر کدام (20.00 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
SKU: جستجوی نزدیک (اصلی)
با استفاده از ماسک فیلد یا لیست فیلد در درخواست جستجوی نزدیک (جدید)، میتوانید پاسخ را فقط به آن قسمتهای مشخص شده محدود کنید. این SKU زمانی فعال می شود که شما فقط فیلدهای زیر را درخواست کنید:
سرویس وب : places.accessibilityOptions
، places.addressComponents
، places.adrFormatAddress
، places.attributions
، places.businessStatus
، places.containingPlaces
، places.displayName
، places.formattedAddress
، places.googleMapsLinks
* places.iconBackgroundColor
places.googleMapsUri
places.iconMaskBaseUri
iconMaskBaseUri، places.id
، places.location
، places.name
. نام ** ، places.photos
، places.plusCode
، places.primaryType
، places.primaryTypeDisplayName
.primaryTypeDisplayName، places.pureServiceAreaBusiness
، places.shortFormattedAddress
.shortFormattedAddress، places.subDestinations
places.types
. places.utcOffsetMinutes
، places.viewport
* قسمت places.googleMapsLinks
در مرحله پیشنمایش پیشنمایش GA است و هزینهای دریافت نمیکند، به این معنی که صورتحساب 0 دلار برای استفاده در طول پیشنمایش است.
** فیلد places.name
حاوی نام منبع مکان به شکل است: places/ PLACE_ID
. برای دسترسی به نام متنی مکان، از places.displayName
استفاده کنید.
محدوده حجم ماهانه (قیمت هر تماس) | ||
---|---|---|
| | |
0.032 دلار برای هر کدام (32.00 دلار در هر 1000) | 0.0256 دلار برای هر کدام (25.60 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
SKU: جستجوی نزدیک (پیشرفته)
با استفاده از ماسک فیلد یا لیست فیلد در درخواست جستجوی نزدیک (جدید)، میتوانید پاسخ را فقط به آن قسمتهای مشخص شده محدود کنید. این SKU زمانی فعال می شود که شما فقط فیلدهای زیر را درخواست کنید:
وب سرویس : places.currentOpeningHours
, places.currentSecondaryOpeningHours
, places.internationalPhoneNumber
, places.nationalPhoneNumber
, places.priceLevel
, places.priceRange
, places.rating
, places.regularOpeningHours
, places.regularSecondaryOpeningHours
. places.userRatingCount
, places.websiteUri
محدوده حجم ماهانه (قیمت هر تماس) | ||
---|---|---|
| | |
0.035 دلار برای هر کدام (35.00 دلار در هر 1000) | 0.028 دلار برای هر کدام (28.00 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
SKU: جستجوی نزدیک (ترجیحا)
با استفاده از ماسک فیلد یا لیست فیلد در درخواست جستجوی نزدیک (جدید)، میتوانید پاسخ را فقط به آن قسمتهای مشخص شده محدود کنید. این SKU زمانی فعال می شود که شما فقط فیلدهای زیر را درخواست کنید:
وب سرویس : places.allowsDogs
، places.curbsidePickup
، places.delivery
، places.dineIn
، places.editorialSummary
، places.evChargeOptions
، places.fuelOptions
، places.goodForChildren
، places.goodForGroups
، places.goodForWatchingSports
، places.liveMusic
. places.menuForChildren
، places.parkingOptions
پارکینگ گزینهها، places.paymentOptions
پرداخت گزینهها، places.outdoorSeating
در فضای باز، places.reservable
رزرو، places.restroom
، places.reviews
، places.routingSummaries
خلاصهها، * places.servesBeer
، places.servesBreakfast
صبحانه، places.servesBrunch
places.servesCocktails
places.servesCoffee
، places.servesDessert
سروها دسر , places.servesDinner
places.servesLunch
شام places.servesWine
places.servesVegetarianFood
places.takeout
* فقط جستجوی متن و جستجوی نزدیک
محدوده حجم ماهانه (قیمت هر تماس) | ||
---|---|---|
| | |
0.040 دلار برای هر کدام (40.00 دلار در هر 1000) | 0.032 دلار برای هر کدام (32.00 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
SKU: جستجوی متن (فقط شناسه)
با استفاده از ماسک فیلد یا لیست فیلد در درخواست جستجوی متن (جدید)، میتوانید پاسخ را فقط به آن قسمتهای مشخص شده محدود کنید. این SKU زمانی فعال می شود که شما فقط فیلدهای زیر را درخواست کنید:
وب سرویس : places.attributions
، places.id
، places.name
* ، nextPageToken
* فیلد places.name
حاوی نام منبع مکان به شکل است: places/ PLACE_ID
. برای دسترسی به نام متنی مکان، از places.displayName
استفاده کنید.
محدوده حجم ماهانه (قیمت هر تماس) | ||
---|---|---|
| | |
0.0 دلار برای هر کدام (0.00 دلار در هر 1000) | 0.0 دلار برای هر کدام (0.00 دلار در هر 1000) | 0.0 دلار برای هر کدام (0.00 دلار در هر 1000) |
SKU: جستجوی متن (پایه)
با استفاده از ماسک فیلد یا لیست فیلد در درخواست جستجوی متن (جدید)، میتوانید پاسخ را فقط به آن قسمتهای مشخص شده محدود کنید. این SKU زمانی فعال می شود که شما فقط فیلدهای زیر را درخواست کنید:
سرویس وب places.iconBackgroundColor
places.accessibilityOptions
، places.addressComponents
، places.adrFormatAddress
، places.businessStatus
، places.containingPlaces
، places.displayName
، places.formattedAddress
، places.googleMapsLinks
* ، places.googleMapsUri
places.iconMaskBaseUri
. places.location
, places.photos
, places.plusCode
, places.primaryType
, places.primaryTypeDisplayName
, places.pureServiceAreaBusiness
, places.shortFormattedAddress
, places.subDestinations
, places.types
, places.utcOffsetMinutes
places.viewport
* قسمت places.googleMapsLinks
در مرحله پیشنمایش پیشنمایش GA است و هزینهای دریافت نمیکند، به این معنی که صورتحساب 0 دلار برای استفاده در طول پیشنمایش است.
محدوده حجم ماهانه (قیمت هر تماس) | ||
---|---|---|
| | |
0.032 دلار برای هر کدام (32.00 دلار در هر 1000) | 0.0256 دلار برای هر کدام (25.60 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
SKU: جستجوی متن (پیشرفته)
با استفاده از ماسک فیلد یا لیست فیلد در درخواست جستجوی متن (جدید)، میتوانید پاسخ را فقط به آن قسمتهای مشخص شده محدود کنید. این SKU زمانی فعال می شود که شما فقط فیلدهای زیر را درخواست کنید:
وب سرویس : places.currentOpeningHours
, places.currentSecondaryOpeningHours
, places.internationalPhoneNumber
, places.nationalPhoneNumber
, places.priceLevel
, places.priceRange
, places.rating
, places.regularOpeningHours
, places.regularSecondaryOpeningHours
. places.userRatingCount
, places.websiteUri
محدوده حجم ماهانه (قیمت هر تماس) | ||
---|---|---|
| | |
0.035 دلار برای هر کدام (35.00 دلار در هر 1000) | 0.028 دلار برای هر کدام (28.00 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
SKU: جستجوی متن (ترجیحا)
با استفاده از ماسک فیلد یا لیست فیلد در درخواست جستجوی متن (جدید)، میتوانید پاسخ را فقط به آن قسمتهای مشخص شده محدود کنید. این SKU زمانی فعال می شود که شما فقط فیلدهای زیر را درخواست کنید:
وب سرویس : places.allowsDogs
، places.curbsidePickup
، places.delivery
، places.dineIn
، places.editorialSummary
، places.evChargeOptions
، places.fuelOptions
، places.goodForChildren
، places.goodForGroups
، places.goodForWatchingSports
، places.liveMusic
. places.menuForChildren
، places.parkingOptions
پارکینگ گزینهها، places.paymentOptions
. پرداخت گزینهها، places.outdoorSeating
در فضای باز، places.reservable
رزرو، places.restroom
، places.reviews
، places.routingSummaries
خلاصهها، * places.servesBeer
، places.servesBreakfast
صبحانه، places.servesBrunch
places.servesCocktails
places.servesCoffee
، places.servesDessert
سروها دسر , places.servesDinner
places.servesLunch
شام places.servesWine
places.servesVegetarianFood
places.takeout
* فقط جستجوی متن و جستجوی نزدیک
محدوده حجم ماهانه (قیمت هر تماس) | ||
---|---|---|
| | |
0.040 دلار برای هر کدام (40.00 دلار در هر 1000) | 0.032 دلار برای هر کدام (32.00 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
SKU: عکس مکان
برای هر درخواست به API یک Place Photo SKU دریافت میشود.
محدوده حجم ماهانه (قیمت هر تماس) | ||
---|---|---|
| | |
0.007 دلار برای هر کدام (7.00 دلار در هر 1000) | 0.0056 دلار برای هر کدام (5.60 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
قیمت گذاری برای Places API
درباره جلسات تکمیل خودکار
یک جلسه تکمیل خودکار شامل برخی از درخواستهای تکمیل خودکار (برای بازیابی پیشنهادات در یک مکان همانطور که کاربر تایپ میکند)، و حداکثر یک درخواست Places Details (برای بازیابی جزئیات مکان انتخاب شده توسط کاربر) است. همان نشانه جلسه به درخواست تکمیل خودکار و متعاقباً درخواست جزئیات مکان ارسال می شود. یک جلسه با اولین درخواست تکمیل خودکار شروع می شود (که معمولاً زمانی اتفاق می افتد که کاربر شروع به تایپ می کند). زمانی که کاربر یکی از پیشنهادات تکمیل خودکار را انتخاب کرده باشد، تماس جزئیات مکان ها برقرار می شود. اگر کاربر پیشنهادی را انتخاب نکند، تماسی با Places Details برقرار نمیشود.
پس از اینکه کاربر یک مکان را انتخاب کرد (یعنی تماس جزئیات مکان ها برقرار شد)، باید یک جلسه جدید را با استفاده از یک نشانه جلسه جدید شروع کنید.
جلسات تکمیل خودکار را می توان از API های زیر ایجاد کرد:
- سرویس تکمیل خودکار مکان API Places یا سرویس تکمیل خودکار مکانها در Maps JavaScript API . شما باید برنامه خود را طوری طراحی کنید که نشانه های جلسه ارائه دهد (شاید نیاز باشد کد موجود خود را تغییر دهید).
- ویجت تکمیل خودکار Maps JavaScript API . صورتحساب مبتنی بر جلسه بهطور خودکار در آن ویجتها فعال میشود، بدون نیاز به تغییر کد.
نشانه جلسه برای یک جلسه کاربر خوب است و نباید برای بیش از یک جلسه کاربر استفاده شود. اگر از یک نشانه جلسه استفاده مجدد کنید، جلسه نامعتبر تلقی می شود و درخواست ها به گونه ای محاسبه می شوند که گویی نشانه جلسه ارائه نشده است.
درخواستهای تکمیل خودکار و درخواستهای جزئیات مکانها با استفاده از جلسات در SKUهای مختلف صورتحساب میشوند.
درباره 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_COLOROUPlace.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
محدوده حجم ماهانه (قیمت هر تماس) | ||
---|---|---|
| | |
هزینه درخواست مکان ها + 0.00 USD | هزینه درخواست مکان ها + 0.00 USD | هزینه درخواست مکان ها + 0.00 USD |
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
, orwebsite
محدوده حجم ماهانه (قیمت هر تماس) | ||
---|---|---|
| | |
هزینه درخواست مکان ها + 0.003 دلار برای هر کدام (+ 3.00 دلار در هر 1000) | هزینه درخواست مکان ها + 0.0024 دلار برای هر کدام (+ 2.40 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
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
.
محدوده حجم ماهانه (قیمت هر تماس) | ||
---|---|---|
| | |
هزینه درخواست مکان ها + 0.005 دلار برای هر کدام (+ 5.00 دلار در هر 1000) | هزینه درخواست مکان ها + 0.004 دلار برای هر کدام (+ 4.00 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
SKU: تکمیل خودکار - به ازای هر درخواست
SKU تکمیل خودکار – به ازای هر درخواست برای هر یک از این تماسها یا درخواستهایی که شامل نشانه جلسه نیستند، هزینه میشود:
- Android:
findAutocompletePredictions()
- iOS:
findAutocompletePredictionsFromQuery:
- جاوا اسکریپت: سرویس تکمیل خودکار مکان Maps JavaScript API
- وب سرویس: Places API Place Autocomplete Service
برای تماسهایی که از یک جلسه تکمیل خودکار نامعتبر انجام میشود (به عنوان مثال، جلسهای که از یک نشانه جلسه مجددا استفاده میکند) هزینه تکمیل خودکار – به ازای هر درخواست SKU نیز دریافت میشود.
درخواستهای تکمیل خودکار از ابزارک تکمیل خودکار مکان Maps JavaScript API ممکن است یک SKU تکمیل خودکار - به ازای هر درخواست در صورتی که تماسهایی از یک جلسه تکمیل خودکار نامعتبر برقرار شود، دریافت شود. این ممکن است زمانی اتفاق بیفتد که کاربر چندین آدرس مختلف را تایپ میکند یا آدرسهای مختلف را در ویجت کپی/پیست میکند و همیشه یک پیشبینی تکمیل خودکار را انتخاب نمیکند.
محدوده حجم ماهانه (قیمت به ازای هر درخواست) | ||
---|---|---|
| | |
0.00283 USD به ازای هر (2.83 دلار در هر 1000) | 0.00227 USD به ازای هر (2.27 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
SKU: تکمیل خودکار بدون جزئیات مکان - در هر جلسه
تکمیل خودکار بدون جزئیات مکان – SKU در هر جلسه برای یک جلسه تکمیل خودکار که شامل درخواست جزئیات مکان نیست (در عرض چند دقیقه پس از شروع جلسه) هزینه دریافت میشود.
محدوده حجم ماهانه (قیمت هر جلسه) | ||
---|---|---|
| | |
0.017 دلار برای هر کدام (17.00 دلار در هر 1000) | 0.0136 دلار برای هر کدام (13.60 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
مثال
اگر برنامه شما این دو تماس را در یک جلسه صادر کرد:
اندروید
- 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 صورتحساب میشوند: تکمیل خودکار بدون جزئیات مکان – در هر جلسه .
محدوده حجم ماهانه (قیمت هر جلسه) | ||
---|---|---|
| | |
0.00 USD | 0.00 USD | 0.00 USD |
مثال
اگر برنامه شما سه تماس زیر را در یک جلسه صادر کرد:
اندروید
- 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
محدوده حجم ماهانه (قیمت به ازای هر درخواست) | ||
---|---|---|
| | |
0.00283 USD به ازای هر (2.83 دلار در هر 1000) | 0.00227 USD به ازای هر (2.27 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
قیمت گذاری بر اساس جلسه تکمیل خودکار با استفاده از تکمیل خودکار Query پشتیبانی نمی شود. هزینه تماسهای بعدی Places Details بر اساس قیمت معمولی Places Details محاسبه میشود.
SKU: جزئیات مکان ها
هزینه تماسهای جزئیات مکانها به شرح زیر است:
محدوده حجم ماهانه (قیمت هر تماس) | ||
---|---|---|
| | |
0.017 دلار برای هر کدام (17.00 دلار در هر 1000) | 0.0136 دلار برای هر کدام (13.60 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
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 های داده ایجاد می شوند ، و شما برای جزئیات مکان تماس یا درخواست به علاوه هزینه تمام داده ها دریافت می کنید.
نمونه ها
- یکی از این تماس ها یا درخواست ها را انجام دهید:
- موبایل: با
fetchPlace()
با Android یاfetchPlaceFromPlaceID:
در iOS ، و فقط قسمتADDRESS
را مشخص کنید - API وب یا سرویس: یک مکان را درخواست کنید و فقط قسمت آدرس را مشخص کنید:
getPlaceDetails(fields: formatted_address)
- جزئیات مکان (قیمت شروع از 0.017 دلار در هر جلسه)
- داده های اساسی (صورتحساب با 0.00 دلار)
- موبایل: با
- یکی از این تماس ها یا درخواست ها را انجام دهید:
- موبایل: با
fetchPlace()
با Android یاfetchPlaceFromPlaceID:
در iOS تماس بگیرید و فقط قسمتPHONE_NUMBER
را مشخص کنید - API یا سرویس: یک مکان را درخواست کنید و قسمت شماره تلفن را مشخص کنید:
getPlaceDetails(fields: formatted_phone_number)
- جزئیات مکان (قیمت شروع از 0.017 دلار در هر جلسه)
- با داده های تماس (قیمت شروع از 0.003 دلار در هر درخواست)
- موبایل: با
- یکی از این تماس ها یا درخواست ها را انجام دهید:
- موبایل: با
fetchPlace()
در Android یاfetchPlaceFromPlaceID:
در iOS تماس بگیرید و تمام زمینه ها را مشخص کنید - API یا سرویس وب: یک مکان را درخواست کنید و تمام قسمت ها را مشخص کنید (در صورت عدم مشخص کردن هیچ زمینه ای ، این نوع درخواست پیش فرض است):
getPlaceDetails()
.
- جزئیات مکان (قیمت شروع از 0.017 دلار در هر جلسه)
- داده های اساسی (صورتحساب با 0.00 دلار)
- با داده های تماس (قیمت شروع از 0.003 دلار در هر درخواست)
- داده های جو (قیمت شروع از 0.005 دلار در هر درخواست)
- موبایل: با
SKU: جزئیات مکان - تازه سازی شناسه
برای تازه کردن شناسه های مکان قدیمی ، از درخواست Place Details استفاده کنید. این نوع درخواست ها بدون هیچ هزینه ای در دسترس هستند.
دامنه حجم ماهانه (قیمت در هر تماس) | ||
---|---|---|
| | |
0.00 USD | 0.00 USD | 0.00 USD |
مثال
درخواست جزئیات مکان را مشخص کنید که فقط قسمت شناسه مکان را مشخص کنید: getPlaceDetails(fields: place_id)
. در صورتحساب خود ، این SKU ذکر شده را مشاهده خواهید کرد (هنگام مشاهده صورتحساب خود توسط SKU ):
- جزئیات مکان - تازه سازی شناسه (صورتحساب با 0.00 دلار)
SKU: مکان را پیدا کنید
Find Place برای درخواست مکان Find شارژ می شود.
دامنه حجم ماهانه (قیمت در هر تماس) | ||
---|---|---|
| | |
در هر کدام 0.017 دلار (17.00 دلار در هر 1000) | 0.0136 دلار در هر کدام (13.60 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
بسته به زمینه هایی که در درخواست مشخص شده است ، درخواست های مکان را نیز پیدا کنید که SKU داده ( اساسی ، مخاطب و/یا جو ) ایجاد می کند. مانند درخواست های جزئیات مکان ، می توانید از پارامتر Fields در درخواست Find Place خود استفاده کنید تا پاسخ فقط به قسمتهای مشخص شده محدود شود. شما برای درخواست Find Place و همچنین داده های درخواست شده صورتحساب می شوید. به طور پیش فرض ، اگر هیچ زمینه ای درخواست نشده باشد ، فقط شناسه مکان بازگردانده می شود ، بنابراین هیچ هزینه داده اضافی متحمل نمی شود.
نمونه ها
- شما یک درخواست مکان پیدا می کنید و فقط قسمت آدرس را مشخص می کنید:
FindPlace(fields: formatted_address)
. در صورتحساب خود ، این SKU های ذکر شده را مشاهده خواهید کرد (هنگام مشاهده صورتحساب خود توسط SKU ):- مکان را پیدا کنید (قیمت شروع از 0.017 دلار در هر تماس)
- داده های اساسی (صورتحساب با 0.00 دلار)
- شما یک درخواست مکان پیدا می کنید و قسمت شماره تلفن را مشخص می کنید:
FindPlace(fields: formatted_phone_number)
. در صورتحساب خود ، این SKU های ذکر شده را مشاهده خواهید کرد (هنگام مشاهده صورتحساب خود توسط SKU ):- مکان را پیدا کنید (قیمت شروع از 0.017 دلار در هر تماس)
- با داده های تماس (قیمت شروع از 0.003 دلار در هر درخواست)
- شما یک درخواست مکان پیدا می کنید و زمینه هایی را از هر سه سطل از نوع داده ها مشخص می کنید:
FindPlace(fields: formatted_address, opening_hours, price_level)
. در صورتحساب خود ، این SKU های ذکر شده را مشاهده خواهید کرد (هنگام مشاهده صورتحساب خود توسط SKU ):- مکان را پیدا کنید (قیمت شروع از 0.017 دلار در هر تماس)
- داده های اساسی (صورتحساب با 0.00 دلار)
- با داده های تماس (قیمت شروع از 0.003 دلار در هر درخواست)
- داده های جو (قیمت شروع از 0.005 دلار در هر درخواست)
SKU: مکان را پیدا کنید - فقط شناسه
Find Place - ID فقط برای یافتن درخواست های مکان که فقط شناسه مکان را برای بازگشت مشخص می کند ، شارژ می شود. به طور پیش فرض ، اگر هیچ زمینه ای در درخواست Find Place مشخص نشده باشد ، فقط شناسه مکان بازگردانده می شود.
دامنه حجم ماهانه (قیمت در هر تماس) | ||
---|---|---|
| | |
0.00 USD | 0.00 USD | 0.00 USD |
مثال
شما یک درخواست مکان پیدا می کنید و فقط قسمت place_id
را مشخص می کنید: FindPlace(fields: place_id)
. در صورتحساب خود ، این SKU ذکر شده را مشاهده خواهید کرد (هنگام مشاهده صورتحساب خود توسط SKU ):
- Find Place - ID فقط (صورتحساب با 0.00 دلار)
SKU: مکان ها - جستجوی مجاور
مکان ها - جستجوی مجاور برای درخواست به نقشه های JavaScript API در نزدیکی سرویس جستجو در نزدیکی ( nearbySearch()
) یا به مکان های API در نزدیکی سرویس پرداخت می شود.
دامنه حجم ماهانه (قیمت در هر تماس) | ||
---|---|---|
| | |
0.032 دلار در هر کدام (32.00 دلار در هر 1000) | 0.0256 دلار در هر کدام (25.60 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
درخواست های جستجو در نزدیکی لیستی از مکان ها را برمی گردانند ، اما از مشخص کردن اینکه کدام قسمت ها بازگردانده می شوند ، پشتیبانی نمی کنند. درخواست های جستجو در نزدیکی زیر مجموعه ای از زمینه های داده پشتیبانی شده را برمی گرداند. شما برای درخواست جستجوی مجاور در هر یک از 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 دلار در هر کدام (32.00 دلار در هر 1000) | 0.0256 دلار در هر کدام (25.60 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
درخواست های جستجوی متن لیستی از مکان ها را برمی گرداند ، اما از مشخص کردن کدام قسمت ها پشتیبانی نمی کند. درخواست های جستجوی متن زیر مجموعه ای از قسمتهای داده پشتیبانی شده را برمی گرداند. شما برای درخواست جستجوی متن از هر یک از 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 برای به دست آوردن داده های پیکسل استفاده نشود ، باعث صورتحساب نمی شود.
دامنه حجم ماهانه (قیمت در هر تماس) | ||
---|---|---|
| | |
0.007 دلار در هر کدام (7.00 دلار در هر 1000) | 0.0056 دلار در هر کدام (5.60 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
محدودیت های دیگر استفاده
در حالی که حداکثر تعداد درخواست در روز وجود ندارد ، محدودیت های استفاده زیر هنوز اعمال می شود:
مکان های API (جدید) : حد نرخ 600 QPM (درخواست در دقیقه) در هر روش API در هر پروژه است. به این معنی که هر روش API سهمیه جداگانه ای دارد.
مکان های API : حد نرخ 6000 qpm (درخواست در دقیقه) است. این به عنوان مجموع درخواست های سمت مشتری و سمت سرور برای کلیه برنامه ها با استفاده از اعتبارنامه همان پروژه محاسبه می شود.
شرایط استفاده محدودیت
برای کسب اطلاعات در مورد شرایط استفاده ، به خط مشی برای مکان های API و بخش محدودیت مجوز از شرایط خدمات پلت فرم Google Maps مراجعه کنید.
هزینه استفاده خود را مدیریت کنید
برای مدیریت هزینه استفاده خود از مکانها API یا پاسخگویی به خواسته های ترافیک تولید خود ، محدودیت های سهمیه روزانه را برای همه درخواست ها به هر API تعیین کنید. سهمیه روزانه در نیمه شب اقیانوس آرام تنظیم می شود.
برای مشاهده یا تغییر محدودیت سهمیه برای مکانها API:
- در کنسول ابری ، صفحه سهمیه پلت فرم Google Maps را باز کنید.
- روی کشویی APIS کلیک کرده و API مکان ها را انتخاب کنید.
- برای مشاهده محدوده سهمیه ، به کارت درخواست ها بروید.
یک جدول نام و محدودیت های سهمیه را ذکر کرده است. - برای تغییر حد سهمیه ، برای آن حد بر روی نماد ویرایش کلیک کنید.
در گفتگوی که ظاهر می شود ، در قسمت Lota Limit ، محدوده سهمیه روزانه قابل پرداخت را وارد کنید (تا حد سهمیه ، در صورت وجود ، توسط Google مشخص شده است) و Save را انتخاب کنید.
اگر استفاده از API شما در هر روز به حد سهمیه قابل پرداخت شما برسد ، درخواست شما قادر به دسترسی به API برای باقی مانده آن روز نخواهد بود.