Places API 政策

本文件列出的規定適用於所有使用 Places API (新版) 開發的應用程式，包括該 API 涵蓋的 Autocomplete (新版) 服務。如要瞭解 Google 地圖開發人員的一般資訊，請參閱《Google 地圖平台服務條款》。

政策

本節說明與 Places API 相關的政策。政策提供實用的導入指南和規定，協助您正確使用本服務，並符合 Google 地圖平台的期望。

快取限制的例外狀況

請注意，用於識別地點的地點 ID 不受快取限制的約束。 因此您可以無限期儲存地點 ID 值。 API 回應中的 place_id 欄位會傳回地點 ID。如要瞭解如何儲存、重新整理及管理地點 ID，請參閱地點 ID 指南。

歐洲經濟區國家/地區

如果客戶的帳單地址位於歐洲經濟區 (EEA)，則適用不同的服務條款，且產品功能可能有所不同。使用 Google 地圖平台建構服務前，請先詳閱下列歐洲經濟區專屬條款和資訊：

如果您的帳單地址不在歐洲經濟區，則適用下列服務條款：

Google 地圖出處資訊規定

本節提供透過應用程式顯示 Google 地圖和內容的著作權聲明規定和指南。

顯示 Google 地圖出處資訊

在應用程式或網站中顯示 Google 地圖平台 API 的內容時，必須遵守 Google 地圖出處資訊規定。如果內容顯示在 Google 地圖上，且已顯示出處資訊，則無須額外註明出處。

包含 Google 地圖出處資訊

對於 Google 地圖平台已在使用者介面中提供的 Google 地圖出處資訊，例如 Places UI Kit：

  • 無論顯示位置為何，請勿移除內含的出處資訊。請勿變更、隱藏或遮蓋出處資訊，並確保出處資訊在背景上清楚可見。
  • 請務必使用邊框、背景顏色、陰影或足夠的空白空間等 UI 提示，在視覺上區分 Google 地圖平台內容和其他內容。
  • 進行視覺修改時，您必須遵守所有 Google 地圖出處資訊規定。

盡可能以 Google 地圖標誌的形式提供出處資訊。 如果空間有限，可使用「Google 地圖」。 必須讓使用者清楚哪些內容是由 Google 地圖提供。

左：Google 地圖標誌出處資訊，右：Google 地圖文字出處資訊
左側：Google 地圖標誌出處資訊，右側：Google 地圖文字出處資訊

標誌出處

在應用程式或網站中使用 Google 地圖標誌時，請遵守下列規定。
Google 地圖標誌出處資訊的適用變化版本
Google 地圖標誌出處資訊的適用變體

下載 Google 地圖標誌

使用官方 Google 地圖標誌檔案。請下載下方的標誌，並按照本節的規範使用。

下載 Google 地圖出處資訊資產

使用 Google 地圖標誌時，請遵守下列規範。

  • 請勿以任何方式修改標誌。
  • 請維持標誌的顯示比例，避免變形。
  • 在雜亂的背景 (例如地圖或圖片) 上使用輪廓標誌。
  • 在純色或細微漸層等簡單背景上使用非輪廓標誌。

標誌大小規格

Google 地圖標誌的尺寸規格如下：
  • 標誌高度下限：16 dp
  • 標誌高度上限：19 dp
  • 標誌周圍至少應留空：左、右和頂端 10dp，底部 5dp

如要瞭解 dp，請參閱「Material Design」網站上的「像素密度」。

Google 地圖標誌，顯示最小留空空間和可接受的大小範圍
Google 地圖標誌，顯示最小淨空區域和可接受的大小範圍

標誌可存取性

請遵守下列 Google 地圖標誌的無障礙規定：
  • 確保標誌和背景之間有可存取的對比度。
  • 加入無障礙標籤，並附上「Google 地圖」文字。
Google 地圖標誌出處資訊的變體和無障礙問題
Google 地圖標誌出處資訊的不可接受變體和無障礙問題

文字出處

如果介面大小不支援使用 Google 地圖標誌，可以改用文字拼出 Google 地圖。請按照下列指南進行：

Google 地圖文字出處資訊的可用變體
Google 地圖文字出處資訊的適用變體
  • 請勿以任何方式修改「Google 地圖」文字：
    • 請勿變更「Google 地圖」的大小寫。
    • 請勿將「Google 地圖」換行
    • 請勿將「Google 地圖」翻譯成其他語言。
    • 使用 HTML 屬性 translate="no"，防止瀏覽器翻譯 Google 地圖。
