自动补全和会话定价
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
Google 建议您使用包含自动补全(新)的会话。
会话有助于简化定价,并为使用自动补全(新)功能提供一致的定价模式。
会话从包含会话令牌的第一个“自动补全(新)”请求开始,一直持续到每个后续的“自动补全(新)”请求,然后因使用该会话令牌的“地点详情(新)”或“地址验证”请求而终止。
会话终止后,任何使用过期会话令牌对“自动补全(新)”“地点详情(新)”或“地址验证”的调用都将按没有会话令牌的情况计费。
不完整的会话(即未因“地点详情(新)”或“地址验证”请求而终止的会话)仅针对“自动补全(新)”请求收费,并使用 SKU:自动补全请求。
会话结算
以“地点详情(新)- 必需项”请求结束的会话
对于以使用 SKU:Places API 地点详情精简版中的字段的请求结束的自动补全(新)会话:
以地址验证或地点详情(新)(非必需)请求结束的会话
对于以地址验证请求或地点详情 (New) 请求结束的自动补全 (New) 会话,如果该请求使用地点详情 Pro、Enterprise 或 Enterprise + Atmosphere 中的字段,则:
-
自动补全(新)请求:所有自动补全(新)请求均按 SKU:自动补全会话使用情况计费,这意味着这些请求无需付费。
-
“地点详情(新)”或“地址验证”请求:您还需要按相应 SKU 为终止请求付费:
会议价格场景
以下是三种最常见的会话定价方案:
以下部分将介绍每种情形下的具体结算费用。
位置数据自动补全
在“自动补全位置数据”方案中,您希望使用自动补全(新)和地点详情(新)来获取某个地点的相关位置信息。例如,您可以从自动补全(新)中选择建议,然后使用地点详情(新)获取地点的纬度和经度坐标,以便在地图上显示该地点。
位置信息可能包括以下内容:
- 地址
- 以纬度和经度坐标表示的位置
- Plus Code
- 类型
- 视口
此会话因对“地点详情(新)”发出单个请求而终止,该请求请求的字段由 SKU:地点详情精简版定义。
则计费方式如下:
地点发现自动补全
在地点发现的自动补全场景中,您感兴趣的不仅仅是地点的地理位置数据。例如,您可以提出以下任一请求:
在此方案中,您的会话因单个“地点详情(新)”请求而终止,该请求请求了“地点详情(新)”专业版、Pro或企业版 + 氛围 SKU 中包含的任何字段。
则计费方式如下:
自动补全结账和送货信息
Address Validation API 是一项接受地址的服务。它会识别地址组成部分并验证这些组成部分。它还会对地址进行标准化处理以方便邮寄,并找到地址的最优纬度和经度坐标。
在结账和送货场景的自动补全功能中,您可以通过向 Address Validation API 发出请求来终止会话,以验证所选地址。
则计费方式如下:
不含课程的价格
如果您不使用会话,则系统会根据您向“自动补全(新)”发出的请求次数,使用 SKU:自动补全请求进行结算。
不完整或已放弃会话的定价
如果会话被放弃(即未通过调用“地点详情(新)”或“地址验证”来终止),“自动补全(新)”请求将恢复为按请求结算的定价模式,并按 SKU:自动补全请求计费。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-08-31。
[null,null,["最后更新时间 (UTC):2025-08-31。"],[[["\u003cp\u003eGoogle recommends using sessions with Place Autocomplete for simplified and consistent pricing.\u003c/p\u003e\n"],["\u003cp\u003eSessions are initiated with the first Autocomplete request containing a session token and terminated by a Place Details request using the same token.\u003c/p\u003e\n"],["\u003cp\u003eSessions enable discounted pricing for Autocomplete requests after the initial few and are billed differently based on the type of Place Details request terminating them (Location data, Place discovery, or Checkout and delivery).\u003c/p\u003e\n"],["\u003cp\u003eIf sessions are not used or are incomplete (not terminated by a Place Details request), Autocomplete requests are billed individually at a standard rate.\u003c/p\u003e\n"],["\u003cp\u003eSessions cannot be shared between Places API endpoints and Places API (New) endpoints, limiting their use to specific sequences of requests within the same API version.\u003c/p\u003e\n"]]],[],null,["# Autocomplete 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**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n\n\nGoogle recommends that you use sessions with [Autocomplete (New)](/maps/documentation/javascript/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)."]]