نشانههای جلسه رشتهها (یا اشیاء) تولید شده توسط کاربر هستند که تماسهای تکمیل خودکار (جدید) را بهعنوان جلسه پیگیری میکنند. تکمیل خودکار (جدید) از نشانههای جلسه برای گروهبندی مراحل جستجو و انتخاب جستجوی تکمیل خودکار کاربر در یک جلسه مجزا برای اهداف صورتحساب استفاده میکند.
کاربران مسئول ایجاد نشانه های جلسه برای هر جلسه هستند. نشانههای جلسه باید رشتههای base64 ایمن URL و نام فایل باشند. کاربران میتوانند نشانههای جلسه را به هر شکلی تولید کنند، اگرچه Google توصیه میکند از نسخه 4 شناسههای منحصربهفرد جهانی (UUID) برای نشانههای جلسه استفاده کنید.
جلسه با تماس با تکمیل خودکار (جدید) شروع میشود و با تماس با جزئیات مکان (جدید) یا اعتبارسنجی آدرس به پایان میرسد. هر جلسه میتواند چندین درخواست تکمیل خودکار (جدید) داشته باشد و به دنبال آن یک درخواست برای جزئیات مکان (جدید) یا اعتبارسنجی آدرس ارائه شود. کلید(های) API مورد استفاده برای هر درخواست در یک جلسه باید متعلق به همان پروژه Google Cloud Console باشد.
نشانههای جلسه به روشهای زیر خاتمه مییابند:
جزئیات مکان (جدید) نامیده می شود.
Address Validation نامیده می شود.
جلسه رها شده است.
پس از پایان جلسه، رمز دیگر معتبر نیست. برنامه شما باید برای هر جلسه جدید یک توکن جدید تولید کند. اگر پارامتر sessionToken حذف شود، یا اگر از یک نشانه جلسه استفاده مجدد کنید، جلسه جدید به گونهای محاسبه میشود که گویی هیچ علامت جلسه ارائه نشده است (هر درخواست جداگانه صورتحساب میشود).
تاریخ آخرین بهروزرسانی 2025-08-15 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-15 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eSession tokens track Autocomplete (New) calls as sessions for billing purposes, grouping query and selection phases.\u003c/p\u003e\n"],["\u003cp\u003eUsers must create URL- and filename-safe base64 strings as session tokens for each session, ideally using version 4 UUIDs.\u003c/p\u003e\n"],["\u003cp\u003eA session starts with an Autocomplete (New) call and ends with a Place Details (New) or Address Validation call, allowing multiple Autocomplete queries within the session.\u003c/p\u003e\n"],["\u003cp\u003eSession tokens expire after a Place Details (New) or Address Validation call, if abandoned, or if reused; a new token is needed for each session.\u003c/p\u003e\n"],["\u003cp\u003eOmitting or reusing session tokens results in each request being billed separately, instead of as a session.\u003c/p\u003e\n"]]],["To use this feature, enable Places API (New). Session tokens, which are URL-safe base64 strings (ideally UUIDs), group autocomplete queries and selections into sessions for billing. A session begins with an Autocomplete (New) call and ends with a Place Details (New) or Address Validation call. Each session can contain several autocomplete queries. Tokens are single-use per session; reusing them or omitting them results in per-request billing.\n"],null,["\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/ios-sdk/cloud-setup#enabling-apis).\n\n\u003cbr /\u003e\n\n\nSelect platform: [Android](/maps/documentation/places/android-sdk/session-tokens \"View this page for the Android platform docs.\") [iOS](/maps/documentation/places/ios-sdk/session-tokens \"View this page for the iOS platform docs.\") [JavaScript](/maps/documentation/javascript/places-autocomplete#session_tokens \"View this page for the JavaScript platform docs.\") [Web Service](/maps/documentation/places/web-service/session-tokens \"View this page for the Web Service platform docs.\")\n\n\u003cbr /\u003e\n\nSession tokens\n\nSession tokens are user-generated strings (or objects) that track [Autocomplete (New)](/maps/documentation/places/ios-sdk/place-autocomplete)\ncalls as *sessions*. Autocomplete (New) uses session tokens to group the query\nand selection phases of a user autocomplete search into a discrete session for\nbilling purposes.\n\nUsers are responsible for creating session tokens for each session. Session\ntokens must be URL- and filename-safe base64 strings. Users can generate session\ntokens in any manner, although Google recommends using [version 4 universally\nunique identifiers (UUIDs)](https://tools.ietf.org/html/rfc4122) for session tokens.\n\nThe session begins with a call to Autocomplete (New), and concludes with a call\nto [Place Details (New)](/maps/documentation/places/ios-sdk/details-place) or [Address Validation](/maps/documentation/address-validation/overview). Each session can have\nmultiple Autocomplete (New) queries, followed by one request to Place Details\n(New) or Address Validation. The API key(s) used for each request within a\nsession must belong to the same Google Cloud Console project.\n| **Note:** Session tokens cannot be exchanged between Places API endpoints and Places API (New) or Address Validation endpoints. For example, [Place\n| Autocomplete](/maps/documentation/places/ios-sdk/autocomplete) request can be followed by a Place Details request in the same session, but it cannot be followed by a Place Details (New) request or an Address Validation request in the same session.\n\nSession tokens terminate in the following ways:\n\n- Place Details (New) is called.\n- Address Validation is called.\n- The session is abandoned.\n\n| **Note:** You can optionally omit the Autocomplete (New) session token from a request. If the session token is omitted, each request is billed separately and charges the [Autocomplete -- Per Request SKU](/maps/documentation/places/ios-sdk/usage-and-billing#autocomplete-request-new-ess-sku).\n\nOnce a session has concluded, the token is no longer valid; your app must\ngenerate a fresh token for each new session. If the sessionToken parameter is\nomitted, or if you reuse a session token, the new session is charged as if no\nsession token was provided (each request is billed separately).\n\nFor more information about how Autocomplete (New) requests are billed, see\n[Autocomplete (New) and session pricing](/maps/documentation/places/ios-sdk/session-pricing)."]]