Google 地圖文字出處資訊的變化形式違反規定
不接受的 Google 地圖文字出處資訊變體

  • 按照下表說明，設定 Google 地圖文字樣式：

    Google 地圖文字樣式規定
    屬性 樣式
    字型系列 Roboto。載入字型為選用項目。
    備用字型系列 產品中已使用的任何無襯線內文字型，或「Sans-Serif」來叫用預設系統字型
    字型樣式 一般
    字型粗細 400
    字型顏色 白色、黑色 (#1F1F1F) 或灰色 (#5E5E5E)。與背景維持無障礙(4.5:1) 對比度。
    字型大小 字型大小下限：12sp
    字型大小上限：16sp
    如要瞭解 sp，請參閱 Material Design 網站上的「字型大小單位」。
    字母間距 一般

CSS 範例

下列 CSS 會在白色或淺色背景上，以適當的排版樣式和顏色顯示 Google 地圖。

@import url('https://fonts.googleapis.com/css2?family=Roboto&display=swap');

.GMP-attribution {
font-family: Roboto, Sans-Serif;
font-style: normal;
font-weight: 400;
font-size: 1rem;
letter-spacing: normal;
white-space: nowrap;
color: #5e5e5e;
}

視覺元素規定

請遵守下列 Google 地圖出處資訊的視覺處理規定。

  • 將出處資訊放在內容頂端或底部附近，並位於同一個視覺容器中。如果是單行內容，出處資訊可以放在右側或左側。

  • 使用邊框、背景顏色、陰影或足夠的空白空間等 UI 提示，從視覺上區分 Google 地圖平台內容和其他內容。

  • 請勿將 Google 地圖與非 Google 地圖平台內容混用，以免誤導使用者。
  • 確認出處資訊一律清晰可見。請勿移除、隱藏、遮蓋或修改。

下圖顯示這些視覺需求範例。

Google 地圖出處資訊位於內容頂端、底部和側邊的範例
Google 地圖出處資訊的範例，分別位於內容頂端、底部和側邊

以下是三種方法，可將 Google 地圖內容 (地點評分) 與其他內容區分開來
三種區分 Google 地圖內容 (地點評分) 與其他內容的方法範例

請勿遮蓋 Google 地圖出處資訊，或將其與其他來源的內容混用
請勿遮蓋 Google 地圖出處資訊，也不要與其他來源的內容混用

第三方資料供應商

Google 地圖產品上的部分資料和圖片來自 Google 以外的供應商。 對於部分產品 (例如 Map Tiles API)，我們可能會向您提供第三方資料供應商的必要出處資訊。如果我們這麼做，作者資訊的文字必須包含「Google 地圖」名稱和相關資料供應商，例如「地圖資料：Google、Maxar Technologies」。如果 Google 提供第三方出處資訊，只加入「Google 地圖」或 Google 標誌並非適當的出處資訊。

其他出處資訊相關規定

以下是 Places API 的專屬出處資訊規定。

自動完成使用者地址

如果使用者在客戶應用程式中使用自動完成功能預先輸入街道地址，且該街道地址是使用者在沒有自動完成功能輔助的情況下，完整且準確地提供，則使用者選取的地址不受《Google 地圖平台協議》中的 Google 地圖內容限制規範。這項例外情況僅適用於使用者選取的街道地址，且僅限於該使用者的特定交易；不適用於自動完成功能提供的建議地址清單，也不適用於其他 Google 地圖內容。這項例外情況不適用於其他 Google 地圖平台服務提供的任何地標或地址查詢功能。

自動完成使用者地址

在上圖中，左側的地址清單仍受 Google 地圖內容限制。使用者選取地址後，該地址就不會受到 Google 地圖內容限制，但僅限於該使用者適用的交易。

第三方出處資訊

請按照這些操作說明擷取第三方出處資訊，並在應用程式中顯示這類資訊。

擷取地點的出處資訊

如果應用程式會顯示以呼叫 Place Details 取得的地點 ID 資訊，則也須針對取得的地點詳細資料，顯示相關第三方出處資訊。

回應的 Place 物件中的出處資訊會以 Attribution 物件表示。如要在回應中新增 Attribution，請在要求的欄位遮罩中加入 places.attributions (Nearby Search 和 Text Search) 或 attributions (Place Details)。

Attribution 物件的欄位是包含出處資訊 provider 和 providerUri 的字串，或是空白字串 (如果沒有任何可顯示的出處資訊)。

顯示相片出處資訊

如果應用程式會顯示相片，請務必標註每張相片擁有者的作者資訊。

如果回應內含 Place 物件，相片的詳細資料會包含在 photos 陣列中。如要在回應中新增 photos 陣列，請在要求的欄位遮罩中加入 places.photos (Nearby Search 和 Text Search) 或 photos (Place Details)。

photos 陣列的每個元素都是 Photo 的執行個體，內含 authorAttributions 陣列，類型為 AuthorAttribution。

AuthorAttribution 物件的欄位是包含出處資訊 displayName、uri 和 photoUri 的字串，或是空白字串 (如果沒有任何可顯示的出處資訊)。

顯示評論

回應中的 Place 物件最多可包含 5 則評論。您可以視需要在應用程式中顯示這些評論。

顯示 Google 使用者提供的評論時，必須在附近顯示作者姓名。如果 Review 物件的作者出處欄位提供這項資訊，建議您一併加入作者相片和個人資料連結。下圖為公園的評論範例：

顯示作者出處資訊

Google 也建議您向使用者顯示評論的排序方式。

回應的 Place 物件中的每則評論，都會以 Review 物件表示。如要在回應中新增 Review 物件，請在要求的欄位遮罩中加入 places.reviews (Nearby Search 和 Text Search) 或 reviews (Place Details)。

Review 物件的欄位包含出處資訊，如果沒有可顯示的出處資訊，則為空白。

搜尋結果歸因

在歐洲，使用 Google 的未經調整排名時，搜尋產品必須提供說明文字，且說明文字與搜尋結果的距離不得超過 1 次點擊，內容應描述決定搜尋結果排名的主要因素和這些因素的權重。說明文字：

標題：關於這些結果

內文：搜尋某個位置附近的商家或地點時，Google 地圖會顯示本地搜尋結果。系統會結合多項因素 (主要包括關聯性、距離和名氣)，找出最符合的搜尋結果。

按鈕 1：瞭解詳情
「瞭解詳情」文字應連結至說明中心文章。

按鈕 2：確定

AI 輔助摘要

在應用程式中顯示 AI 生成摘要 (包括地點、區域和評論摘要) 時，請務必遵守下列規定：

  • 顯示下列必要出處資訊、檢舉連結和參考連結。
  • 使用者必須能夠閱讀 Google 地圖提供的完整摘要文字。

顯示 AI 輔助摘要的揭露文字

顯示任何類型的 AI 輔助摘要時，請務必在摘要下方立即加入本地化揭露文字 (位於回應主體的 disclosureText 欄位中)。請勿修改或擴增 API 提供的揭露文字。

所有 AI 生成摘要類型的揭露聲明
圖 1：三種 AI 輔助摘要類型下方皆正確顯示揭露事項文字。

地點和區域摘要的其他規定

應用程式中顯示的地點和區域摘要必須附上下列文字和必要連結：

文字 規定
關於此摘要 請參閱「Google 收集及使用在地商家資訊的方式」一文：https://support.google.com/local-listings/answer/9851099。
報表摘要

使用回應的 flagContentUri 欄位中包含的連結，向 Google 回報摘要內容的問題。

注意：無論在哪個區域，凡是透過 Places API (新版) 提供的 AI 摘要，都將受到 Google 內容和產品政策的規範。您必須通知使用者，如要檢舉根據適用法律應從 Google 服務中移除的內容，請使用提供的檢舉內容網址 (flagContentUri)。
地點和區域摘要的揭露事項
圖 2：AI 輔助區域摘要，以及透過溢位選單提供給使用者的相關連結。

查看摘要規定

應用程式中顯示的評論摘要必須附上「評論摘要」的標題。此外，您必須使用下列文字和必要連結：

文字 規定
關於此摘要 如要瞭解「Google 收集及使用在地商家資訊的方式」，請參閱以下連結：https://support.google.com/local-listings/answer/9851099
報表摘要

使用回覆的 flagContentUri 欄位中包含的連結。

注意：無論在哪個區域，凡是透過 Places API (新版) 提供的 AI 摘要，都將受到 Google 內容和產品政策的規範。您必須通知使用者，如要檢舉根據適用法律應從 Google 服務中移除的內容，請使用提供的檢舉內容網址 (flagContentUri)。
查看評論 使用回覆的 googleMapsLinks.reviewsUri 欄位中包含的連結。
評論摘要的揭露事項
圖 3：AI 輔助評論摘要，以及透過溢位選單提供給使用者的相關連結。

顯示車輛用途的指引

為確保駕駛人安全，Google 建議在車輛專用 Android 平台中，於停車模式下顯示 AI 生成摘要。如果在駕駛模式下顯示摘要，畫面上的資訊應簡單明瞭，確保駕駛人能迅速將注意力轉回道路：

  • 最多 3 行
  • 最多 120 個半形字元或 24 個字
  • 正面尺寸下限為 24 dp

特別是在車輛環境中，開發人員有責任以安全的方式呈現 AI 輔助摘要，並遵守所有當地法律和法規。