Maps JavaScript API 用量和结算

Maps JavaScript API 请求会根据请求类型生成对两个不同 SKU 的调用:地图加载全景图片。 对 Maps JavaScript API 地点库其他 JavaScript 服务的调用与 JavaScript 原生 SKU 是分开定价的。 点击信息 信息图标可查看此页面的内容目录。

Maps JavaScript API 的结算和定价

如需了解 Google 如何计算您的结算和价格,请参阅 Google Maps Platform 价格列表Google Maps Platform 价格列表 - 印度

SKU:动态地图

此 SKU 会按应用显示地图时地图加载次数进行计费。

  类别 基本功能版
  可结算事件 地图加载
  触发器

当应用以以下任一方式显示已加载的地图时,此 SKU 会按地图加载次数计费:

用户与地图互动(例如平移、缩放或切换地图图层)时不会产生额外的地图加载。

  价格 主要价格表
印度价格表

SKU:动态街景

此 SKU 适用于向 Street View Static API 发出并返回动态街景全景图片的请求。

  类别 Pro
  可结算事件 全景
  触发器

当您使用以下某个类或方法实例化全景图片对象时,系统会触发此 SKU:

  价格 主要价格表
印度价格表

Maps JavaScript API 地点库的定价

SKU:自动补全请求

对于不使用会话的对 Autocomplete API 的请求,您需要支付此 SKU 的费用。如需了解如何使用会话来限制在单个自动补全会话期间计费的请求数量,请参阅会话令牌SKU:自动补全会话用量

  类别 基本功能版
  可结算事件 请求
  触发器

在以下情况下,系统会触发此 SKU:

  • 您的请求不包含会话令牌。
  • 您的请求包含会话令牌,但您放弃了会话。
  • 您的请求包含会话令牌,但您会在特定情况下终止会话。如需了解自动补全会话用量,请参阅会话令牌自动补全会话用量
  价格 主要价格表
印度价格表

SKU:自动补全会话使用情况

此 SKU 会对包含会话令牌的对 Autocomplete(新)API 的每次请求收费。

  类别 基本功能版
  可结算事件 请求
  触发器

当您向包含会话令牌的“自动补全(新)”API 发送请求时,系统会触发此 SKU。

此 SKU 可用作“自动补全(新)”请求 SKU 的封装容器,可让您限制单个自动补全会话期间计费的请求数量。如需了解自动补全会话用量,请参阅会话令牌

注意:如果您不将会话与“自动补全(新)”搭配使用,系统会按“自动补全”请求使用 SKU:自动补全请求 对您进行计费。

  价格 主要价格表
印度价格表

SKU:Places API 地点详情必备功能(仅限 ID)

此 SKU 用于对仅返回地点 ID 的地点详情请求进行计费。

  类别 基本功能版
  可结算事件 使用指定字段掩码的请求。
  触发器

当您请求以下字段时,系统会触发此 SKU:

  • Maps JavaScript API 地点库
    id
    photos

  字段遮罩结算示例

以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。

  • 如果您的请求字段掩码仅包含此 SKU 中的字段:系统会按照此 SKU 的费率对请求进行结算。例如,您可以请求此 SKU 中的一个或多个字段,并按此 SKU 的费率付费。
  • 如果您的请求字段掩码包含其他 SKU 中的字段:系统会按请求的字段的最高 SKU 费率对请求进行结算。例如,如果您包含多个 SKU(例如“基本”SKU 和“企业”SKU)中的字段,则系统会按“企业”SKU 的费率对该请求进行结算。
  价格 主要价格表
印度价格表

SKU:Places API 地点详情必备知识

对于检索此 SKU 中字段的“地点详情”API 请求,系统会按此 SKU 进行计费。
  类别 基本功能版
  可结算事件 使用指定字段掩码的请求。
  触发器

当您请求以下位置信息字段时,系统会触发此 SKU:

  • 地点库、Maps JavaScript API
    addressComponents
    adrFormatAddress
    formattedAddress
    location
    plusCode
    types
    viewport

  字段遮罩结算示例

以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。

  • 如果您的请求字段掩码仅包含此 SKU 中的字段:系统会按照此 SKU 的费率对请求进行结算。例如,您可以请求此 SKU 中的一个或多个字段,并按此 SKU 的费率付费。
  • 如果您的请求字段掩码包含其他 SKU 中的字段:系统会按请求的字段的最高 SKU 费率对请求进行结算。例如,如果您包含多个 SKU(例如“基本”SKU 和“企业”SKU)中的字段,则系统会按“企业”SKU 的费率对该请求进行结算。
  价格 主要价格表
