تنصحك Google باستخدام الجلسات مع الإكمال التلقائي (جديد).
تساعد الجلسات في تبسيط الأسعار وتوفير نموذج أسعار ثابت لاستخدامه مع ميزة "الإكمال التلقائي (جديد)".
تبدأ الجلسة بطلب "الإكمال التلقائي (جديد)" الأول الذي يتضمّن رمزًا مميّزًا للجلسة، وتستمر خلال كل طلب "إكمال تلقائي (جديد)" لاحق، ثم تنتهي بطلب إلى "تفاصيل المكان (جديد)" أو "التحقّق من صحة العنوان" يستخدم رمز الجلسة المميّز.
بعد انتهاء الجلسة، سيتم تحصيل رسوم مقابل أي طلب إلى "الإكمال التلقائي (جديد)" أو "تفاصيل المكان (جديد)" أو "التحقّق من صحة العنوان" يستخدم رمز الجلسة المنتهي الصلاحية، كما لو لم يكن هناك رمز جلسة.
لا يتم تحصيل رسوم الجلسات غير المكتملة، أي الجلسات التي لم يتم إنهاؤها بطلب إلى Place Details (New) أو Address Validation، إلا مقابل طلبات الإكمال التلقائي (جديد) باستخدام رمز التخزين التعريفي: طلبات الإكمال التلقائي.
الفوترة حسب الجلسة
الجلسات التي تنتهي بطلب أساسي لتفاصيل المكان (جديد)
أول 12 طلبًا من طلبات الإكمال التلقائي (جديد): يتم تحصيل رسوم منك مقابل كل طلب من طلبات الإكمال التلقائي (جديد)، بحد أقصى 12 طلبًا، باستخدام رمز التخزين التعريفي: طلبات الإكمال التلقائي.
بالنسبة إلى طلبات الإكمال التلقائي (جديد) رقم 13 والإصدارات الأحدث في الجلسة نفسها: سيتم تحصيل الرسوم منك وفقًا لرمز التخزين التعريفي: استخدام جلسة الإكمال التلقائي، ما يعني أنّه لن يتم تحصيل أي رسوم مقابل هذه الطلبات.
الجلسات التي تنتهي بطلبات "التحقّق من صحة العنوان" أو "تفاصيل المكان (جديد)" (غير أساسية)
بالنسبة إلى جلسات "الإكمال التلقائي (جديد)" التي تنتهي بطلب "التحقّق من صحة العنوان" أو طلب "تفاصيل المكان (جديد)" باستخدام حقول من "تفاصيل المكان" Pro أو Enterprise أو Enterprise + Atmosphere:
طلبات الإكمال التلقائي (جديد): يتم تحصيل رسوم من جميع طلبات الإكمال التلقائي (جديد) وفقًا لوحدة حفظ المخزون: استخدام جلسة الإكمال التلقائي، ما يعني أنّه لا يتم تحصيل أي رسوم مقابل هذه الطلبات.
طلب "تفاصيل المكان (جديد)" أو "التحقّق من صحة العنوان": يتم أيضًا تحصيل رسوم منك مقابل الطلب الذي تم إنهاؤه وفقًا لوحدة حفظ المخزون المناسبة:
توضّح الأقسام التالية رسوم الفوترة الفردية لكل سيناريو.
الإكمال التلقائي لبيانات الموقع الجغرافي
في سيناريو "الإكمال التلقائي لبيانات الموقع الجغرافي"، يهمّك استخدام ميزة "الإكمال التلقائي (جديدة)" و"تفاصيل المكان (جديدة)" للحصول على معلومات الموقع الجغرافي لمكان معيّن. على سبيل المثال، يمكنك اختيار اقتراح من "الإكمال التلقائي" (جديد)، ثم استخدام "تفاصيل المكان" (جديد) للحصول على إحداثيات خطوط الطول والعرض الخاصة بالمكان لعرضه على الخريطة.
في سيناريو "الإكمال التلقائي" لاكتشاف الأماكن، يهمّك الحصول على أكثر من مجرد بيانات الموقع الجغرافي لمكان معيّن. على سبيل المثال، يمكنك طلب أي مما يلي:
خيارات تسهيل الاستخدام
ساعات العمل الحالية
خيارات ركن السيارة
المراجعات
التقييمات
في هذا السيناريو، يتم إنهاء جلستك بطلب واحد إلى Place Details (New) يطلب أي حقول مضمّنة في رموز التخزين التعريفي Pro أو Enterprise أو Enterprise + Atmosphere في Place Details (New).
Address Validation API هي خدمة تقبل عنوانًا. تحدّد هذه الخدمة مكوّنات العنوان وتتحقّق من صحتها. تعمل هذه الخدمة أيضًا على توحيد تنسيق العنوان المخصّص للمراسلة، وتحديد أفضل إحداثيات معروفة لخط الطول وخط العرض الخاصة به.
في سيناريو "الإكمال التلقائي لعملية الدفع والتسليم"، يمكنك إنهاء الجلسة بطلب إلى Address Validation API للتحقّق من صحة العنوان المحدّد.
الأسعار للجلسات غير المكتملة أو التي تمّ التخلي عنها
في حال تم إيقاف الجلسة، أي لم يتم إنهاؤها من خلال طلب إلى Place Details (New) أو Address Validation، ستعود طلبات Autocomplete (New) إلى نموذج التسعير لكل طلب وسيتم تحصيل الرسوم وفقًا لرمز التخزين التعريفي: طلبات الإكمال التلقائي.
تاريخ التعديل الأخير: 2025-08-27 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-08-27 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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\u003eWithout sessions, each Autocomplete (New) request is billed individually, while incomplete sessions revert to per-request pricing for Autocomplete (New) requests.\u003c/p\u003e\n"],["\u003cp\u003eSession pricing varies depending on the scenario and the specific SKUs used, with details outlined in provided tables and examples.\u003c/p\u003e\n"]]],["Google's Autocomplete (New) service uses sessions for pricing, starting with an Autocomplete request containing a session token. Subsequent Autocomplete requests within the session are followed by a Place Details (New) or Address Validation request, which terminates the session. Incomplete sessions are billed per Autocomplete request. Three common scenarios include location data, place discovery, and checkout/delivery, each with different billing structures for Autocomplete and the terminating request. Without sessions, all Autocomplete requests are billed per request.\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/android-sdk/cloud-setup#enabling-apis).\n\n\u003cbr /\u003e\n\n\nGoogle recommends that you use sessions with [Autocomplete (New)](/maps/documentation/places/android-sdk/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)."]]
