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

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

صورت‌حساب و قیمت‌گذاری برای Places API

برای اطلاعات در مورد نحوه محاسبه صورت‌حساب و قیمت‌گذاری توسط Google، به فهرست قیمت‌گذاری پلتفرم نقشه‌های Google یا فهرست قیمت‌گذاری پلتفرم نقشه‌های Google - هند مراجعه کنید.

مکانها (جدید) SKUهای محصول

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

دسته بندی	این که آیا SKU در دسته Essentials، Pro یا Enterprise SKU قرار می گیرد.
رویداد قابل پرداخت	چه رویدادی برای SKU صورت‌حساب می‌شود.
محرک ها	کدام عناصر کد رویدادهای قابل پرداخت را راه اندازی می کنند.
قیمت گذاری	پیوندهایی به جدول قیمت گذاری برای گروه آن SKU.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

SKU: Places API Place Details Essentials (فقط شناسه ها)

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

	دسته بندی	ملزومات
	رویداد قابل پرداخت	با فیلد ماسک های مشخص شده درخواست کنید.
	محرک ها	این SKU هنگامی فعال می شود که شما فیلدهای زیر را درخواست کنید: وب سرویس : `attributions` `id` `name` ^* `photos` ^* فیلد `name` حاوی نام منبع مکان به شکل است: `places/ PLACE_ID` . از `displayName` برای دسترسی به نام متنی مکان استفاده کنید.
	نمونه های صورتحساب ماسک فیلد	اینها نمونه هایی از نحوه صدور صورتحساب درخواست بر اساس فیلدهایی است که در فیلد ماسک انتخاب می کنید. اگر ماسک فیلد درخواست شما فقط شامل فیلدهایی از این SKU است : درخواست با این نرخ SKU محاسبه می شود. برای مثال، می‌توانید یک یا چند فیلد را از این SKU درخواست کنید و با این نرخ SKU صورت‌حساب دریافت می‌کنید. اگر ماسک فیلد درخواست شما شامل فیلدهایی از SKUهای دیگر است : درخواست با بالاترین نرخ SKU برای فیلدهای درخواستی صورت‌حساب می‌شود. به عنوان مثال، اگر فیلدهایی را از چندین SKU، مانند Essentials SKU و Enterprise SKU وارد کنید، در این صورت درخواست با نرخ Enterprise SKU محاسبه می شود.
	قیمت گذاری	جدول قیمت اصلی جدول قیمت هند

SKU: Places API Place Details Essentials

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

	دسته بندی	ملزومات
	رویداد قابل پرداخت	با فیلد ماسک های مشخص شده درخواست کنید.
	محرک ها	این SKU هنگامی فعال می شود که شما فیلدهای مکان زیر را درخواست کنید: وب سرویس : `addressComponents` `adrFormatAddress` `formattedAddress` `location` `plusCode` `shortFormattedAddress` `types` `viewport`
	نمونه های صورتحساب ماسک فیلد	اینها نمونه هایی از نحوه صدور صورتحساب درخواست بر اساس فیلدهایی است که در فیلد ماسک انتخاب می کنید. اگر ماسک فیلد درخواست شما فقط شامل فیلدهایی از این SKU است : درخواست با این نرخ SKU محاسبه می شود. برای مثال، می‌توانید یک یا چند فیلد را از این SKU درخواست کنید و با این نرخ SKU صورت‌حساب دریافت می‌کنید. اگر ماسک فیلد درخواست شما شامل فیلدهایی از SKUهای دیگر است : درخواست با بالاترین نرخ SKU برای فیلدهای درخواستی صورت‌حساب می‌شود. به عنوان مثال، اگر فیلدهایی را از چندین SKU، مانند Essentials SKU و Enterprise SKU وارد کنید، در این صورت درخواست با نرخ Enterprise SKU محاسبه می شود.
	قیمت گذاری	جدول قیمت اصلی جدول قیمت هند

SKU: Places API Place Details Pro

این SKU برای فیلدهایی که در یک درخواست Place Details Pro مشخص می‌کنید صورت‌حساب می‌گیرد.

	دسته بندی	حرفه ای
	رویداد قابل پرداخت	با فیلد ماسک های مشخص شده درخواست کنید.
	محرک ها	این SKU زمانی فعال می‌شود که شما فقط فیلدهای زیر یا فیلدهای با نرخ پایین‌تر را درخواست کنید: وب سرویس : `accessibilityOptions` `businessStatus` `containingPlaces` `displayName` `googleMapsLinks` ^* `googleMapsUri` `iconBackgroundColor` `iconMaskBaseUri` `primaryType` `primaryTypeDisplayName` `pureServiceAreaBusiness` `subDestinations` `utcOffsetMinutes` ^* فیلد `googleMapsLinks` در مرحله پیش‌نمایش پیش‌نمایش GA است و هزینه‌ای دریافت نمی‌کند، به این معنی که صورت‌حساب 0 دلار برای استفاده در حین پیش‌نمایش است.
	نمونه های صورتحساب ماسک فیلد	اینها نمونه هایی از نحوه صدور صورتحساب درخواست بر اساس فیلدهایی است که در فیلد ماسک انتخاب می کنید. اگر ماسک فیلد درخواست شما فقط شامل فیلدهایی از این SKU است : درخواست با این نرخ SKU محاسبه می شود. برای مثال، می‌توانید یک یا چند فیلد را از این SKU درخواست کنید و با این نرخ SKU صورت‌حساب دریافت می‌کنید. اگر ماسک فیلد درخواست شما شامل فیلدهایی از SKUهای دیگر است : درخواست با بالاترین نرخ SKU برای فیلدهای درخواستی صورت‌حساب می‌شود. به عنوان مثال، اگر فیلدهایی را از چندین SKU، مانند Essentials SKU و Enterprise SKU وارد کنید، در این صورت درخواست با نرخ Enterprise SKU محاسبه می شود.
	قیمت گذاری	جدول قیمت اصلی جدول قیمت هند

