Places SDK for iOS 政策

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

這份說明文件列出了使用 Places SDK for iOS 開發的所有應用程式專屬規定,包括屬於該 API 的 Place Autocomplete 服務。若想進一步瞭解 Google 地圖開發人員一般資訊,請參閱《Google 地圖平台服務條款》。

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

開發 Places SDK for iOS 應用程式時,您必須讓應用程式提供《使用條款》和《隱私權政策》的規範,並遵守您與 Google 所簽訂的協議規範:

  • 公開發布《使用條款》和《隱私權政策》。
  • 您必須在應用程式的使用條款中明確指出,在使用您的應用程式時,使用者必須遵守《Google 服務條款》。
  • 您必須在「隱私權政策」中通知使用者您正在使用 Google Maps API,並以 Google 隱私權政策的方式納入計畫。

建議依據《# 使用條款》和《隱私權政策》的方式來提供適用的應用程式,實際情況取決於應用程式的平台。

行動應用程式

開發行動應用程式時,建議您於相關應用程式商店和應用程式的選單選單中,提供使用條款隱私權政策的連結。

網頁應用程式

開發網頁應用程式時,建議您在網站頁尾提供《使用條款》和「隱私權政策」的連結。

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

使用 Places SDK for iOS 的應用程式會受到您與 Google 所同意的條款規範。依據「協議」的條款,您不得根據「條款」中所述的有限條件,預先擷取、建立索引、儲存或快取任何「內容」。

顯示 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 取得地點擷取地點時,您可以在 GMSPlaceattributions 屬性中擷取該地點的歸因。

系統會以 NSAttributedString 物件的形式提供 attributions

擷取一系列地點的歸因

如果您的應用程式會顯示要求裝置目前位置取得的資訊,則必須針對顯示的地點詳細資料顯示第三方歸因。您可以前往 GMSPlaceLikelihoodList 中的 attributions 屬性,擷取在要求中擷取的所有地點歸因資訊。

系統會以 NSAttributedString 物件的形式提供 attributions,並以相同方式存取與顯示 attributions,與如上方所述。

顯示相片的出處資訊

如果您的應用程式會顯示相片,您就必須針對包含該相片的每張相片顯示歸因。如要取得相片的歸因,請呼叫 GMSPlacePhotoMetadata.attributions。這個屬性是 NSAttributedString,或者在沒有可顯示的屬性時則為 nil

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;
                      }
                    }
                  }];
    

顯示第三方歸因

第三方提供者的歸因分析會以 NSAttributedString 物件的形式提供,其中包含您必須保留且向使用者顯示的內容和連結。

歸因屬性的建議方法是使用 UITextView,因為歸因中的連結必須正常運作。 如要確保連結正常運作,請在 UITextView 上設定委派,並將 UITextViewDelegateshouldInteractWithURL 方法設為傳回 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;
}
    

第三方歸因範例

第三方歸因通常包含帶有連結的文字。例如:

提供範例:範例公司

在上述範例中,範例公司文字範圍涵蓋了 NSLink 屬性。

請注意,用於識別地點的地點 ID 不受快取限制的約束,因此,您無限期可以儲存地點 ID 值。地點 ID 會在 Places SDK for iOS 回應的 place_id 欄位中傳回。

Google 歸因的樣式規範

如果您無法使用可下載的 Google 標誌,請參閱 CSS 和 HTML 中 Google 歸因的樣式規範。

周圍留空

鎖定圖文標誌的預留空間應等於或大於 Google 中「G」的高度。

歸因文案和 Google 標誌之間的空間應為「G」寬度的一半。

易讀

署名文字應清晰易讀,並會顯示在指定背景的正確色彩變化版本中。請務必為您選取的標誌變化版本提供足夠的對比度。

顏色

請在白色或淺色背景上使用 Google Material Gray 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」時,會轉譯為「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;