印度价格表

SKU:Places API 地点详情 Pro

此 SKU 会按您在地点详情 Pro 请求中指定的字段收费。

  类别 Pro
  可结算事件 使用指定字段掩码的请求。
  触发器 当您请求以下字段或费率较低的字段时,会触发此 SKU:
  • 地点库、Maps JavaScript API
    accessibilityOptions
    businessStatus
    displayName
    googleMapsUri
    iconBackgroundColor
    primaryTypeDisplayName
    svgIconMaskURI
    types
    utcOffsetMinutes

  字段遮罩结算示例

以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。

  • 如果您的请求字段掩码仅包含此 SKU 中的字段:系统会按照此 SKU 的费率对请求进行结算。例如,您可以请求此 SKU 中的一个或多个字段,并按此 SKU 的费率付费。
  • 如果您的请求字段掩码包含其他 SKU 中的字段:系统会按请求的字段的最高 SKU 费率对请求进行结算。例如,如果您包含多个 SKU(例如“基本”SKU 和“企业”SKU)中的字段,则系统会按“企业”SKU 的费率对该请求进行结算。
  价格 主要价格表
印度价格表

SKU:Places API 地点详情企业版

此 SKU 用于按地点请求(包含企业版字段)进行结算。

  类别 企业
  可结算事件 使用指定字段掩码的请求。
  触发器 当您请求以下字段时,系统会触发此 SKU:
  • 地点库、Maps JavaScript APIinternationalPhoneNumber
    nationalPhoneNumber
    priceLevel
    rating
    regularOpeningHours
    userRatingCount
    websiteUri

如果您使用请求 SKU:地点详情(基本、高级或首选)中的任意字段的地点详情调用终止“自动补全”会话,则该调用将按 SKU:地点详情(首选)进行计费。如需了解详情,请参阅 SKU:自动补全会话使用情况

  字段遮罩结算示例

以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。

  • 如果您的请求字段掩码仅包含此 SKU 中的字段:系统会按照此 SKU 的费率对请求进行结算。例如,您可以请求此 SKU 中的一个或多个字段,并按此 SKU 的费率付费。
  • 如果您的请求字段掩码包含其他 SKU 中的字段:系统会按请求的字段的最高 SKU 费率对请求进行结算。例如,如果您包含多个 SKU(例如“基本”SKU 和“企业”SKU)中的字段,则系统会按“企业”SKU 的费率对该请求进行结算。
  价格 主要价格表
印度价格表

SKU:Places API 地点详情企业版 + 氛围

此 SKU 会针对请求指定氛围字段的对地点详情 API 的调用进行计费。

  类别 企业
  可结算事件 请求
  触发器

当您请求以下字段时,系统会触发此 SKU:

  • Maps JavaScript API 地点库
    allowsDogs
    editorialSummary
    evChargeOptions
    fuelOptions
    hasCurbsidePickup
    hasDelivery
    hasDineIn
    hasLiveMusic
    hasMenuForChildren
    hasOutdoorSeating
    hasRestroom
    hasTakeout
    hasWifi
    isGoodForChildren
    isGoodForGroups
    isGoodForWatchingSports
    isReservable
    parkingOptions
    paymentOptions
    priceLevel
    reviews
    servesBeer
    servesBreakfast
    servesBrunch
    servesCocktails
    servesCoffee
    servesDessert
    servesDinner
    servesLunch
    servesVegetarianFood
    servesWine

如果“自动补全”会话因“地点详情”调用而终止,并且该调用请求了SKU:地点详情(基本、高级或首选)中的任意字段,则该调用将按 SKU:地点详情(首选)进行计费。如需了解详情,请参阅 SKU:自动补全会话使用情况

  字段遮罩结算示例

以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。

  • 如果您的请求字段掩码仅包含此 SKU 中的字段:系统会按照此 SKU 的费率对请求进行结算。例如,您可以请求此 SKU 中的一个或多个字段,并按此 SKU 的费率付费。
  • 如果您的请求字段掩码包含其他 SKU 中的字段:系统会按请求的字段的最高 SKU 费率对请求进行结算。例如,如果您包含多个 SKU(例如“基本”SKU 和“企业”SKU)中的字段,则系统会按“企业”SKU 的费率对该请求进行结算。
  价格 主要价格表
印度价格表

SKU:Places API 附近搜索 Pro