SKU: Places API Place Details Enterprise

این SKU برای یک درخواست Places که شامل فیلدهای Enterprise است صورتحساب می گیرد.

	دسته بندی	تصدی
	رویداد قابل پرداخت	با فیلد ماسک های مشخص شده درخواست کنید.
	محرک ها	این SKU هنگامی فعال می شود که شما فیلدهای زیر را درخواست کنید: وب سرویس : `currentOpeningHours` `currentSecondaryOpeningHours` `internationalPhoneNumber` `nationalPhoneNumber` `priceLevel` `priceRange` `rating` `regularOpeningHours` `regularSecondaryOpeningHours` `userRatingCount` `websiteUri` اگر یک جلسه تکمیل خودکار را با تماس جزئیات مکان که هر فیلدی را از SKU درخواست می‌کند خاتمه دهید: جزئیات مکان (پایه، پیشرفته یا ترجیحی) ، آنگاه صورت‌حساب تماس در SKU: جزئیات مکان (ترجیح‌دهی) محاسبه می‌شود. برای اطلاعات بیشتر، SKU: تکمیل خودکار جلسه استفاده را ببینید.
	نمونه های صورتحساب ماسک فیلد	اینها نمونه هایی از نحوه صدور صورتحساب درخواست بر اساس فیلدهایی است که در فیلد ماسک انتخاب می کنید. اگر ماسک فیلد درخواست شما فقط شامل فیلدهایی از این SKU است : درخواست با این نرخ SKU محاسبه می شود. برای مثال، می‌توانید یک یا چند فیلد را از این SKU درخواست کنید و با این نرخ SKU صورت‌حساب دریافت می‌کنید. اگر ماسک فیلد درخواست شما شامل فیلدهایی از SKUهای دیگر است : درخواست با بالاترین نرخ SKU برای فیلدهای درخواستی صورت‌حساب می‌شود. به عنوان مثال، اگر فیلدهایی را از چندین SKU، مانند Essentials SKU و Enterprise SKU وارد کنید، در این صورت درخواست با نرخ Enterprise SKU محاسبه می شود.
	قیمت گذاری	جدول قیمت اصلی جدول قیمت هند

SKU: Places API جزئیات مکان Enterprise + Atmosphere

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

	دسته بندی	تصدی
	رویداد قابل پرداخت	درخواست کنید
	محرک ها	این 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: تکمیل خودکار جلسه استفاده را ببینید.
	نمونه های صورتحساب ماسک فیلد	اینها نمونه هایی از نحوه صدور صورتحساب درخواست بر اساس فیلدهایی است که در فیلد ماسک انتخاب می کنید. اگر ماسک فیلد درخواست شما فقط شامل فیلدهایی از این SKU است : درخواست با این نرخ SKU محاسبه می شود. برای مثال، می‌توانید یک یا چند فیلد را از این SKU درخواست کنید و با این نرخ SKU صورت‌حساب دریافت می‌کنید. اگر ماسک فیلد درخواست شما شامل فیلدهایی از SKUهای دیگر است : درخواست با بالاترین نرخ SKU برای فیلدهای درخواستی صورت‌حساب می‌شود. به عنوان مثال، اگر فیلدهایی را از چندین SKU، مانند Essentials SKU و Enterprise SKU وارد کنید، در این صورت درخواست با نرخ Enterprise SKU محاسبه می شود.
	قیمت گذاری	جدول قیمت اصلی جدول قیمت هند

SKU: Places API Nearby Search Pro

این SKU برای فیلدهایی که در یک درخواست Nearby Search Pro مشخص کرده‌اید، صورت‌حساب می‌گیرد.

	دسته بندی	حرفه ای
	رویداد قابل پرداخت	با فیلد ماسک های مشخص شده درخواست کنید.
	محرک ها	این SKU زمانی فعال می‌شود که شما فقط فیلدهای زیر یا فیلدهای با نرخ پایین‌تر را درخواست کنید: وب سرویس : `places.accessibilityOptions` `places.addressComponents` `places.adrFormatAddress` `places.attributions` `places.businessStatus` `places.containingPlaces` `places.displayName` `places.formattedAddress` `places.googleMapsLinks` ^* `places.googleMapsUri` `places.iconBackgroundColor` `places.iconMaskBaseUri` `places.id` `places.location` `places.name` ^** `places.photos` `places.plusCode` `places.primaryType` `places.primaryTypeDisplayName` `places.pureServiceAreaBusiness` `places.shortFormattedAddress` `places.subDestinations` `places.types` `places.utcOffsetMinutes` `places.viewport` ^* قسمت `places.googleMapsLinks` در مرحله پیش‌نمایش پیش‌نمایش GA است و هزینه‌ای دریافت نمی‌کند، به این معنی که صورت‌حساب 0 دلار برای استفاده در طول پیش‌نمایش است. ^** فیلد `places.name` حاوی نام منبع مکان به شکل است: `places/ PLACE_ID` . برای دسترسی به نام متنی مکان، `places.displayName` استفاده کنید.
	نمونه های صورتحساب ماسک فیلد	اینها نمونه هایی از نحوه صدور صورتحساب درخواست بر اساس فیلدهایی است که در فیلد ماسک انتخاب می کنید. اگر ماسک فیلد درخواست شما فقط شامل فیلدهایی از این SKU است : درخواست با این نرخ SKU محاسبه می شود. برای مثال، می‌توانید یک یا چند فیلد را از این SKU درخواست کنید و با این نرخ SKU صورت‌حساب دریافت می‌کنید. اگر ماسک فیلد درخواست شما شامل فیلدهایی از SKUهای دیگر است : درخواست با بالاترین نرخ SKU برای فیلدهای درخواستی صورت‌حساب می‌شود. به عنوان مثال، اگر فیلدهایی را از چندین SKU، مانند Essentials SKU و Enterprise SKU وارد کنید، در این صورت درخواست با نرخ Enterprise SKU محاسبه می شود.
	قیمت گذاری	جدول قیمت اصلی جدول قیمت هند

