---
title: "计费与权限"
description: "启用您使用的 Google 地图 API，并估算其对计费的影响。"
canonical_url: "https://nuxt-scripts.zhcndoc.com/scripts/google-maps/guides/billing"
last_updated: "2026-08-11T09:33:14.328Z"
---

## 必需的 API 权限

仅启用实现所使用的 API：

<table>
<thead>
  <tr>
    <th>
      API
    </th>
    
    <th>
      必需？
    </th>
    
    <th>
      使用时机
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <a href="https://developers.google.com/maps/documentation/javascript/get-api-key" rel="nofollow">
        Maps JavaScript API
      </a>
    </td>
    
    <td>
      是
    </td>
    
    <td>
      交互式地图渲染
    </td>
  </tr>
  
  <tr>
    <td>
      <a href="https://developers.google.com/maps/documentation/maps-static/get-api-key" rel="nofollow">
        Maps Static API
      </a>
    </td>
    
    <td>
      可选
    </td>
    
    <td>
      <code className="language-html shiki shiki-themes github-light github-light material-theme-palenight" language="html" style="">
        <span class="sx-uw">
          <
        </span>
        
        <span class="sFfpx">
          ScriptGoogleMapsStaticMap
        </span>
        
        <span class="sx-uw">
          >
        </span>
      </code>
      
       图像，包括放置在 <code>
        #placeholder
      </code>
      
       插槽中的图像
    </td>
  </tr>
  
  <tr>
    <td>
      <a href="https://developers.google.com/maps/documentation/javascript/legacy/places" rel="nofollow">
        Places API (Legacy)
      </a>
    </td>
    
    <td>
      可选
    </td>
    
    <td>
      通过 <code className="language-ts shiki shiki-themes github-light github-light material-theme-palenight" language="ts" style="">
        <span class="s0YkB">
          resolveQueryToLatLng
        </span>
        
        <span class="sqjlB">
          ()
        </span>
      </code>
      
       解析地址
    </td>
  </tr>
</tbody>
</table>

默认情况下，占位符插槽为空，因此普通的 `<ScriptGoogleMaps>` 不会调用 Maps Static API。

## 当前定价

Google 按 SKU 对每个 API 收费，并为每个 SKU 分别设置每月免费使用额度。截至 2026 年 7 月，相关的全球标价如下：

<table>
<thead>
  <tr>
    <th>
      操作
    </th>
    
    <th>
      SKU
    </th>
    
    <th align="right">
      每月免费事件数
    </th>
    
    <th align="right">
      每 1,000 次的首个付费层级
    </th>
    
    <th>
      计费时机
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      加载交互式地图
    </td>
    
    <td>
      Dynamic Maps
    </td>
    
    <td align="right">
      10,000
    </td>
    
    <td align="right">
      $7
    </td>
    
    <td>
      每次 Maps JavaScript API 创建地图时
    </td>
  </tr>
  
  <tr>
    <td>
      加载静态预览
    </td>
    
    <td>
      Static Maps
    </td>
    
    <td align="right">
      10,000
    </td>
    
    <td align="right">
      $2
    </td>
    
    <td>
      每次 <code className="language-html shiki shiki-themes github-light github-light material-theme-palenight" language="html" style="">
        <span class="sx-uw">
          <
        </span>
        
        <span class="sFfpx">
          ScriptGoogleMapsStaticMap
        </span>
        
        <span class="sx-uw">
          >
        </span>
      </code>
      
       图片请求时
    </td>
  </tr>
  
  <tr>
    <td>
      在浏览器中解析地址
    </td>
    
    <td>
      Find Place (legacy)
    </td>
    
    <td align="right">
      5,000
    </td>
    
    <td align="right">
      $17
    </td>
    
    <td>
      每次 <code className="language-ts shiki shiki-themes github-light github-light material-theme-palenight" language="ts" style="">
        <span class="s0YkB">
          resolveQueryToLatLng
        </span>
        
        <span class="sqjlB">
          ()
        </span>
      </code>
      
       查询时
    </td>
  </tr>
