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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

محدوده حجم ماهانه (قیمت هر تماس)
0-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 پایان یافت: اعتبار سنجی آدرس ترجیح داده می شود .

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

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

---

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

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

وب سرویس : attributions ، id ، name ^* ، photos

^* فیلد name حاوی نام منبع مکان به شکل است: places/ PLACE_ID . از displayName برای دسترسی به نام متنی مکان استفاده کنید.

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

---

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

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

وب سرویس : addressComponents ، adrFormatAddress ، formattedAddress ، location ، plusCode ، shortFormattedAddress ، types ، viewport

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

---

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

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

وب سرویس : accessibilityOptions ، businessStatus ، displayName ، googleMapsUri ، iconBackgroundColor ، iconMaskBaseUri ، primaryType ، primaryTypeDisplayName ، subDestinations ، utcOffsetMinutes

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

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

---

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

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

وب سرویس : currentOpeningHours , currentSecondaryOpeningHours , internationalPhoneNumber , nationalPhoneNumber , priceLevel , rating , regularOpeningHours , regularSecondaryOpeningHours , userRatingCount , websiteUri

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

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

---

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

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

وب سرویس : allowsDogs , curbsidePickup , delivery , dineIn , editorialSummary , evChargeOptions , fuelOptions , goodForChildren reviews goodForGroups , goodForWatchingSports , liveMusic , menuForChildren , servesCocktails parkingOptions reservable paymentOptions خلاصه، ^* servesBeer ، servesBreakfast outdoorSeating ، سرو restroom ، servesBrunch routingSummaries ، servesCoffee , servesDessert , servesDinner , servesLunch , servesVegetarianFood , servesWine , takeout

^* فقط جستجوی متن و جستجوی نزدیک

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

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

---

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

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

وب سرویس places.iconMaskBaseUri places.accessibilityOptions ، places.addressComponents ، places.adrFormatAddress places.location places.attributions ، places.businessStatus ، places.displayName ، places.formattedAddress places.id places.googleMapsUri ، places.iconBackgroundColor . , places.name ^* , places.photos , places.plusCode , places.primaryType , places.primaryTypeDisplayName , places.shortFormattedAddress , places.subDestinations , places.types , places.utcOffsetMinutes , places.viewport

^* فیلد places.name حاوی نام منبع مکان به شکل است: places/ PLACE_ID . برای دسترسی به نام متنی مکان، از places.displayName استفاده کنید.

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

---

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

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

وب سرویس : places.currentOpeningHours , places.currentSecondaryOpeningHours , places.internationalPhoneNumber , places.nationalPhoneNumber places.websiteUri places.priceLevel , places.rating , places.regularOpeningHours , places.regularSecondaryOpeningHours places.userRatingCount

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

---

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

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

وب سرویس : places.allowsDogs ، places.curbsidePickup ، places.delivery ، places.dineIn ، places.editorialSummary ، places.evChargeOptions ، places.fuelOptions ، places.goodForChildren ،place.goodForGroups، places.goodForGroups ، places.goodForWatchingSports ، places.liveMusic .goodForvesmen، 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.takeout places.servesDinner places.servesWine places.servesLunch places.servesVegetarianFood

^* فقط جستجوی متن و جستجوی نزدیک

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

---

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

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

وب سرویس : places.attributions ، places.id ، places.name ^* ، nextPageToken

^* فیلد places.name حاوی نام منبع مکان به شکل است: places/ PLACE_ID . برای دسترسی به نام متنی مکان، از places.displayName استفاده کنید.

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

---

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

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

وب سرویس : places.accessibilityOptions ، places.addressComponents ، places.adrFormatAddress ، places.businessStatus ، places.displayName places.photos places.formattedAddress ، places.googleMapsUri ، places.iconBackgroundColor ، places.iconMaskBaseUri places.location places.plusCode , places.primaryType , places.primaryTypeDisplayName , places.shortFormattedAddress , places.subDestinations , places.types , places.utcOffsetMinutes , places.viewport

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

---

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

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

وب سرویس : places.currentOpeningHours , places.currentSecondaryOpeningHours , places.internationalPhoneNumber , places.nationalPhoneNumber places.websiteUri places.priceLevel , places.rating , places.regularOpeningHours , places.regularSecondaryOpeningHours places.userRatingCount

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

---

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

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