SKU: Places API Nearby Search Enterprise

این SKU برای درخواست‌های Nearby Search که شامل هر فیلد Enterprise است، صورت‌حساب می‌گیرد.

	دسته بندی	تصدی
	رویداد قابل پرداخت	با فیلد ماسک های مشخص شده درخواست کنید.
	محرک ها	این SKU هنگامی فعال می شود که شما فیلدهای زیر را درخواست کنید: وب سرویس : `places.currentOpeningHours` `places.currentSecondaryOpeningHours` `places.internationalPhoneNumber` `places.nationalPhoneNumber` `places.priceLevel` `places.priceRange` `places.rating` `places.regularOpeningHours` `places.regularSecondaryOpeningHours` `places.userRatingCount` `places.websiteUri`
	نمونه های صورتحساب ماسک فیلد	اینها نمونه هایی از نحوه صدور صورتحساب درخواست بر اساس فیلدهایی است که در فیلد ماسک انتخاب می کنید. اگر ماسک فیلد درخواست شما فقط شامل فیلدهایی از این SKU است : درخواست با این نرخ SKU محاسبه می شود. برای مثال، می‌توانید یک یا چند فیلد را از این SKU درخواست کنید و با این نرخ SKU صورت‌حساب دریافت می‌کنید. اگر ماسک فیلد درخواست شما شامل فیلدهایی از SKUهای دیگر است : درخواست با بالاترین نرخ SKU برای فیلدهای درخواستی صورت‌حساب می‌شود. به عنوان مثال، اگر فیلدهایی را از چندین SKU، مانند Essentials SKU و Enterprise SKU وارد کنید، در این صورت درخواست با نرخ Enterprise SKU محاسبه می شود.
	قیمت گذاری	جدول قیمت اصلی جدول قیمت هند

SKU: Places API Nearby Search Enterprise + Atmosphere

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

	دسته بندی	تصدی
	رویداد قابل پرداخت	درخواست کنید
	محرک ها	این 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.servesVegetarianFood` `places.servesWine` `places.takeout` ^* فقط جستجوی متن و جستجوی نزدیک
	نمونه های صورتحساب ماسک فیلد	اینها نمونه هایی از نحوه صدور صورتحساب درخواست بر اساس فیلدهایی است که در فیلد ماسک انتخاب می کنید. اگر ماسک فیلد درخواست شما فقط شامل فیلدهایی از این SKU است : درخواست با این نرخ SKU محاسبه می شود. برای مثال، می‌توانید یک یا چند فیلد را از این SKU درخواست کنید و با این نرخ SKU صورت‌حساب دریافت می‌کنید. اگر ماسک فیلد درخواست شما شامل فیلدهایی از SKUهای دیگر است : درخواست با بالاترین نرخ SKU برای فیلدهای درخواستی صورت‌حساب می‌شود. به عنوان مثال، اگر فیلدهایی را از چندین SKU، مانند Essentials SKU و Enterprise SKU وارد کنید، در این صورت درخواست با نرخ Enterprise SKU محاسبه می شود.
	قیمت گذاری	جدول قیمت اصلی جدول قیمت هند

SKU: Places API Text Search Essentials (فقط شناسه ها)

این SKU برای درخواست هایی به Text Search API که فقط شناسه ها را برمی گرداند، صورتحساب می شود.

	دسته بندی	ملزومات
	رویداد قابل پرداخت	با فیلد ماسک های مشخص شده درخواست کنید.
	محرک ها	این SKU زمانی فعال می شود که شما فقط فیلدهای زیر را درخواست کنید: وب سرویس : `places.attributions` `places.id` `places.name` ^* `nextPageToken` ^* فیلد `places.name` حاوی نام منبع مکان به شکل است: `places/ PLACE_ID` . برای دسترسی به نام متنی مکان، `places.displayName` استفاده کنید.
	نمونه های صورتحساب ماسک فیلد	اینها نمونه هایی از نحوه صدور صورتحساب درخواست بر اساس فیلدهایی است که در فیلد ماسک انتخاب می کنید. اگر ماسک فیلد درخواست شما فقط شامل فیلدهایی از این SKU است : درخواست با این نرخ SKU محاسبه می شود. برای مثال، می‌توانید یک یا چند فیلد را از این SKU درخواست کنید و با این نرخ SKU صورت‌حساب دریافت می‌کنید. اگر ماسک فیلد درخواست شما شامل فیلدهایی از SKUهای دیگر است : درخواست با بالاترین نرخ SKU برای فیلدهای درخواستی صورت‌حساب می‌شود. به عنوان مثال، اگر فیلدهایی را از چندین SKU، مانند Essentials SKU و Enterprise SKU وارد کنید، در این صورت درخواست با نرخ Enterprise SKU محاسبه می شود.
	قیمت گذاری	جدول قیمت اصلی جدول قیمت هند

SKU: Places API Text Search Pro

این SKU یک SKU داده است که برای فیلدهایی که در یک درخواست Text Search Pro مشخص کرده اید صورتحساب می گیرد.

	دسته بندی	حرفه ای
	رویداد قابل پرداخت	با فیلد ماسک های مشخص شده درخواست کنید.
	محرک ها	این SKU زمانی فعال می‌شود که شما فقط فیلدهای زیر یا فیلدهای با نرخ پایین‌تر را درخواست کنید: وب سرویس : `places.accessibilityOptions` `places.addressComponents` `places.adrFormatAddress` `places.businessStatus` `places.containingPlaces` `places.displayName` `places.formattedAddress` `places.googleMapsLinks` ^* `places.googleMapsUri` `places.iconBackgroundColor` `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 دلار برای استفاده در طول پیش‌نمایش است.
	نمونه های صورتحساب ماسک فیلد	اینها نمونه هایی از نحوه صدور صورتحساب درخواست بر اساس فیلدهایی است که در فیلد ماسک انتخاب می کنید. اگر ماسک فیلد درخواست شما فقط شامل فیلدهایی از این SKU است : درخواست با این نرخ SKU محاسبه می شود. برای مثال، می‌توانید یک یا چند فیلد را از این SKU درخواست کنید و با این نرخ SKU صورت‌حساب دریافت می‌کنید. اگر ماسک فیلد درخواست شما شامل فیلدهایی از SKUهای دیگر است : درخواست با بالاترین نرخ SKU برای فیلدهای درخواستی صورت‌حساب می‌شود. به عنوان مثال، اگر فیلدهایی را از چندین SKU، مانند Essentials SKU و Enterprise SKU وارد کنید، در این صورت درخواست با نرخ Enterprise SKU محاسبه می شود.
	قیمت گذاری	جدول قیمت اصلی جدول قیمت هند

