این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

مکان‌های SDK برای استفاده و صورت‌حساب Android

خطا: 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 نسخه 3.3.0 و نسخه های جدیدتر از دو نسخه SDK پشتیبانی می کند: Places SDK برای Android و Places SDK برای Android (جدید) ، نسخه نسل بعدی SDK. برای یادگیری تفاوت های کلیدی بین دو نسخه SDK، به انتخاب نسخه SDK خود مراجعه کنید.

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

قیمت تکمیل خودکار مکان و مکان فعلی برای هر دو SDK یکسان است.

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

استفاده از SKU × قیمت هر استفاده

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

قیمت گذاری Places SDK برای Android (جدید)

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

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

استفاده از یک فیلد ماسک یک روش طراحی خوب برای اطمینان از عدم درخواست داده های غیر ضروری است که به جلوگیری از زمان پردازش غیر ضروری و هزینه های صورتحساب کمک می کند.

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

یک جلسه تکمیل خودکار (جدید) شامل یک یا چند درخواست تکمیل خودکار (جدید) و یک درخواست جزئیات مکان (جدید) یا درخواست اعتبار سنجی آدرس است. همان نشانه جلسه به درخواست تکمیل خودکار (جدید) و به درخواست بعدی جزئیات مکان (جدید) یا درخواست اعتبار سنجی آدرس ارسال می شود.

یک جلسه با اولین درخواست تکمیل خودکار (جدید) شروع می شود. زمانی که کاربر یکی از پیشنهادات تکمیل خودکار (جدید) را انتخاب کرد، درخواست جزئیات مکان (جدید) یا درخواست اعتبار سنجی آدرس داده می شود. اگر جلسه رها شود، به این معنی که هیچ درخواستی برای جزئیات مکان (جدید) یا درخواست اعتبار سنجی آدرس انجام نشود، درخواست‌های تکمیل خودکار (جدید) به‌گونه‌ای محاسبه می‌شوند که گویی هیچ نشانه جلسه ارائه نشده است.

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

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

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

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

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

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

محدوده حجم ماهانه (قیمت هر تماس)
0-100000	100001–500000	500000+
0.00283 USD به ازای هر (2.83 دلار در هر 1000)	0.00227 USD به ازای هر (2.27 دلار در هر 1000)	برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید

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

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

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

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

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

محدوده حجم ماهانه (قیمت هر تماس)
0-100000	100001–500000	500000+
0.00 دلار برای هر کدام (0.00 دلار در هر 1000)	0.00 دلار برای هر کدام (0.00 دلار در هر 1000)	0.00 دلار برای هر کدام (0.00 دلار در هر 1000)

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

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

Android : Place.Field.DISPLAY_NAME ، Place.Field.ID ، Place.Field.PHOTO_METADATAS ، Place.Field.RESOURCE_NAME

محدوده حجم ماهانه (قیمت هر تماس)
0-100000	100001–500000	500000+
0.0 دلار برای هر کدام (0.00 دلار در هر 1000)	0.0 دلار برای هر کدام (0.00 دلار در هر 1000)	0.0 دلار برای هر کدام (0.00 دلار در هر 1000)

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

Android : Place.Field.ADDRESS_COMPONENTS , ADR_FORMAT_ADDRESS , Place.Field.FORMATTED_ADDRESS , Place.Field.LOCATION , Place.Field.PLUS_CODE , Place.Field.SHORT_FORMATTED_ADDRESS , TY Place.Field.TYPES , Place.Field.VIEWPORT

توجه: فیلدهای Place.Field.ADDRESS و Place.Field.LAT_LNG در نسخه 4.0 Places SDK برای Android منسوخ شده است. به جای آن به ترتیب از Place.Field.FORMATTED_ADDRESS و Place.Field.LOCATION استفاده کنید.

محدوده حجم ماهانه (قیمت هر تماس)
0-100000	100001–500000	500000+
0.005 دلار برای هر کدام (5.00 دلار در هر 1000)	0.004 دلار برای هر کدام (4.00 دلار در هر 1000)	برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید

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

Android : Place.Field.ACCESSIBILITY_OPTIONS ، Place.Field.BUSINESS_STATUS ، Place.Field.GOOGLE_MAPS_URI ، Place.Field.ICON_BACKGROUND_COLOR ، Place.Field.ICON_MASK_URL ، Place.Field.PRIMARY_TYPE_DISPLAY_NAME Place.Field.SUB_DESTINATIONS ، Place.Field.UTC_OFFSET