此 SKU 按您在附近搜索 Pro 请求中指定的字段进行计费。

  类别 Pro
  可结算事件 使用指定字段掩码的请求。
  触发器 当您请求以下字段或费率较低的字段时,会触发此 SKU:
  • 地点库、Maps JavaScript API
    accessibilityOptions
    addressComponents
    adrFormatAddress
    businessStatus
    displayName
    formattedAddress
    googleMapsUri
    iconBackgroundColor
    id
    location
    photos
    plusCode
    svgIconMaskURI
    types
    utcOffsetMinutes
    viewport

  字段遮罩结算示例

以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。

  • 如果您的请求字段掩码仅包含此 SKU 中的字段:系统会按照此 SKU 的费率对请求进行结算。例如,您可以请求此 SKU 中的一个或多个字段,并按此 SKU 的费率付费。
  • 如果您的请求字段掩码包含其他 SKU 中的字段:系统会按请求的字段的最高 SKU 费率对请求进行结算。例如,如果您包含多个 SKU(例如“基本”SKU 和“企业”SKU)中的字段,则系统会按“企业”SKU 的费率对该请求进行结算。
  价格 主要价格表
印度价格表

SKU:Places API 附近搜索企业版

此 SKU 适用于包含任何企业版字段的附近搜索请求。

  类别 企业
  可结算事件 使用指定字段掩码的请求。
  触发器

当您请求以下字段时,系统会触发此 SKU:

  • 地点库、Maps JavaScript API
    internationalPhoneNumber
    nationalPhoneNumber
    priceLevel
    rating
    regularOpeningHours
    userRatingCount
    websiteUri

  字段遮罩结算示例

以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。

  • 如果您的请求字段掩码仅包含此 SKU 中的字段:系统会按照此 SKU 的费率对请求进行结算。例如,您可以请求此 SKU 中的一个或多个字段,并按此 SKU 的费率付费。
  • 如果您的请求字段掩码包含其他 SKU 中的字段:系统会按请求的字段的最高 SKU 费率对请求进行结算。例如,如果您包含多个 SKU(例如“基本”SKU 和“企业”SKU)中的字段,则系统会按“企业”SKU 的费率对该请求进行结算。
  价格 主要价格表
印度价格表

SKU:Places API 附近搜索企业版 + 氛围

此 SKU 针对包含指定 atmostphere 字段的附近搜索请求进行计费。

  类别 企业
  可结算事件 请求
  触发器

当您请求以下字段时,系统会触发此 SKU:

  • Maps JavaScript API 地点库
    allowsDogs
    editorialSummary
    evChargeOptions
    fuelOptions
    hasCurbsidePickup
    hasDelivery
    hasDineIn
    hasLiveMusic
    hasMenuForChildren
    hasOutdoorSeating
    hasRestroom
    hasTakeout
    hasWifi
    isGoodForChildren
    isGoodForGroups
    isGoodForWatchingSports
    isReservable
    parkingOptions
    paymentOptions
    priceLevel
    reviews
    servesBeer
    servesBreakfast
    servesBrunch
    servesCocktails
    servesCoffee
    servesDessert
    servesDinner
    servesLunch
    servesVegetarianFood
    servesWine

  字段遮罩结算示例

以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。

  • 如果您的请求字段掩码仅包含此 SKU 中的字段:系统会按照此 SKU 的费率对请求进行结算。例如,您可以请求此 SKU 中的一个或多个字段,并按此 SKU 的费率付费。
  • 如果您的请求字段掩码包含其他 SKU 中的字段:系统会按请求的字段的最高 SKU 费率对请求进行结算。例如,如果您包含多个 SKU(例如“基本”SKU 和“企业”SKU)中的字段,则系统会按“企业”SKU 的费率对该请求进行结算。
  价格 主要价格表
印度价格表

SKU:Places API 文本搜索必备功能(仅 ID)

您需要为仅返回 ID 的 Text Search API 请求支付此 SKU 费用。
  类别 基本功能版
  可结算事件 使用指定字段掩码的请求。
  触发器

当您请求以下字段时,会触发此 SKU:

  • Maps JavaScript API 地点库
    id

  字段遮罩结算示例

以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。

  • 如果您的请求字段掩码仅包含此 SKU 中的字段:系统会按照此 SKU 的费率对请求进行结算。例如,您可以请求此 SKU 中的一个或多个字段,并按此 SKU 的费率付费。
  • 如果您的请求字段掩码包含其他 SKU 中的字段:系统会按请求的字段的最高 SKU 费率对请求进行结算。例如,如果您包含多个 SKU(例如“基本”SKU 和“企业”SKU)中的字段,则系统会按“企业”SKU 的费率对该请求进行结算。
  价格 主要价格表