SKU: Places API Text Search Enterprise

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

	دسته بندی	تصدی
	رویداد قابل پرداخت	با فیلد ماسک های مشخص شده درخواست کنید.
	محرک ها	این SKU هنگامی فعال می شود که شما فیلدهای زیر را درخواست کنید: وب سرویس : `places.currentOpeningHours` `places.currentSecondaryOpeningHours` `places.internationalPhoneNumber` `places.nationalPhoneNumber` `places.priceLevel` `places.priceRange` `places.rating` `places.regularOpeningHours` `places.regularSecondaryOpeningHours` `places.userRatingCount` `places.websiteUri`
	نمونه های صورتحساب ماسک فیلد	اینها نمونه هایی از نحوه صدور صورتحساب درخواست بر اساس فیلدهایی است که در فیلد ماسک انتخاب می کنید. اگر ماسک فیلد درخواست شما فقط شامل فیلدهایی از این SKU است : درخواست با این نرخ SKU محاسبه می شود. برای مثال، می‌توانید یک یا چند فیلد را از این SKU درخواست کنید و با این نرخ SKU صورت‌حساب دریافت می‌کنید. اگر ماسک فیلد درخواست شما شامل فیلدهایی از SKUهای دیگر است : درخواست با بالاترین نرخ SKU برای فیلدهای درخواستی صورت‌حساب می‌شود. به عنوان مثال، اگر فیلدهایی را از چندین SKU، مانند Essentials SKU و Enterprise SKU وارد کنید، در این صورت درخواست با نرخ Enterprise SKU محاسبه می شود.
	قیمت گذاری	جدول قیمت اصلی جدول قیمت هند

SKU: Places API Text Search Enterprise + Atmosphere