توجه: فیلدهای Place.Field.ICON_URL و Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE در نسخه 4.0 Places SDK برای Android منسوخ شده است. به جای آن به ترتیب از Place.Field.ICON_MASK_URL و Place.Field.ACCESSIBILITY_OPTIONS استفاده کنید. Place.Field.ACCESSIBILITY_OPTIONS فقط برای جزئیات مکان (جدید) در دسترس است.

محدوده حجم ماهانه (قیمت هر تماس)
0-100000	100001–500000	500000+
0.0170 دلار برای هر کدام (17.00 دلار در هر 1000)	0.0136 دلار برای هر کدام (13.60 دلار در هر 1000)	برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید

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

Android : Place.Field.CURRENT_OPENING_HOURS ، Place.Field.CURRENT_SECONDARY_OPENING_HOURS Place.Field.INTERNATIONAL_PHONE_NUMBER ، Place.Field.NATIONAL_PHONE_NUMBER Place.Field.OPENING_HOURS Place.Field.SECONDARY_OPENING_HOURS Place.Field.RATING Place.Field.PRICE_LEVEL Place.Field.USER_RATING_COUNT Place.Field.WEBSITE_URI

توجه: فیلدهای Place.Field.PHONE_NUMBER و Place.Field.USER_RATINGS_TOTAL در نسخه 4.0 Places SDK برای Android منسوخ شدند. به جای آن به ترتیب از Place.Field.INTERNATIONAL_PHONE_NUMBER و Place.USER_RATING_COUNT استفاده کنید.

محدوده حجم ماهانه (قیمت هر تماس)
0-100000	100001–500000	500000+
0.020 دلار برای هر کدام (20.00 دلار در هر 1000)	0.016 دلار برای هر کدام (16.00 دلار در هر 1000)	برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید

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

Android : Place.Field.ALLOWS_DOGS , Place.Field.CURBSIDE_PICKUP , Place.Field.DELIVERY Place.Field.GOOD_FOR_CHILDREN Place.Field.DINE_IN , Place.Field.EDITORIAL_SUMMARY , Place.Field.EV_CHARGE_OPTIONS Place.Field.FUEL_OPTIONS ، Place.Field.GOOD_FOR_GROUPS , Place.Field.GOOD_FOR_WATCHING_SPORTS , Place.Field.LIVE_MUSIC , Place.Field.MENU_FOR_CHILDREN , Place.Field.OUTDOOR_SEATING , Place.Field.PAYMENT_OPTIONS Place.Field.RESERVABLE Place.Field.PARKING_OPTIONS Place.Field.RESTROOM , Place.Field.REVIEWS , Place.Field.SERVES_BEER , Place.Field.SERVES_BREAKFAST , Place.Field.SERVES_BRUNCH , Place.Field.SERVES_COCKTAILS Place.Field.SERVES_DESSERT Place.Field.SERVES_COFFEE Place.Field.SERVES_DINNER ، Place.Field.SERVES_LUNCH ، Place.Field.SERVES_VEGETARIAN_FOOD ، Place.Field.SERVES_WINE ، Place.Field.TAKEOUT

محدوده حجم ماهانه (قیمت هر تماس)
0-100000	100001–500000	500000+
0.025 دلار برای هر کدام (25.00 دلار در هر 1000)	0.020 دلار برای هر کدام (20.00 دلار در هر 1000)	برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید

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

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

Android Place.Field.ADDRESS Place.Field.ADDRESS_COMPONENTS Place.Field.ICON_BACKGROUND_COLOR Place.Field.BUSINESS_STATUS Place.Field.ICON_URL Place.Field.LAT_LNG Place.Field.PHOTO_METADATAS Place.Field.PLUS_CODE Place.Field.ID , Place.Field.NAME , Place.Field.TYPES , Place.Field.UTC_OFFSET , Place.Field.VIEWPORT , Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE

محدوده حجم ماهانه (قیمت هر تماس)
0-100000	100001–500000	500000+
0.032 دلار برای هر کدام (32.00 دلار در هر 1000)	0.0256 دلار برای هر کدام (25.60 دلار در هر 1000)	برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید

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