印度价格表

SKU:Places API 文本搜索 Pro

此 SKU 属于数据 SKU,系统会根据您在文本搜索 Pro 请求中指定的字段来计算费用。
  类别 Pro
  可结算事件 使用指定字段掩码的请求。
  触发器 当您请求以下字段或费率较低的字段时,会触发此 SKU:
  • Maps JavaScript API 地点库
    accessibilityOptions
    addressComponents
    adrFormatAddress
    businessStatus
    displayName
    formattedAddress
    googleMapsUri
    iconBackgroundColor
    location
    photos
    plusCode
    svgIconMaskURI
    types
    utcOffsetMinutes
    viewport

  字段遮罩结算示例

以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。

  • 如果您的请求字段掩码仅包含此 SKU 中的字段:系统会按照此 SKU 的费率对请求进行结算。例如,您可以请求此 SKU 中的一个或多个字段,并按此 SKU 的费率付费。
  • 如果您的请求字段掩码包含其他 SKU 中的字段:系统会按请求的字段的最高 SKU 费率对请求进行结算。例如,如果您包含多个 SKU(例如“基本”SKU 和“企业”SKU)中的字段,则系统会按“企业”SKU 的费率对该请求进行结算。
  价格 主要价格表
印度价格表

SKU:Places API 文本搜索企业版

此 SKU 适用于包含任何企业版字段的文本搜索请求。

  类别 企业
  可结算事件 使用指定字段掩码的请求。
  触发器 当您请求以下字段时,系统会触发此 SKU:
  • 地点库、Maps JavaScript API
    internationalPhoneNumber
    nationalPhoneNumber
    priceLevel
    rating
    regularOpeningHours
    userRatingCount
    websiteUri

  字段遮罩结算示例

以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。

  • 如果您的请求字段掩码仅包含此 SKU 中的字段:系统会按照此 SKU 的费率对请求进行结算。例如,您可以请求此 SKU 中的一个或多个字段,并按此 SKU 的费率付费。
  • 如果您的请求字段掩码包含其他 SKU 中的字段:系统会按请求的字段的最高 SKU 费率对请求进行结算。例如,如果您包含多个 SKU(例如“基本”SKU 和“企业”SKU)中的字段,则系统会按“企业”SKU 的费率对该请求进行结算。
  价格 主要价格表
印度价格表

SKU:Places API 文本搜索企业版 + 氛围

系统会针对包含任何大气字段的文本搜索请求对此 SKU 进行计费。

  类别 企业
  可结算事件 请求
  触发器 当您请求以下字段时,系统会触发此 SKU:
  • Maps JavaScript API 地点库
    allowsDogs
    editorialSummary
    evChargeOptions
    fuelOptions
    hasCurbsidePickup
    hasDelivery
    hasDineIn
    hasLiveMusic
    hasMenuForChildren
    hasOutdoorSeating
    hasRestroom
    hasTakeout
    hasWifi
    isGoodForChildren
    isGoodForGroups
    isGoodForWatchingSports
    isReservable
    parkingOptions
    paymentOptions
    priceLevel
    reviews
    servesBeer
    servesBreakfast
    servesBrunch
    servesCocktails
    servesCoffee
    servesDessert
    servesDinner
    servesLunch
    servesVegetarianFood
    servesWine

  字段遮罩结算示例

以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。

  • 如果您的请求字段掩码仅包含此 SKU 中的字段:系统会按照此 SKU 的费率对请求进行结算。例如,您可以请求此 SKU 中的一个或多个字段,并按此 SKU 的费率付费。
  • 如果您的请求字段掩码包含其他 SKU 中的字段:系统会按请求的字段的最高 SKU 费率对请求进行结算。例如,如果您包含多个 SKU(例如“基本”SKU 和“企业”SKU)中的字段,则系统会按“企业”SKU 的费率对该请求进行结算。
  价格 主要价格表
印度价格表

SKU:地点详情照片

此 SKU 用于针对地点详情照片请求进行结算。

  类别 企业
  可结算事件 请求
  触发器 当您向地点详情 API 请求照片时,系统会触发结算。
  价格 主要价格表
印度价格表

关于“自动补全”会话