این 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.servesVegetarianFood` `places.servesWine` `places.takeout` ^* فقط جستجوی متن و جستجوی نزدیک
	نمونه های صورتحساب ماسک فیلد	اینها نمونه هایی از نحوه صدور صورتحساب درخواست بر اساس فیلدهایی است که در فیلد ماسک انتخاب می کنید. اگر ماسک فیلد درخواست شما فقط شامل فیلدهایی از این SKU است : درخواست با این نرخ SKU محاسبه می شود. برای مثال، می‌توانید یک یا چند فیلد را از این SKU درخواست کنید و با این نرخ SKU صورت‌حساب دریافت می‌کنید. اگر ماسک فیلد درخواست شما شامل فیلدهایی از SKUهای دیگر است : درخواست با بالاترین نرخ SKU برای فیلدهای درخواستی صورت‌حساب می‌شود. به عنوان مثال، اگر فیلدهایی را از چندین SKU، مانند Essentials SKU و Enterprise SKU وارد کنید، در این صورت درخواست با نرخ Enterprise SKU محاسبه می شود.
	قیمت گذاری	جدول قیمت اصلی جدول قیمت هند

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

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

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

SKUهای محصولات Legacy Places

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

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

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

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

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

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

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

درباره مکان‌ها اطلاعات SKU

سه SKU داده مکان ها عبارتند از: داده های پایه ، داده های تماس و داده های جوی .

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

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

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

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

Places Details Pro
مکان را پیدا کنید

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

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

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

این SKU یک SKU داده است که فیلدهای Basic Data را در یک درخواست Place Details یا Find Place صورت‌حساب می‌دهد. این SKU علاوه بر SKU پایه برای درخواستی که آن را راه اندازی کرده است، هزینه دریافت می کند.

فیلدهای دسته پایه در هزینه پایه درخواست مکان ها گنجانده شده است و هزینه اضافی را در پی نخواهد داشت.

	دسته بندی	ملزومات
	رویداد قابل پرداخت	با فیلد ماسک های مشخص شده درخواست کنید.
	محرک ها	هنگامی که شما هر یک از این فیلدها را درخواست می کنید، SKU داده های پایه فعال می شود: اندروید: `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` . فیلدهای منسوخ شده: فیلدهای زیر در نسخه 4.0 Places SDK برای Android منسوخ شده اند: فیلدهای `Place.Field.ADDRESS` ، `Place.Field.ICON_URL` ، `Place.Field.LAT_LNG` ، `Place.Field.NAME` ، و `Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE` `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` `plus_code` `type` `url` `utc_offset` `vicinity` `wheelchair_accessible_entrance`
	نمونه های صورتحساب ماسک فیلد	اینها نمونه هایی از نحوه صدور صورتحساب درخواست بر اساس فیلدهایی است که در فیلد ماسک انتخاب می کنید. اگر ماسک فیلد درخواست شما فقط شامل فیلدهایی از این SKU است : درخواست با این نرخ SKU محاسبه می شود. برای مثال، می‌توانید یک یا چند فیلد را از این SKU درخواست کنید و با این نرخ SKU صورت‌حساب دریافت می‌کنید. اگر ماسک فیلد درخواست شما شامل فیلدهایی از SKUهای دیگر است : درخواست با بالاترین نرخ SKU برای فیلدهای درخواستی صورت‌حساب می‌شود. به عنوان مثال، اگر فیلدهایی را از چندین SKU، مانند Essentials SKU و Enterprise SKU وارد کنید، در این صورت درخواست با نرخ Enterprise SKU محاسبه می شود.
	قیمت گذاری	جدول قیمت اصلی جدول قیمت هند

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

این SKU یک SKU داده است که برای فیلدهای Contact Data در یک درخواست Place Details یا Find Place صورت‌حساب می‌دهد. این SKU علاوه بر 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`
	نمونه های صورتحساب ماسک فیلد	اینها نمونه هایی از نحوه صدور صورتحساب درخواست بر اساس فیلدهایی است که در فیلد ماسک انتخاب می کنید. اگر ماسک فیلد درخواست شما فقط شامل فیلدهایی از این SKU است : درخواست با این نرخ SKU محاسبه می شود. برای مثال، می‌توانید یک یا چند فیلد را از این SKU درخواست کنید و با این نرخ SKU صورت‌حساب دریافت می‌کنید. اگر ماسک فیلد درخواست شما شامل فیلدهایی از SKUهای دیگر است : درخواست با بالاترین نرخ SKU برای فیلدهای درخواستی صورت‌حساب می‌شود. به عنوان مثال، اگر فیلدهایی را از چندین SKU، مانند Essentials SKU و Enterprise SKU وارد کنید، در این صورت درخواست با نرخ Enterprise SKU محاسبه می شود.
	قیمت گذاری	جدول قیمت اصلی جدول قیمت هند

SKU: داده های جو