محدوده حجم ماهانه (قیمت هر تماس)
0-100000	100001–500000	500000+
0.035 دلار برای هر کدام (35.00 دلار در هر 1000)	0.028 دلار برای هر کدام (28.00 دلار در هر 1000)	برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید

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

محدوده حجم ماهانه (قیمت هر تماس)
0-100000	100001–500000	500000+
0.040 دلار برای هر کدام (40.00 دلار در هر 1000)	0.032 دلار برای هر کدام (32.00 دلار در هر 1000)	برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید

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

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

Android : Place.Field.DISPLAY_NAME ، Place.Field.ID ، Place.Field.RESOURCE_NAME

محدوده حجم ماهانه (قیمت هر تماس)
0-100000	100001–500000	500000+
0.0 دلار برای هر کدام (0.00 دلار در هر 1000)	0.0 دلار برای هر کدام (0.00 دلار در هر 1000)	0.0 دلار برای هر کدام (0.00 دلار در هر 1000)

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

Android : Place.Field.ACCESSIBILITY_OPTIONS ، Place.Field.ADDRESS_COMPONENTS ، Place.Field.ADR_FORMAT_ADDRESS ، Place.Field.BUSINESS_STATUS ، Place.Field.FORMATTED_ADDRESS ، Place.Field.GOOGLE_MAPS_URI Place.Field.ICON_BACKGROUND_COLOR ، Place.Field.ICON_MASK_URL ، Place.Field.LOCATION Place.Field.TYPES Place.Field.PHOTO_METADATAS , Place.Field.PLUS_CODE , Place.Field.PRIMARY_TYPE_DISPLAY_NAME , Place.Field.SHORT_FORMATTED_ADDRESS , Place.Field.SUB_DESTINATIONS Place.Field.VIEWPORT Place.Field.UTC_OFFSET Place.Field.VIEWPORT

توجه: فیلدهای Place.Field.ADDRESS ، Place.Field.ICON_URL ، Place.Field.LAT_LNG ، و Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE در نسخه 4.0 Places SDK برای Android منسوخ شدند. به جای آن به ترتیب از Place.Field.FORMATTED_ADDRESS ، Place.Field.ICON_MASK_URL ، Place.Field.LOCATION و Place.ACCESSIBILITY_OPTIONS استفاده کنید. Place.Field.ACCESSIBILITY_OPTIONS فقط برای جزئیات مکان (جدید) در دسترس است.

محدوده حجم ماهانه (قیمت هر تماس)
0-100000	100001–500000	500000+
0.032 دلار برای هر کدام (32.00 دلار در هر 1000)	0.0256 دلار برای هر کدام (25.60 دلار در هر 1000)	برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید

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

محدوده حجم ماهانه (قیمت هر تماس)
0-100000	100001–500000	500000+
0.035 دلار برای هر کدام (35.00 دلار در هر 1000)	0.028 دلار برای هر کدام (28.00 دلار در هر 1000)	برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید

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

محدوده حجم ماهانه (قیمت هر تماس)
0-100000	100001–500000	500000+
0.040 دلار برای هر کدام (40.00 دلار در هر 1000)	0.032 دلار برای هر کدام (32.00 دلار در هر 1000)	برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید

SKU: عکس مکان

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

محدوده حجم ماهانه (قیمت هر تماس)
0-100000	100001–500000	500000+
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.ACCESSIBILITY_OPTIONS ، Place.Field.ADDRESS_COMPONENTS ، Place.Field.BUSINESS_STATUS ، Place.Field.DISPLAY_NAME ، Place.Field.FORMATTED_ADDRESS ، Place.Field.ICON_BACKGROUND_COLOR . 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 .

توجه: فیلدهای Place.Field.ADDRESS ، Place.Field.ICON_URL ، Place.Field.LAT_LNG ، Place.Field.NAME ، و Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE در نسخه 4.0 Places SDK برای Android منسوخ شده است. به جای آن به ترتیب از Place.Field.FORMATTED_ADDRESS ، Place.Field.ICON_MASK_URL ، Place.Field.LOCATION ، Place.Field.DISPLAY_NAME و Place.ACCESSIBILITY_OPTIONS استفاده کنید. Place.Field.ACCESSIBILITY_OPTIONS فقط برای جزئیات مکان (جدید) در دسترس است.

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-100000	100001–500000	500000+
هزینه درخواست مکان ها + 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

