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 tính năng Tự động hoàn thành địa điểm thuộc API đó. Thông tin chung khác cho Google Maps nhà phát triển có thể được tìm thấy 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 bạn phát triển SDK Địa điểm dành cho ứng dụng iOS, bạn phải cung cấp Điều khoản Sử dụng và Quyền riêng tư Chính sách liên quan đến đơn đăng ký của bạn đáp ứng các nguyên tắc đượ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 khai sẵn có.
- Bạn phải nêu rõ trong Điều khoản sử dụng của ứng dụng của mình rằng khi sử dụng ứng dụng, người dùng bị ràng buộc bởi Điều khoản của Google Dịch vụ.
- 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 API của Google Maps và kết hợp bằng cách tham khảo Chính sách quyền riêng tư của Google.
Nơi được đề xuất cung cấp Điều khoản sử dụng và Chính sách quyền riêng tư phụ thuộc vào nền tảng của ứng dụng của bạn.
Ứng dụng dành cho thiết bị di động
Nếu đang phát triển một ứ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ư đối với ứng dụng của bạn trang tải xuống trong cửa hàng ứng dụng liên quan và trong phần cài đặt ứng dụng .
Ứng dụng web
Nếu đang phát triển một ứ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 của bạn.
Tìm nạp trước, lưu vào bộ nhớ đệm hoặc lưu trữ nội dung
Các ứ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 của Thoả thuận với Google. Theo các điều khoản trong Thoả thuận của bạ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ừ điều kiện được nêu trong điều khoản.
Lưu ý rằng mã địa điểm, được dùng để xác định duy nhất một địa điểm, được miễn các 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 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ị SDK địa điểm dành cho kết quả iOS trên Google Maps hoặc không có bản đồ. Nếu bạn muốn hiển thị SDK Địa điểm dành cho kết quả iOS trên bản đồ, thì những kết quả này phải được hiển thị trên Google Map. 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à thuộc tính của Google
Nếu ứng dụng của bạn hiển thị dữ liệu trên Google Map, thì liên kết biểu trưng sẽ được bao gồm và không được thay đổi. Các ứng dụng hiển thị dữ liệu trên Google trên cùng một màn hình như Google Maps không cần thiết để cung cấp thêm thuộc tính cho Google.
Nếu ứng dụng của bạn hiển thị dữ liệu trên một trang hoặc chế độ xem không còn hiển thị Bản đồ Google, bạn phải hiển thị biểu trưng của 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 Google trên một tab và Google Maps với dữ liệu đó trên một thẻ khác, thẻ đầu tiên phải hiển thị biểu trưng 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, biểu trưng phải được hiển thị cùng dòng.
Biểu trưng Google nên được đặt ở góc dưới cùng bên trái của bản đồ kèm theo thuộc tính thông tin được đặt ở góc dưới cùng bên phải, cả hai thông tin này phải hiển thị trên bản đồ được hiển thị dưới dạng tổng thể và không nằm dưới bản đồ hoặc một vị trí khác trong ứng dụng. Chiến lược phát hành đĩa đơn ví dụ về bản đồ sau đây hiển thị biểu trưng Google ở phía dưới bên trái của bản đồ và thuộc tính ở phía dưới bên phải.
| Để dùng trên nền sáng | Để dùng trên nền tối |
|---|---|
|
|
Tệp zip sau chứa biểu trưng Google có kích thước chính xác cho máy tính để bàn, Android và iOS. Bạn không thể đổi kích thước hoặc sửa đổi các hình ảnh này biểu trưng theo bất kỳ cách nào.
Tải xuống: google_logo.zip
Đừng sửa đổi thông tin ghi nhận sự đóng góp. Không xóa, che khuất hoặc cắt bỏ thuộc tính của bạn. Bạn không thể sử dụng biểu trưng của Google cùng dòng (ví dụ: "Những bản đồ này từ [Google_logo]").
Liên tục phân bổ giá trị đóng góp. Nếu sử dụng ảnh chụp màn hình hình ảnh của Google bên ngoài nhúng trực tiếp, bao gồm thuộc tính chuẩn như xuất hiện 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 thuộc tính, miễn là văn bản trong phạm vi gần nội dung và dễ đọc với người xem hoặc độc giả thông thường. Bạn không được di chuyển thông tin ghi nhận tác giả ra khỏi nội dung, chẳng hạn như đến cuối cuốn sách, các thông tin ghi công của tệp hoặc chương trình hay phần chân trang của trang web.
Bao gồm cả nhà cung cấp dữ liệu bên thứ ba. Một số dữ liệu và hình ảnh trên bản đồ của chúng tôi các sản phẩm này đến từ các nhà cung cấp không phải Google. Nếu sử dụng hình ảnh như vậy, văn bản thuộc tính phải thể hiện 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." Trường hợp nhà cung cấp dữ liệu của bên thứ ba được trích dẫn với hình ảnh, chỉ bao gồm "Google" hoặc biểu trưng của Google không có thuộc tính thích hợp.
Nếu bạn đang sử dụng Nền tảng Google Maps trên một thiết bị không có màn hình ghi nhận tác giả thiết thực, hãy hãy 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ổ
Thông tin ghi nhận đóng góp 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 ở định dạng mà thông tin được cung cấp. Điều khoản đề 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.
Các phân bổ của bên thứ ba được trả về bởi API này không bao gồm mô hình phân bổ của Google. Bạn phải tự thêm thông tin ghi công này, như được mô tả trong Hiển thị biểu trưng và thuộc tính của Google.
Hãy làm theo các hướng dẫn này để truy xuất thông tin phân bổ của bên thứ ba cho một trang web hoặc một tập hợp các địa điểm.
Truy xuất thông tin ghi nhận sự đóng góp cho một địa điểm
Khi bạn truy xuất một địa điểm bằng cách nhận một
địa điểm theo mã, bạn
có thể truy xuất thông tin ghi nhận đóng góp cho địa điểm đó từ
Thuộc tính 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 ghi nhận sự đóng góp cho một tập hợp địa điểm
Nếu ứng dụng của bạn cho thấy thông tin thu được bằng cách yêu cầu
địa điểm hiện tại, ứng dụng phải hiển thị
thuộc tính của bên thứ ba cho thông tin chi tiết về địa điểm được hiển thị. Bạn có thể truy xuất
cho tất cả các vị trí được truy xuất trong yêu cầu, từ
attributions cơ sở lưu trú trên
GMSPlaceLikelihoodList.
attributions được cung cấp dưới dạng một
Đối tượng NSAttributedString mà bạn có thể truy cập và hiển thị trong
giống như attributions trên một vị trí, như mô tả
ở trên.
Hiển thị thuộc tính cho ảnh
Nếu ứng dụng của bạn hiển thị
photos, thì bạn phải
hiển thị attributions và authorAttributions bất kỳ cho mỗi mục
ảnh có chúng.
- Để truy cập vào bất kỳ thông tin ghi nhận sự đóng góp 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ị. - Để truy cập vào mọi thông tin ghi nhận tác giả, hãy sử dụng
GMSPlacePhotoMetadata.authorAttributions. Tài sản này chứa một mả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 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á
bài đánh giá được biểu thị bằng đối tượng GMSPlaceReview. Bạn có thể
tuỳ ý hiển thị những bài đánh giá này trong ứng dụng của bạn.
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 bao gồm
ảnh và đường liên kết
đến hồ sơ của họ. Hình ảnh sau đây cho thấy một ví dụ
về bài đánh giá một công viên:
Bạn cũng nên đăng cách sắp xếp các bài đánh giá theo người dùng cuối.
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ị thuộc tính của bên thứ ba
Thông tin ghi nhận sự đóng góp cho nhà cung cấp bên thứ ba được cung cấp dưới dạng các đối tượng NSAttributedString
chứa nội dung và đường liên kết mà bạn phải duy trì và hiển thị cho người dùng.
Bạn nên sử dụng UITextView để hiển thị các thông tin ghi nhận sự đóng góp, vì các đường liên kết trong thông tin phân bổ phải hoạt động.
Để đảm bảo các đường liên kết hoạt động, hãy thiết lập uỷ quyền trên UITextView và thiết lập 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ề thuộc tính 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, phạm vi văn bản Công ty mẫu được đề cập trong
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 chọn kiểu cho các thuộc tính của 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 đường khoá phải bằng hoặc lớn hơn chiều cao thuộc "G" trong Google.
Khoảng cách giữa bản sao thuộc tính 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 có đúng biến thể màu sắc để thông tin cơ bả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 với phạm vi từ 0% đến 40% tông màu đen tối đa.
#5F6368 RGB 95 99 104 HSL 213 5 39 HSB 213 9 41
Trên nền tối hơn và trên ảnh chụp hoặc các mẫu không bận rộn, hãy sử dụng văn bản màu trắng cho dòng ghi tên tác giả và phân bổ giá trị đóng góp.
#FFFFFF RGB 255 255 255 HSL 0 0 100 HSB 0 0 100
Phông chữ
Sử dụng Phông chữ Roboto.
Dịch vụ so sánh giá (CSS) mẫu
CSS sau đây, khi áp dụng cho văn bản "Google", sẽ hiển thị "Google" với tính năng thích hợp phông chữ, màu sắc và khoảng cách 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;