Tạo và quản lý tập dữ liệu

Các tập dữ liệu cho phép bạn tải dữ liệu không gian địa lý lên từ một tệp cục bộ hoặc từ Google Cloud Storage lên Nền tảng Google Maps. Sau đó, bạn có thể liên kết một tập dữ liệu với một hoặc nhiều kiểu bản đồ trong Cloud Console. Sau khi liên kết tập dữ liệu với kiểu bản đồ, hãy sử dụng API định kiểu dựa trên dữ liệu để tự động tạo kiểu cho ứng dụng bản đồ.

Bạn cũng có thể sử dụng API REST để tải dữ liệu không gian địa lý lên tập dữ liệu. Để biết thêm thông tin, hãy xem API Tập dữ liệu Maps

Định cấu hình vai trò

Để tạo và quản lý các tập dữ liệu trong một dự án trên Google Cloud, bạn phải có vai trò IAM của Chủ sở hữu hoặc Người chỉnh sửa đối với dự án.

Lưu ý: Nếu đã tạo dự án, thì bạn sẽ có vai trò Chủ sở hữu đối với dự án. Trang IAM của Google Cloud Console cho thấy chủ sở hữu và người chỉnh sửa dự án.

Ngoài ra, bạn có thể chỉ định các vai trò IAM sau đây cho một tài khoản người dùng hoặc tài khoản dịch vụ mà bạn dùng để quản lý tập dữ liệu:

• Vai trò Maps Platform Datasets Admin cấp cho người dùng hoặc tài khoản dịch vụ quyền đọc/ghi vào các tập dữ liệu trong dự án. Vai trò này cho phép người dùng thực hiện tất cả các thao tác trên một tập dữ liệu.
• Vai trò Maps Platform Datasets Viewer cấp quyền chỉ có thể đọc đối với các tập dữ liệu trong dự án. Vai trò này cho phép bạn thực hiện thao tác danh sách, nhận hoặc tải xuống đối với một tập dữ liệu.

Để biết thêm thông tin, hãy xem bài viết Cấp vai trò IAM bằng bảng điều khiển Google Cloud.

Nguồn dữ liệu cho một tập dữ liệu

Sau khi bạn tạo một tập dữ liệu, hãy tải dữ liệu lên tập dữ liệu từ Google Cloud Storage hoặc từ một tệp cục bộ.

• Khi tải dữ liệu lên từ Cloud Storage, hãy chỉ định đường dẫn tệp đến tài nguyên chứa dữ liệu trong Cloud Storage. Đường dẫn này có dạng gs://GCS_BUCKET/FILE.

  Người dùng đưa ra yêu cầu này cần có vai trò Storage Object Viewer (Người xem đối tượng lưu trữ) hoặc bất kỳ vai trò nào khác có quyền storage.objects.get. Để biết thêm thông tin về cách quản lý quyền truy cập vào Cloud Storage, hãy xem bài viết Tổng quan về chế độ kiểm soát quyền truy cập.

• Khi tải dữ liệu lên từ một tệp cục bộ, hãy chỉ định đường dẫn đến tệp GeoJSON, KML hoặc CSV chứa dữ liệu cần tải lên.

Điều kiện tiên quyết

Khi tạo tập dữ liệu:

• Tên hiển thị phải là duy nhất trong dự án trên Google Cloud.
• Tên hiển thị phải dưới 64 byte (Vì các ký tự này được biểu thị bằng UTF-8, nên trong một số ngôn ngữ, mỗi ký tự có thể được biểu thị bằng nhiều byte).
• Nội dung mô tả phải dưới 1000 byte.

Khi tải dữ liệu lên:

• Các loại tệp được hỗ trợ là CSV, GeoJSON và KML.
• Kích thước tệp tối đa được hỗ trợ là 350 MB.
• Tên cột thuộc tính không được bắt đầu bằng chuỗi "?_".
• Hình học ba chiều không được hỗ trợ. Trong đó bao gồm hậu tố "Z" ở định dạng WKT và toạ độ cao độ ở định dạng GeoJSON.

Lưu ý: Tuỳ thuộc vào kích thước của tệp dữ liệu, quá trình tải lên có thể mất vài phút hoặc thậm chí nhiều giờ để hoàn tất. Nếu xảy ra lỗi khi tải lên, bạn sẽ nhận được thông báo lỗi. Đừng tìm cách xoá tập dữ liệu cho đến khi tập dữ liệu đó trả về phản hồi từ thao tác tải lên.