</tbody>
</table>

以上是第一个付费量级的美元标价。更高用量的层级、区域定价和产品变更可能会影响总费用；在制定预算前，请查看[当前 Google Maps Platform 价格表](https://developers.google.com/maps/billing-and-pricing/pricing)。

Google 还提供[固定价格订阅方案](https://developers.google.com/maps/billing-and-pricing/subscriptions)，在所包含的 SKU 之间共享每月调用额度。超出额度的调用将恢复按量付费，因此下面的估算使用标准标价。

Google 于 2025 年 3 月 1 日以按 SKU 计算的免费使用额度取代了原有的每月 200 美元循环抵扣额度。[Google 的定价概览](https://developers.google.com/maps/billing-and-pricing/overview)介绍了当前的计费模式。

## Nuxt Scripts 如何影响使用方式

**延迟加载：** Dynamic Maps 事件仅在配置的触发器触发后才会发生。使用默认的交互触发器时，从未与地图交互的访客不会加载 JavaScript API。

**不发起默认静态请求：** `<ScriptGoogleMaps>` 的占位符为空。仅当地图预览值得额外的 Static Maps 事件时，才添加 `<ScriptGoogleMapsStaticMap>`。

**地址解析：** `resolveQueryToLatLng()` 使用浏览器的 Places 库。坐标可以避免此查找过程。

**直接使用静态地图：** `<ScriptGoogleMapsStaticMap>` 使用公开的浏览器密钥直接从 Google 加载图像。请为其提供一个单独的密钥，将其限制为你的网站和 Maps Static API；或者允许共享注册表密钥访问 Maps JavaScript API、Places API (Legacy) 和 Maps Static API。

## 成本控制

1. **如果有坐标，请使用坐标。** 将 `center` 传入为 `{ lat, lng }`，而不是通过 Places 解析地址。
2. **保留默认的延迟触发方式。** 仅当地图应在 hydration 后开始加载，而不是等待元素交互时，才使用 `trigger="immediate"`。
3. **使用自定义占位内容。** `#placeholder` 插槽中的本地图片不会增加任何 Maps Static API 事件。```vue
<ScriptGoogleMaps>
  <template #placeholder>
    <img src="/my-map-placeholder.webp" alt="商店位置地图">
  </template>
</ScriptGoogleMaps>
```
4. **设置预算和配额限制。** Google 建议设置预算提醒以了解费用情况，并在需要严格限制用量时设置配额限制。请参阅[管理 Google Maps Platform 费用](https://developers.google.com/maps/billing-and-pricing/manage-costs)。
5. **如果需要更简单的地图，可以考虑 Embed API。** [Maps Embed API 可无限免费使用](https://developers.google.com/maps/documentation/embed/usage-and-billing)，但仍需要 API 密钥。请使用 iframe 嵌入；它不是通过 `useScript()` 加载的脚本。

## 每月估算示例

在 2026 年 7 月全球目录价格下，每月 100,000 次页面浏览量：

<table>
<thead>
  <tr>
    <th>
      场景
    </th>
    
    <th align="right">
      预计每月费用
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      无交互的延迟加载地图
    </td>
    
    <td align="right">
      $0
    </td>
  </tr>
  
  <tr>
    <td>
      20% 的访客加载交互式地图
    </td>
    
    <td align="right">
      $70
    </td>
  </tr>
  
  <tr>
    <td>
      每位访客都加载交互式地图
    </td>
    
    <td align="right">
      $630
    </td>
  </tr>
  
  <tr>
    <td>
      每次查看都显示静态预览，无交互
    </td>
    
    <td align="right">
      $180
    </td>
  </tr>
  
  <tr>
    <td>
      每次查看都显示静态预览，且 20% 的访客进行交互
    </td>
    
    <td align="right">
      $250
    </td>
  </tr>
</tbody>
</table>

这些示例已应用每个 SKU 的免费使用额度，但不包括 Places 请求、税费、协商折扣，以及同一结算账号下其他项目产生的费用。