Tài liệu này liệt kê những yêu cầu dành riêng cho mọi ứng dụng được phát triển bằng SDK Địa điểm dành cho iOS, bao gồm cả dịch vụ Tự động hoàn thành địa điểm trong API đó. Bạn có thể xem thêm thông tin chung dành cho nhà phát triển Google Maps trong Điều khoản dịch vụ của Nền tảng Google Maps.
Cung cấp điều khoản sử dụng và chính sách quyền riêng tư
Nếu phát triển ứng dụng SDK địa điểm dành cho iOS, bạn phải cung cấp Điều khoản sử dụng và Chính sách quyền riêng tư cho ứng dụng của mình theo các nguyên tắc đã nêu trong Thoả thuận của bạn với Google:
- Điều khoản sử dụng và Chính sách quyền riêng tư phải được công bố công khai.
- Bạn phải nêu rõ trong Điều khoản sử dụng của ứng dụng rằng khi sử dụng ứng dụng, người dùng phải tuân thủ Điều khoản dịch vụ của Google.
- Bạn phải thông báo cho người dùng trong Chính sách quyền riêng tư rằng bạn đang sử dụng (các) API Maps của Google và đưa vào bằng cách tham chiếu Chính sách quyền riêng tư của Google.
Bạn nên đăng Điều khoản sử dụng và Chính sách quyền riêng tư ở vị trí nào tuỳ thuộc vào nền tảng của ứng dụng.
Ứng dụng dành cho thiết bị di động
Nếu phát triển ứng dụng di động, bạn nên cung cấp đường liên kết đến Điều khoản sử dụng và Chính sách quyền riêng tư trên trang tải xuống của ứng dụng trong cửa hàng ứng dụng có liên quan và trong trình đơn cài đặt ứng dụng.
Ứng dụng web
Nếu phát triển ứng dụng web, bạn nên cung cấp đường liên kết đến Điều khoản sử dụng và Chính sách quyền riêng tư ở chân trang web.
Tìm nạp trước, lưu vào bộ nhớ đệm hoặc lưu trữ nội dung
Ứng dụng sử dụng SDK Địa điểm dành cho iOS phải tuân thủ các điều khoản trong Thoả thuận của bạn với Google. Theo các điều khoản của Thoả thuận, bạn không được tìm nạp trước, lập chỉ mục, lưu trữ hoặc lưu vào bộ nhớ đệm bất kỳ Nội dung nào, ngoại trừ trong các điều kiện hạn chế nêu trong điều khoản.
Xin lưu ý rằng mã địa điểm dùng để xác định duy nhất một địa điểm sẽ không phải tuân thủ các quy định hạn chế về việc lưu vào bộ nhớ đệm. Mã địa điểm được trả về trong trường place_id trong SDK Địa điểm dành cho phản hồi trên iOS. Tìm hiểu cách lưu, làm mới và quản lý mã địa điểm trong Hướng dẫn về mã địa điểm.
Hiển thị kết quả về SDK Địa điểm dành cho iOS
Bạn có thể hiển thị kết quả của SDK Địa điểm dành cho iOS trên Google Maps hoặc không có bản đồ. Nếu bạn muốn hiển thị kết quả của SDK Địa điểm dành cho iOS trên bản đồ, thì các kết quả này phải hiển thị trên Google Maps. Bạn không được phép sử dụng SDK Địa điểm cho dữ liệu iOS trên bản đồ không phải là bản đồ của Google.
Hiển thị biểu trưng và thông tin ghi công của Google
Nếu ứng dụng của bạn hiển thị dữ liệu trên Google Maps, thì biểu trưng Google sẽ xuất hiện và không được thay đổi. Các ứng dụng hiển thị dữ liệu của Google trên cùng màn hình với Google Maps không bắt buộc phải cung cấp thêm thông tin phân bổ cho Google.
Nếu ứng dụng của bạn hiển thị dữ liệu trên một trang hoặc thành phần hiển thị không đồng thời hiển thị Google Maps, thì bạn phải hiển thị biểu trưng Google cùng với dữ liệu đó. Ví dụ: nếu ứng dụng của bạn hiển thị dữ liệu của Google trên một thẻ và Google Maps có dữ liệu đó trên một thẻ khác, thì thẻ đầu tiên phải hiển thị biểu trưng của Google. Nếu ứng dụng của bạn sử dụng các trường tìm kiếm có hoặc không có tính năng tự động hoàn thành, thì biểu trưng phải xuất hiện cùng dòng.
Biểu trưng Google phải được đặt ở góc dưới cùng bên trái của bản đồ, còn thông tin ghi công phải được đặt ở góc dưới cùng bên phải. Cả hai đều phải được trình bày trên bản đồ dưới dạng một tổng thể chứ không được đặt bên dưới bản đồ hoặc một vị trí khác trong ứng dụng. Ví dụ về bản đồ sau đây cho thấy biểu trưng Google ở dưới cùng bên trái của bản đồ và thông tin ghi công ở dưới cùng bên phải.
| Để sử dụng trên nền sáng | Để dùng trên nền tối |
|---|---|
|
|
Tệp zip sau đây chứa biểu trưng Google ở kích thước chính xác cho các ứng dụng dành cho máy tính, Android và iOS. Bạn không được thay đổi kích thước hoặc sửa đổi các biểu trưng này theo bất kỳ cách nào.
Tải xuống: google_logo.zip
Đừng sửa đổi thuộc tính phân bổ. Không xoá, che khuất hoặc cắt bỏ thông tin phân bổ. Bạn không được sử dụng biểu trưng của Google cùng dòng (ví dụ: "Những bản đồ này là của [Google_logo]").
Giữ cho mô hình phân bổ gần nhau. Nếu sử dụng ảnh chụp màn hình của hình ảnh trên Google bên ngoài tính năng nhúng trực tiếp, hãy thêm thông tin ghi công tiêu chuẩn như trong hình ảnh. Nếu cần, bạn có thể tuỳ chỉnh kiểu và vị trí của văn bản ghi công, miễn là văn bản đó nằm gần nội dung và người xem hoặc người đọc thông thường có thể đọc được. Bạn không được di chuyển phần ghi công ra khỏi nội dung, chẳng hạn như ra cuối sách, phần ghi công của tệp hoặc chương trình hoặc chân trang của trang web.
Bao gồm nhà cung cấp dữ liệu bên thứ ba. Một số dữ liệu và hình ảnh trên các sản phẩm lập bản đồ của chúng tôi là của các nhà cung cấp khác ngoài Google. Nếu sử dụng hình ảnh như vậy, văn bản ghi công của bạn phải nêu tên "Google" và (các) nhà cung cấp dữ liệu có liên quan, chẳng hạn như "Dữ liệu bản đồ: Google, Maxar Technologies". Khi có nhà cung cấp dữ liệu bên thứ ba được trích dẫn cùng với hình ảnh, việc chỉ ghi "Google" hoặc biểu trưng Google là chưa đủ.
Nếu bạn đang sử dụng Nền tảng Google Maps trên một thiết bị không hỗ trợ hiển thị thông tin ghi nhận tác giả, vui lòng liên hệ với nhóm bán hàng của Google để thảo luận về các giấy phép phù hợp với trường hợp sử dụng của bạn.
Các yêu cầu khác về mô hình phân bổ
Nội dung ghi công cho nhà cung cấp bên thứ ba chứa nội dung và đường liên kết mà bạn phải hiển thị cho người dùng theo định dạng mà nhà cung cấp cung cấp. Google đề xuất ứng dụng của bạn hiển thị thông tin này bên dưới thông tin chi tiết về địa điểm.
Thuộc tính của bên thứ ba do API trả về không bao gồm thuộc tính của Google. Bạn phải tự thêm thông tin ghi công này, như mô tả trong phần Hiển thị biểu trưng và thông tin ghi công của Google.
Hãy làm theo hướng dẫn này để truy xuất thông tin phân bổ của bên thứ ba cho một địa điểm hoặc một tập hợp địa điểm.
Truy xuất thông tin phân bổ cho một địa điểm
Khi truy xuất một địa điểm bằng cách truy xuất địa điểm theo mã nhận dạng, bạn có thể truy xuất các thuộc tính của địa điểm đó từ tài sản attributions trên GMSPlace.
attributions được cung cấp dưới dạng một đối tượng NSAttributedString.
Truy xuất thông tin phân bổ cho một tập hợp địa điểm
Nếu ứng dụng của bạn hiển thị thông tin thu được bằng cách yêu cầu vị trí hiện tại của thiết bị, thì ứng dụng đó phải hiển thị thông tin ghi công của bên thứ ba cho thông tin chi tiết về vị trí được hiển thị. Bạn có thể truy xuất
các thuộc tính cho tất cả các vị trí được truy xuất trong yêu cầu, từ
thuộc tính attributions trên
GMSPlaceLikelihoodList.
attributions được cung cấp dưới dạng đối tượng NSAttributedString. Bạn có thể truy cập và hiển thị đối tượng này giống như attributions ở một nơi duy nhất, như mô tả ở trên.
Thuộc tính kết quả tìm kiếm
Tại Châu Âu, khi sử dụng thứ hạng không phân biệt đối xử của Google, các sản phẩm tìm kiếm phải có văn bản giải thích chỉ sau 1 lượt nhấp, trong đó mô tả các yếu tố chính và trọng số của các yếu tố chính quyết định thứ hạng của kết quả tìm kiếm. Văn bản giải thích:
Tiêu đề: Giới thiệu về những kết quả này
Nội dung: Khi bạn tìm kiếm doanh nghiệp hoặc địa điểm gần một vị trí, Google Maps sẽ hiển thị cho bạn kết quả tại địa phương. Một số yếu tố — chủ yếu là mức độ liên quan, khoảng cách và sự nổi bật — được kết hợp để giúp tìm ra kết quả tốt nhất cho nội dung bạn tìm kiếm.
Nút 1: Tìm hiểu thêm
Nội dung "Tìm hiểu thêm" phải liên kết đến một bài viết trong Trung tâm trợ giúp.
Nút 2: OK
Hiển thị thông tin ghi công cho một bức ảnh
Nếu ứng dụng của bạn hiển thị ảnh, thì bạn phải hiển thị mọi attributions và authorAttributions cho mỗi ảnh có các thuộc tính đó.
- Để truy cập vào bất kỳ thông tin phân bổ nào, hãy sử dụng
GMSPlacePhotoMetadata.attributions. Thuộc tính này làNSAttributedStringhoặcnilnếu không có thuộc tính nào để hiển thị. - Để xem thông tin ghi nhận sự đóng góp của tác giả, hãy sử dụng
GMSPlacePhotoMetadata.authorAttributions. Thuộc tính này chứa một mảng các đối tượngGMSPlaceAuthorAttribution.
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; } } }];
Hiển thị bài đánh giá
Một đối tượng GMSPlace có thể chứa tối đa 5 bài đánh giá, trong đó mỗi bài đánh giá được biểu thị bằng một đối tượng GMSPlaceReview. Bạn có thể hiển thị các bài đánh giá này trong ứng dụng của mình (không bắt buộc).
Khi hiển thị các bài đánh giá do người dùng Google đóng góp, bạn phải đặt tên tác giả ở gần. Khi có trong trường ghi công tác giả của đối tượng GMSPlaceReview, bạn nên thêm ảnh của tác giả và liên kết đến hồ sơ của họ. Hình ảnh sau đây là ví dụ về bài đánh giá một công viên:
Google cũng khuyên bạn nên cho người dùng cuối biết cách sắp xếp bài đánh giá.
Cách xem bài đánh giá:
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. } }];
Hiển thị mô hình phân bổ của bên thứ ba
Thông tin ghi công cho nhà cung cấp bên thứ ba được cung cấp dưới dạng đối tượng NSAttributedString chứa nội dung và đường liên kết mà bạn phải lưu giữ và hiển thị cho người dùng.
Bạn nên hiển thị thông tin ghi công bằng UITextView vì các đường liên kết trong thông tin ghi công phải hoạt động.
Để đảm bảo các đường liên kết hoạt động, hãy đặt một đối tượng uỷ quyền trên UITextView và đặt phương thức shouldInteractWithURL của UITextViewDelegate để trả về 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; }
Ví dụ về mô hình phân bổ của bên thứ ba
Thông tin ghi nhận sự đóng góp của bên thứ ba thường bao gồm văn bản kèm theo một đường liên kết. Ví dụ:
Trang thông tin theo Công ty mẫu
Trong ví dụ trên, dải văn bản Example Company (Công ty mẫu) được bao phủ bởi thuộc tính NSLink.
Nguyên tắc về kiểu cho mô hình phân bổ trên Google
Sau đây là nguyên tắc về kiểu cho phần ghi công Google trong CSS và HTML nếu bạn không thể sử dụng biểu trưng Google có thể tải xuống.
Không gian trống
Khoảng không gian trống xung quanh phần khoá phải bằng hoặc lớn hơn chiều cao của chữ "G" trong Google.
Khoảng cách giữa nội dung ghi công và biểu trưng Google phải bằng một nửa chiều rộng của chữ "G".
Mức độ dễ đọc
Dòng tên tác giả phải luôn rõ ràng, dễ đọc và xuất hiện với biến thể màu phù hợp cho một nền nhất định. Luôn đảm bảo cung cấp đủ độ tương phản cho biến thể biểu trưng mà bạn chọn.
Màu
Sử dụng văn bản Google Material Gray 700 trên nền trắng hoặc sáng, sử dụng độ phủ màu đen tối đa từ 0% đến 40%.
#5F6368 RGB 95 99 104 HSL 213 5 39 HSB 213 9 41
Trên nền tối hơn, cũng như trên ảnh chụp hoặc các mẫu không rối mắt, hãy sử dụng văn bản màu trắng cho dòng giới thiệu và thông tin ghi công.
#FFFFFF RGB 255 255 255 HSL 0 0 100 HSB 0 0 100
Phông chữ
Hãy sử dụng phông chữ Roboto.
Ví dụ về CSS
Khi áp dụng cho văn bản "Google", CSS sau đây sẽ hiển thị "Google" với phông chữ, màu sắc và khoảng cách thích hợp trên nền trắng hoặc sáng.
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;