Lưu ý: Các ô bản đồ được tạo bằng dữ liệu được tải lên bằng API Tập dữ liệu Maps có thể làm giảm hoặc đơn giản hoá dữ liệu dày đặc hoặc phức tạp ở mức thu phóng thấp. Ví dụ: khi người dùng thu nhỏ một tiểu bang hoặc quốc gia (ví dụ: mức thu phóng 5-12), dữ liệu dạng ô có thể trông khác so với khi phóng to một thành phố hoặc vùng lân cận (ví dụ: mức thu phóng 13-18). Điều này xảy ra để giữ cho thẻ thông tin gọn gàng và hoạt động hiệu quả bằng cách sử dụng thẻ thông tin với trình kết xuất bản đồ.

Mẹo: Nếu tệp dữ liệu của bạn lớn và có nhiều thuộc tính không cần để định kiểu và bạn muốn tối ưu hoá hiệu suất kết xuất, hãy chỉnh sửa tệp để xoá các thuộc tính không cần thiết. Việc giảm số lượng thuộc tính cũng làm giảm kích thước của các ô trên bản đồ, từ đó cải thiện hiệu suất kết xuất.

Các phương pháp hay nhất về chuẩn bị dữ liệu

Nếu dữ liệu nguồn của bạn phức tạp hoặc lớn, chẳng hạn như các điểm dày đặc, chuỗi đường dài hoặc đa giác (thường có kích thước tệp nguồn lớn hơn 50 MB thuộc danh mục này), hãy cân nhắc đơn giản hoá dữ liệu trước khi tải lên để đạt được hiệu suất tốt nhất trong bản đồ trực quan.

Dưới đây là một số phương pháp hay nhất để chuẩn bị dữ liệu của bạn:

1. Giảm thiểu các thuộc tính tính năng. Chỉ giữ lại các thuộc tính đối tượng cần thiết để tạo kiểu cho bản đồ của bạn, ví dụ: "id" và "category". Bạn có thể kết hợp các thuộc tính bổ sung với một tính năng trong ứng dụng khách bằng cách sử dụng kiểu dựa trên dữ liệu trên khoá giá trị nhận dạng duy nhất. Ví dụ: xem phần Xem dữ liệu của bạn theo thời gian thực bằng Định kiểu dựa trên dữ liệu.
2. Sử dụng kiểu dữ liệu đơn giản cho các đối tượng thuộc tính nếu có thể (chẳng hạn như số nguyên) để giảm thiểu kích thước thẻ thông tin và cải thiện hiệu suất của bản đồ.
3. Đơn giản hoá hình học phức tạp trước khi tải tệp lên. Bạn có thể thực hiện việc này bằng một công cụ không gian địa lý mà bạn chọn, chẳng hạn như tiện ích nguồn mở Mapshaper.org hoặc trong BigQuery bằng cách sử dụng ST_Simplify trên các hình đa giác phức tạp.
4. Cụm các điểm rất dày đặc trước khi tải tệp lên. Bạn có thể thực hiện việc này trong một công cụ không gian địa lý mà bạn chọn, chẳng hạn như các hàm cụm turf.js nguồn mở hoặc trong BigQuery bằng cách sử dụng ST_CLUSTERDBSCAN trên các hình học điểm dày đặc.

Xem thêm hướng dẫn về các phương pháp hay nhất về tập dữ liệu trong bài viết Trực quan hoá dữ liệu của bạn bằng Tập dữ liệu và BigQuery.

Yêu cầu đối với GeoJSON

SDK Maps dành cho iOS hỗ trợ thông số kỹ thuật GeoJSON hiện tại. SDK Maps dành cho iOS cũng hỗ trợ các tệp GeoJSON chứa bất kỳ loại đối tượng nào sau đây:

• Đối tượng hình học. Đối tượng hình học là một hình dạng không gian, được mô tả là một sự kết hợp giữa các điểm, đường kẻ và đa giác có các lỗ tuỳ chọn.
• Đối tượng làm nổi bật. Đối tượng tính năng chứa một hình học cùng với các cặp tên/giá trị bổ sung, có ý nghĩa dành riêng cho ứng dụng.
• Bộ sưu tập tính năng. Bộ sưu tập đối tượng là một tập hợp các đối tượng đối tượng.