“自动补全”会话包含一些“自动补全”请求(用于在用户输入内容时检索建议地点),以及最多一个“地点详情”请求(用于检索与用户所选的地点有关的详细信息)。系统会将同一个会话令牌传递给“自动补全”请求和随后的“地点详情”请求。第一个“自动补全”请求发出时(通常是在用户开始输入时),会话开始。在用户选择其中一条“自动补全”建议后,系统会执行“地点详情”调用。如果用户未选择建议,系统不会执行“地点详情”调用。

在用户选择地点(即系统执行“地点详情”调用)后,您必须使用新的会话令牌启动新会话。

“自动补全”会话可以通过以下 API 生成:

会话令牌非常适合单个用户会话,但不能用于多个用户会话。如果您重复使用某个会话令牌,相应会话会被视为无效,并且系统会按未提供会话令牌的情况为请求计费。

使用会话的“自动补全”请求和“地点详情”请求以不同的 SKU 计费。

关于地点数据 SKU

三个地点数据 SKU 包括:基本数据联系人数据氛围数据

系统会针对以下情况触发一个或多个数据 SKU:

  • Android:对 fetchPlace()findCurrentPlace() 的每次请求
  • iOS:对 fetchPlaceFromPlaceID:findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: 的每次调用
  • 网络服务:每个地点请求,具体取决于请求中指定的字段

对于触发数据 SKU 的请求,除了基本 SKU 费用之外,您还始终需要支付相应的数据 SKU 费用。例如,对于包含“基本数据”字段的“地点详情”请求,您需要同时支付“基本数据”SKU 费用和“地点详情”SKU 费用。

对于 Web 服务,您可以通过以下 Places API 请求指定要返回的数据字段:

对于 Web 服务,以下 Places API 调用不支持指定返回的字段。这些调用始终会返回所有地点数据,您除了支付每个 API 请求的费用外,还需支付三个地点数据 SKU 的费用:

SKU:基本数据

此 SKU 属于数据 SKU,用于对“地点详情”或“查找地点”请求中的基本数据字段进行计费。对于触发此 SKU 的请求,除了基本 SKU 费用之外,您还需要支付此 SKU 的费用。

基本类别中的字段的费用包含在地点请求的基本费用中,它们不会产生任何额外费用。

  类别 基本功能版
  可结算事件 使用指定字段掩码的请求。
  触发器 当您请求以下任一字段时,系统会触发基本数据 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
    plus_code
    type
    url
    utc_offset
    vicinity
    wheelchair_accessible_entrance
  字段遮罩结算示例

以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。

  • 如果您的请求字段掩码仅包含此 SKU 中的字段:系统会按照此 SKU 的费率对请求进行结算。例如,您可以请求此 SKU 中的一个或多个字段,并按此 SKU 的费率付费。
  • 如果您的请求字段掩码包含其他 SKU 中的字段:系统会按请求的字段的最高 SKU 费率对请求进行结算。例如,如果您包含多个 SKU(例如“基本”SKU 和“企业”SKU)中的字段,则系统会按“企业”SKU 的费率对该请求进行结算。
  价格 主要价格表
印度价格表

SKU:联系人数据

此 SKU 属于数据 SKU,用于针对“地点详情”或“查找地点”请求中的联系人数据字段进行结算。对于触发此 SKU 的请求,除了基本 SKU 费用之外,您还需要支付此 SKU 的费用。

在“地点详情”请求或“查找地点”请求中使用 fields 参数时(对于网络服务),或使用 Place.Field 数组时(对于 Android 或 iOS),您可以将响应限制为仅包含指定的字段。联系人类别中的字段会产生额外费用。

  类别 企业
  可结算事件 使用指定字段掩码的请求。
  触发器 系统会在收到以下任一字段请求时触发联系人数据 SKU:
  • AndroidPlace.Field.CURRENT_OPENING_HOURSPlace.Field.INTERNATIONAL_PHONE_NUMBERPlace.Field.OPENING_HOURSPlace.Field.SECONDARY_OPENING_HOURSPlace.Field.WEBSITE_URI
  • iOSGMSPlaceFieldOpeningHoursGMSPlaceFieldPhoneNumberGMSPlaceFieldWebsite
  • 网络服务formatted_phone_numberinternational_phone_numberopening_hourscurrent_opening_hourssecondary_opening_hourswebsite
  字段遮罩结算示例

