Google توصیه میکند از جلسات با تکمیل خودکار (جدید) استفاده کنید. جلسات به سادهسازی قیمتگذاری و ارائه یک مدل قیمتگذاری ثابت برای استفاده با تکمیل خودکار (جدید) کمک میکنند.
یک جلسه با اولین درخواست تکمیل خودکار (جدید) شروع می شود که شامل یک نشانه جلسه است، تا هر درخواست تکمیل خودکار بعدی (جدید) ادامه می یابد و سپس با درخواستی به جزئیات مکان (جدید) یا اعتبار سنجی آدرس که از نشانه جلسه استفاده می کند، پایان می یابد.
پس از پایان جلسه، هر تماسی با تکمیل خودکار (جدید)، جزئیات مکان (جدید)، یا اعتبارسنجی آدرس که از نشانه جلسه منقضی شده استفاده میکند، به گونهای صورتحساب میشود که گویی نشانه جلسه وجود نداشته است.
جلسات ناقص، یعنی جلساتی که با درخواست جزئیات مکان (جدید) یا اعتبار سنجی آدرس خاتمه نمییابند، فقط برای درخواستهای تکمیل خودکار (جدید) با استفاده از SKU محاسبه میشوند: درخواستهای تکمیل خودکار .
صورتحساب جلسه
پایان جلسات در یک درخواست جزئیات مکان (جدید) Essentials
اولین 12 درخواست تکمیل خودکار (جدید) : برای هر درخواست تکمیل خودکار (جدید)، حداکثر تا 12 درخواست، با استفاده از SKU: درخواستهای تکمیل خودکار، صورتحساب دریافت میکنید.
برای درخواستهای تکمیل خودکار (جدید) 13 و بالاتر در همان جلسه : صورتحساب شما در SKU دریافت میشود: استفاده از جلسه تکمیل خودکار ، به این معنی که هزینهای برای آن درخواستها دریافت نمیشود.
جلسات با درخواست اعتبار آدرس یا جزئیات مکان (جدید) (غیر ضروری) خاتمه می یابد
برای جلسات تکمیل خودکار (جدید) که با درخواست اعتبار آدرس یا درخواست جزئیات مکان (جدید) با استفاده از فیلدهای Place Details Pro ، Enterprise یا Enterprise + Atmosphere خاتمه می یابد:
بخشهای زیر هزینههای صورتحساب جداگانه برای هر سناریو را توضیح میدهند.
تکمیل خودکار برای داده های مکان
در سناریوی تکمیل خودکار برای داده های مکان، شما علاقه مند هستید که از تکمیل خودکار (جدید) و جزئیات مکان (جدید) برای به دست آوردن اطلاعات مکان در مورد یک مکان استفاده کنید. برای مثال، پیشنهادی را از تکمیل خودکار (جدید) انتخاب میکنید، سپس از جزئیات مکان (جدید) برای دریافت مختصات طول و عرض جغرافیایی مکان برای نشان دادن آن مکان روی نقشه استفاده میکنید.
در سناریوی تکمیل خودکار برای کشف مکان، شما علاقه مند به دستیابی به اطلاعاتی بیش از اطلاعات مکان در مورد یک مکان هستید. برای مثال، ممکن است یکی از موارد زیر را درخواست کنید:
گزینه های دسترسی
ساعات کاری فعلی
گزینه های پارکینگ
بررسی ها
رتبه بندی ها
برای این سناریو، جلسه شما با یک درخواست به جزئیات مکان (جدید) خاتمه مییابد که فیلدهای موجود در جزئیات مکان (جدید) Pro , Enterprise یا Enterprise + Atmosphere SKU را درخواست میکند.
Address Validation API سرویسی است که یک آدرس را می پذیرد. اجزای آدرس را شناسایی و آنها را تأیید می کند. همچنین آدرس پستی را استاندارد می کند و بهترین مختصات طول و عرض جغرافیایی شناخته شده را برای آن پیدا می کند.
در سناریوی تکمیل خودکار برای پرداخت و تحویل، جلسه را با درخواستی از Address Validation API برای اعتبارسنجی آدرس انتخاب شده خاتمه می دهید.
اگر از جلسات استفاده نمیکنید، به ازای درخواست تکمیل خودکار (جدید) با استفاده از SKU: درخواستهای تکمیل خودکار صورتحساب دریافت میکنید.
قیمت برای جلسات ناقص یا رها شده
اگر جلسه رها شود، به این معنی که با تماس با جزئیات مکان (جدید) یا اعتبار سنجی آدرس پایان نیافته است، درخواستهای تکمیل خودکار (جدید) به مدل قیمتگذاری هر درخواست برمیگردند و براساس SKU صورتحساب میشوند: درخواستهای تکمیل خودکار .
تاریخ آخرین بهروزرسانی 2025-09-04 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-09-04 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eGoogle recommends using sessions with Autocomplete (New) to simplify pricing and provide a consistent model.\u003c/p\u003e\n"],["\u003cp\u003eSessions are initiated with the first Autocomplete (New) request containing a session token and terminate with a Place Details (New) or Address Validation request using the same token.\u003c/p\u003e\n"],["\u003cp\u003eThree common pricing scenarios exist: Autocomplete for location data, Autocomplete for place discovery, and Autocomplete for checkout and delivery, each with its own billing structure.\u003c/p\u003e\n"],["\u003cp\u003eIncomplete or abandoned sessions revert to per-request pricing for Autocomplete (New) requests.\u003c/p\u003e\n"],["\u003cp\u003eWithout sessions, each Autocomplete (New) request is billed individually.\u003c/p\u003e\n"]]],[],null,["# Autocomplete (New) and session pricing\n\nSelect platform: [Android](/maps/documentation/places/android-sdk/session-pricing \"View this page for the Android platform docs.\") [iOS](/maps/documentation/places/ios-sdk/session-pricing \"View this page for the iOS platform docs.\") [JavaScript](/maps/documentation/javascript/session-pricing \"View this page for the JavaScript platform docs.\") [Web Service](/maps/documentation/places/web-service/session-pricing \"View this page for the Web Service platform docs.\")\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| This feature requires that you enable Places API (New), the next generation of the Places API. For more information, see [Enable APIs](/maps/documentation/places/web-service/cloud-setup#enabling-apis).\n\n\u003cbr /\u003e\n\n\nGoogle recommends that you use sessions with [Autocomplete (New)](/maps/documentation/places/web-service/place-autocomplete).\nSessions help simplify pricing and provide a consistent pricing model for use with Autocomplete (New).\n\n\nA session starts with the first Autocomplete (New) request that includes a session token,\ncontinues through each subsequent Autocomplete (New) request, and is then terminated by a request\nto Place Details (New) or Address Validation that uses the session token.\n\n\nAfter the session terminates, any call to Autocomplete (New), Place Details (New), or Address\nValidation that uses the expired session token is billed as if there was no session token.\n\n\nIncomplete sessions, meaning sessions that are not terminated by a request to Place Details (New)\nor Address Validation, are billed only for the Autocomplete (New) requests using the\n[SKU: Autocomplete Requests](/maps/billing-and-pricing/sku-details#places_autocomplete-request-new-ess-sku).\n\nSession billing\n---------------\n\n### Sessions terminating in a Place Details (New) Essentials request\n\nFor Autocomplete (New) sessions that terminate in a request using fields from\n[SKU: Places API Place Details Essentials](/maps/billing-and-pricing/sku-details#place-details-ess-sku):\n\n- **First 12 Autocomplete (New) requests** : You are billed for each Autocomplete (New) request, up to a maximum of 12 requests, using the [SKU: Autocomplete Requests](/maps/billing-and-pricing/sku-details#places_autocomplete-request-new-ess-sku).\n- **For Autocomplete (New) requests 13 and higher in the same session** : You are billed at the [SKU: Autocomplete Session Usage](/maps/billing-and-pricing/sku-details#autocomplete-session-new-ess-sku), meaning there is no charge for those requests.\n- **Place Details (New) Essentials:** You are also billed for the terminating request at [SKU: Places API Place Details Essentials](/maps/billing-and-pricing/sku-details#place-details-ess-sku).\n\n| **Note:** If you terminate the session by making a request to Place Details (New) using the [SKU: Places API Place Details Essentials (IDs Only)](/maps/billing-and-pricing/sku-details#place-details-id-only-ess-sku), then all requests to Autocomplete (New) are billed using the [SKU: Autocomplete Requests](/maps/billing-and-pricing/sku-details#places_autocomplete-request-new-ess-sku), as if you did not use sessions. This is because the request using the [SKU: Places API Place Details Essentials (IDs Only)](/maps/billing-and-pricing/sku-details#place-details-id-only-ess-sku) is not charged, so all Autocomplete (New) requests revert to per-request pricing.\n\n### Sessions terminating in Address Validation or Place Details (New) (non-Essentials) requests\n\nFor Autocomplete (New) sessions that terminate in an Address Validation request or a Place\nDetails (New) request using fields from Place Details\n[Pro](/maps/billing-and-pricing/sku-details#place-details-pro-sku),\n[Enterprise](/maps/billing-and-pricing/sku-details#place-details-ent-sku),\nor [Enterprise + Atmosphere](/maps/billing-and-pricing/sku-details#place-details-ent-plus-sku):\n\n- **Autocomplete (New) requests:** All Autocomplete (New) requests are billed at the [SKU: Autocomplete Session Usage](/maps/billing-and-pricing/sku-details#autocomplete-session-new-ess-sku), meaning there is no charge for those requests.\n- **Place Details (New) or Address Validation request:** You are also billed for the terminating request at the appropriate SKU:\n - **Place Details (New)** terminating requests are billed at [SKU: Place Details Enterprise + Atmosphere](/maps/billing-and-pricing/sku-details#place-details-ent-plus-sku), regardless of the fields requested.\n - **Address Validation** terminating requests are billed at [SKU: Address Validation Enterprise](/maps/billing-and-pricing/sku-details#address-validation-ent-sku).\n\nSession pricing scenarios\n-------------------------\n\nThe three most common session pricing scenarios are:\n\n- [Autocomplete for location data](#ac-location-data)\n- [Autocomplete for place discovery](#ac-place-discovery)\n- [Autocomplete for checkout and delivery](#ac-checkout-delivery)\n\nThe following sections describe the individual billing charges for each scenario.\n\n### Autocomplete for location data\n\n\nIn the Autocomplete for location data scenario, you are interested in using Autocomplete (New) and\nPlace Details (New) to obtain location information about a place. For example, you select a\nsuggestion from Autocomplete (New), then use Place Details (New) to get the place's latitude and\nlongitude coordinates to show that place on a map.\n\nLocation information can include the following:\n\n- Address\n- Location as latitude and longitude coordinates\n- Plus Code\n- Types\n- Viewport\n\n\nThis session is terminated by a single request to Place Details (New) that requests fields\ndefined by the\n[SKU: Place Details Essentials](/maps/billing-and-pricing/sku-details#place-details-ess-sku).\n\nYou are then billed as follows:\n\n- **The first 12 Autocomplete (New) requests** are billed at the [SKU: Autocomplete Requests](/maps/billing-and-pricing/sku-details#places_autocomplete-request-new-ess-sku).\n- **Any remaining Autocomplete (New) requests** are billed at the [SKU: Autocomplete Session Usage](/maps/billing-and-pricing/sku-details#autocomplete-session-new-ess-sku), meaning there is no charge for those requests.\n- **The terminating Place Details (New) request** is charged at the [SKU: Places API Place Details Essentials](/maps/billing-and-pricing/sku-details#place-details-ess-sku).\n\n### Autocomplete for place discovery\n\n\nIn the Autocomplete for place discovery scenario, you are interested in obtaining more than just\nlocation data about a place. For example, you might request any of the following:\n\n- Accessibility options\n- Current opening hours\n- Parking options\n- Reviews\n- Ratings\n\n\nFor this scenario, your session is terminated by a single request to Place Details (New) that\nrequests **any fields** included in the Place Details (New)\n[Pro](/maps/billing-and-pricing/sku-details#place-details-pro-sku),\n[Enterprise](/maps/billing-and-pricing/sku-details#place-details-ent-sku), or\n[Enterprise + Atmosphere](/maps/billing-and-pricing/sku-details#place-details-ent-plus-sku) SKUs.\n\nYou are then billed as follows:\n\n- **All Autocomplete (New) requests** are billed at the [SKU: Autocomplete Session Usage](/maps/billing-and-pricing/sku-details#autocomplete-session-new-ess-sku), meaning there is no charge for those requests.\n- **The terminating Place Details (New) request** is billed at [SKU: Places API Place Details Enterprise + Atmosphere](/maps/billing-and-pricing/sku-details#place-details-ent-plus-sku).\n\n### Autocomplete for checkout and delivery\n\n\nThe [Address Validation API](/maps/documentation/address-validation/overview) is a\nservice that accepts an address. It identifies address components and validates them. It also\nstandardizes the address for mailing and finds the best known latitude and longitude coordinates\nfor it.\n\n\nIn the Autocomplete for checkout and delivery scenario, you terminate the session with a request\nto the\n[Address Validation API](/maps/documentation/address-validation/requests-validate-address)\nto validate the selected address.\n\nYou are then billed as follows:\n\n- **All Autocomplete (New) requests** are billed at the [SKU: Autocomplete Session Usage](/maps/billing-and-pricing/sku-details#autocomplete-session-new-ess-sku), meaning there is no charge for those requests.\n- **An optional Place Details Essentials request** is billed at no charge, if requested before the terminating Address Validation request.\n- **The terminating Address Validation request** is billed at the [SKU: Address Validation Enterprise](/maps/billing-and-pricing/sku-details#address-validation-ent-sku).\n\nPricing without sessions\n------------------------\n\n\nIf you don't use sessions, you are billed per request to Autocomplete (New) using the\n[SKU: Autocomplete Requests](/maps/billing-and-pricing/sku-details#places_autocomplete-request-new-ess-sku).\n\nPricing for incomplete or abandoned sessions\n--------------------------------------------\n\n\nIf a session is abandoned, meaning not terminated by a call to Place Details (New) or Address\nValidation, Autocomplete (New) requests revert to the per-request pricing model and are billed\nper the\n[SKU: Autocomplete Requests](/maps/billing-and-pricing/sku-details#places_autocomplete-request-new-ess-sku)."]]