این SKU برای درخواست‌هایی به Atmosphere Data API که فیلدهای این SKU را مشخص می‌کند صورت‌حساب می‌دهد.

	دسته بندی	تصدی
	رویداد قابل پرداخت	با فیلد ماسک های مشخص شده درخواست کنید.
	محرک ها	صورت‌حساب زمانی فعال می‌شود که هر یک از این فیلدها را درخواست کنید: اندروید `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.SERVES_WINE` `Place.Field.TAKEOUT` `Place.Field.USER_RATING_COUNT` فیلدهای منسوخ شده: فیلد `Place.Field.USER_RATINGS_TOTAL` در نسخه 4.0 Places SDK برای Android منسوخ شده است. به جای آن از `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_dinner` `serves_lunch` ، `serves_vegetarian_food` `serves_wine` `takeout` `user_ratings_total` .
	نمونه های صورتحساب ماسک فیلد	اینها نمونه هایی از نحوه صدور صورتحساب درخواست بر اساس فیلدهایی است که در فیلد ماسک انتخاب می کنید. اگر ماسک فیلد درخواست شما فقط شامل فیلدهایی از این SKU است : درخواست با این نرخ SKU محاسبه می شود. برای مثال، می‌توانید یک یا چند فیلد را از این SKU درخواست کنید و با این نرخ SKU صورت‌حساب دریافت می‌کنید. اگر ماسک فیلد درخواست شما شامل فیلدهایی از SKUهای دیگر است : درخواست با بالاترین نرخ SKU برای فیلدهای درخواستی صورت‌حساب می‌شود. به عنوان مثال، اگر فیلدهایی را از چندین SKU، مانند Essentials SKU و Enterprise SKU وارد کنید، در این صورت درخواست با نرخ Enterprise SKU محاسبه می شود.
	قیمت گذاری	جدول قیمت اصلی جدول قیمت هند

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

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

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

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

	دسته بندی	ملزومات
	رویداد قابل پرداخت	درخواست کنید
	محرک ها	صورت‌حساب برای موارد زیر فعال می‌شود: اندروید: `findAutocompletePredictions()` iOS: `findAutocompletePredictionsFromQuery:` جاوا اسکریپت: سرویس تکمیل خودکار مکان Maps JavaScript API وب سرویس: سرویس Places API Place Autocomplete
	قیمت گذاری	جدول قیمت اصلی جدول قیمت هند

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

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

	دسته بندی	حرفه ای
	رویداد قابل پرداخت	جلسه
	محرک ها	اگر برنامه شما این دو درخواست را در یک جلسه صادر کند، صورت‌حساب شروع می‌شود: اندروید findAutocompletePredictions() (.setQuery("par")، .setSessionToken(XYZ)) findAutocompletePredictions() (.setQuery("paris")، .setSessionToken(XYZ)) iOS placeClient?.findAutocompletePredictions(fromQuery: "par" ... placeClient?.findAutocompletePredictions(fromQuery: "paris" ... وب سرویس ارسال درخواست تکمیل خودکار (input="par"، session_token: XYZ) درخواست تکمیل خودکار (input="paris"، session_token: XYZ) هنگام مشاهده صورتحساب خود توسط SKU ، این SKU را مشاهده می کنید: تکمیل خودکار بدون جزئیات مکان - در هر جلسه
	قیمت گذاری	جدول قیمت اصلی جدول قیمت هند

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

درخواست تکمیل خودکار بدون پرداخت هزینه در دسترس است. این SKU زمانی صورت‌حساب می‌دهد که جزئیات مکان بعدی را بر اساس قیمت‌گذاری معمولی جزئیات مکان درخواست کنید.

	دسته بندی	ملزومات
	رویداد قابل پرداخت	جلسه
	محرک ها	تکمیل خودکار (شامل جزئیات مکان) - SKU هر جلسه برای یک جلسه تکمیل خودکار که شامل هر یک از درخواست‌های زیر است، هزینه می‌شود: Android: تماسی با `fetchPlace()` iOS: تماسی برای `fetchPlaceFromPlaceID:` وب سرویس: درخواست جزئیات مکان درخواست جزئیات مکان، SKUهای داده ( اصلی ، تماس ، و/یا جو ) را ایجاد می کند - بسته به فیلدهایی که در درخواست مشخص می کنید. اگر فیلدهای خاصی را در درخواست جزئیات مکان درخواست نکنید، همه SKUهای داده فعال می شوند (Essentials، Pro، Enterprise و Enterprise + Atmosphere). فقط فیلدهایی را که برای جلوگیری از هزینه های غیرضروری نیاز دارید، مشخص کنید. اگر در طول جلسه تکمیل خودکار فقط درخواست بازخوانی شناسه جزئیات مکان (درخواست شما فقط فیلد `place_id` مشخص می‌کند)، جلسه به‌عنوان SKU محاسبه می‌شود: تکمیل خودکار بدون جزئیات مکان - در هر جلسه .
	نمونه ها	اگر برنامه شما سه تماس زیر را در یک جلسه صادر کرد: اندروید findAutocompletePredictions() (.setQuery("par")، .setSessionToken(XYZ)) findAutocompletePredictions() (.setQuery("paris")، .setSessionToken(XYZ)) fetchPlace() (با `FetchPlaceRequest` شامل شناسه مکان و فیلد ADDRESS) iOS placeClient?.findAutocompletePredictions(fromQuery: "par" ... placeClient?.findAutocompletePredictions(fromQuery: "paris" ... fetchPlaceFromPlaceID: (شامل شناسه مکان و فیلد `GMSPlaceFieldFormattedAddress` ) وب سرویس وب سرویس درخواست تکمیل خودکار مکان‌ها (input="par", session_token: XYZ) درخواست تکمیل خودکار مکان‌ها (input="paris", session_token: XYZ) جزئیات مکان ها (place_id، session_token: XYZ، فیلدها:formatted_address) در صورتحساب خود، این SKUها را مشاهده خواهید کرد (هنگام مشاهده صورتحساب خود توسط SKU ): تکمیل خودکار (شامل جزئیات مکان) - در هر جلسه جزئیات مکان داده های پایه
	قیمت گذاری	جدول قیمت اصلی جدول قیمت هند

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

این SKU قدیمی برای درخواست های تکمیل خودکار Query صورتحساب می گیرد.

	دسته بندی	ملزومات
	رویداد قابل پرداخت	درخواست کنید
	محرک ها	این SKU هنگامی فعال می شود که با استفاده از خدمات زیر یک درخواست تکمیل خودکار Query ارائه می کنید: جاوا اسکریپت: سرویس تکمیل خودکار مکان‌های API جاوا اسکریپت Maps ( `getQueryPredictions()` ) و استفاده از ابزارک SearchBox Maps JavaScript API (درخواست‌های تکمیل خودکار Query به عنوان نوع کاربر ایجاد می‌شوند). وب سرویس: سرویس تکمیل خودکار Query Places API قیمت گذاری بر اساس جلسه تکمیل خودکار با استفاده از تکمیل خودکار Query پشتیبانی نمی شود. درخواست‌های بعدی جزئیات مکان براساس SKU Pro جزئیات مکان محاسبه می‌شوند.
	قیمت گذاری	جدول قیمت اصلی جدول قیمت هند

SKU: Place Details Pro

این SKU برای درخواست‌های قدیمی Place Details صورت‌حساب می‌گیرد.

	دسته بندی	حرفه ای
	رویداد قابل پرداخت	درخواست کنید
	محرک ها	صورت‌حساب برای درخواست‌های APIهای زیر فعال می‌شود: Android: Places SDK برای Android ( `fetchPlace()` ) iOS: مکان‌های SDK برای iOS ( `fetchPlaceFromPlaceID:` :) جاوا اسکریپت: Maps JavaScript API Details Service ( `getDetails` ) JavaScript: Maps JavaScript API Place Autocomplete Widget ( `getPlace` ) جاوا اسکریپت: Maps JavaScript API Place SearchBox ویجت : متد `getPlaces()` پس از انتخاب یک نتیجه مکان (نماد: پین)، نه یک پرس و جو (نماد: ذره بین)، همانطور که در اینجا نشان داده شده است: در نتایج ویجت جعبه جستجو، پس از تایپ "پیتزا" در کادر جستجو، توجه کنید که Pizza Autentico یک نماد پین در کنار آن دارد که نشان می دهد یک نتیجه مکان (و نه یک پرس و جو) است. وب سرویس: Places API خدمات جزئیات مکان با API وب و خدمات، SKU جزئیات مکان هزینه می‌شود، خواه توکن جلسه ارائه دهید یا نه. این SKU همچنین صورت‌حساب SKUهای داده را فعال می‌کند : اگر فیلدهای داده را در درخواست خود وارد کنید، می‌تواند صورت‌حساب اضافی را برای SKUهای داده ایجاد کند: Basic ، Contact ، و Atmosphere . فقط فیلدهای داده ای را مشخص کنید که می خواهید از هزینه های غیر ضروری جلوگیری کنید. برای این SKU و همچنین برای داده هایی که درخواست می کنید صورتحساب دریافت می کنید.
	نمونه ها	یکی از این تماس ها یا درخواست ها را انجام دهید: تلفن همراه: با `fetchPlace()` در Android یا `fetchPlaceFromPlaceID:` در iOS تماس بگیرید و فقط قسمت `ADDRESS` مشخص کنید Web API یا سرویس: درخواست جزئیات مکان را انجام دهید و فقط فیلد آدرس را مشخص کنید: `getPlaceDetails(fields: formatted_address)` در صورتحساب خود، این SKUها را مشاهده خواهید کرد (هنگام مشاهده صورتحساب خود توسط SKU ): جزئیات مکان داده های پایه یکی از این تماس ها یا درخواست ها را انجام دهید: تلفن همراه: با `fetchPlace()` در Android یا `fetchPlaceFromPlaceID:` در iOS تماس بگیرید و فقط فیلد `PHONE_NUMBER` مشخص کنید Web API یا سرویس: درخواست جزئیات مکان و فیلد شماره تلفن را مشخص کنید: `getPlaceDetails(fields: formatted_phone_number)` در صورتحساب خود، این SKUها را مشاهده خواهید کرد (هنگام مشاهده صورتحساب خود توسط SKU ): جزئیات مکان اطلاعات تماس یکی از این تماس ها یا درخواست ها را انجام دهید: تلفن همراه: با `fetchPlace()` در Android یا `fetchPlaceFromPlaceID:` در iOS تماس بگیرید و تمام فیلدها را مشخص کنید Web API یا سرویس: یک درخواست Place Details کنید و همه فیلدها را مشخص کنید (اگر هیچ فیلدی را مشخص نکنید این نوع درخواست پیش‌فرض است): `getPlaceDetails()` . در صورتحساب خود، این SKUها را مشاهده خواهید کرد (هنگام مشاهده صورتحساب خود توسط SKU ): جزئیات مکان داده های پایه اطلاعات تماس داده های جو
	قیمت گذاری	جدول قیمت اصلی جدول قیمت هند

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

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

	دسته بندی	ملزومات
	رویداد قابل پرداخت	درخواست کنید
	محرک ها	صورت‌حساب زمانی آغاز می‌شود که درخواست جزئیات مکان را انجام دهید و فقط قسمت شناسه مکان را مشخص کنید: `getPlaceDetails(fields: place_id)` .
	قیمت گذاری	جدول قیمت اصلی جدول قیمت هند

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

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

این SKU همچنین صورت‌حساب SKUهای داده را فعال می‌کند : اگر فیلدهای داده را در درخواست خود وارد کنید، می‌تواند صورت‌حساب اضافی را برای SKUهای داده ایجاد کند: Basic ، Contact ، و Atmosphere . فقط فیلدهای داده ای را مشخص کنید که می خواهید از هزینه های غیر ضروری جلوگیری کنید. برای این SKU و همچنین برای داده هایی که درخواست می کنید صورتحساب دریافت می کنید.

	دسته بندی	حرفه ای
	رویداد قابل پرداخت	درخواست کنید
	محرک ها	این SKU برای درخواست ها به روش های زیر صورتحساب می گیرد: مکان فعلی را پیدا کنید این SKU همچنین صورت‌حساب SKUهای داده را فعال می‌کند : اگر فیلدهای داده را در درخواست خود وارد کنید، می‌تواند صورت‌حساب اضافی را برای SKUهای داده ایجاد کند: Basic ، Contact ، و Atmosphere . فقط فیلدهای داده ای را مشخص کنید که می خواهید از هزینه های غیر ضروری جلوگیری کنید. برای این SKU و همچنین برای داده هایی که درخواست می کنید صورتحساب دریافت می کنید.
	نمونه ها	مثال‌های زیر نشان می‌دهند که هنگام درخواست یافتن مکان کنونی و مشخص کردن فیلدها از SKUهای داده‌های Basic، Contact و Atmosphere، برای چه SKUهایی صورت‌حساب دریافت می‌کنید. برای مشاهده SKUها در صورتحساب خود، صورتحساب خود را براساس SKU همانطور که در تجزیه و تحلیل استفاده و هزینه هر SKU توضیح داده شده است، مشاهده کنید. شما یک درخواست Find Place می کنید و فقط فیلد آدرس را مشخص می کنید: `FindPlace(fields: formatted_address)` . صورتحساب شما این SKU ها را نشان می دهد: مکان را پیدا کنید داده های پایه شما یک درخواست Find Place می کنید و فیلد شماره تلفن را مشخص می کنید: `FindPlace(fields: formatted_phone_number)` . صورتحساب شما این SKU ها را نشان می دهد: مکان را پیدا کنید اطلاعات تماس شما یک درخواست Find Place می‌کنید و فیلدهایی را از هر سه سطل نوع داده مشخص می‌کنید: `FindPlace(fields: formatted_address, opening_hours, price_level)` . صورتحساب شما این SKU ها را نشان می دهد: مکان را پیدا کنید داده های پایه اطلاعات تماس داده های جو
	قیمت گذاری	جدول قیمت اصلی جدول قیمت هند

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

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

	دسته بندی	ملزومات
	رویداد قابل پرداخت	درخواست کنید
	محرک ها	شما یک درخواست Find Place را بدون هیچ فیلدی مشخص می کنید، یا فقط فیلد `place_id` مشخص می کنید: `FindPlace(fields: place_id)` .
	قیمت گذاری	جدول قیمت اصلی جدول قیمت هند

SKU: مکان‌ها – جستجوی نزدیک

این SKU برای درخواست‌های Nearby Search صورت‌حساب می‌گیرد.

	دسته بندی	حرفه ای
	رویداد قابل پرداخت	درخواست کنید
	محرک ها	این SKU هنگامی فعال می شود که با استفاده از یکی از API های زیر درخواست جستجوی Nearby را ارائه می کنید: Maps JavaScript API Place Nearby Service Search ( `nearbySearch()` ) Places API Nearby Search Service این درخواست از تعیین فیلدهایی که باید بازگردانده شوند پشتیبانی نمی کند. پاسخ فهرستی از مکان‌ها و زیرمجموعه‌ای از فیلدهای داده پشتیبانی شده را برمی‌گرداند. این SKU همچنین صورت‌حساب SKUهای داده را فعال می‌کند : اگر فیلدهای داده را در درخواست خود وارد کنید، می‌تواند صورت‌حساب اضافی را برای SKUهای داده ایجاد کند: Basic ، Contact ، و Atmosphere . فقط فیلدهای داده ای را مشخص کنید که می خواهید از هزینه های غیر ضروری جلوگیری کنید. برای این SKU و همچنین برای داده هایی که درخواست می کنید صورتحساب دریافت می کنید.
	نمونه ها	شما یک درخواست Nearby Search، مانند `NearbySearch (San Francisco, 100 meters)` می دهید. صورتحساب شما این SKU ها را هنگام مشاهده صورتحساب توسط SKU نشان می دهد: مکان داده های پایه اطلاعات تماس داده های جو
	قیمت گذاری	جدول قیمت اصلی جدول قیمت هند

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

این SKU برای درخواست‌های سرویس جستجوی متن مکان‌ها صورت‌حساب می‌دهد.

	دسته بندی	حرفه ای
	رویداد قابل پرداخت	درخواست کنید
	محرک ها	صورت‌حساب برای درخواست‌های خدمات زیر فعال می‌شود: Maps JavaScript API Place Text Search Service ( `textSearch()` ). سرویس جستجوی متن API Places درخواست‌های جستجوی متن فهرستی از مکان‌ها را برمی‌گردانند، اما از تعیین اینکه کدام فیلدها برگردانده می‌شوند، پشتیبانی نمی‌کنند. درخواست های جستجوی متن زیرمجموعه ای از فیلدهای داده پشتیبانی شده را برمی گرداند. برای درخواست جستجوی متن و همچنین همه SKUهای نوع داده: داده‌های پایه ، داده‌های تماس ، و داده‌های جوی از شما هزینه دریافت می‌شود. مکان – SKU جستجوی متن نیز توسط ابزارک مکان جستجوی جعبه جاوا اسکریپت Maps JavaScript راه اندازی می شود: متد `getPlaces()` پس از انتخاب یک پرس و جوی مکان (نماد: ذره بین)، نه نتیجه (نماد: پین)، همانطور که در اینجا نشان داده شده است: در نتایج ویجت جعبه جستجو، پس از تایپ "پیتزا" در کادر جستجو، توجه کنید که تحویل پیتزا یک آیکون ذره بین در کنار آن دارد که نشان می دهد یک جستجوی مکان است (و نه نتیجه).
	مثال	اگر یک درخواست جستجوی متن، مانند `TextSearch(123 Main Street)` ارائه دهید، صورتحساب شما این SKU ها را هنگام مشاهده صورتحساب شما توسط SKU نشان می دهد: مکان - جستجوی متن داده های پایه اطلاعات تماس داده های جو
	قیمت گذاری	جدول قیمت اصلی جدول قیمت هند

SKU: Places API جزئیات مکان عکس ها

این SKU برای سرویس قدیمی Places Photo صورت‌حساب می‌گیرد.

	دسته بندی	تصدی
	رویداد قابل پرداخت	درخواست کنید
	محرک ها	صورت‌حساب برای موارد زیر فعال می‌شود: Android: فراخوانی به `fetchPhoto()` iOS: تماس برای `loadPlacePhoto:` جاوا اسکریپت: به کتابخانه مکان‌ها، سرویس عکس‌های مکان API جاوا اسکریپت Maps هنگام درخواست داده از آدرس‌های اینترنتی بازگردانده شده توسط `PlacePhoto.getUrl()` برای بارگیری داده‌های پیکسل تصویر. تا زمانی که URL واقعاً برای به دست آوردن داده های پیکسل استفاده نشود، صورتحساب را شروع نمی کند. وب سرویس: درخواست به سرویس Places API Place Photos
	قیمت گذاری	جدول قیمت اصلی جدول قیمت هند

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

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

Places API (جدید) : محدودیت نرخ 600 QPM (درخواست در دقیقه) به ازای هر روش API در هر پروژه است. به این معنی که هر روش API یک سهمیه جداگانه دارد.
Places API : محدودیت نرخ 6000 QPM (درخواست در دقیقه) است. این به عنوان مجموع درخواست های سمت مشتری و سمت سرور برای همه برنامه ها با استفاده از اعتبار یک پروژه محاسبه می شود.

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

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