وب سرویس : places.allowsDogs ، places.curbsidePickup ، places.delivery ، places.dineIn ، places.editorialSummary ، places.evChargeOptions ، places.fuelOptions ، places.goodForChildren ،place.goodForGroups، places.goodForGroups ، places.goodForWatchingSports ، places.liveMusic .goodForvesmen، 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.takeout places.servesDinner places.servesWine places.servesLunch places.servesVegetarianFood

^* فقط جستجوی متن و جستجوی نزدیک

محدوده حجم ماهانه (قیمت هر تماس)
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 API

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

---

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

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

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

محدوده حجم ماهانه (قیمت هر تماس)
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
• 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
  
• 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

• 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-100000	100001–500000	500000+
0.00 دلار آمریکا	0.00 دلار آمریکا	0.00 دلار آمریکا

مثال

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

اندروید

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

iOS

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

وب سرویس

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

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

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

---

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

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

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

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

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

---

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

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

محدوده حجم ماهانه (قیمت هر تماس)
0-100000	100001–500000	500000+
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() پس از انتخاب یک نتیجه مکان (نماد: پین)، *نه* یک پرس و جو (نماد: ذره بین)، همانطور که در اینجا نشان داده شده است:

  

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

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

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

نمونه ها

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

---

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

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

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

مثال

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

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

---

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

Find Place برای درخواست Find Place هزینه دریافت می کند.

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

درخواست‌های Find Place بسته به فیلدهایی که در درخواست مشخص شده‌اند، SKUهای داده ( Basic ، Contact ، و/یا Atmosphere ) تولید می‌کنند. مانند درخواست‌های Place Details، می‌توانید از پارامتر فیلدها در درخواست Find Place خود استفاده کنید تا پاسخ را فقط به آن قسمت‌های مشخص شده محدود کنید. برای درخواست Find Place و همچنین داده های درخواستی صورتحساب دریافت می کنید. به‌طور پیش‌فرض، اگر فیلد NO درخواست شود، فقط شناسه مکان برگردانده می‌شود، بنابراین هزینه‌های اضافی برای داده‌ها متحمل نمی‌شوند.

نمونه ها

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

---

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

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

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

مثال

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

• مکان را پیدا کنید - فقط شناسه (هزینه 0.00 دلار آمریکا)

---

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

مکان – جستجوی نزدیک برای درخواست‌هایی که به سرویس جستجوی مکان در نزدیکی API جاوا اسکریپت Maps nearbySearch() ) یا سرویس جستجوی مکان‌های API نزدیک پرداخت می‌شود، پرداخت می‌شود.

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

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

مثال

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

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

---

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

مکان – جستجوی متن برای درخواست‌ها به سرویس جستجوی متن مکان در Maps JavaScript API ( textSearch() )، یا به خدمات جستجوی متن API مکان‌ها پرداخت می‌شود.

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

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

مکان – SKU جستجوی متن نیز توسط ابزارک مکان SearchBox در Maps JavaScript API ایجاد می‌شود: متد getPlaces() پس از انتخاب یک جستجوی مکان (نماد: ذره‌بین) نه نتیجه (نماد: پین)، همانطور که در اینجا نشان داده شده است:

مثال

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