توجه: فیلد Place.Field.PHONE_NUMBER در نسخه 4.0 Places SDK برای Android منسوخ شده است. به جای آن از Place.Field.INTERNATIONAL_PHONE_NUMBER استفاده کنید.

iOS: GMSPlaceFieldOpeningHours ، GMSPlaceFieldPhoneNumber ، یا GMSPlaceFieldWebsite
سرویس وب: formatted_phone_number , international_phone_number , opening_hours , current_opening_hours , secondary_opening_hours , or website

محدوده حجم ماهانه (قیمت هر تماس)
0-100000	100001–500000	500000+
هزینه درخواست مکان ها + 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_VEGETARIAN_FOOD , Place.Field.TAKEOUT ,TA Place.Field.USER_RATING_COUNT Place.Field.SERVES_WINE
توجه: فیلد Place.Field.USER_RATINGS_TOTAL در نسخه 4.0 Places SDK برای Android منسوخ شده است. به جای آن از Place.Field.USER_RATING_COUNT استفاده کنید.
iOS: GMSPlaceFieldPriceLevel , GMSPlaceFieldRating , GMSPlaceFieldUserRatingsTotal , GMSPlaceFieldTakeout , GMSPlaceFieldDelivery , GMSPlaceFieldDineIn , GMSPlaceFieldCurbsidePickup , GMSPlaceFieldServesBrunch , GMSPlaceFieldServesBreakfast , GMSPlaceFieldServesDinner GMSPlaceFieldReservable , GMSPlaceFieldServesLunch , GMSPlaceFieldServesBeer , GMSPlaceFieldServesWine یا GMSPlaceFieldServesVegetarianFood .
جاوا اسکریپت : فیلدها را ببینید (جزئیات مکان)
وب سرویس : curbside_pickup ، delivery ، dine_in ، editorial_summary ، price_level ، rating بندی، reservable ، reviews ، serves_beer ، serves_breakfast ، serves_brunch serves_lunch serves_dinner ، سروهای_گیاهی_غذاهای_غذایی، سروهای_گیاهی_غذاهای_غذایی، سروهای_گیاهی_غذاهای_غذایی، سروهای_گیاهی_غذاهای_غذایی، serves_vegetarian_food ، serves_wine ، takeout ، user_ratings_total های وب

محدوده حجم ماهانه (قیمت هر تماس)
0-100000	100001–500000	500000+
هزینه درخواست مکان ها + 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-100000	100001–500000	500000+
0.00283 USD به ازای هر (2.83 دلار در هر 1000)	0.00227 USD به ازای هر (2.27 دلار در هر 1000)	برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید

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

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

محدوده حجم ماهانه (قیمت هر جلسه)
0-100000	100001–500000	500000+
0.017 دلار برای هر کدام (17.00 دلار در هر 1000)	0.0136 دلار برای هر کدام (13.60 دلار در هر 1000)	برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید

مثال

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

اندروید

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

iOS

وب سرویس

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

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

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

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

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

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

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

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

اگر زمینه های موجود در درخواست Place Details را مشخص نکنید ، تمام SKU های داده ها تحریک می شوند (اساسی ، تماس و جو).

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

دامنه حجم ماهانه (قیمت در هر جلسه)
0-100،000	100،001-500،000	500000+
0.00 USD	0.00 USD	0.00 USD

مثال

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

اندروید

findautocompletepredictions () (.setQuery ("par") ، .SetsessionToken (xyz))
findautocompletepredictions () (.setQuery ("پاریس") ، .SetsessionToken (xyz))
FetchPlace () (با یک FetchPlaceRequest شامل شناسه مکان و قسمت آدرس)

iOS

Placesclient؟
Placesclient؟
FetchPlaceFroplaceId: (از جمله شناسه Place ، و قسمت GMSPlaceFieldFormattedAddress )

وب سرویس

درخواست خودکار را به صورت خودکار قرار می دهد (input = "par" ، session_token: xyz)
درخواست خودکار را به صورت خودکار قرار می دهد (input = "پاریس" ، session_token: xyz)
جزئیات مکان (place_id ، session_token: xyz ، زمینه ها: formatted_address)

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

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

SKU: جزئیات را قرار دهید

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

