خطا: 9005 PLACES_API_RATE_LIMIT_EXCEEDED
Places SDK برای Android از یک مدل قیمتگذاری مبتنی بر پرداخت استفاده میکند. Places SDK for Android درخواستهای Places SDK for Android توسط SKU صورتحساب میشود. همراه با شرایط استفاده کلی Google، محدودیتهای استفاده خاص برای Places SDK برای Android وجود دارد. هزینه ها و استفاده خود را با ابزارهای موجود در Google Cloud Console مدیریت کنید .
نحوه صورتحساب Places SDK برای Android
Places SDK برای Android (جدید) و Places SDK برای Android از یک مدل قیمتگذاری مبتنی بر پرداخت استفاده میکند. APIها و SDKهای پلتفرم Google Maps توسط SKU صورتحساب میشوند. استفاده برای هر SKU ردیابی میشود و هر API یا SDK ممکن است بیش از یک SKU محصول داشته باشد. هزینه توسط:
برای تخمین هزینه استفاده در هر API یا SDK از ماشین حساب قیمت و استفاده ما استفاده کنید. برای SKUهای پلتفرم Google Maps واجد شرایط، هر ماه اعتبار 200 دلاری Google Maps Platform برای هر حساب صورتحساب در دسترس است. این اعتبار به طور خودکار 1 به SKUهای واجد شرایط اعمال می شود.
قیمت گذاری Places SDK برای Android (جدید)
درباره ماسک های میدانی
در درخواستهای خود از ماسکهای فیلد که لیستهای فیلد نیز نامیده میشوند استفاده کنید تا لیست فیلدهایی را که باید در پاسخ بازگردانده شوند مشخص کنید. سپس با بالاترین SKU مربوط به درخواست شما صورتحساب دریافت می کنید. این بدان معناست که اگر فیلدهایی را در SKU (پایه) و SKU (پیشرفته) انتخاب کنید، بر اساس SKU (پیشرفته) صورتحساب دریافت می کنید.
استفاده از یک فیلد ماسک یک روش طراحی خوب برای اطمینان از عدم درخواست داده های غیر ضروری است که به جلوگیری از زمان پردازش غیر ضروری و هزینه های صورتحساب کمک می کند.
SKU: جزئیات مکان (فقط شناسه ها)
با استفاده از یک ماسک فیلد یا لیست فیلد در درخواست جزئیات مکان (جدید)، می توانید پاسخ را فقط به آن فیلدهای مشخص شده محدود کنید. این SKU زمانی فعال می شود که شما فقط فیلدهای زیر را درخواست کنید:
Android : Place.Field.ID
، Place.Field.NAME
، Place.Field.PHOTO_METADATAS
محدوده حجم ماهانه (قیمت هر تماس) | ||
---|---|---|
| | |
0.0 دلار برای هر کدام (0.00 دلار در هر 1000) | 0.0 دلار برای هر کدام (0.00 دلار در هر 1000) | 0.0 دلار برای هر کدام (0.00 دلار در هر 1000) |
SKU: جزئیات مکان (اصلی)
با استفاده از یک ماسک فیلد یا لیست فیلد در درخواست جزئیات مکان (جدید)، می توانید پاسخ را فقط به آن فیلدهای مشخص شده محدود کنید. این SKU زمانی فعال می شود که شما فقط فیلدهای زیر را درخواست کنید:
Android : Place.Field.ADDRESS
, Place.Field.ADDRESS_COMPONENTS
, Place.Field.BUSINESS_STATUS
Place.Field.LAT_LNG
Place.Field.ICON_BACKGROUND_COLOR
, Place.Field.ICON_URL
, Place.Field.PLUS_CODE
, Place.Field.TYPES
. Place.Field.UTC_OFFSET
، Place.Field.VIEWPORT
Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
محدوده حجم ماهانه (قیمت هر تماس) | ||
---|---|---|
| | |
0.0170 دلار برای هر کدام (17.00 دلار در هر 1000) | 0.0136 دلار برای هر کدام (13.60 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
SKU: جزئیات مکان (پیشرفته)
با استفاده از یک ماسک فیلد یا لیست فیلد در درخواست جزئیات مکان (جدید)، می توانید پاسخ را فقط به آن فیلدهای مشخص شده محدود کنید. این SKU زمانی فعال می شود که شما فقط فیلدهای زیر را درخواست کنید:
Android : Place.Field.CURRENT_OPENING_HOURS
, Place.Field.SECONDARY_OPENING_HOURS
, Place.Field.PHONE_NUMBER
, Place.Field.PRICE_LEVEL
, Place.Field.RATING
, Place.Field.OPENING_HOURS
, Place.Field.USER_RATINGS_TOTAL
Place.Field.WEBSITE_URI
محدوده حجم ماهانه (قیمت هر تماس) | ||
---|---|---|
| | |
0.020 دلار برای هر کدام (20.00 دلار در هر 1000) | 0.016 دلار برای هر کدام (16.00 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
SKU: جزئیات مکان (ترجیحا)
با استفاده از یک ماسک فیلد یا لیست فیلد در درخواست جزئیات مکان (جدید)، می توانید پاسخ را فقط به آن فیلدهای مشخص شده محدود کنید. این SKU زمانی فعال می شود که شما فقط فیلدهای زیر را درخواست کنید:
Android : Place.Field.CURBSIDE_PICKUP
, Place.Field.DELIVERY
, Place.Field.DINE_IN
, Place.Field.EDITORIAL_SUMMARY
, Place.Field.RESERVABLE
, Place.Field.REVIEWS
, Place.Field.SERVES_BEER
, Place.Field.SERVES, Place.Field.SERVES_BREAKFAST
. Place.Field.SERVES_BRUNCH
, Place.Field.SERVES_DINNER
, Place.Field.SERVES_LUNCH
, Place.Field.SERVES_VEGETARIAN_FOOD
, Place.Field.SERVES_WINE
, Place.Field.TAKEOUT
محدوده حجم ماهانه (قیمت هر تماس) | ||
---|---|---|
| | |
0.025 دلار برای هر کدام (25.00 دلار در هر 1000) | 0.020 دلار برای هر کدام (20.00 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
SKU: جستجوی متن (فقط شناسه)
با استفاده از یک ماسک فیلد یا لیست فیلد در درخواست جزئیات مکان (جدید)، می توانید پاسخ را فقط به آن فیلدهای مشخص شده محدود کنید. این SKU زمانی فعال می شود که شما فقط فیلدهای زیر را درخواست کنید:
Android : Place.Field.ID
، Place.Field.NAME
محدوده حجم ماهانه (قیمت هر تماس) | ||
---|---|---|
| | |
0.0 دلار برای هر کدام (0.00 دلار در هر 1000) | 0.0 دلار برای هر کدام (0.00 دلار در هر 1000) | 0.0 دلار برای هر کدام (0.00 دلار در هر 1000) |
SKU: جستجوی متن (پایه)
با استفاده از یک ماسک فیلد یا لیست فیلد در درخواست جزئیات مکان (جدید)، می توانید پاسخ را فقط به آن فیلدهای مشخص شده محدود کنید. این SKU زمانی فعال می شود که شما فقط فیلدهای زیر را درخواست کنید:
Android : Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
, Place.Field.ADDRESS_COMPONENTS
, Place.Field.BUSINESS_STATUS
, Place.Field.ADDRESS
, Place.Field.ICON_BACKGROUND_COLOR
, Place.Field.LAT_LNG
, Place.Field.PHOTO_METADATAS
Place.Field.ICON_URL
Place.Field.PLUS_CODE
، Place.Field.TYPES
، Place.Field.UTC_OFFSET
، Place.Field.VIEWPORT
محدوده حجم ماهانه (قیمت هر تماس) | ||
---|---|---|
| | |
0.032 دلار برای هر کدام (32.00 دلار در هر 1000) | 0.0256 دلار برای هر کدام (25.60 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
SKU: جستجوی متن (پیشرفته)
با استفاده از یک ماسک فیلد یا لیست فیلد در درخواست جزئیات مکان (جدید)، می توانید پاسخ را فقط به آن فیلدهای مشخص شده محدود کنید. این SKU زمانی فعال می شود که شما فقط فیلدهای زیر را درخواست کنید:
Android : Place.Field.CURRENT_OPENING_HOURS
, Place.Field.SECONDARY_OPENING_HOURS
, Place.Field.PHONE_NUMBER
, Place.Field.PRICE_LEVEL
, Place.Field.RATING
, Place.Field.OPENING_HOURS
, Place.Field.USER_RATINGS_TOTAL
Place.Field.WEBSITE_URI
محدوده حجم ماهانه (قیمت هر تماس) | ||
---|---|---|
| | |
0.035 دلار برای هر کدام (35.00 دلار در هر 1000) | 0.028 دلار برای هر کدام (28.00 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
SKU: جستجوی متن (ترجیحا)
با استفاده از یک ماسک فیلد یا لیست فیلد در درخواست جزئیات مکان (جدید)، می توانید پاسخ را فقط به آن فیلدهای مشخص شده محدود کنید. این SKU زمانی فعال می شود که شما فقط فیلدهای زیر را درخواست کنید:
Android : Place.Field.CURBSIDE_PICKUP
, Place.Field.DELIVERY
, Place.Field.DINE_IN
, Place.Field.EDITORIAL_SUMMARY
, Place.Field.RESERVABLE
, Place.Field.REVIEWS
, Place.Field.SERVES_BEER
, Place.Field.SERVES, Place.Field.SERVES_BREAKFAST
. Place.Field.SERVES_BRUNCH
, Place.Field.SERVES_DINNER
, Place.Field.SERVES_LUNCH
, Place.Field.SERVES_VEGETARIAN_FOOD
, Place.Field.SERVES_WINE
, Place.Field.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 SDK برای اندروید
درباره جلسات تکمیل خودکار
یک جلسه تکمیل خودکار شامل برخی از درخواستهای تکمیل خودکار (برای بازیابی پیشنهادات در یک مکان همانطور که کاربر تایپ میکند)، و حداکثر یک درخواست 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 جزئیات مکان محاسبه می شود.
SKU: داده های پایه
با استفاده از پارامتر فیلدها در درخواست جزئیات مکان یا یافتن مکان، میتوانید پاسخ را فقط به آن فیلدهای مشخص شده محدود کنید. فیلدهای دسته Basic در هزینه پایه درخواست Places گنجانده شده است و هزینه اضافی دریافت نمی کند. هنگامی که هر یک از این فیلدها درخواست شود، SKU داده های پایه فعال می شود:
- Android:
Place.Field.ADDRESS
,Place.Field.ADDRESS_COMPONENTS
,Place.Field.BUSINESS_STATUS
,Place.Field.ICON_BACKGROUND_COLOR
,Place.Field.ICON_URL
,Place.Field.ID
,Place.Field.LAT_LNG
,Place.Field.NAME
Place.Field.PHOTO_METADATAS
،Place.Field.PLUS_CODE
،Place.Field.TYPES
،Place.Field.VIEWPORT
،Place.Field.UTC_OFFSET
، یاPlace.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
- iOS:
GMSPlaceFieldFormattedAddress
،GMSPlaceFieldBusinesssStatus
،GMSPlaceFieldID
،GMSPlaceFieldCoordinate
،GMSPlaceFieldName
،GMSPlaceFieldPhotos
GMSPlaceFieldViewport
GMSPlaceFieldPlusCode
،GMSPlaceFieldTypes
، - سرویس وب:
address_component
،adr_address
،business_status
،formatted_address
،geometry
،icon
،name
،permanently_closed
،photo
،place_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.OPENING_HOURS
،Place.Field.PHONE_NUMBER
،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_VEGETARIAN_FOOD
،Place.Field.SERVES_LUNCH
،Place.Field.SERVES_DINNER
،Place.Field.SERVES_WINE
، مکان.میدانPlace.Field.TAKEOUT
Place.Field.USER_RATINGS_TOTAL
- iOS:
GMSPlaceFieldPriceLevel
,GMSPlaceFieldRating
,GMSPlaceFieldUserRatingsTotal
,GMSPlaceFieldTakeout
,GMSPlaceFieldDelivery
,GMSPlaceFieldDineIn
, GMSPlaceFieldCurbsideCurbsideBservableSPickupce,GMSPlaceFieldCurbsidePickup
,GMSPlaceFieldReservable
GMSPlaceFieldServesBrunch
GMSPlaceFieldServesLunch
,GMSPlaceFieldServesBreakfast
,GMSPlaceFieldServesDinner
,GMSPlaceFieldServesBeer
,GMSPlaceFieldServesWine
یاGMSPlaceFieldServesVegetarianFood
. - جاوا اسکریپت : فیلدها را ببینید (جزئیات مکان)
- وب سرویس :
curbside_pickup
،delivery
،dine_in
،editorial_summary
،price_level
،rating
،reservable
،reviews
،serves_beer
،serves_breakfast
،serves_brunch
،serves_dinner
، ناهار_ناهار، سروهای_گیاهی_غذای_غذایی،serves_lunch
،serves_vegetarian_food
،takeout
،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: جزئیات مکان
هزینه تماس با جزئیات مکان به شرح زیر است:
محدوده حجم ماهانه (قیمت هر تماس) | ||
---|---|---|
| | |
0.017 دلار برای هر کدام (17.00 دلار در هر 1000) | 0.0136 دلار برای هر کدام (13.60 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
SKU جزئیات مکان از این APIها ایجاد می شود:
- Android: Places SDK برای Android (
fetchPlace()
) - iOS: مکانهای SDK برای iOS (
fetchPlaceFromPlaceID:
:) - JavaScript: Maps JavaScript's Place Details Service (
getDetails
) - جاوا اسکریپت: ویجت تکمیل خودکار مکان (
getPlace
) در API جاوا اسکریپت Maps - جاوا اسکریپت: نقشه جاوا اسکریپت جاوا اسکریپت ابزارک SearchBox مکان : متد
getPlaces()
پس از انتخاب یک نتیجه مکان (نماد: پین)، *نه* یک پرس و جو (نماد: ذره بین)، همانطور که در اینجا نشان داده شده است:در نتایج ویجت جعبه جستجو، پس از تایپ "پیتزا" در کادر جستجو، توجه کنید که Pizza Autentico یک نماد پین در کنار آن دارد که نشان می دهد یک نتیجه مکان (و نه یک پرس و جو) است. - وب سرویس: Places API خدمات جزئیات مکان
با وب API و سرویسها، SKU جزئیات مکان هزینه میشود، چه نشانه جلسه ارائه شود یا نه.
یک تماس یا درخواست جزئیات مکان نیز بسته به فیلدهایی که در تماس یا درخواست مشخص شدهاند، SKUهای داده ( اصلی ، تماس ، و/یا جو ) ایجاد میکند. اگر هیچ فیلدی در تماس یا درخواست جزئیات مکان مشخص نشده باشد، همه SKUهای داده فعال می شوند و برای تماس یا درخواست جزئیات مکان ها به اضافه هزینه تمام داده ها هزینه دریافت می کنید.
مثال ها
- یکی از این تماس ها یا درخواست ها را انجام دهید:
- تلفن همراه: با
fetchPlace()
در Android یاfetchPlaceFromPlaceID:
در iOS تماس بگیرید و فقط قسمتADDRESS
را مشخص کنید - Web API یا سرویس: درخواست جزئیات مکان را انجام دهید و فقط فیلد آدرس را مشخص کنید:
getPlaceDetails(fields: formatted_address)
- جزئیات مکان (قیمت از 0.017 دلار در هر جلسه شروع می شود)
- داده های پایه (صورتحساب 0.00 USD)
- تلفن همراه: با
- یکی از این تماس ها یا درخواست ها را انجام دهید:
- تلفن همراه: با
fetchPlace()
در Android یاfetchPlaceFromPlaceID:
در iOS تماس بگیرید و فقط فیلدPHONE_NUMBER
مشخص کنید - Web API یا سرویس: درخواست جزئیات مکان و فیلد شماره تلفن را مشخص کنید:
getPlaceDetails(fields: formatted_phone_number)
- جزئیات مکان (قیمت از 0.017 دلار در هر جلسه شروع می شود)
- اطلاعات تماس (قیمت از 0.003 دلار در هر درخواست شروع می شود)
- تلفن همراه: با
- یکی از این تماس ها یا درخواست ها را انجام دهید:
- تلفن همراه: با
fetchPlace()
در Android یاfetchPlaceFromPlaceID:
در iOS تماس بگیرید و تمام فیلدها را مشخص کنید - Web API یا سرویس: یک درخواست Place Details ایجاد کنید و همه فیلدها را مشخص کنید (اگر هیچ فیلدی را مشخص نکنید این نوع درخواست پیشفرض است):
getPlaceDetails()
.
- جزئیات مکان (قیمت از 0.017 دلار در هر جلسه شروع می شود)
- داده های پایه (صورتحساب 0.00 USD)
- اطلاعات تماس (قیمت از 0.003 دلار در هر درخواست شروع می شود)
- داده های جوی (قیمت از 0.005 دلار در هر درخواست شروع می شود)
- تلفن همراه: با
SKU: مکان فعلی را پیدا کنید
هزینه Find Current Place برای تماسهای findCurrentPlace()
(Android) یا findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) محاسبه میشود.
محدوده حجم ماهانه (قیمت هر تماس) | ||
---|---|---|
| | |
0.030 دلار برای هر کدام (30.00 دلار در هر 1000) | 0.024 دلار برای هر کدام (24.00 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
فراخوانی برای findCurrentPlace()
(Android) یا findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) همچنین بسته به فیلدهایی که در تماس مشخص شدهاند، SKUهای داده ( Basic ، Contact ، و/یا Atmosphere ) تولید میکنند. فیلدهای داده را مشخص کنید تا پاسخ فقط به آن فیلدها محدود شود. برای تماس یافتن مکان فعلی و همچنین دادههای درخواستی صورتحساب دریافت میکنید.
مثال ها
- شما با
findCurrentPlace()
(Android) یاfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) تماس می گیرید و فقط فیلدADDRESS
را مشخص می کنید. در صورتحساب خود، این SKUها را مشاهده خواهید کرد (هنگام مشاهده صورتحساب خود توسط SKU ):- مکان فعلی را پیدا کنید (قیمت از 0.030 دلار برای هر درخواست شروع می شود)
- داده های پایه (صورتحساب 0.00 USD)
- شما با
findCurrentPlace()
(Android) یاfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) تماس بگیرید و فیلدPHONE_NUMBER
را مشخص کنید. در صورتحساب خود، این SKUها را مشاهده خواهید کرد (هنگام مشاهده صورتحساب خود توسط SKU ):- مکان فعلی را پیدا کنید (قیمت از 0.030 دلار برای هر درخواست شروع می شود)
- اطلاعات تماس (قیمت از 0.003 دلار در هر درخواست شروع می شود)
- شما
findCurrentPlace()
(Android) یاfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) را فراخوانی می کنید و فیلدهای هر سه سطل نوع داده را مشخص می کنید. در صورتحساب خود، این SKUها را مشاهده خواهید کرد (هنگام مشاهده صورتحساب خود توسط SKU ):- مکان فعلی را پیدا کنید (قیمت از 0.030 دلار برای هر درخواست شروع می شود)
- داده های پایه (صورتحساب 0.00 USD)
- اطلاعات تماس (قیمت از 0.003 دلار در هر درخواست شروع می شود)
- داده های جوی (قیمت از 0.005 دلار در هر درخواست شروع می شود)
SKU: عکس مکان
هزینه SKU عکس مکان برای:
- Android: فراخوانی به
fetchPhoto()
- iOS: تماس برای
loadPlacePhoto:
- جاوا اسکریپت: به کتابخانه مکانها، سرویس عکسهای مکان API جاوا اسکریپت Maps هنگام درخواست داده از آدرسهای اینترنتی بازگردانده شده توسط
PlacePhoto.getUrl()
برای بارگیری دادههای پیکسل تصویر - وب سرویس: درخواست به سرویس Places API Place Photos
برای سرویس جاوا اسکریپت، فراخوانی متد PlacePhoto.getUrl()
باعث صدور صورتحساب نمیشود تا زمانی که URL واقعاً برای به دست آوردن دادههای پیکسل استفاده شود.
محدوده حجم ماهانه (قیمت هر تماس) | ||
---|---|---|
| | |
0.007 دلار برای هر کدام (7.00 دلار در هر 1000) | 0.0056 دلار برای هر کدام (5.60 دلار در هر 1000) | برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید |
محدودیت های شرایط استفاده
برای کسب اطلاعات در مورد شرایط استفاده، به بخش محدودیتهای مجوز در شرایط خدمات پلتفرم Google Maps مراجعه کنید.
هزینه استفاده خود را مدیریت کنید
برای مدیریت هزینه استفاده از Places SDK برای Android یا برآورده کردن نیازهای ترافیک تولید خود، محدودیتهای سهمیه روزانه را برای همه درخواستها برای هر API تنظیم کنید. سهمیه های روزانه در نیمه شب به وقت اقیانوس آرام بازنشانی می شوند.
برای مشاهده یا تغییر محدودیتهای سهمیه برای Places SDK برای Android:
- در Cloud Console، صفحه Google Maps Platform Quotas را باز کنید.
- روی منوی کشویی APIs کلیک کنید و Places SDK for Android را انتخاب کنید.
- برای مشاهده محدودیت های سهمیه، به سمت پایین به کارت درخواست ها بروید.
یک جدول اسامی و محدودیت های سهمیه را فهرست می کند. - برای تغییر یک محدودیت سهمیه، روی نماد ویرایش آن محدودیت کلیک کنید.
در کادر گفتگوی ظاهر شده، در قسمت محدودیت سهمیه ، محدودیت سهمیه روزانه قابل پرداخت ترجیحی (تا سقف سهمیه، در صورت وجود، تعیین شده توسط Google) را وارد کرده و ذخیره را انتخاب کنید.
اگر میزان استفاده از API شما در هر روز به حد نصاب قابل پرداخت شما برسد، برنامه شما تا باقیمانده آن روز نمیتواند به API دسترسی داشته باشد.
منابع مدیریت هزینه های مرتبط
کاربران در هند باید قبل از ایجاد حساب صورتحساب Google Maps Platform برای دریافت اعتبار Maps Platform یک حساب صورتحساب Google Cloud Platform ایجاد کنند. ↩