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.
Lưu trữ, lưu vào bộ nhớ đệm và trích xuất dữ liệu
Khi sử dụng Nội dung trên Google Maps trong ứng dụng, hãy tuân thủ các yêu cầu về việc xử lý dữ liệu trong Mục 3.2.3 của Điều khoản dịch vụ của Google Maps Platform và Điều khoản dành riêng cho dịch vụ của Google Maps Platform:
- Các quy định hạn chế về việc lưu vào bộ nhớ đệm và trích xuất dữ liệu (Mục 3.2.3(a) và (b)): Chỉ lưu vào bộ nhớ đệm hoặc lưu trữ Nội dung trên Google Maps theo đúng quy định trong Điều khoản dành riêng cho dịch vụ của Google Maps Platform. Không xuất, trích xuất hoặc thu thập Nội dung trên Google Maps để sử dụng bên ngoài Dịch vụ. Ví dụ: không tìm nạp trước, lập chỉ mục, lưu trữ hoặc phân phối lại Nội dung trên Google Maps bên ngoài Dịch vụ; tải xuống hàng loạt ô bản đồ, hình ảnh trong Chế độ xem đường phố, mã địa lý, thông tin đường đi, kết quả ma trận khoảng cách, thông tin về đường, thông tin về địa điểm, giá trị độ cao hoặc thông tin chi tiết về múi giờ; hoặc sao chép và lưu tên doanh nghiệp, địa chỉ hoặc bài đánh giá của người dùng.
- Các giới hạn nội dung phái sinh (Mục 3.2.3(c)): Sử dụng Nội dung trên Google Maps trong ứng dụng của bạn theo quy định trong Điều khoản dịch vụ của Google Maps Platform. Không tạo nội dung dựa trên Nội dung của Google Maps. Ví dụ: không theo dõi hoặc số hoá các đối tượng từ hình ảnh vệ tinh, xây dựng mô hình 3D hoặc mô hình địa hình, sử dụng giá trị vĩ độ và kinh độ của Địa điểm làm dữ liệu đầu vào cho hoạt động phân tích điểm trong đa giác, xây dựng chỉ mục vị trí từ hình ảnh trong Chế độ xem đường phố hoặc chuyển đổi thời gian lái xe dựa trên văn bản thành lời nói tổng hợp.
Để giảm độ trễ và chi phí được lập hoá đơn mà không cần lưu dữ liệu bị hạn chế vào bộ nhớ đệm, hãy sử dụng mặt nạ trường hoặc danh sách trường để chỉ yêu cầu những trường mà giao diện người dùng của bạn cần. Lưu trữ các giá trị nhận dạng được miễn trừ, chẳng hạn như mã địa điểm, để tìm nạp thông tin chi tiết mới khi người dùng tương tác với một địa điểm.
Các kỹ sư hỗ trợ kỹ thuật của Google không thể tư vấn pháp lý hoặc đưa ra ngoại lệ đối với Điều khoản dịch vụ của Google Maps Platform. Hãy tham khảo ý kiến của cố vấn pháp lý để xác định xem việc triển khai của bạn có tuân thủ các điều khoản hay không, hoặc liên hệ với Nhóm bán hàng nếu trường hợp sử dụng của bạn yêu cầu cấp phép tuỳ chỉnh.
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 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 dành 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
- 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 phải tuân thủ các điều khoản dịch vụ sau đây:
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: 16 dp
- 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 ghi nhận tác giả dữ liệu của Google
Dữ liệu do Map Tiles API trả về 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 hoặc yêu cầu thông tin khung nhìn thích hợp. 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 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 quy định.
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. 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 đồ cơ sở và 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 tuân thủ 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 các 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ý có Ô 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ế theo cách thủ công hoặc bằng máy.
Tạo video bằng 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 chức năng của (các) ứng dụng của bạn.
- Video quảng bá phải được đánh dấu rõ ràng là "chỉ dành cho mục đích quảng bá" và phải tuân thủ nguyên tắ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 có nội dung 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ả các thuộc tính 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ị 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).
