Places SDK for iOS 政策

這份文件列出了所有應用程式適用的要求 使用 Places SDK for iOS 開發的產品,包括 Place Autocomplete 屬於該 API 的一部分Google 地圖的其他一般資訊 請前往 Google 地圖平台服務條款

提供使用條款和隱私權政策

如果您開發的是 Places SDK for iOS 應用程式,務必提供 條款 使用方式隱私權 政策規範 且符合與 Google 簽訂的「協議」所列的規範:

  • 使用條款和隱私權政策須設為公開。
  • 在應用程式的使用條款中,務必明確陳述使用應用程式時,使用者將受到 Google《服務條款》的約束。
  • 在隱私權政策中,務必告知使用者您目前使用 Google Maps API,並參照援引《Google 隱私權政策》。

適合顯示使用條款和隱私權政策的位置,取決於應用程式的平台。

行動應用程式

如果是開發行動應用程式,建議您提供 應用程式適用的使用條款隱私權政策 以及應用程式設定中的下載頁面 或前往 Google 試算表選單

網頁應用程式

如果開發的是網頁應用程式,建議您在網站頁尾提供使用條款和隱私權政策的連結。

預先擷取、快取或儲存內容

使用 Places SDK for iOS 的應用程式必須遵守 與 Google 簽訂的協議根據協議條款,除了已載述的少數情況,對於任何內容,一律不得預先擷取、建立索引、儲存或快取。

請注意,用於識別地點的地點 ID 不受快取限制的約束,地點 ID 會在 Places SDK for iOS 回應。若要瞭解如何儲存、重新整理及管理地點 ID,請參閱地點 ID 指南

顯示 Places SDK for iOS 結果

您可以在 Google 地圖上顯示 Places SDK for iOS 結果,或是在沒有地圖的情況下顯示。如果您想 在地圖上顯示 Places SDK for iOS 結果,然後這些結果必須顯示在 Google 地圖上。 禁止在非 Google 地圖上使用 Places SDK for iOS 資料。

如果應用程式在 Google 地圖上顯示資料,則 Google 圖片加上不可變更,且不可修改。如果應用程式顯示 Google 資料時,與 Google 地圖在同一畫面,就不必進一步註明出處為 Google 的資訊。

如果應用程式顯示資料時,網頁或畫面上未一併顯示 Google 地圖,這些資料就須標註 Google 標誌。舉例來說,假使應用程式在一個分頁上顯示 Google 資料,在另一個分頁顯示含有這些資料的 Google 地圖,那麼第一個分頁就須顯示 Google 標誌。假如應用程式提供搜尋欄位 (不論是否使用自動完成功能),則欄位內都需要顯示這個標誌。

Google 標誌應置於地圖左下角,出處資訊則應放在右下角,兩者都要完整呈現在地圖上,不可出現在地圖下方或應用程式內的其他位置。在下列範例地圖中,Google 標誌位於地圖左下角,出處資訊則位於右下角。

政策出處資訊位置

以下 ZIP 檔案內含 Google 標誌,大小適用於電腦版、Android 版和 iOS 版應用程式。請勿調整或修改標誌大小。

下載檔案:google_logo.zip

