Tài liệu này liệt kê các yêu cầu đối với ứng dụng được phát triển bằng Geocoding API. Xin lưu ý rằng việc sử dụng Geocoding API chịu sự điều chỉnh của Thỏa thuận giữa bạn và Google.
Chính sách
Phần này mô tả các chính sách liên quan đến Geocoding API. Các chính sách này cung cấp hướng dẫn và yêu cầu thực tế về cách triển khai để giúp bạn sử dụng Dịch vụ một cách chính xác và phù hợp với kỳ vọng của Nền tảng Google Maps.
Trường hợp 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)
không phải tuân thủ các hạn chế về bộ nhớ đệm.
Do đó, bạn có thể lưu trữ 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 về 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ụ riêng cho 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 riêng. Trước khi xây dựng bằng Nền tảng Google Maps, hãy xem các điều khoản và thông tin dành riêng cho EEA sau đây:
- Điều khoản dịch vụ của Nền tảng Google Maps ở EEA
- Điều khoản dành riêng cho dịch vụ của Nền tảng Google Maps ở EEA
- Câu hỏi thường gặp về EEA
- Yêu cầu về an toàn giao thông của Nền tảng Google Maps
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 Nền tảng Google Maps
- Điều khoản dành riêng cho dịch vụ của Nền tảng Google Maps
Yêu cầu về việc ghi công Google Maps
Phần này cung cấp các yêu cầu và nguyên tắc về việc ghi công khi hiển thị Google Maps và Nội dung thông qua ứng dụng của bạn.
Hiển thị thông tin ghi công Google Maps
Bạn phải tuân thủ các yêu cầu về việc ghi công Google Maps khi hiển thị Nội dung từ các API của Nền tảng Google Maps 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 nếu Nội dung xuất hiện trên Google Maps mà thông tin ghi công đã hiển thị.
Thông tin ghi công Google Maps được đưa vào
Đối với thông tin ghi công Google Maps mà Nền tảng Google Maps đã cung cấp trong giao diện người dùng, chẳng hạn như trong Bộ công cụ giao diện người dùng Địa điểm:
- Đừng xoá thông tin ghi công được đưa vào bất kể thông tin đó xuất hiện ở đâu. Đừng sửa đổi, ẩn, hoặc che khuất thông tin ghi công và hãy đảm bảo thông tin đó hiển thị rõ ràng trên nền.
- Luôn phân biệt Nội dung của Nền tảng Google Maps 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 về hình ảnh, bạn phải tuân thủ tất cả các yêu cầu về việc ghi công Google Maps.
Biểu trưng và văn bản ghi công Google Maps
Thông tin ghi công nên ở 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 biết rõ nội dung nào do Google Maps cung cấp.
Thông tin ghi cô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 xuống bên dưới và làm theo nguyên tắc trong phần này.
Tải các thành phần ghi công Google Maps xuốngKhi sử dụng biểu trưng Google Maps, hãy tuân thủ các nguyên tắc sau.
- Đừng 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 đơn sắc 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.
- Đưa nhãn hỗ trợ tiếp cận có văn bản Google Maps vào.
Thông tin ghi cô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 thủ các nguyên tắc sau:
- Đừng sửa đổi văn bản Google Maps theo bất kỳ cách nào:
- Đừng thay đổi cách viết hoa của Google Maps
- Đừng xuống dòng Google Maps
- Đừng 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) so 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 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ý hình ảnh của thông tin ghi công 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 hình ảnh. Đố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 Nội dung của Nền tảng Google Maps 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 đủ.
- Đừng trình bày sai về Google Maps bằng cách ghi công cho nội dung không phải của 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. Tuyệt đối không xoá, ẩn, che khuất hoặc sửa đổi thông tin đó.
Các hì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 bên thứ ba, việc chỉ đưa "Google Maps" hoặc biểu trưng Google vào không phải là thông tin ghi công phù hợp.
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, 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 Nền tảng 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, hãy luôn đưa văn bản tiết lộ thông tin đã bản địa hoá (được cung cấp trong trường disclosure_text của nội dung phản hồi) ngay bên dưới bản tóm tắt. Tuyệt đối không sửa đổi hoặc bổ sung văn bản tiết lộ thông tin do API cung cấp.
Yêu cầu về bản tóm tắt khi đến
Bản tóm tắt khi đến xuất hiện trong ứng dụng của bạn phải đi kèm với văn bản và đườ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 đế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 ý: Bản tóm tắt do AI tạo được cung cấp thông qua Geocoding API phải tuân thủ 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 họ 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 cách sử dụng URL nội dung gắn cờ ( |
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 để có 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 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
- Không quá 120 ký tự hoặc 24 từ
- 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 cách an toàn và tuân thủ tất cả luật và quy định tại địa phương.