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 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à Google.
Chính sách
Phần này mô tả các chính sách liên quan đến Map Tiles API. Các chính sách cung cấp các nguyên tắc và yêu cầu triển khai thực tế để 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 Google Maps Platform.
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 Map Tiles API 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. Tuân theo các điều khoản trong 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ế được nêu trong điều khoản.
Cụ thể, các ứng dụng nên sử dụng Map Tiles API để trực quan hoá bản đồ. Bạn không được sử dụng Map Tiles API cho bất kỳ trường hợp sử dụng nào không liên quan đến hình ảnh trực quan, chẳng hạn như:
- Phân tích hình ảnh
- Phiên dịch máy
- Phát hiện đối tượng hoặc nhận dạng
- Trích xuất hoặc bán lại dữ liệu địa lý
- Sử dụng khi không có mạng, bao gồm cả việc sử dụng cho bất kỳ mục đích nào nêu trên
Phản hồi của Map Tiles API có thể bao gồm các 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 khách của bạn phải tuân thủ giá trị max-age, giá trị stale-while-revalidate, lệnh must-revalidate và lệnh private khi các giá trị và lệnh này được truyền trong phản hồi.
Phản hồi của Map Tiles API 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.
In
Bạn không được sử dụng hình ảnh trong Chế độ xem đường phố cho mục đích in ấn, như đã nêu trong chính sách của Chế độ xem đường phố.
Các quốc gia và 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 cho 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 sau đây dành riêng cho Khu vực kinh tế Châu Âu (EEA):
- Điều khoản dịch vụ của Google Maps Platform tại Khu vực kinh tế Châu Âu (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 về Khu vực kinh tế Châu Âu (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 nằm trong Khu vực kinh tế Châu Âu (EEA), thì bạn sẽ phải tuân theo các điều khoản dịch vụ sau:
Hiển thị thông tin ghi nhận tác giả của Google Maps
Bạn phải ghi rõ nguồn 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. Thông tin ghi nhận tác giả phải 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.
Thông tin ghi nhận tác giả biểu trưng
Biểu trưng của Google Maps
Sử dụng biểu trưng chính thức của Google Maps được cung cấp bên dưới.
Tải tài sản ghi nhận tác giả của Google Maps xuống
Khi 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 hình.
- 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 trơn, chẳng hạn như màu đồng nhất hoặc dải màu 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: 19 dp
- Khoảng trống tối thiểu xung quanh biểu trưng: 10 dp ở bên trái, bên phải và phía trên, 5 dp ở phía dưới
Để tìm hiểu về dp, hãy xem phần Mật độ pixel trên trang web Material Design.
Hỗ trợ tiếp cận biểu trưng
Hãy tuân thủ các yêu cầu sau đây về khả năng hỗ trợ tiếp cận đối với biểu trưng Google Maps:
- Duy trì độ tương phản dễ 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.
Hiển thị biểu trưng Google Maps 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 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 đệm hợp lý giữa biểu trưng Google và biểu trưng của bên thứ ba để chúng xuất hiện dưới dạng các biểu trưng độc lập. Không có biểu trưng nào được chồng chéo hoặc che khuất thông tin ghi nhận tác giả dữ liệu do phản hồi của API cung cấp.
Hiển thị thông tin về dữ liệu của Google
Dữ liệu được trả về từ Map Tiles API yêu cầu hiển thị thông tin ghi nhận tác giả và bản quyền từ siêu dữ liệu thích hợp hoặc yêu cầu thông tin khung nhìn. Bạn nên hiển thị đầy đủ thông tin này ở 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 ô hiển thị hoặc trong chế độ xem trình kết xuất 3D. Xin lưu ý rằng các chuỗi ghi nhận tác giả 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ị đầy đủ thông tin ghi nhận tác giả dữ liệu do các quy định ràng buộc về kích thước khung nhìn, hãy cân nhắc thêm một phần tử trên giao diện người dùng có thể nhấp hoặc di chuột qua có nhãn "Nguồn dữ liệu". Phần tử này sẽ mở ra trong cửa sổ bản đồ để cung cấp thông tin ghi nhận tác giả. Luôn cố gắng duy trì các phương pháp hay nhất về bản đồ.
Hiển thị thông tin ghi nhận tác giả dữ liệu của 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 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 nhận tác giả bắt buộc đối với nhà cung cấp dữ liệu bên thứ ba. Khi chúng tôi làm như vậy, văn bản ghi nhận tác giả của bạn phải nêu 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 nhận tác giả của bên thứ ba, việc chỉ thêm "Google Maps" hoặc biểu trưng Google không phải là cách ghi nhận tác giả đúng.
Khi sử dụng Map Tiles API để hiển thị dữ liệu của Google Maps dưới dạng bản đồ cơ sở và phủ dữ liệu không gian địa lý của bên thứ ba (không phải của Google), bạn không được chồng chéo hoặc che khuất thông tin ghi công dữ liệu trên Google bằng thông tin ghi công dữ liệu của bên thứ ba theo bất kỳ cách nào. Thông tin ghi nhận tác giả của dữ liệu bên thứ ba phải được tách biệt rõ ràng với thông tin ghi nhận tác giả của dữ liệu của Google. Ngoài ra, bạn phải thể hiện rõ ràng rằng biểu trưng của Google Maps và thông tin ghi nhận tác giả dữ liệu của Google có liên kết với bản đồ nền và liên kết với nhau.
Hiển thị biểu trưng và thông tin ghi nhận tác giả dữ liệu trong hình ảnh kết hợp
Khi sử dụng dữ liệu của 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 rằng người xem hiểu rõ phần nào của hình ảnh trực quan hoá bản đồ là của Google và phần nào là của 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 trong phần Hiển thị thông tin ghi nhận tác giả của Google Maps ở trên.
Ví dụ: hãy cân nhắc việc kết hợp Ô 3D ảnh thực tế (làm nền) với mô hình ảnh thực tế của riêng bạn (ở nền trước). Người dùng có thể nhầm lẫn về việc thành phần nào 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 ghi nhận tác giả trên giao diện người dùng hoặc luồng người dùng về phần nào của cảnh bắt nguồn từ dữ liệu của Google Maps. Bạn chịu trách nhiệm tuân thủ mọi yêu cầu về thông tin ghi công của bên thứ ba có thể áp dụng cho các nguồn dữ liệu mà bạn sử dụng cùng với dữ liệu của Google Maps.
Lớp phủ dữ liệu địa lý với Ô 3D ảnh thực tế
Bạn có thể phủ các đối tượng 3D của riêng mình lên Ô 3D ảnh thực tế, miễn là các đối tượng 3D đó không được trích xuất, truy vết hoặc lấy từ Ô 3D ảnh thực tế bằng cách thủ công hoặc bằng máy.
Tạo video có Map Tiles API
- Video được quảng bá: Bạn có thể tạo video được quảng bá theo các điều khoản của Thoả thuận và những điều sau:
- Video được quảng bá không được chứa hình ảnh trong Chế độ xem đường phố.
- Video được quảng bá phải có thời lượng không quá 30 giây.
- Video được quảng bá phải nói về các 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 là "chỉ dành cho mục đích quảng cáo" và phải tuân thủ các nguyên tắc về việc Hiển thị thông tin ghi nhận tác giả của Google Maps.
- Bạn không được bán lại video được quảng bá 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ả cá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.
Đang truy xuất thông tin về tác giả và bản quyền
Lấy thông tin ghi nhận tác giả và bản quyền từ trường copyright trong phản hồi của các lệnh gọi API sau, tuỳ thuộc vào dịch vụ bạn đang sử dụng:
Ô 2D
Ô Bản đồ đường, Vệ tinh và Địa hình
Thông tin về bản quyền và thông tin ghi nhận tác giả có trong phản hồi thông tin về khung nhìn, như trong ví dụ sau.
{
"copyright": "Map data ©2023",
"maxZoomRects": [
{
"maxZoom": 19,
"north": 90,
"south": -90,
"east": 180,
"west": -180
},
...
]
}
Ô Chế độ xem phố
Thông tin về bản quyền và thông tin ghi nhận tác giả có trong phản hồi siêu dữ liệu của Chế độ xem đường phố. Ví dụ:
{
"panoId": "rZ9KeTyhA11i0VppYNzsSg",
"lat": 37.420864219339165,
"lng": -122.08446528377291,
"imageHeight": 6656,
"imageWidth": 13312,
"tileHeight": 512,
"tileWidth": 512,
"heading": 94.35,
"tilt": 88.39652,
"roll": 1.7181772,
"imageryType": "outdoor",
"date": "2023-01",
"copyright": "© 2023 Google",
"reportProblemLink": "https://cbks0.googleapis.com/cbk?output=report&panoid=rZ9KeTyhA11i0VppYNzsSg&cb_client=api&cbp=1,0,,0,0",
…
}
Mã nhận dạng ảnh toàn cảnh (dùng để xác định riêng từng ảnh toàn cảnh trong Chế độ xem đường phố) được miễn áp dụng quy định hạn chế về việc lưu vào bộ nhớ đệm. Do đó, bạn có thể lưu trữ giá trị mã nhận dạng ảnh toàn cảnh
vô thời hạn. Giá trị mã nhận dạng ảnh 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ố.
Bạn phải hiển thị siêu liên kết reportProblemLink ở góc dưới cùng bên phải của hình ảnh và siêu liên kết này phải có văn bản liên kết, chẳng hạn như "Báo cáo vấn đề về hình ảnh này".
Ô 3D ảnh thực tế
Đối với Ô 3D ảnh thực tế, dữ liệu ghi nhận tác giả được trả về trong mỗi yêu cầu về ô.
Bạn phải tổng hợp, sắp xếp và hiển thị trên một dòng tất cả thông tin ghi nhận tác giả cho các ô được hiển thị; thường là dọc theo phần dưới cùng của bản kết xuất. Ví dụ: bạn có thể tìm thấy thông tin ghi nhận tác giả dữ liệu trong một mảnh 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ì để hiển thị thông tin ghi nhận tác giả, bạn cần bật showCreditsOnScreen trong HTML kết xuất.
// 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ị thông tin ghi nhận tác giả, bạn cần bật trường Show Credits On Screen (Hiển thị thông tin ghi nhận tác giả trên màn hình) trong World Outliner (Bảng đề cương 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ị thông tin ghi nhận tác giả, bạn cần bật trường Show Credits On Screen (Hiện thông tin ghi nhận tác giả trên màn hình) trong bảng điều khiển Inspector (Trình kiểm tra).