以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。

  • 如果您的请求字段掩码仅包含此 SKU 中的字段:系统会按照此 SKU 的费率对请求进行结算。例如,您可以请求此 SKU 中的一个或多个字段,并按此 SKU 的费率付费。
  • 如果您的请求字段掩码包含其他 SKU 中的字段:系统会按请求的字段的最高 SKU 费率对请求进行结算。例如,如果您包含多个 SKU(例如“基本”SKU 和“企业”SKU)中的字段,则系统会按“企业”SKU 的费率对该请求进行结算。
  价格 主要价格表
印度价格表

SKU:氛围数据

对于向 Atmosphere Data API 发出并指定此 SKU 中字段的请求,您需要支付此 SKU 的费用。

  类别 企业
  可结算事件 使用指定字段掩码的请求。
  触发器 当您请求以下任一字段时,系统就会触发结算:
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.SERVES_WINE
Place.Field.TAKEOUT
Place.Field.USER_RATING_COUNT
GMSPlaceFieldPriceLevel
GMSPlaceFieldRating
GMSPlaceFieldUserRatingsTotal
GMSPlaceFieldTakeout
GMSPlaceFieldDelivery
GMSPlaceFieldDineIn
GMSPlaceFieldCurbsidePickup
GMSPlaceFieldReservable
GMSPlaceFieldServesBreakfast
GMSPlaceFieldServesLunch
GMSPlaceFieldServesDinner
GMSPlaceFieldServesBeer
GMSPlaceFieldServesWine
GMSPlaceFieldServesBrunch
GMSPlaceFieldServesVegetarianFood
请参阅字段(地点详情)
curbside_pickup
delivery
dine_in, editorial_summary
price_level
rating
reservable
reviews
serves_beer
serves_breakfast
serves_brunch
serves_dinner
serves_lunch,
serves_vegetarian_food
serves_wine
takeout
user_ratings_total
  字段遮罩结算示例

以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。

  • 如果您的请求字段掩码仅包含此 SKU 中的字段:系统会按照此 SKU 的费率对请求进行结算。例如,您可以请求此 SKU 中的一个或多个字段,并按此 SKU 的费率付费。
  • 如果您的请求字段掩码包含其他 SKU 中的字段:系统会按请求的字段的最高 SKU 费率对请求进行结算。例如,如果您包含多个 SKU(例如“基本”SKU 和“企业”SKU)中的字段,则系统会按“企业”SKU 的费率对该请求进行结算。
  价格 主要价格表
印度价格表

SKU:自动补全 - 按请求结算

此 SKU 用于结算不包含会话令牌的请求

如果您从无效的“自动补全”会话(例如重复使用会话令牌的会话)发出请求,系统也会收取“自动补全 - 按请求结算”SKU 费用。

如果您从无效的“自动补全”会话发出请求,来自 Maps JavaScript API 的地点自动补全 widget 的“自动补全”请求可能会被收取“自动补全 - 按请求结算”SKU 费用。当用户输入多个不同的地址或将不同的地址复制/粘贴到该 widget 中,且并不总是选择自动补全联想查询时,可能会发生这种情况。

  类别 基本功能版
  可结算事件 请求
  触发器 系统会针对以下情况触发结算:
  价格 主要价格表
印度价格表

SKU:自动补全(不含地点详情)- 按会话结算

此 SKU 适用于不包含“地点详情”请求的自动补全会话(在会话开始的几分钟内)。

  类别 Pro
  可结算事件 会话
  触发器 如果您的应用在单次会话中发出以下两个请求,系统就会触发结算:

按 SKU 查看账单时,您会看到账单中列出了以下 SKU:

  • 自动补全(不含地点详情)- 按会话结算
  价格 主要价格表
印度价格表

SKU:自动补全(包含地点详情)- 按会话结算

您无需为“自动补全”请求付费。当您请求后续地点详情时,系统会按常规的地点详情定价对此 SKU 进行计费。

  类别 基本功能版
  可结算事件 会话
  触发器 您需要为包含以下任何一项的“自动补全”会话支付自动补全(包含地点详情)- 按会话结算 SKU 的费用:
  • Android:对 fetchPlace() 的调用
  • iOS:对 fetchPlaceFromPlaceID: 的调用
  • 网络服务:“地点详情”请求

“地点详情”请求会生成数据 SKU(基本数据联系人数据和/或氛围数据),具体取决于您在请求中指定的字段。

如果您未在“地点详情”请求中请求特定字段,系统会触发所有数据 SKU(基本版、专业版、企业版和企业版 + 氛围数据)。请仅指定您需要的字段,以免产生不必要的费用。