• مکان - جستجوی متن (قیمت از 0.032 دلار در هر تماس شروع می شود)
• داده های پایه (صورتحساب 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-100000	100001–500000	500000+
0.007 دلار برای هر کدام (7.00 دلار در هر 1000)	0.0056 دلار برای هر کدام (5.60 دلار در هر 1000)	برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید

---

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

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

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

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

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

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

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

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

برای مشاهده یا تغییر محدودیت‌های سهمیه برای Places API:

1. در Cloud Console، صفحه Google Maps Platform Quotas را باز کنید.
2. روی منوی کشویی APIs کلیک کنید و Places API را انتخاب کنید.
3. برای مشاهده محدودیت های سهمیه، به سمت پایین به کارت درخواست ها بروید.
   یک جدول اسامی و محدودیت های سهمیه را فهرست می کند.
4. برای تغییر یک محدودیت سهمیه، روی نماد ویرایش آن محدودیت کلیک کنید.
   در کادر گفتگوی ظاهر شده، در قسمت محدودیت سهمیه ، محدودیت سهمیه روزانه قابل پرداخت ترجیحی (تا سقف سهمیه، در صورت وجود، تعیین شده توسط Google) را وارد کرده و ذخیره را انتخاب کنید.

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

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

• صورت‌حساب و قیمت‌گذاری پلتفرم Google Maps
• گزارش و نظارت پلتفرم نقشه های گوگل

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

محدوده حجم ماهانه (قیمت هر تماس)
0-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 پایان یافت: اعتبار سنجی آدرس ترجیح داده می شود .

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

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

---

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

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

وب سرویس : attributions ، id ، name ^* ، photos

^* فیلد name حاوی نام منبع مکان به شکل است: places/ PLACE_ID . از displayName برای دسترسی به نام متنی مکان استفاده کنید.

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

---

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

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

وب سرویس : addressComponents ، adrFormatAddress ، formattedAddress ، location ، plusCode ، shortFormattedAddress ، types ، viewport

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

---

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

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

وب سرویس : accessibilityOptions ، businessStatus ، displayName ، googleMapsUri ، iconBackgroundColor ، iconMaskBaseUri ، primaryType ، primaryTypeDisplayName ، subDestinations ، utcOffsetMinutes

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

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

---

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

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

وب سرویس : currentOpeningHours , currentSecondaryOpeningHours , internationalPhoneNumber , nationalPhoneNumber , priceLevel , rating , regularOpeningHours , regularSecondaryOpeningHours , userRatingCount , websiteUri

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

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

---

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

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

وب سرویس : allowsDogs , curbsidePickup , delivery , dineIn , editorialSummary , evChargeOptions , fuelOptions , goodForChildren reviews goodForGroups , goodForWatchingSports , liveMusic , menuForChildren , servesCocktails parkingOptions reservable paymentOptions خلاصه، ^* servesBeer ، servesBreakfast outdoorSeating ، سرو restroom ، servesBrunch routingSummaries ، servesCoffee , servesDessert , servesDinner , servesLunch , servesVegetarianFood , servesWine , takeout

^* فقط جستجوی متن و جستجوی نزدیک

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

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

---

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

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

وب سرویس places.iconMaskBaseUri places.accessibilityOptions ، places.addressComponents ، places.adrFormatAddress places.location places.attributions ، places.businessStatus ، places.displayName ، places.formattedAddress places.id places.googleMapsUri ، places.iconBackgroundColor . , places.name ^* , places.photos , places.plusCode , places.primaryType , places.primaryTypeDisplayName , places.shortFormattedAddress , places.subDestinations , places.types , places.utcOffsetMinutes , places.viewport

^* فیلد places.name حاوی نام منبع مکان به شکل است: places/ PLACE_ID . برای دسترسی به نام متنی مکان، از places.displayName استفاده کنید.

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

---

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

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

وب سرویس : places.currentOpeningHours , places.currentSecondaryOpeningHours , places.internationalPhoneNumber , places.nationalPhoneNumber places.websiteUri places.priceLevel , places.rating , places.regularOpeningHours , places.regularSecondaryOpeningHours places.userRatingCount

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

---

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

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

وب سرویس : places.allowsDogs ، places.curbsidePickup ، places.delivery ، places.dineIn ، places.editorialSummary ، places.evChargeOptions ، places.fuelOptions ، places.goodForChildren ،place.goodForGroups، places.goodForGroups ، places.goodForWatchingSports ، places.liveMusic .goodForvesmen، 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.takeout places.servesDinner places.servesWine places.servesLunch places.servesVegetarianFood

^* فقط جستجوی متن و جستجوی نزدیک

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

---

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

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

وب سرویس : places.attributions ، places.id ، places.name ^* ، nextPageToken

^* فیلد places.name حاوی نام منبع مکان به شکل است: places/ PLACE_ID . برای دسترسی به نام متنی مکان، از places.displayName استفاده کنید.

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

---

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

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

وب سرویس : places.accessibilityOptions ، places.addressComponents ، places.adrFormatAddress ، places.businessStatus ، places.displayName places.photos places.formattedAddress ، places.googleMapsUri ، places.iconBackgroundColor ، places.iconMaskBaseUri places.location places.plusCode , places.primaryType , places.primaryTypeDisplayName , places.shortFormattedAddress , places.subDestinations , places.types , places.utcOffsetMinutes , places.viewport

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

---

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

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

وب سرویس : places.currentOpeningHours , places.currentSecondaryOpeningHours , places.internationalPhoneNumber , places.nationalPhoneNumber places.websiteUri places.priceLevel , places.rating , places.regularOpeningHours , places.regularSecondaryOpeningHours places.userRatingCount

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

---

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

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

وب سرویس : places.allowsDogs ، places.curbsidePickup ، places.delivery ، places.dineIn ، places.editorialSummary ، places.evChargeOptions ، places.fuelOptions ، places.goodForChildren ،place.goodForGroups، places.goodForGroups ، places.goodForWatchingSports ، places.liveMusic .goodForvesmen، 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.takeout places.servesDinner places.servesWine places.servesLunch places.servesVegetarianFood

^* فقط جستجوی متن و جستجوی نزدیک

محدوده حجم ماهانه (قیمت هر تماس)
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 API

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

---

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

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

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

محدوده حجم ماهانه (قیمت هر تماس)
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
• 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
  
• 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

• 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-100000	100001–500000	500000+
0.00 دلار آمریکا	0.00 دلار آمریکا	0.00 دلار آمریکا

مثال

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

اندروید

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

iOS

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

وب سرویس

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

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

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

---

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

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

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

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

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

---

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

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

محدوده حجم ماهانه (قیمت هر تماس)
0-100000	100001–500000	500000+
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() پس از انتخاب یک نتیجه مکان (نماد: پین)، *نه* یک پرس و جو (نماد: ذره بین)، همانطور که در اینجا نشان داده شده است:

  

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

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

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

نمونه ها

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

---

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

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

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

مثال

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

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

---

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

Find Place برای درخواست Find Place هزینه دریافت می کند.

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

درخواست‌های Find Place بسته به فیلدهایی که در درخواست مشخص شده‌اند، SKUهای داده ( Basic ، Contact ، و/یا Atmosphere ) تولید می‌کنند. مانند درخواست‌های Place Details، می‌توانید از پارامتر فیلدها در درخواست Find Place خود استفاده کنید تا پاسخ را فقط به آن قسمت‌های مشخص شده محدود کنید. برای درخواست Find Place و همچنین داده های درخواستی صورتحساب دریافت می کنید. به‌طور پیش‌فرض، اگر فیلد NO درخواست شود، فقط شناسه مکان برگردانده می‌شود، بنابراین هزینه‌های اضافی برای داده‌ها متحمل نمی‌شوند.

نمونه ها

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

---

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

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

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

مثال

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

• مکان را پیدا کنید - فقط شناسه (هزینه 0.00 دلار آمریکا)

---

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

مکان – جستجوی نزدیک برای درخواست‌هایی که به سرویس جستجوی مکان در نزدیکی API جاوا اسکریپت Maps nearbySearch() ) یا سرویس جستجوی مکان‌های API نزدیک پرداخت می‌شود، پرداخت می‌شود.

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

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

