Tài liệu này liệt kê các yêu cầu dành riêng cho tất cả ứng dụng được phát triển bằng Places API (Mới), bao gồm cả dịch vụ Tự động hoàn thành (Mới) là một phần của API đó. Bạn có thể tìm thấy thông tin chung hơn 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.
Chính sách
Phần này mô tả các chính sách liên quan đến Places API. Các chính sách cung cấp hướng dẫn và yêu cầu thực hiện thực tế để giúp bạn sử dụng Dịch vụ đúng cách và phù hợp với kỳ vọng của Nền tảng Google Maps.
Ngoại lệ đối với các hạn chế về bộ nhớ đệm
Xin lưu ý rằng Mã địa điểm (dùng để xác định duy nhất một địa điểm) được
miễn các hạn chế về bộ nhớ đệm.
Do đó, bạn có thể lưu trữ các giá trị mã địa điểm vô thời hạn.
Mã địa điểm được trả về trong trường place_id trong
các phản hồi API. 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 Mã địa điểm.
Các quốc gia và vùng lãnh thổ thuộc Khu vực kinh tế Châu Âu
Sản phẩm này có Điều khoản dịch vụ khác nhau đối với những khách hàng có địa chỉ thanh toán ở Khu vực kinh tế Châu Âu (EEA) và cũng có thể có chức năng khác. Trước khi xây dựng bằng Google Maps Platform, hãy xem các điều khoản và thông tin dành riêng cho Khu vực kinh tế Châu Âu (EEA) sau đây:
- Điều khoản dịch vụ của Google Maps Platform tại EEA
- Điều khoản dành riêng cho dịch vụ của Google Maps Platform tại Khu vực kinh tế Châu Âu (EEA)
- Câu hỏi thường gặp (FAQ) về EEA
- Yêu cầu về an toàn đường bộ của Google Maps Platform
Nếu địa chỉ thanh toán của bạn không ở EEA, thì các điều khoản dịch vụ sau đây sẽ áp dụng cho bạn:
- Điều khoản dịch vụ của Google Maps Platform
- Điều khoản dành riêng cho dịch vụ của Google Maps Platform
Yêu cầu về thông tin ghi công của Google Maps
Phần này cung cấp các yêu cầu và nguyên tắc về thông tin ghi công để hiển thị Google Maps và Nội dung thông qua các ứng dụng của bạn.
Hiển thị thông tin ghi công của Google Maps
Bạn phải tuân thủ các yêu cầu về thông tin ghi công của Google Maps khi hiển thị Nội dung từ các API của Google Maps Platform trong ứng dụng hoặc trang web của mình. Bạn không cần thêm thông tin ghi công bổ sung nếu Nội dung được hiển thị trên Google Maps mà thông tin ghi công đã hiển thị.
Thông tin ghi công của Google Maps được đưa vào
Đối với thông tin ghi công của Google Maps đã được Google Maps Platform cung cấp trong giao diện người dùng, chẳng hạn như trong Places UI Kit:
- Không được xoá thông tin ghi công được đưa vào, bất kể thông tin đó được hiển thị ở đâu. Không được sửa đổi, ẩn, hoặc che khuất thông tin ghi công và đảm bảo thông tin đó hiển thị rõ ràng trên nền.
- Luôn phân biệt trực quan Nội dung của Google Maps Platform với nội dung khác bằng cách sử dụng các dấu hiệu trên giao diện người dùng, chẳng hạn như đường viền, màu nền, bóng hoặc khoảng trắng vừa đủ.
- Khi thực hiện các sửa đổi trực quan, bạn phải tuân thủ tất cả các yêu cầu về thông tin ghi công của Google Maps
Biểu trưng và văn bản ghi công của Google Maps
Thông tin ghi công nên có dạng biểu trưng Google Maps bất cứ khi nào có thể. Trong trường hợp không gian bị hạn chế, bạn có thể sử dụng văn bản Google Maps. Người dùng cuối phải luôn thấy rõ nội dung nào do Google Maps cung cấp.
Thông tin ghi công bằng biểu trưng
Hãy tuân thủ các yêu cầu sau để sử dụng biểu trưng Google Maps trong ứng dụng hoặc trang web của bạn.
Tải biểu trưng Google Maps xuống
Sử dụng các tệp biểu trưng chính thức của Google Maps. Tải các biểu trưng bên dưới xuống và làm theo nguyên tắc trong phần này.
Tải các thành phần ghi công của Google Maps xuốngKhi sử dụng biểu trưng Google Maps, hãy tuân theo các nguyên tắc sau.
- Không được sửa đổi biểu trưng theo bất kỳ cách nào.
- Duy trì tỷ lệ khung hình của biểu trưng để tránh bị méo.
- Sử dụng biểu trưng có đường viền trên nền rối mắt, chẳng hạn như bản đồ hoặc hình ảnh.
- Sử dụng biểu trưng không có đường viền trên nền đơn giản, chẳng hạn như màu đồng nhất hoặc màu chuyển sắc tinh tế.
Quy cách về kích thước biểu trưng
Hãy tuân thủ các quy cách về kích thước sau đây cho biểu trưng Google Maps:- Chiều cao tối thiểu của biểu trưng: 16dp
- Chiều cao tối đa của biểu trưng: 19dp
- Khoảng trắng tối thiểu của biểu trưng: 10dp ở bên trái, bên phải và trên cùng, 5dp ở dưới cùng
Để tìm hiểu về dp, hãy xem Mật độ pixel trên trang web Material Design.
Khả năng tiếp cận của biểu trưng
Hãy tuân thủ các yêu cầu về khả năng tiếp cận sau đây cho biểu trưng Google Maps:- Duy trì độ tương phản có thể tiếp cận giữa biểu trưng và nền.
- Thêm nhãn hỗ trợ tiếp cận có văn bản Google Maps.
Thông tin ghi công bằng văn bản
Nếu kích thước giao diện của bạn không hỗ trợ việc sử dụng biểu trưng Google Maps, bạn có thể viết Google Maps bằng văn bản. Hãy tuân theo các nguyên tắc sau:
- Không được sửa đổi văn bản Google Maps theo bất kỳ cách nào:
- Không được thay đổi cách viết hoa của Google Maps
- Không được xuống dòng Google Maps
- Không được bản địa hoá Google Maps sang ngôn ngữ khác.
- Ngăn trình duyệt dịch Google Maps bằng cách sử dụng thuộc tính HTML
translate="no".
Tạo kiểu cho văn bản Google Maps như mô tả trong bảng sau:
Yêu cầu về kiểu văn bản Google Maps Thuộc tính Kiểu Bộ phông chữ Roboto. Bạn không bắt buộc phải tải phông chữ. Bộ phông chữ dự phòng Bất kỳ phông chữ không chân nào đã được sử dụng trong sản phẩm của bạn hoặc "Sans-Serif" để gọi phông chữ mặc định của hệ thống Kiểu phông chữ Bình thường Độ đậm phông chữ 400 Màu phông chữ Trắng, đen (#1F1F1F) hoặc xám (#5E5E5E). Duy trì độ tương phản có thể tiếp cận (4,5:1) với nền. Cỡ chữ Cỡ chữ tối thiểu: 12sp
Cỡ chữ tối đa: 16sp
Để tìm hiểu về sp, hãy xem Đơn vị cỡ chữ trên trang web Material Design.Khoảng cách giữa chữ cái Bình thường
Ví dụ về CSS
CSS sau đây hiển thị Google Maps với kiểu chữ và màu sắc phù hợp trên nền trắng hoặc nền sáng.
@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; }
Yêu cầu về hình ảnh
Hãy tuân thủ các yêu cầu sau đối với việc xử lý trực quan thông tin ghi công của Google Maps.Đặt thông tin ghi công ở gần đầu hoặc cuối nội dung và trong cùng một vùng chứa trực quan. Đối với một dòng nội dung, bạn có thể đặt thông tin ghi công ở bên phải hoặc bên trái.
Phân biệt trực quan Nội dung của Google Maps Platform với nội dung khác bằng cách sử dụng các dấu hiệu trên giao diện người dùng, chẳng hạn như đường viền, màu nền, bóng hoặc khoảng trắng vừa đủ.
- Không được trình bày sai Google Maps bằng cách ghi công cho nội dung không thuộc Nền tảng Google Maps.
- Xác minh rằng thông tin ghi công luôn hiển thị và dễ đọc. Không được xoá, ẩn, che khuất hoặc sửa đổi thông tin ghi công.
Các hình ảnh sau đây cho thấy ví dụ về các yêu cầu về hình ảnh này.
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 bản đồ của chúng tôi đến từ các nhà cung cấp không phải là Google. Đối với một số sản phẩm, chẳng hạn như Map Tiles API, chúng tôi có thể cung cấp cho bạn thông tin ghi công bắt buộc cho nhà cung cấp dữ liệu bên thứ ba. Khi đó, văn bản ghi công của bạn phải có tên "Google Maps" 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 Google cung cấp thông tin ghi công của bên thứ ba, việc chỉ đưa vào "Google Maps" hoặc biểu trưng Google không phải là thông tin ghi công thích hợp.
Các yêu cầu khác về thông tin ghi công
Các yêu cầu về thông tin ghi công sau đây dành riêng cho Places API.
Tự động hoàn thành cho địa chỉ của người dùng cuối
Khi người dùng cuối sử dụng chức năng Tự động hoàn thành trong Ứng dụng khách hàng của bạn để nhập trước địa chỉ đường phố và địa chỉ đường phố đó sẽ được người dùng cuối cung cấp đầy đủ và chính xác mà không cần chức năng Tự động hoàn thành, thì địa chỉ mà người dùng cuối chọn sẽ không phải tuân theo các giới hạn nội dung của Google Maps trong Thỏa thuận về Google Maps Platform. Ngoại lệ này chỉ áp dụng cho địa chỉ đường phố do người dùng cuối chọn và chỉ dành cho giao dịch cụ thể của người dùng cuối đó; ngoại lệ này không áp dụng cho danh sách địa chỉ được đề xuất do chức năng Tự động hoàn thành cung cấp hoặc cho Nội dung khác của Google Maps. Ngoại lệ này không áp dụng cho bất kỳ chức năng tra cứu địa điểm yêu thích hoặc địa chỉ nào do các Dịch vụ khác của Google Maps Platform cung cấp.
Trong hình ảnh trước đó, danh sách địa chỉ ở bên trái vẫn phải tuân theo các hạn chế về Nội dung của Google Maps. Sau khi người dùng cuối chọn địa chỉ mà họ muốn, địa chỉ đó sẽ không phải tuân theo các hạn chế về Nội dung của Google Maps chỉ nhằm mục đích giao dịch áp dụng của người dùng cuối đó.
Thông tin ghi công của bên thứ ba
Hãy làm theo các hướng dẫn sau để truy xuất thông tin ghi công của bên thứ ba và hiển thị thông tin ghi công trong ứng dụng của bạn.
Truy xuất thông tin ghi công từ một Địa điểm
Nếu ứng dụng của bạn hiển thị thông tin thu được bằng cách gọi Place Details bằng mã địa điểm, thì ứng dụng cũ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ề địa điểm thu được.
Thông tin ghi công trong đối tượng của phản hồi được biểu thị bằng đối tượng.PlaceAttribution Để thêm Attribution vào phản hồi, hãy đưa
places.attributions (Nearby Search và Tìm kiếm văn bản) hoặc attributions
(Place Details) vào
mặt nạ trường của yêu cầu.
Các trường của đối tượng Attribution là các chuỗi chứa provider
và providerUri của thông tin ghi công hoặc một chuỗi trống nếu không có thông tin ghi công nào để
hiển thị.
Hiển thị thông tin ghi công cho ảnh
Nếu ứng dụng của bạn hiển thị ảnh, thì bạn phải hiển thị thông tin ghi công của tác giả cho mỗi ảnh có thông tin ghi công.
Thông tin chi tiết về ảnh trong đối tượng
Place
của phản hồi có trong mảng photos. Để thêm photos
mảng vào phản hồi, hãy đưa places.photos (Nearby Search và Tìm kiếm văn bản) hoặc
photos (Place Details) vào
mặt nạ trường của yêu cầu.
Mỗi phần tử của mảng photos là một thực thể của
Photo,
chứa mảng authorAttributions thuộc loại
AuthorAttribution.
Các trường của đối tượng AuthorAttribution là các chuỗi chứa displayName, uri và photoUri của thông tin ghi công hoặc một chuỗi trống nếu không có thông tin ghi công nào để hiển thị.
Hiển thị bài đánh giá
Đối tượng Place
trong phản hồi có thể chứa tối đa 5 bài đánh giá. Bạn có thể tuỳ ý hiển thị các bài đánh giá này trong ứng dụng của mình.
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 của tác giả ở gần. Khi có trong trường thông tin ghi công của tác giả của đối tượng Review, bạn nên thêm ảnh của tác giả và đường liên kết đến hồ sơ của họ. Hình ảnh sau đây cho thấy ví dụ về bài đánh giá về một công viên:
Google cũng khuyên bạn nên hiển thị cách sắp xếp các bài đánh giá cho người dùng cuối.
Mỗi bài đánh giá trong một
Place
đối tượng của phản hồi được biểu thị bằng một
Review
đối tượng. Để thêm đối tượng Review vào phản hồi, hãy đưa places.reviews
(Nearby Search và Tìm kiếm văn bản) hoặc reviews (Place Details) vào
mặt nạ trường của yêu cầu.
Các trường của đối tượng Review chứa thông tin ghi công hoặc trống nếu không có thông tin ghi công nào để hiển thị.
Thông tin ghi công của kết quả tìm kiếm
Ở Châu Âu, khi sử dụng bảng xếp hạng không bị can thiệp của Google, các sản phẩm tìm kiếm phải có văn bản giải thích cách xác định thứ hạng kết quả tìm kiếm. Văn bản này phải mô tả các yếu tố chính và mức độ quan trọng của các yếu tố chính, đồng thời người dùng chỉ cần nhấp một lần để xem văn bản đó. Văn bản giải thích:
Tiêu đề: Giới thiệu về các kết quả này
Nội dung: Khi bạn tìm kiếm các doanh nghiệp hoặc địa điểm ở gần một vị trí, Google Maps sẽ hiển thị 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 tìm kiếm của bạn.
Nút 1: Tìm hiểu thêm
Văn bản"Tìm hiểu thêm" phải liên kết đến bài viết trên Trung tâm trợ giúp.
Nút 2: OK
Bản tóm tắt do AI tạo
Khi hiển thị bản tóm tắt do AI tạo trong ứng dụng của bạn (bao gồm cả bản tóm tắt về địa điểm, khu vực và bài đánh giá), bạn phải làm như sau:
- Hiển thị thông tin ghi công, đường liên kết báo cáo và đường liên kết tham chiếu bắt buộc như được xác định bên dưới.
- Người dùng cuối phải có thể đọc toàn bộ văn bản tóm tắt do Google Maps cung cấp.
Hiển thị văn bản tiết lộ thông tin về bản tóm tắt do AI tạo
Khi hiển thị bản tóm tắt do AI tạo thuộc bất kỳ loại nào, hãy luôn thêm văn bản tiết lộ thông tin đã bản địa hoá (được cung cấp trong trường disclosureText của nội dung phản hồi) ngay bên dưới bản tóm tắt. Không được sửa đổi hoặc bổ sung văn bản tiết lộ thông tin do API cung cấp.
Các yêu cầu bổ sung về bản tóm tắt địa điểm và khu vực
Bản tóm tắt địa điểm và khu vực được hiển thị trong ứng dụng của bạn phải đi kèm với văn bản và các đường liên kết bắt buộc sau đây:
| Văn bản | Yêu cầu |
|---|---|
| Giới thiệu về thông tin tóm tắt này | Sử dụng đường liên kết sau đây đến bài viết "Cách Google lấy nguồn và sử dụng thông tin trong trang thông tin địa phương": https://support.google.com/local-listings/answer/9851099. |
| Báo cáo thông tin tóm tắt |
Sử dụng đường liên kết có trong trường Lưu ý: Các bản tóm tắt do AI cung cấp thông qua Places API (Mới) phải tuân theo chính sách về nội dung và sản phẩm của Google ở bất cứ nơi nào trên thế giới. Bạn phải thông báo cho người dùng cuối rằng nếu muốn báo cáo nội dung cần xoá khỏi các dịch vụ của Google theo luật hiện hành, thì họ nên báo cáo nội dung đó bằng URL nội dung gắn cờ được cung cấp ( |
Yêu cầu về bản tóm tắt bài đánh giá
Bản tóm tắt bài đánh giá được hiển thị trong ứng dụng của bạn phải đi kèm với tiêu đề có văn bản "Tóm tắt bài đánh giá". Ngoài ra, bạn phải sử dụng văn bản và các đường liên kết bắt buộc sau đây:
| Văn bản | Yêu cầu |
|---|---|
| Giới thiệu về thông tin tóm tắt này | Sử dụng đường liên kết sau đây đến bài viết "Cách Google lấy nguồn và sử dụng thông tin trong trang thông tin địa phương": https://support.google.com/local-listings/answer/9851099 |
| Báo cáo thông tin tóm tắt |
Sử dụng đường liên kết có trong trường Lưu ý: Các bản tóm tắt do AI cung cấp thông qua Places API (Mới) phải tuân theo chính sách về nội dung và sản phẩm của Google ở bất cứ nơi nào trên thế giới. Bạn phải thông báo cho người dùng cuối rằng nếu muốn báo cáo nội dung cần xoá khỏi các dịch vụ của Google theo luật hiện hành, thì họ nên báo cáo nội dung đó bằng URL nội dung gắn cờ được cung cấp ( |
| Xem bài đánh giá | Sử dụng đường liên kết có trong trường reviewSummary.reviewsUri của phản hồi. |
Hướng dẫn hiển thị cho các trường hợp sử dụng trong ô tô
Để đảm bảo an toàn cho người lái xe, Google khuyên bạn nên hiển thị bản tóm tắt do AI tạo ở chế độ đỗ xe cho trải nghiệm trong ô tô. Nếu hiển thị bản tóm tắt ở chế độ lái xe, thông tin trên màn hình phải đơn giản, rõ ràng và ngắn gọn để đảm bảo người lái xe nhanh chóng tập trung trở lại vào đường:
- Không quá 3 dòng
- 120 ký tự hoặc 24 từ trở xuống
- Cỡ chữ tối thiểu là 24dp
Đặc biệt là trong bối cảnh ô tô, nhà phát triển có trách nhiệm hiển thị bản tóm tắt do AI tạo theo những cách an toàn và tuân thủ mọi luật và quy định của địa phương.