如果您在“自动补全”会话期间仅请求刷新地点详情 ID(您的请求仅指定 place_id 字段),系统会按 SKU:自动补全(不含地点详情)- 按会话结算对该会话进行计费。

  示例

如果您的应用在单次会话中发出以下三个调用:

网络服务

您会看到账单中列出了以下 SKU(按 SKU 查看账单时):

  • 自动补全(包含地点详情)- 按会话结算
  • 地点详情
  • 基本数据
  价格 主要价格表
印度价格表

SKU:查询自动补全 - 按请求结算

此旧版 SKU 用于按查询自动补全请求计费。

  类别 基本功能版
  可结算事件 请求
  触发器

当您使用以下服务发出查询自动补全请求时,系统会触发此 SKU:

使用“查询自动补全”时,不支持按“自动补全”会话定价。随后的“地点详情”请求需按“地点详情 Pro”SKU支付费用。

  价格 主要价格表
印度价格表

SKU:地点详情 Pro

此 SKU 用于按旧版地点详情请求计费。

  类别 Pro
  可结算事件 请求
  触发器 系统会针对以下 API 发出的请求触发结算:

使用网络 API 和服务时,无论您是否提供会话令牌,都会收取“地点详情”SKU 费用。

此 SKU 还会触发数据 SKU 的计费:如果您在请求中添加数据字段,系统可能会针对数据 SKU(基本数据联系人数据氛围数据)触发额外的计费。 请仅指定您需要的数据字段,以免产生不必要的费用。您需要为此 SKU 以及您请求的数据付费。

  示例
  1. 发出以下某项调用或请求:
    • 移动设备:在 Android 上调用 fetchPlace(),或在 iOS 上调用 fetchPlaceFromPlaceID:,且仅指定 ADDRESS 字段
    • 网络 API 或服务:发出“地点详情”请求,且仅指定“地址”字段:getPlaceDetails(fields: formatted_address)
    您会看到账单中列出了以下 SKU(按 SKU 查看账单时):
    • 地点详情
    • 基本数据
  2. 发出以下某项调用或请求:
    • 移动设备:在 Android 上调用 fetchPlace(),或在 iOS 上调用 fetchPlaceFromPlaceID:,且仅指定 PHONE_NUMBER 字段
    • 网络 API 或服务:发出“地点详情”请求并指定“电话号码”字段:getPlaceDetails(fields: formatted_phone_number)
    您会看到账单中列出了以下 SKU(按 SKU 查看账单时):
    • 地点详情
    • 联系人数据
  3. 发出以下某项调用或请求:
    • 移动设备:在 Android 上调用 fetchPlace(),或在 iOS 上调用 fetchPlaceFromPlaceID:,并指定所有字段
    • 网络 API 或服务:发出“地点详情”请求并指定所有字段(如果您未指定任何字段,系统将默认发出此类请求):getPlaceDetails()
    您会看到账单中列出了以下 SKU(按 SKU 查看账单时):
    • 地点详情
    • 基本数据
    • 联系人数据
    • 环境氛围数据
  价格 主要价格表
印度价格表

SKU:地点详情 - ID 刷新

对于向地点详情 API 发出用于 刷新过时的地点 ID 的请求,您需要支付此 SKU 的费用。

  类别 基本功能版
  可结算事件 请求
  触发器 当您发出仅指定“地点 ID”字段的“地点详情”请求时,系统会触发结算:getPlaceDetails(fields: place_id)
  价格 主要价格表
印度价格表

SKU:查找地点

对于返回地点 ID 以外的其他字段的“查找地点”请求,系统会按此 SKU 进行计费。

此 SKU 还会触发数据 SKU 的计费:如果您在请求中添加数据字段,系统可能会针对数据 SKU(基本数据联系人数据氛围数据)触发额外的计费。 请仅指定您需要的数据字段,以免产生不必要的费用。您需要为此 SKU 以及您请求的数据付费。

  类别 Pro
  可结算事件 请求
  触发器 此 SKU 会对以下方法的请求进行计费:
  • 查找当前地点

此 SKU 还会触发数据 SKU 的计费:如果您在请求中添加数据字段,系统可能会针对数据 SKU(基本数据联系人数据氛围数据)触发额外的计费。 请仅指定您需要的数据字段,以免产生不必要的费用。您需要为此 SKU 以及您请求的数据付费。

  示例

