這個主題列出的作者資訊相關規定,適用於所有使用 Places SDK for Android 開發的應用程式,包括該 API 涵蓋的 Place Autocomplete 服務。如要瞭解更多的 Google Maps Platform 條款,請參閱《Google Maps Platform 服務條款》。
政策
本節說明 Places SDK for Android 的相關政策。政策提供實用的導入指南和規定,協助您正確使用服務,並符合 Google Maps Platform 的期望。
資料儲存、快取和抓取
在應用程式中使用 Google 地圖內容時,請遵循《Google 地圖平台服務條款》第 3.2.3 節和《Google 地圖平台服務專屬條款》中的資料處理規定:
- 快取和抓取限制 (第 3.2.3(a) 和 (b) 節):只有在《Google Maps Platform 服務專屬條款》明確允許的情況下,才能快取或儲存 Google 地圖內容。請勿匯出、擷取或抓取 Google 地圖內容,用於「服務」以外的用途。舉例來說,請勿在「服務」以外預先擷取、建立索引、儲存或重新發布 Google 地圖內容;大量下載地圖圖塊、街景服務圖像、地理編碼、路線、距離矩陣結果、道路資訊、地點資訊、海拔高度值或時區詳細資料;或複製及儲存商家名稱、地址或使用者評論。
- 衍生內容限制 (第 3.2.3(c) 節):請依《Google 地圖平台服務條款》規定,在應用程式中使用 Google 地圖內容。請勿根據 Google 地圖內容建立內容。舉例來說,請勿追蹤或數位化衛星圖像中的地圖項目、建構 3D 或地形模型、使用 Places 經緯度值做為點在多邊形內分析的輸入內容、根據街景服務圖像建構位置索引,或將文字形式的行車時間轉換為合成語音。
如要降低延遲時間和已計費用,同時避免快取受限制資料,請使用欄位遮罩或欄位清單,只要求使用者介面所需的欄位。儲存地點 ID 等豁免 ID,以便在使用者與地點互動時擷取最新詳細資料。
Google 技術支援工程師無法提供法律諮詢,也無法針對《Google Maps Platform 服務條款》授予例外狀況。請諮詢法律顧問,確認您的導入方式是否符合條款規定。如果您的用途需要自訂授權,請與銷售人員聯絡。
快取限制的例外狀況
《Google Maps Platform 服務專屬條款》允許下列有限的快取例外狀況:
- 地點 ID:用於識別地點的地點 ID 不受快取限制的約束,因此您可以無限期儲存地點 ID 值。API 回應中的
id或place_id欄位會傳回地點 ID。如要瞭解如何儲存、重新整理及管理地點 ID,請參閱地點 ID 指南。 - 經緯度座標:使用《Google Maps Platform 服務特定條款》中允許此例外的服務時,您可以暫時快取緯度 (
latitude) 和經度 (longitude) 值,最長可連續快取 30 個日曆天,之後必須刪除快取的座標:- Routes API、Route Optimization API、Directions API (舊版) 和 Roads API
- Geocoding API、Geolocation API 和 Address Validation API
- Places API、Places UI Kit 和 Navigation SDK
- 服務專屬快取期限:《Google Maps Platform 服務專屬條款》也定義了 Address Validation API、Air Quality API、Pollen API、Solar API、Weather API 和 Places Aggregate API 的欄位專屬快取期限和許可用途。
歐洲經濟區國家/地區
如果客戶的帳單地址位於歐洲經濟區 (EEA),這項產品適用的服務條款和功能可能有所不同。使用 Google 地圖平台建構內容前,請詳閱下列歐洲經濟區專屬條款和資訊:
- Google Maps Platform 歐洲經濟區服務條款
- Google Maps Platform 歐洲經濟區服務專屬條款
- 歐洲經濟區常見問題
- Google Maps Platform 道路安全規定
如果您的帳單地址不在歐洲經濟區,則適用下列服務條款:
Google 地圖必須註明出處規定
本節說明透過應用程式顯示 Google 地圖和內容時,必須遵守的出處標示規定和規範。
歸因範例
以下是 Places UI Kit 的出處範例。
顯示 Google 地圖出處
在應用程式或網站中顯示 Google Maps Platform API 的內容時,必須遵守 Google 地圖作者資訊相關規定。如果內容顯示在已標明出處的 Google 地圖上,則不必額外註明出處。
包含 Google 地圖出處
如果 Google Maps Platform 已在使用者介面 (例如 Places UI Kit) 提供 Google 地圖出處資訊:
- 無論出處資訊顯示在何處,都請勿移除。請勿修改、隱藏或遮蓋出處,並確保出處在背景中清晰可見。
- 請一律使用邊框、背景顏色、陰影或足夠的空白等 UI 提示,在視覺上區分 Google 地圖平台內容與其他內容。
- 進行視覺修改時,您必須遵守所有 Google 地圖出處規定。
Google 地圖標誌和文字出處
作者資訊應盡可能採用 Google 地圖標誌的形式。如果空間有限,可以使用「Google 地圖」文字。 使用者必須能清楚分辨哪些內容是由 Google 地圖提供。
標誌出處
在應用程式或網站中使用 Google 地圖標誌時,請遵守下列規定。下載 Google 地圖標誌
使用官方 Google 地圖標誌檔案。請下載下方標誌,並按照本節的規範使用。
下載 Google 地圖出處素材資源使用 Google 地圖標誌時,請遵循下列規範。
- 請勿以任何方式修改標誌。
- 維持標誌的顯示比例,避免變形。
- 在雜亂的背景 (例如地圖或圖片) 上,使用有外框的標誌。
- 在純色或柔和漸層等素色背景上,使用無外框的標誌。
標誌大小規格
請遵循下列 Google 地圖標誌大小規格:- 標誌高度下限:16 dp
- 標誌高度上限:19dp
- 標誌最小留白區域:左、右和頂端 10dp,底部 5dp
如要瞭解 dp,請參閱 Material Design 網站上的像素密度。
標誌無障礙功能
請遵守下列 Google 地圖標誌無障礙規定:- 標誌和背景之間應維持無障礙對比度。
- 加入無障礙標籤,並附上「Google 地圖」文字。
文字出處
如果介面大小不支援使用 Google 地圖標誌,可以拼出「Google 地圖」文字。請按照下列指南進行:
- 請勿以任何方式修改「Google 地圖」文字:
- 請勿變更 Google 地圖的大小寫
- 請勿將「Google 地圖」拆成多行
- 請勿將 Google 地圖本地化為其他語言。
- 使用 HTML 屬性
translate="no",防止瀏覽器翻譯 Google 地圖。
請按照下表說明設定 Google 地圖文字樣式:
Google 地圖文字樣式規定 屬性 樣式 字型系列 Roboto。載入字型為選用步驟。 備用字型系列 產品中已使用的任何 Sans Serif 內文字型,或「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 Maps Platform 內容與其他內容。
- 請勿將非 Google 地圖平台內容歸功於 Google 地圖,以免造成誤解。
- 請確認出處資訊一律清晰可見。請勿移除、隱藏、遮蓋或修改。
下圖是這些視覺效果規定的範例。
第三方資料供應商
地圖產品中的部分資料和圖片來自 Google 以外的供應商。 對於某些產品 (例如 Map Tiles API),我們可能會提供第三方資料供應商的必要出處資訊。在這種情況下,出處資訊文字必須包含「Google 地圖」名稱和相關資料供應商,例如「地圖資料:Google、Maxar Technologies」。如果 Google 提供第三方出處資訊,僅加入「Google 地圖」或 Google 標誌並非適當的出處資訊。
其他出處資訊相關規定
請按照這些操作說明擷取第三方出處資訊,並在應用程式中顯示這類資訊。
。擷取地點的出處資訊
如果應用程式會顯示以呼叫依 ID 取得地點取得的資訊,則也須針對取得的 Place Details,顯示相關第三方出處資訊。
API 會傳回 Place 物件。如要從 Place 物件擷取出處資訊,請呼叫 Place.getAttributions()。這個方法會傳回 String 物件的 List,如果沒有可顯示的出處資訊,則傳回空值。
String placeId = "INSERT_PLACE_ID_HERE"; List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.DISPLAY_NAME); FetchPlaceRequest request = FetchPlaceRequest.newInstance(placeId, placeFields); placesClient.fetchPlace(request).addOnSuccessListener((response) -> { Place place = response.getPlace(); textView.append("Place found: " + place.getName()); List<String> attributions = place.getAttributions(); if (attributions != null) { StringBuilder stringBuilder = new StringBuilder("Attributions: "); for (String attribution : attributions) { stringBuilder.append(attribution).append("\n"); } textView.append(stringBuilder.toString()); }}).addOnFailureListener((exception) -> { if (exception instanceof ApiException) { // Handle the error. } } );
顯示相片出處資訊
如果應用程式會顯示地點相片,請務必標註每張相片的作者資訊。PhotoMetadata,可包含兩種出處資訊:
- Attributions:由
PhotoMetadata.getAttributions()存取的出處字串。 - AuthorAttributions:
AuthorAttributions物件,由PhotoMetadata.getAuthorAttributions()存取。
如要取得相片的字串作者資訊,請呼叫 PhotoMetadata.getAttributions()。這個方法會傳回 HTML 字元序列,如果沒有可顯示的出處資訊,則傳回空白字串。
// Get the photo metadata from the Place object. PhotoMetadata photoMetadata = place.getPhotoMetadatas().get(0); // Get the attribution text. String attributions = photoMetadata.getAttributions();
如要取得相片的作者資訊,請呼叫 PhotoMetadata.getAuthorAttributions()。這個方法會傳回 AuthorAttributions 物件。這個物件包含 AuthorAttribution 物件的 List,每個作者屬性各一個。
// Get the photo metadata from the Place object. PhotoMetadata photoMetadata = place.getPhotoMetadatas().get(0); // Get the author attributions object. AuthorAttributions authorAttributions = photoMetadata.getAuthorAttributions(); List<AuthorAttribution> authorAttributionList = authorAttributions.asList();
搜尋結果歸因
在歐洲,使用 Google 的未經修改排名時,搜尋產品必須提供說明文字,且使用者最多只需點按 1 次即可查看。說明文字應描述決定搜尋結果排名的主要因素,以及這些因素的權重。說明文字:
標題:關於這些結果
內文:搜尋某個位置附近的商家或地點時,Google 地圖會顯示本地搜尋結果。系統會結合多項因素 (主要包括關聯性、距離和名氣) 找出最符合的搜尋結果。
按鈕 1:瞭解詳情
「瞭解詳情」文字應連結至說明中心文章。
按鈕 2:確定
顯示評論
Place 物件最多可包含 5 則評論,每則評論皆以 Review 物件表示。您可以視需要在應用程式中顯示這些評論。
顯示 Google 使用者提供的評論時,必須在附近標示作者名稱。如果 Review 物件的作者屬性欄位有提供作者相片和個人資料連結,建議您一併加入。下圖是公園評論範例:

Google 也建議您向使用者顯示評論的排序方式。
如要存取評論,請呼叫 Place.getReviews():
// Specify the fields to return. final List<Place.Field> placeFields = Arrays.asList(Place.Field.REVIEWS); // Construct a request object, passing the place ID and fields array. final FetchPlaceRequest request = FetchPlaceRequest.newInstance("INSERT_PLACE_ID_HERE", placeFields); placesClient.fetchPlace(request).addOnSuccessListener((response) -> { Place place = response.getPlace(); List<Review> reviews = place.getReviews(); // For loop for iterating over the List for (int i = 0; i < reviews.size(); i++) { // For each review, get the Review object. Review placeReview = reviews.get(i); // Get any attribution and author attribution. String reviewAttribution = placeReview.getAttribution(); AuthorAttribution authorAttribution = placeReview.getAuthorAttribution(); // Display the review contents and attributions as necessary. } }).addOnFailureListener((exception) -> { if (exception instanceof ApiException) { // Handle the error. } });
顯示第三方出處資訊
第三方供應商的著作權聲明包含 HTML 格式的內容和連結,您必須保留這些內容和連結,並以提供的格式向使用者顯示。Google 建議在地點詳細資料下方顯示這項資訊。
API 會為應用程式使用的所有地點產生出處資訊。出處資訊是依 API 呼叫提供,而非依地點提供。
顯示出處資訊的方法之一是使用 TextView。例如:
TextView attributionsText = (TextView) findViewById(R.id.attributions); String thirdPartyAttributions = place.getAttributions(); attributionsText.setText(thirdPartyAttributions);
第三方出處註明範例
Listings by <a href="https://www.example.com/">Example Company</a>
自動完成使用者地址
如果使用者在「客戶應用程式」中使用「自動完成」功能預先輸入街道地址,且該街道地址在不使用「自動完成」的情況下,也能由使用者完整且準確地提供,則使用者選取的地址不受《Google Maps Platform 協議》中的 Google 地圖內容限制。這項例外狀況僅適用於使用者選取的街道地址,且僅限於該使用者的特定交易;不適用於自動完成功能提供的建議地址清單,或其他 Google 地圖內容。這項例外狀況不適用於其他 Google 地圖平台服務提供的任何搜尋搜尋點或地址功能。

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