Tài liệu này liệt kê các yêu cầu dành cho ứng dụng được phát triển bằng Map Tiles API. Xin lưu ý rằng việc sử dụng Map Tiles API chịu sự điều chỉnh của Thoả thuận giữa bạn với Google.
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 API Thẻ thông tin trên Maps, bạn phải cung cấp Điều khoản sử dụng và Chính sách quyền riêng tư với ứng dụng của mình. Chính sách này đáp ứng các nguyên tắc đã nêu trong Thỏa 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 cung cấp 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 chịu sự ràng buộc của Điều khoản dịch vụ của Google.
- Trong Chính sách quyền riêng tư, bạn phải thông báo cho người dùng rằng bạn đang sử dụng(các) API Google Maps và đưa vào bằng cách tham khảo Chính sách quyền riêng tư của Google.
Địa điểm bạn nên cung cấp Điều khoản sử dụng và Chính sách quyền riêng tư 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 một ứng dụng dành cho thiết bị 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 liên quan và trong trình đơ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 một đườ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 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 API Thẻ thông tin trên bản đồ phải chịu sự ràng buộc của các điều khoản trong Thoả thuận của bạ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ừ các điều kiện giới hạn được nêu trong điều khoản.
Cụ thể, ứng dụng phải sử dụng Map Tiles API để trực quan hoá bản đồ. Bạn không được sử dụng API Thẻ thông tin bản đồ cho bất kỳ trường hợp sử dụng không trực quan nào, chẳng hạn như:
- Phân tích hình ảnh
- Diễn giải bằng máy
- Phát hiện/nhận dạng đối tượng
- Trích xuất dữ liệu địa lý hoặc bán lại
- Sử dụng ngoại tuyến, bao gồm cho bất kỳ mục đích nào ở trên
Phản hồi của API Thẻ thông tin bản đồ có thể bao gồm tiêu đề Cache-Control cần được triển khai theo tài liệu về giao thức HTTP. Ví dụ: ứng dụng của bạn phải tuân theo giá trị max-age, giá trị stale-while-revalidate, lệnh must-revalidate và lệnh private khi chúng được truyền vào phản hồi.
Phản hồi của API Thẻ thông tin của Maps cũng có thể bao gồm tiêu đề ETag. Tiêu đề này cũng phải được triển khai theo tài liệu về giao thức HTTP khi yêu cầu xác thực lại.
Xin lưu ý rằng mã địa điểm (dùng để xác định riêng một địa điểm) sẽ được miễn hạn chế lưu vào bộ nhớ đệm. Mã địa điểm được trả về trong trường "place_id" trong các phản hồi của API Thẻ thông tin bản đồ. 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ị biểu trưng của Google
Khi sử dụng API Thẻ thông tin trên bản đồ để hiển thị Google Maps, bạn cũng phải hiển thị biểu trưng của Google trên bản đồ và không được thay đổi biểu trưng theo bất kỳ cách nào. Bạn nên đặt biểu trưng của Google ở góc dưới cùng bên trái của bản đồ và đặt thông tin ghi nhận tác giả ở góc bên phải của bản đồ. Để biết thêm thông tin, hãy xem nguyên tắc của chúng tôi trong Trung tâm tài nguyên thương hiệu.
Đối với trải nghiệm bản đồ 3D có tính chất điện ảnh hơn, tức là nếu chưa thể sẵn sàng đáp ứng các yêu cầu thiết kế theo trải nghiệm của bạn về trải nghiệm người dùng đối với các nguyên tắc đặt vị trí này, thì bạn vẫn cần hiển thị rõ ràng biểu trưng Google ở đầu, cuối hoặc cả hai đầu của trải nghiệm, sao cho đối tượng của bạn hiểu được quyền tác giả của bản đồ. Bạn vẫn phải tuân thủ việc hiển thị các thông tin phân bổ dữ liệu của bên thứ ba như mô tả dưới đây trong suốt thời gian trải nghiệm điện ảnh. Hãy xem bài viết Hiển thị biểu trưng và thuộc tính dữ liệu trong hình ảnh trực quan kết hợp dưới đây để được hướng dẫn thêm.
Ví dụ về bản đồ sau đây cho thấy biểu trưng của 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.
| Để sử dụng trên nền sáng | Để sử dụng trên nền tối |
|---|---|
|
|
Tệp zip sau đây chứa biểu trưng Google ở đúng kích thướ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. Đừng xoá, che khuất hoặc cắt thông tin thuộc tính. Bạn không thể sử dụng biểu trưng của Google cùng dòng (ví dụ: "Các bản đồ này đến từ [Google_logo]").
Luôn phân bổ theo cách phù hợp. Nếu bạn sử dụng ảnh chụp màn hình hình ảnh trên Google bên ngoài video được nhúng trực tiếp, hãy cung cấp thông tin ghi nhận tác giả 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 ghi công, miễn là văn bản đó ở gần nội dung và có thể đọc được đối với người xem hoặc người đọc thông thường. Bạn không được di chuyển thuộc tính ra khỏi nội dung, chẳng hạn như đến cuối sách, ghi công của tệp hoặc chương trình hoặc chân trang web của bạn.
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 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ông phải Google. Nếu bạn sử dụng những hình ảnh như vậy, văn bản ghi công của bạn phải có 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 nhà cung cấp dữ liệu bên thứ ba được trích dẫn cùng với hình ảnh mà chỉ chứa "Google" hoặc biểu trưng Google là không đúng.
Nếu bạn đang sử dụng Nền tảng Google Maps trên một thiết bị không phù hợp để hiển thị thuộc tính, 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.
Hiển thị biểu trưng của Google bằng trình kết xuất của bên thứ ba
Khi sử dụng Map Tiles API để hiển thị Google Maps bằng trình kết xuất đồ hoạ của bên thứ ba, bạn không được chồng chéo hoặc che khuất biểu trưng Google bằng bất kỳ biểu trưng nào khác, chẳng hạn như biểu trưng của trình kết xuất. Duy trì khoảng cách vùng đệm hợp lý giữa biểu trưng của Google và biểu trưng của bên thứ ba để biểu trưng này xuất hiện dưới dạng biểu trưng độc lập. Không biểu trưng nào có thể chồng chéo hoặc che khuất thuộc tính dữ liệu do phản hồi của API cung cấp.
Hiển thị các mô hình phân bổ dữ liệu của Google
Dữ liệu được trả về từ API Thẻ thông tin của Maps cần hiển thị thông tin ghi nhận tác giả và bản quyền từ các yêu cầu thông tin khung nhìn hoặc siêu dữ liệu thích hợp. Bạn nên hiển thị đầy đủ thông tin này như được cung cấp ở vị trí thích hợp, thường là góc dưới cùng bên phải của tập hợp thẻ thông tin hiển thị hoặc trong chế độ xem trình kết xuất 3D. Lưu ý rằng các chuỗi phân bổ có thể thay đổi, tuỳ thuộc vào dữ liệu bản đồ mà khung nhìn của trình kết xuất yêu cầu.
Nếu không thể hiển thị toàn bộ các thuộc tính dữ liệu do các giới hạn về kích thước khung nhìn, hãy cân nhắc thêm một thành phần trên giao diện người dùng di chuột hoặc có thể nhấp vào có nhãn "Nguồn dữ liệu". Thành phần này sẽ mở trong cửa sổ bản đồ để cung cấp thông tin về thuộc tính. Luôn cố gắng duy trì các phương pháp viết bản đồ hiệu quả.
Hiển thị thuộc tính dữ liệu của bên thứ ba
Khi sử dụng Map Tiles API để hiển thị dữ liệu Google Maps dưới dạng bản đồ cơ sở và lớp phủ dữ liệu không gian địa lý của bên thứ ba (không phải của Google), bạn có thể phải hiển thị dữ liệu phân bổ từ nhà cung cấp dữ liệu bên thứ ba. Bạn không được chồng chéo hoặc che khuất thông tin phân bổ dữ liệu trên Google theo bất kỳ cách nào với thuộc tính dữ liệu của dữ liệu bên thứ ba. Phải tách biệt rõ ràng việc phân bổ dữ liệu của bên thứ ba với dữ liệu phân bổ của Google. Ngoài ra, bạn phải rõ ràng rằng biểu trưng của Google và thông tin thuộc tính dữ liệu của Google được liên kết với bản đồ cơ sở và với nhau.
Hiển thị biểu trưng và thông tin ghi nhận sự đóng góp dữ liệu trong hình ảnh trực quan kết hợp
Khi sử dụng dữ liệu Google Maps làm bản đồ cơ sở trong khi phủ dữ liệu bản đồ của riêng bạn, bạn phải đảm bảo đối tượng của mình hiểu đầy đủ về phần nào của hình ảnh bản đồ được gán cho Google và phần nào được gán cho dữ liệu bản đồ của riêng bạn. Ngoài ra, hãy làm theo các nguyên tắc về Hiển thị biểu trưng Google ở trên.
Chẳng hạn, hãy cân nhắc kết hợp Thẻ thông tin 3D ảnh thực (làm màu nền) với các mô hình ảnh thực của riêng bạn (ở nền trước). Người dùng có thể nhầm lẫn về những thành phần của cảnh bắt nguồn từ dữ liệu của Google Maps. Trong những trường hợp như vậy, bạn phải nêu rõ trong chuỗi thuộc tính giao diện người dùng hoặc luồng người dùng, phần nào của cảnh bắt nguồn từ dữ liệu của Google Maps. Bạn có trách nhiệm tuân thủ mọi yêu cầu ghi công của bên thứ ba có thể áp dụng cho nguồn dữ liệu mà bạn sử dụng với dữ liệu trên Google Maps.
Lớp phủ dữ liệu địa lý với Thẻ thông tin 3D có ảnh thực tế
Bạn có thể phủ các đối tượng 3D của mình lên Thẻ thông tin 3D ảnh thực, miễn là đối tượng 3D đó không được trích xuất, truy vết hoặc lấy bằng tay hay máy từ Thẻ thông tin 3D ảnh thực.
Tạo video có API Thẻ thông tin của bản đồ
- Video quảng cáo: Bạn có thể tạo video quảng cáo tuân theo các điều khoản của Thoả thuận và những quy định sau đây:
- Video quảng cáo không được chứa hình ảnh ở Chế độ xem đường phố.
- Video quảng cáo không được dài quá 30 giây.
- Video quảng cáo phải nói về khả năng của(các) ứng dụng của bạn.
- Video quảng cáo phải được đánh dấu rõ ràng, "chỉ nhằm mục đích quảng cáo" và phải tuân thủ Nguyên tắc phân bổ trong Chính sách của API Thẻ thông tin trên bản đồ.
- Video quảng cáo không được phép bán lại một cách riêng biệt hoặc dưới dạng một phần của phần mềm, ứng dụng hoặc trải nghiệm người dùng.
- Gỡ bỏ: Bạn có trách nhiệm tuân thủ tất cả yêu cầu gỡ bỏ Video quảng cáo đó, bao gồm cả yêu cầu của bên thứ ba.
Truy xuất thông tin ghi công và bản quyền
Lấy thông tin về thuộc tính và bản quyền qua trường copyright trong phản hồi của các lệnh gọi API sau đây, tuỳ thuộc vào dịch vụ bạn đang sử dụng:
Thẻ thông tin 2D
Ô lộ trình, vệ tinh và địa hình
Thông tin bản quyền và thông tin ghi nhận tác giả hiện có trong phản hồi về thông tin khung nhìn, như trong ví dụ sau.
{
"copyright": "Map data ©2023",
"maxZoomRects": [
{
"maxZoom": 19,
"north": 90,
"south": -90,
"east": 180,
"west": -180
},
...
]
}
Các ô trong Chế độ xem đường phố
Thông tin về bản quyền và quyền ghi công có trong phản hồi về siêu dữ liệu của Chế độ xem đường phố. Ví dụ:
{
"panoId": "Zzl28rqGJgaL2IdkUleP8A",
"lat": 50.059138596550696,
"imageHeight": 6656,
"imageWidth": 13312,
"tileHeight": 512,
"tileWidth": 512,
"copyright": "From the Owner, Photo by: Google",
…
}
Mã ảnh toàn cảnh được dùng để xác định riêng một ảnh toàn cảnh trong Chế độ xem đường phố sẽ không bị hạn chế lưu vào bộ nhớ đệm. Do đó, bạn có thể lưu trữ các giá trị mã ảnh toàn cảnh vô thời hạn. Giá trị mã nhận dạng toàn cảnh được trả về trong trường panoId trong phản hồi của API tĩnh của Chế độ xem đường phố.
Ô 3D ảnh thực tế
Đối với Thẻ thông tin 3D ảnh thực, dữ liệu thuộc tính sẽ được trả về trong mỗi yêu cầu thẻ thông tin.
Bạn phải tổng hợp, sắp xếp và hiển thị trong một dòng tất cả các thuộc tính cho các thẻ thông tin hiển thị; thường là dọc theo cuối quá trình kết xuất. Ví dụ: bạn có thể tìm thấy các thông tin phân bổ dữ liệu trong một thẻ thông tin glTF bằng cách xem trong asset, copyright.
{
"asset": {
"version": "2.0",
"generator": "draco_decoder",
"copyright": "Data SIO, NOAA, U.S. Navy, NGA, GEBCO;Landsat / Copernicus"
}
}
CesiumJS
Nếu đang sử dụng CesiumJS làm trình kết xuất, thì bạn cần bật showCreditsOnScreen trong HTML kết xuất để hiển thị các thuộc tính.
// Add Photorealistic 3D Tiles tileset.
const tileset = viewer.scene.primitives.add(new Cesium.Cesium3DTileset({
url: "https://tile.googleapis.com/v1/3dtiles/root.json?key=YOUR_API_KEY",
// This property is needed to appropriately display attributions
// as required.
showCreditsOnScreen: true,
}));
Cesium cho Unreal
Nếu đang sử dụng Cesium cho Unreal làm trình kết xuất, thì để hiển thị các thuộc tính, bạn cần bật trường Show Credits on Screen (Hiện thông tin ghi công trên màn hình) trong World Outliner (Trình phác thảo thế giới).
Cesium cho Unity
Nếu đang sử dụng Cesium cho Unity làm trình kết xuất, thì để hiển thị các thuộc tính phân bổ, bạn cần bật trường Show Credits on Screen (Hiện tín dụng trên màn hình) trong bảng điều khiển của Trình kiểm tra.
Nguyên tắc về kiểu cho mô hình phân bổ của Google
Dưới đây là nguyên tắc về 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 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 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".
Độ dễ đọc
Dòng tên tác giả phải luôn rõ ràng, dễ đọc và hiển thị với nhiều biến thể màu sắc phù hợp với 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 với phạm vi sắc thái đen tối đa là 0%– 40%.
#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, hãy sử dụng văn bản màu trắng cho dòng ghi tên tác giả và 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 được á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;