以下示例展示了在发出“查找当前地点”请求并指定基本数据、联系人数据和氛围数据 SKU 中的字段时,系统会按哪些 SKU 向您收费。如需查看账单中的 SKU,请按 SKU 查看账单,如按 SKU 分析用量和费用中所述。

  1. 您发出“查找地点”请求并仅指定“地址”字段:FindPlace(fields: formatted_address)。您的账单中显示了以下 SKU:
    • 查找地点
    • 基本数据
  2. 您发出“查找地点”请求并指定“电话号码”字段:FindPlace(fields: formatted_phone_number)。您的账单中显示了以下 SKU:
    • 查找地点
    • 联系人数据
  3. 您发出“查找地点”请求并指定所有三个数据类型范畴的字段:FindPlace(fields: formatted_address, opening_hours, price_level)。您的账单中显示了以下 SKU:
    • 查找地点
    • 基本数据
    • 联系人数据
    • 环境氛围数据
  价格 主要价格表
印度价格表

SKU:查找地点 - 仅返回 ID

此 SKU 适用于仅返回地点 ID 的“查找地点”请求。默认情况下,如果您未在“查找地点”请求中指定任何字段,则系统仅会返回地点 ID。

  类别 基本功能版
  可结算事件 请求
  触发器 您发出“查找地点”请求,但未指定任何字段,或者仅指定 place_id 字段:FindPlace(fields: place_id)
  价格 主要价格表
印度价格表

SKU:地点 - 附近搜索

此 SKU 用于按“附近搜索”请求进行结算。

  类别 Pro
  可结算事件 请求
  触发器 当您使用以下任一 API 发出附近搜索请求时,系统会触发此 SKU:

此请求不支持指定要返回的字段。响应会返回地点列表和受支持的数据字段子集

此 SKU 还会触发数据 SKU 的计费:如果您在请求中添加数据字段,系统可能会针对数据 SKU(基本数据联系人数据氛围数据)触发额外的计费。 请仅指定您需要的数据字段,以免产生不必要的费用。您需要为此 SKU 以及您请求的数据付费。

  示例

您发出“附近搜索”请求,例如 NearbySearch (San Francisco, 100 meters)按 SKU 查看账单时,您的账单会显示以下 SKU:

  • 地点
  • 基本数据
  • 联系人数据
  • 环境氛围数据
  价格 主要价格表
印度价格表

SKU:地点 - 文本搜索

对于对地点文本搜索服务的请求,系统会按此 SKU 进行计费。

  类别 Pro
  可结算事件 请求
  触发器 系统会针对对以下服务的请求触发结算:

“文本搜索”请求会返回地点列表,但不支持指定返回哪些字段。“文本搜索”请求会返回受支持的数据字段子集。您需要为“文本搜索”请求以及所有数据类型的 SKU(基本数据联系人数据氛围数据)付费。

“地点 - 文本搜索”SKU 也由 Maps JavaScript API 的地点搜索框 widget 触发:用户选择地点查询(图标:放大镜)而不是结果(图标:图钉)后调用的 getPlaces() 方法,如下所示:

地点详情搜索框微件查询选择
在搜索框 widget 的结果中可以看到,在搜索框中输入“pizza”后,“pizza delivery”前带有放大镜图标,这表示它属于地点查询(而非结果)。
  示例

如果您发出“文本搜索”请求(例如 TextSearch(123 Main Street)),则在按 SKU 查看账单时,账单中会显示以下 SKU:

  • 地点 - 文本搜索
  • 基本数据
  • 联系人数据
  • 环境氛围数据
  价格 主要价格表
印度价格表

SKU:Places API 地点详情照片

此 SKU 用于计费旧版地点照片服务。

  类别 企业
  可结算事件 请求
  触发器 系统会针对以下情况触发结算:
  价格 主要价格表
印度价格表

JavaScript 服务的定价

JavaScript 服务是单独定价的。如需了解详情,请参阅服务的用量和结算页面:

其他用量限制

虽然每天的请求数量没有上限,但 Maps JavaScript API 存在以下用量限额:

  • 30,000 QPM(每分钟请求数)
  • 每个 IP 地址 300 QPM(每分钟请求数)。在 Google Cloud 控制台中,此配额称为 Map loads per minute per user(每用户每分钟地图加载次数)。

Maps JavaScript 中的仿真 3D 地图用量限制

Maps JavaScript 中的仿真 3D 地图设有以下使用限制

  • 100 QPM(每分钟请求数)。
  • 每个 IP 地址 10 QPM(每分钟请求数)。

使用条款限制

如需了解允许用法的完整详情,请参阅 Google Maps Platform 服务条款中的“许可限制”部分