Places SDK for Android 的政策和出處資訊

這個主題列出的作者資訊相關規定，適用於所有使用 Places SDK for Android 開發的應用程式，包括該 API 涵蓋的 Place Autocomplete 服務。如要瞭解更多的 Google 地圖平台條款，請參閱《Google 地圖平台服務條款》。

政策

本節說明 Places SDK for Android 的相關政策。政策提供實用的導入指南和規定，協助您正確使用服務，並符合 Google Maps Platform 的期望。

快取限制的例外狀況

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

歐洲經濟區國家/地區

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

• 《Google Maps Platform 歐洲經濟區服務條款》
• Google Maps Platform 歐洲經濟區服務專屬條款
• 歐洲經濟區常見問題
• 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 地圖標誌時，請遵循下列規範。

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

標誌大小規格

• 標誌高度下限：16 dp
• 標誌高度上限：19dp
• 標誌最小留白區域：左、右和頂端 10dp，底部 5dp

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

標誌無障礙功能

• 標誌和背景之間應保持無障礙對比度。
• 加入無障礙標籤，並附上「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;
}

視覺效果規定

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

• 使用邊框、背景顏色、陰影或足夠的空白等 UI 提示，將 Google 地圖平台內容與其他內容區隔開來。

• 請勿將非 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 地圖內容限制，僅用於該使用者的適用交易。