مثال

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

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

---

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

مکان – جستجوی متن برای درخواست‌ها به سرویس جستجوی متن مکان در Maps JavaScript API ( textSearch() )، یا به خدمات جستجوی متن API مکان‌ها پرداخت می‌شود.

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

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

مکان – SKU جستجوی متن نیز توسط ابزارک مکان SearchBox در Maps JavaScript API ایجاد می‌شود: متد getPlaces() پس از انتخاب یک جستجوی مکان (نماد: ذره‌بین) نه نتیجه (نماد: پین)، همانطور که در اینجا نشان داده شده است:

مثال

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

• مکان - جستجوی متن (قیمت از 0.032 دلار در هر تماس شروع می شود)
• داده های پایه (صورتحساب 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-100000	100001–500000	500000+
0.007 دلار برای هر کدام (7.00 دلار در هر 1000)	0.0056 دلار برای هر کدام (5.60 دلار در هر 1000)	برای اطلاع از قیمت حجم با واحد فروش تماس بگیرید

---

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

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

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

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

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

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

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

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

برای مشاهده یا تغییر محدودیت‌های سهمیه برای Places API:

1. در Cloud Console، صفحه Google Maps Platform Quotas را باز کنید.
2. روی منوی کشویی APIs کلیک کنید و Places API را انتخاب کنید.
3. برای مشاهده محدودیت های سهمیه، به سمت پایین به کارت درخواست ها بروید.
   یک جدول اسامی و محدودیت های سهمیه را فهرست می کند.
4. برای تغییر یک محدودیت سهمیه، روی نماد ویرایش آن محدودیت کلیک کنید.
   در کادر گفتگوی ظاهر شده، در قسمت محدودیت سهمیه ، محدودیت سهمیه روزانه قابل پرداخت ترجیحی (تا سقف سهمیه، در صورت وجود، تعیین شده توسط Google) را وارد کرده و ذخیره را انتخاب کنید.

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

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

• صورت‌حساب و قیمت‌گذاری پلتفرم Google Maps
• گزارش و نظارت پلتفرم نقشه های گوگل