請勿修改出處,請勿移除、遮蓋或裁剪作者資訊 可能不準確或不適當您不得在畫面中內嵌 Google 標誌 (例如「這些地圖 從 [Google_logo] 即可。

確保出處資訊靠近內容。如果不是用直接嵌入的方式加入 Google 圖像螢幕截圖,則標註的標準出處資訊應與該圖片顯示的相同。必要時,您可以自訂出處資訊文字的樣式和位置,只要把握基本原則,確保文字靠近內容,且能讓一般觀眾/讀者清楚易懂即可。請不要將出處資訊移到內容區域以外的位置,例如放到書尾、檔案或節目的製作/演出人員名單,或是網站頁尾。

加入第三方資料供應商。我們準備的地圖中含有 產品是由 Google 以外的供應商提供如果使用這類圖像, 出處必須註明「Google」以及相關資料供應商,例如 「地圖資料:Google,Maxar Technologies。」引用第三方資料供應商時 僅包含「Google」的圖像或 Google 標誌的標示不正確。

如果您在沒有註明出處顯示的裝置上使用 Google 地圖平台 實際可行,請 與 Google 銷售團隊聯絡,討論適合您用途的授權。

其他出處資訊相關規定

註明第三方供應商的內容和連結是由第三方提供 必須根據所提供的格式向使用者顯示。Google 敬上 建議您的應用程式在地點詳細資料下方顯示這項資訊。

如果第三方來源資料是由 API 不含 Google 歸因。您必須 請自行加入出處,方法如: 顯示 Google 標誌與作者資訊

請按照下列操作說明擷取單一網址的第三方歸因 或某個地點的集合。

擷取單一地點的屬性

當您取得地點時,取得 地點 (依 ID),你 就可以從 已開啟 attributions 個房源 GMSPlace

attributions 會以 NSAttributedString 物件。

擷取一組地點的屬性

如果應用程式顯示經由要求裝置的 目前位置,應用程式必須顯示 顯示的地點詳細資料的第三方作者。您可以擷取 從 已啟用 attributions 個房源 GMSPlaceLikelihoodList

attributions 是以 NSAttributedString 物件,您可以在這個物件中存取及顯示該物件 與單一地點上的 attributions 相同,如上所述 上述

顯示相片出處資訊

如果您的應用程式顯示 相片,務必 顯示每個 attributionsauthorAttributions 附加在有問題的照片上

Swift

GMSPlacesClient.sharedClient().lookUpPhotosForPlaceID(placeID) { (photos, error) -> Void in
  if let error = error {
    // TODO: handle the error.
    print("Error: \(error.description)")
  } else {
    // Get attribution for the first photo in the list.
    if let photo = photos?.results.first {
      let attributions = photo.attributions
    }
  }
}
    

Objective-C

[[GMSPlacesClient sharedClient]
    lookUpPhotosForPlaceID:placeID
      callback:^(GMSPlacePhotoMetadataList *_Nullable photos,
                  NSError *_Nullable error) {
        if (error) {
          // TODO: handle the error.
          NSLog(@"Error: %@", [error description]);
        } else {
          // Get attribution for the first photo in the list.
          if (photos.results.count > 0) {
            GMSPlacePhotoMetadata *photo = photos.results.firstObject;
            NSAttributedString *attributions = photo.attributions;
          }
        }
      }];
    

顯示評論

GMSPlace 物件最多可包含五則評論,其中每個評論 評論以 GMSPlaceReview 物件表示你可以 可選擇在您的應用程式中顯示這些評論

顯示 Google 使用者所提供的評論時,請務必將 附近的作者姓名適用於作者作者欄位 (如有) GMSPlaceReview 物件中,我們建議您加入作者的 相片和個人資料連結下圖範例 以下提供部分公園的評論:

顯示作者出處資訊

Google 還建議您顯示評論的排序方式 而非個別使用者的帳戶

如要查看評論,請按照下列步驟操作:

Swift

// Define a Place ID.
let placeID = "ChIJV4k8_9UodTERU5KXbkYpSYs"

// Specify the place data types to return.
let myProperties: [GMSPlaceProperty] = [.name, .website, .reviews]

// Create the GMSFetchPlaceRequest object.
let fetchPlaceRequest = GMSFetchPlaceRequest(placeID: placeID, placeProperties: myProperties)

client.fetchPlaceWithRequest(fetchPlaceRequest: fetchPlaceRequest, callback: {
  (place: GMSPlace?, error: Error?) in
  if let error = error {
    print("An error occurred: \(error.localizedDescription)")
    return
  }
  if let place = place {
    let firstReview: GMSPlaceReview = place.reviews![0]

    // Use firstReview to access review text, authorAttribution, and other fields.

  }
})

Objective-C

// Define a Place ID.
NSString *placeID = @"ChIJV4k8_9UodTERU5KXbkYpSYs";

// Specify the place data types to return, including reviews.
NSArray<GMSPlaceProperty *> *myProperties = @[GMSPlacePropertyName, GMSPlacePropertyWebsite,GMSPlacePropertyReviews];

GMSFetchPlaceRequest *fetchPlaceRequest = [[GMSFetchPlaceRequest alloc] initWithPlaceID:placeID placeProperties: myProperties];

[placesClient fetchPlaceWithRequest: fetchPlaceRequest, callback: ^(GMSPlace *_Nullable place, NSError *_Nullable error) {
  if (error) {
    // TODO: handle the error.
    NSLog(@"Error: %@", [error description]);
  } else {
    // Get first review.
    GMSPlaceReview *firstReview = [place reviews][0];

    // Use firstReview to access review text, authorAttribution, and other fields.

  }
}];

顯示第三方歸因

系統會以 NSAttributedString 物件的形式提供第三方供應商的作者資訊 包含您必須保留並向使用者顯示的內容和連結。

建議使用 UITextView 來顯示作者資訊,因為歸因中的連結必須正常運作。 為確保連結正常運作,請在 UITextView 上設定委派並設定 shouldInteractWithURL UITextViewDelegate 方法傳回 YES

Swift

...
  self.attributionTextView.delegate = self
...

// MARK: - UITextViewDelegate

func textView(textView: UITextView, shouldInteractWithURL URL: NSURL,
  inRange characterRange: NSRange) -> Bool {
  // Make links clickable.
  return true
}
    

Objective-C

...
  self.attributionTextView.delegate = self;
...

#pragma mark - UITextViewDelegate

- (BOOL)textView:(UITextView *)textView
    shouldInteractWithURL:(NSURL *)url
                  inRange:(NSRange)characterRange {
  // Make links clickable.
  return YES;
}
    

第三方歸因範例

第三方作者資訊通常為帶有連結的文字。例如:

商家資訊來源:Example Company

在上例中,「Example Company」文字範圍涵蓋在 NSLink 屬性。

Google 出處資訊樣式守則

如果您無法使用可下載的 Google 標誌,請遵循下列樣式守則,以 CSS 和 HTML 加入 Google 出處資訊。

淨空空間

鎖定圖文標誌周圍的淨空空間大小,應等同或超過 Google 中「G」的高度。

出處資訊與 Google 標誌的間隔應為「G」寬度的一半。

易讀性

署名必須清晰、易讀,並以適當的顏色變化形式呈現 特定背景。採用的標誌版本配色上須有足夠的對比。

顏色

如果是白色或淺色背景,文字顏色使用 Google 礦石灰 700,黑色色調最高介於 0% 到 40%。

Google
#5F6368
RGB 95 99 104
HSL 213 5 39
HSB 213 9 41

如果是深色背景,且為攝影相片或素面花樣,請使用白色文字標註署名和出處資訊。

Google
#FFFFFF
RGB 255 255 255
HSL 0 0 100
HSB 0 0 100

字型

請使用 Roboto 字型。

CSS 範例

將下列 CSS 套用至「Google」,該字就會以適當的字型、顏色和間隔,顯示於白色或淺色背景上。

font-family: Roboto;
font-style: normal;
font-weight: 500;
font-size: 16px;
line-height: 16px;
padding: 16px;
letter-spacing: 0.0575em; /* 0.69px */
color: #5F6368;