SDK Maps dành cho iOS không hỗ trợ các tệp GeoJSON có dữ liệu trong hệ thống tham chiếu toạ độ (CRS) khác với WGS84.

Để biết thêm thông tin về GeoJSON, hãy xem Tuân thủ RFC 7946.

Yêu cầu về KML

SDK bản đồ dành cho iOS có các yêu cầu sau:

• Tất cả URL phải là URL cục bộ (hoặc có liên quan) đến chính tệp đó.
• Hình học điểm, đường và đa giác được hỗ trợ.
• Tất cả các thuộc tính dữ liệu đều được coi là chuỗi.

Các tính năng KML sau đây không được hỗ trợ:

• Biểu tượng hoặc <styleUrl> được xác định bên ngoài tệp.
• Đường liên kết mạng, chẳng hạn như <NetworkLink>
• Lớp phủ mặt đất, chẳng hạn như <GroundOverlay>
• Hình học 3D hoặc bất kỳ thẻ nào liên quan đến độ cao, chẳng hạn như <altitudeMode>
• Các thông số kỹ thuật của camera, chẳng hạn như <LookAt>
• Kiểu được xác định bên trong tệp KML.

Yêu cầu về tệp CSV

Đối với tệp CSV, các tên cột được hỗ trợ được liệt kê theo thứ tự ưu tiên dưới đây:

• latitude, longitude
• lat, long
• x, y
• wkt (Văn bản quen thuộc)
• address, city, state, zip
• address
• Một cột duy nhất chứa tất cả thông tin địa chỉ, chẳng hạn như 1600 Amphitheatre Parkway Mountain View, CA 94043

Ví dụ: tệp của bạn chứa các cột có tên x, y và wkt. Vì x và y có mức độ ưu tiên cao hơn, như được xác định theo thứ tự của các tên cột được hỗ trợ trong danh sách ở trên, nên các giá trị trong cột x và y sẽ được sử dụng và cột wkt sẽ bị bỏ qua.

Ngoài ra:

• Tên mỗi cột phải thuộc về một cột duy nhất. Điều đó nghĩa là bạn không thể có một cột tên là xy chứa cả dữ liệu toạ độ x và y. Các toạ độ x và y phải nằm trong các cột riêng biệt.
• Tên cột không phân biệt chữ hoa chữ thường.
• Thứ tự của các tên cột không quan trọng. Ví dụ: nếu tệp CSV của bạn chứa các cột lat và long, các cột này có thể xuất hiện theo thứ tự bất kỳ.

Xử lý lỗi tải dữ liệu lên

Khi tải dữ liệu lên một tập dữ liệu, bạn có thể gặp một trong các lỗi phổ biến được mô tả trong phần này.

Lỗi GeoJSON

Các lỗi GeoJSON thường gặp bao gồm:

• Thiếu trường type hoặc type không phải là một chuỗi. Tệp dữ liệu GeoJSON đã tải lên phải chứa một trường chuỗi có tên type trong mỗi đối tượng Feature và định nghĩa đối tượng Hình học.

Lỗi KML

Các lỗi KML thường gặp bao gồm:

• Tệp dữ liệu không được chứa bất kỳ tính năng KML nào không được hỗ trợ nêu trên, nếu không, quá trình nhập dữ liệu có thể không thành công.

Lỗi CSV

Các lỗi thường gặp về tệp CSV bao gồm:

• Một số hàng thiếu giá trị cho một cột hình học. Tất cả các hàng trong tệp CSV phải chứa giá trị không được để trống cho các cột hình học. Các cột hình học bao gồm:
  • latitude, longitude
  • lat, long
  • x, y
  • wkt
  • address, city, state, zip
  • address
  • Một cột duy nhất chứa tất cả thông tin địa chỉ, chẳng hạn như 1600 Amphitheatre Parkway Mountain View, CA 94043
  Lưu ý: Lỗi này thường được mô tả bằng một thông báo ở dạng "Không thể chuyển đổi ' ' thành đối tượng kép" hoặc "Không thể phân tích cú pháp mục nhập theo vị trí địa lý.: Thiếu giá trị địa lý".