دامنه حجم ماهانه (قیمت در هر تماس)
0-100،000	100،001-500،000	500000+
در هر کدام 0.017 دلار (17.00 دلار در هر 1000)	0.0136 دلار در هر کدام (13.60 دلار در هر 1000)	برای قیمت گذاری حجم با فروش تماس بگیرید

جزئیات مکان SKU از این API ها تولید می شود:

Android: SDK را برای Android ( fetchPlace() ) قرار می دهد
iOS: SDK را برای iOS ( fetchPlaceFromPlaceID: :)
JavaScript: MAPS SERVITY PLACE PLACE JavaScript API ( getDetails )
JavaScript: Maps JavaScript API Widget Autoclotte Widget ( getPlace )
JavaScript: نقشه Widget Widget Widget : getPlaces() پس از انتخاب کاربر نتیجه (نماد: پین) ، * نه یک پرس و جو (نماد: بزرگنمایی) ، همانطور که در اینجا نشان داده شده است:
در نتایج ویجت جعبه جستجو ، پس از تایپ کردن "پیتزا" در جعبه جستجو ، توجه کنید که Pizza Autentico دارای یک نماد پین در کنار آن است ، نشان می دهد که این یک نتیجه مکانی است (و نه یک پرس و جو).
سرویس وب: محل خدمات جزئیات API را در مکان قرار می دهد

با استفاده از API و خدمات وب ، جزئیات مکان SKU شارژ می شود که آیا یک نشانه جلسه ارائه شده است یا خیر.

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

نمونه ها

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

SKU: مکان فعلی را پیدا کنید

پیدا کردن مکان فعلی برای تماس با findCurrentPlace() (Android) یا findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS).

دامنه حجم ماهانه (قیمت در هر تماس)
0-100،000	100،001-500،000	500000+
در هر کدام 0.030 دلار (30.00 دلار در هر 1000)	0.024 دلار در هر کدام (24.00 دلار در هر 1000)	برای قیمت گذاری حجم با فروش تماس بگیرید

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

نمونه ها

شما با findCurrentPlace() (Android) یا findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) و فقط قسمت ADDRESS را مشخص کنید. در صورتحساب خود ، این SKU های ذکر شده را مشاهده خواهید کرد (هنگام مشاهده صورتحساب خود توسط SKU ):
- مکان فعلی را پیدا کنید (قیمت شروع از 0.030 دلار در هر درخواست)
- داده های اساسی (صورتحساب با 0.00 دلار)
شما با findCurrentPlace() (Android) یا findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) و قسمت PHONE_NUMBER را مشخص کنید. در صورتحساب خود ، این SKU های ذکر شده را مشاهده خواهید کرد (هنگام مشاهده صورتحساب خود توسط SKU ):
- مکان فعلی را پیدا کنید (قیمت شروع از 0.030 دلار در هر درخواست)
- با داده های تماس (قیمت شروع از 0.003 دلار در هر درخواست)
شما با findCurrentPlace() (Android) یا findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) و زمینه ها را از هر سه سطل از نوع داده مشخص کنید. در صورتحساب خود ، این SKU های ذکر شده را مشاهده خواهید کرد (هنگام مشاهده صورتحساب خود توسط SKU ):
- مکان فعلی را پیدا کنید (قیمت شروع از 0.030 دلار در هر درخواست)
- داده های اساسی (صورتحساب با 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-100،000	100،001-500،000	500000+
0.007 دلار در هر کدام (7.00 دلار در هر 1000)	0.0056 دلار در هر کدام (5.60 دلار در هر 1000)	برای قیمت گذاری حجم با فروش تماس بگیرید

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

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

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

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

برای مشاهده یا تغییر محدودیت سهمیه برای مکان های SDK برای Android:

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

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

مکان‌های SDK برای استفاده و صورت‌حساب Android

خطا: 9005 PLACES_API_RATE_LIMIT_EXCEEDED

نحوه صورت‌حساب Places SDK برای Android

قیمت گذاری Places SDK برای Android (جدید)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

SKU: عکس مکان

قیمت گذاری Places SDK برای اندروید

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

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

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

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

SKU: داده های جو

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

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

مثال

اندروید

iOS

وب سرویس

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

مثال

اندروید

iOS

وب سرویس

SKU: جزئیات را قرار دهید

نمونه ها

SKU: مکان فعلی را پیدا کنید

نمونه ها

SKU: عکس قرار دهید

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

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

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