• Nếu x và y là các cột hình học, hãy đảm bảo rằng các đơn vị là kinh độ và vĩ độ. Một số tập dữ liệu công khai sử dụng các hệ toạ độ khác nhau trong các tiêu đề x và y. Nếu bạn sử dụng sai đơn vị, thì tập dữ liệu có thể được nhập thành công nhưng dữ liệu được hiển thị có thể cho thấy các điểm trong tập dữ liệu ở vị trí không mong muốn.

Tạo tập dữ liệu

Cách tạo tập dữ liệu:

1. Trong Google Cloud Console, hãy chuyển đến trang Tập dữ liệu.
2. Nhấp vào Tạo tập dữ liệu.
3. Nhập tên tập dữ liệu. Tên không được trùng lặp trong tất cả các tập dữ liệu.
4. Nhập Mô tả tập dữ liệu (không bắt buộc).
5. Nhấp vào Tiếp tục. Trang Nhập dữ liệu xuất hiện.
6. Chọn Tải nguồn lên của dữ liệu dùng để điền vào tập dữ liệu dưới dạng Máy tính, nghĩa là một tệp cục bộ trên hệ thống của bạn, hoặc bộ chứa Google Cloud Storage.
   • Đối với Máy tính, hãy nhấp vào Browse (Duyệt qua) rồi chọn tệp trong trình chọn tệp.
   • Đối với bộ chứa Google Cloud Storage, hãy nhấp vào Browse (Duyệt qua) rồi chọn bộ chứa và tệp chứa dữ liệu.
7. Chọn Định dạng tệp.
8. Nhấp vào Tiếp tục để xem lại các chế độ cài đặt của bạn.
9. Nhấp vào Tạo. Trang Tập dữ liệu sẽ xuất hiện và cho thấy tập dữ liệu mới của bạn. Trạng thái sẽ là Đang xử lý.
10. Chờ cho đến khi tập dữ liệu có trạng thái Đã hoàn tất.

Xem hoặc sửa đổi tập dữ liệu

Sau khi bạn tạo thành công một tập dữ liệu, tập dữ liệu đó sẽ có trạng thái là Đã hoàn tất. Sau đó, bạn có thể kiểm tra thông tin chi tiết của tập dữ liệu.

Cách xem hoặc sửa đổi tập dữ liệu:

1. Trong Google Cloud Console, hãy chuyển đến trang Tập dữ liệu.
2. Nhấp vào tên của tập dữ liệu. Trang Thông tin chi tiết về tập dữ liệu sẽ xuất hiện.
   1. Nhấp vào thẻ Chi tiết để xem thông tin về tập dữ liệu. Trên thẻ này, bạn cũng có thể chỉnh sửa tên và nội dung mô tả tập dữ liệu.
   2. Nhấp vào thẻ Xem trước để xem tập dữ liệu của bạn trên bản đồ.
   3. Nhấp vào tab Dữ liệu bảng để xem tất cả các thuộc tính của tập dữ liệu. Đây là các thuộc tính mà bạn có thể sử dụng để tạo kiểu cho tập dữ liệu trên bản đồ.
   4. Nhấp vào nút Download (Tải xuống) để tải dữ liệu xuống tệp cục bộ.
   5. Nhấp vào nút Delete (Xoá) để xoá tập dữ liệu.

   6. Nhấp vào nút Nhập tệp dữ liệu để tải dữ liệu mới lên tập dữ liệu.

      Khi bạn tải dữ liệu mới lên tập dữ liệu, hệ thống sẽ tạo một phiên bản mới của tập dữ liệu đó. Nếu dữ liệu mới được tải lên thành công:

      • Trạng thái của phiên bản mới của tập dữ liệu được đặt thành COMPLETED (ĐÃ HOÀN TẤT).
      • Phiên bản mới sẽ trở thành phiên bản "đang hoạt động" và là phiên bản mà ứng dụng của bạn sử dụng.

      Nếu có lỗi trong quá trình tải lên:

      • Trạng thái của phiên bản tập dữ liệu mới được đặt thành một trạng thái khác với trạng thái COMPLETED (ĐÃ HOÀN TẤT). Ví dụ: nếu có một phiên bản "đang hoạt động" trước đó, thì trạng thái của tập dữ liệu sẽ được đặt thành REVERTED.
      • Phiên bản tập dữ liệu "đang hoạt động" trước đây vẫn là phiên bản "đang hoạt động" và là phiên bản mà ứng dụng của bạn sử dụng.