Tải Xuống và Xuất Dữ Liệu

Sau khi máy đo AirGradient của bạn kết nối thành công với WiFi, thiết bị sẽ bắt đầu truyền dữ liệu chất lượng không khí theo thời gian thực đến bảng điều khiển AirGradient.

Ngoài việc xem dữ liệu trực tiếp, nền tảng còn cho phép thu thập và lưu trữ dữ liệu lịch sử. Dữ liệu lịch sử này có thể được xuất ra để phân tích sâu hơn, giúp bạn xác định các xu hướng chất lượng không khí theo thời gian và hiểu rõ hơn về điều kiện môi trường tại vị trí của bạn.

Lưu ý: Bạn có thể tham khảo bảng thuật ngữ để được hướng dẫn vì có thể có những thuật ngữ bạn chưa quen thuộc khi đọc chương này.

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

Để xuất dữ liệu từ máy đo AirGradient của bạn, hãy đảm bảo những điều sau:

• Máy đo AirGradient được kết nối WiFi và cắm điện: Máy đo của bạn phải được bật nguồn và kết nối với mạng WiFi. Điều này đảm bảo thiết bị có thể thu thập dữ liệu chất lượng không khí và truyền đến máy chủ AirGradient. Chỉ những dữ liệu được gửi đến máy chủ mới có sẵn để xuất.
• Thiết bị có kết nối Internet: Bạn sẽ cần một thiết bị có kết nối internet để xuất dữ liệu, thông qua bảng điều khiển AirGradient hoặc sử dụng API. Mặc dù điện thoại thông minh và máy tính bảng được hỗ trợ, chúng tôi khuyến nghị nên sử dụng máy tính để quản lý quy trình xuất dữ liệu một cách thoải mái và hiệu quả nhất.
• Tài khoản Bảng điều khiển AirGradient: Để xuất dữ liệu, bạn cần có tài khoản bảng điều khiển AirGradient được liên kết với máy đo mà bạn muốn xuất dữ liệu. Để tạo tài khoản, bạn sẽ cần một địa chỉ email hợp lệ.
• Chương trình đọc CSV (Nếu xuất qua CSV): Nếu bạn chọn xuất dữ liệu qua tùy chọn CSV từ bảng điều khiển, hãy đảm bảo rằng bạn có một chương trình, chẳng hạn như Excel hoặc Google Sheets, có thể đọc và xử lý tệp CSV.

2. Tùy chọn lưu trữ và xuất dữ liệu

AirGradient cung cấp sự linh hoạt trong cách bạn có thể xuất dữ liệu của mình, nhưng điều quan trọng là phải hiểu các khoảng thời gian lưu trữ dữ liệu và các tùy chọn xuất có sẵn.

• Xuất dữ liệu thô so với Dữ liệu được nhóm:
  • Dữ liệu thô: Đây là dữ liệu chưa qua xử lý ví dụ như dữ liệu được thu thập bởi máy đo của bạn. Dữ liệu thô có thể được xuất trực tiếp từ bảng điều khiển hoặc thông qua API. So với dữ liệu được nhóm, dữ liệu thô chứa nhiều thông tin hơn một chút, ví dụ như tín hiệu thô của cảm biến TVOC, chủ yếu hữu ích cho phân tích khoa học và nghiên cứu chuyên sâu, nhưng đối với hầu hết các mục đích, dữ liệu được nhóm có thể cung cấp tất cả những thông tin chi tiết cần thiết.
  • Dữ liệu được nhóm (tổng hợp): AirGradient tổng hợp dữ liệu thành các khoảng thời gian được xác định trước ( nhóm) để phân tích dễ dàng hơn. Dữ liệu được nhóm cung cấp một cái nhìn tổng quan ở cấp độ cao hơn và hữu ích khi bạn cần dữ liệu tóm tắt trong các phạm vi thời gian cụ thể, chẳng hạn như hàng giờ hoặc hàng ngày. Hãy nhớ rằng kích thước của nhóm sẽ ảnh hưởng đến kích thước tệp — các nhóm lớn hơn (ví dụ: hàng ngày) sẽ dẫn đến các tệp nhỏ hơn, trong khi các nhóm nhỏ hơn (ví dụ: hàng giờ) sẽ tạo ra các tệp lớn hơn.
• Thời gian lưu trữ dữ liệu thô: Dữ liệu thô từ máy đo của bạn chỉ khả dụng trong một thời gian giới hạn. Sau khi hết thời gian lưu trữ, sẽ không thể xuất được dữ liệu thô cũ hơn. Trong mặc định, thời gian lưu trữ là 10 ngày. Nếu bạn cần truy cập vào dữ liệu cũ hơn, vui lòng liên hệ với đội ngũ hỗ trợ của chúng tôi để yêu cầu gia hạn.
• Thời gian lưu trữ dữ liệu được nhóm: Dữ liệu được tổng hợp thành các nhóm nhỏ hơn (ví dụ: nhóm 5 phút hoặc 30 phút) có sẵn trong tối đa 150 ngày. Sau khoảng thời gian này, chỉ có thể truy cập các nhóm lớn hơn (ví dụ: 1 giờ, 1 tuần) để phân tích và xuất.

3. Tổng quan về các tùy chọn xuất dữ liệu

Có hai cách để xuất dữ liệu từ máy đo AirGradient của bạn:

1. Xuất qua Trang Xuất trên Bảng điều khiển AirGradient: Bạn có thể xuất dữ liệu trực tiếp từ bảng điều khiển AirGradient thông qua một trang xuất trực quan. Phương pháp này cung cấp một giao diện dựa trên web đơn giản và dữ liệu sẽ được xuất ở định dạng CSV.
2. Xuất qua API AirGradient: Nếu bạn muốn tự động hóa quy trình xuất hoặc cần tích hợp dữ liệu với các hệ thống bên ngoài, bạn có thể sử dụng API AirGradient. Phương pháp này cung cấp sự linh hoạt cao hơn và cho phép bạn xuất dữ liệu ở định dạng JSON, phù hợp cho các trường hợp sử dụng nâng cao và tích hợp dữ liệu.

3.1 Xuất dữ liệu qua Trang Xuất trong Bảng điều khiển AirGradient

Để xuất dữ liệu qua bảng điều khiển AirGradient, hãy làm theo các bước sau:

1. Đăng nhập vào Tài khoản AirGradient của bạn: Truy cập Bảng điều khiển AirGradient và đăng nhập bằng thông tin xác thực của bạn. Hãy chắc chắn rằng máy đo bạn muốn xuất dữ liệu đã được liên kết với tài khoản của bạn.

2. Truy cập Trang Xuất: Trong bảng điều khiển, đi đến trang Data Export (Xuất dữ liệu). Bạn sẽ tìm thấy trang này trong thực đơn điều hướng bên cạnh.
   

   

3. Chọn Vị trí và Kích thước Nhóm: Bắt đầu bằng cách chọn vị trí (máy đo) mà bạn muốn xuất dữ liệu. Cùng với việc chọn vị trí, bạn cần chọn kích thước nhóm. Nếu bạn muốn dữ liệu thô, hãy chọn tùy chọn “raw” (thô) thay vì kích thước nhóm. Đối với dữ liệu được nhóm, hãy chọn kích thước nhóm mong muốn (ví dụ: 5 phút, 10 phút).

   

4. Chọn Khoảng Ngày: Sau khi chọn vị trí và kích thước nhóm (hoặc dữ liệu thô), hãy chọn khoảng ngày mà bạn muốn xuất dữ liệu. Bạn có thể chọn một khoảng tùy chỉnh dựa trên nhu cầu của mình.
   

   

5. Xuất Dữ liệu: Sau khi đã thực hiện các lựa chọn của mình, hãy nhấp vào nút “Download” để tạo và tải xuống tệp dữ liệu. Dữ liệu của bạn sẽ được chuẩn bị ở định dạng CSV và quá trình tải xuống sẽ tự động bắt đầu.
   

   

6. Mở Tệp CSV: Để xem dữ liệu đã xuất, bạn có thể mở tệp trong Google Sheets hoặc bất kỳ chương trình bảng tính nào khác như OpenOffice:

• Trong Google Sheets, truy cập Google Sheets, tạo một trang tính mới và nhập tệp CSV bằng cách chọn “File” (Tệp) → “Import” (Nhập) → “Upload” (Tải lên).
• Sau khi tệp được tải lên, dữ liệu sẽ được hiển thị thành các cột với các thông số chất lượng không khí và dấu thời gian. Sử dụng bảng tra cứu nhanh này để biết ý nghĩa của các thông số (trên tiêu đề cột)!

3.2 Xuất dữ liệu qua API AirGradient

Ngoài ra, AirGradient cung cấp một API công khai để xuất dữ liệu theo chương trình. Để xuất dữ liệu bằng API, hãy làm theo các bước sau:

1. Lấy Mã Token API: Trong bảng điều khiển AirGradient của bạn, chuyển đến trang General Settings (Cài đặt chung) trong thẻ Connectivity (Kết nối). Kích hoạt quyền truy cập API, và sau khi thành công, bạn sẽ nhận được một mã token API duy nhất.
   

   

2. Khám phá các Điểm cuối API Công khai: Bạn có thể tìm thấy tất cả các điểm cuối API công khai có sẵn trong Swagger Documentation. Trang này cho phép bạn thử các điểm cuối cần thiết và cung cấp mô tả cho từng điểm, bao gồm cả các tham số yêu cầu.
   

   

3. Xác định ID Vị trí: Một số điểm cuối yêu cầu ID vị trí. Đó là ID duy nhất của vị trí mà máy đo của bạn được liên kết. Đây không phải là tên của vị trí. Để tìm ID này, hãy truy cập trang Locations Administration (Quản trị Vị trí) trên bảng điều khiển của bạn. Trong bảng tất cả các vị trí, xác định vị trí mong muốn, và ID vị trí sẽ được hiển thị ở cột đầu tiên.
   

   

4. Thêm vào Mã Token API và ID Vị trí của bạn: Khi thực hiện một yêu cầu, hãy thêm cả mã token API và ID vị trí (nếu có) mà bạn đã truy xuất từ bảng điều khiển của mình vào các trường liên quan.

   

5. Nhận và Sử dụng Dữ liệu: API sẽ trả về dữ liệu ở định dạng JSON. Sau khi nhận được dữ liệu, bạn có thể tích hợp vào hệ thống của mình hoặc sử dụng nó để phân tích thêm.

4. Độ Chính Xác Của Dữ Liệu và Thuật Toán Hiệu Chỉnh

AirGradient đã phát triển các thuật toán hiệu chỉnh cho các thông số chất lượng không khí khác nhau để nâng cao độ chính xác của các phép đo được hiển thị trên bảng điều khiển.

Nếu bạn đang sử dụng dữ liệu đã xuất để phân tích hoặc báo cáo thêm, hãy nhớ rằng có hai cột dữ liệu PM_2.5: thô (chưa hiệu chỉnh) và đã hiệu chỉnh. Dữ liệu thô có thể khác với những gì được hiển thị trên bảng điều khiển do các hiệu chỉnh này. Các công thức hiệu chỉnh được công khai trên trang web AirGradient (xem liên kết bên dưới).

Để biết thêm chi tiết về các thuật toán hiệu chỉnh của chúng tôi và cách chúng cải thiện độ chính xác của dữ liệu, vui lòng truy cập Tài liệu Thuật toán Hiệu chỉnh.

5. Câu hỏi thường gặp (FAQs)

AirGradient có giới hạn quyền truy cập vào dữ liệu từ máy đo của tôi không?

Không, AirGradient áp dụng phương pháp tiếp cận dữ liệu mở, đảm bảo bạn có toàn quyền truy cập vào tất cả dữ liệu do máy đo của bạn thu thập. Bạn có thể xem, xuất và phân tích cả dữ liệu thời gian thực và dữ liệu lịch sử mà không bị hạn chế.
Lưu ý rằng dữ liệu thô chỉ có sẵn để xuất cho đến khi kết thúc thời gian lưu trữ. Tuy nhiên, dữ liệu được nhóm vẫn có sẵn.

Sự khác biệt giữa dữ liệu thô và dữ liệu được nhóm là gì?

Dữ liệu thô là dữ liệu chưa qua xử lý được thu thập trực tiếp từ máy đo của bạn, trong khi dữ liệu được nhóm được tổng hợp thành các khoảng thời gian (ví dụ: 5 phút, 10 phút) để phân tích dễ dàng hơn. So với dữ liệu được nhóm, dữ liệu thô chứa nhiều thông tin hơn một chút, ví dụ như tín hiệu thô của cảm biến TVOC, chủ yếu hữu ích cho phân tích khoa học và nghiên cứu chuyên sâu, nhưng đối với hầu hết các mục đích, dữ liệu được nhóm vẫn cung cấp tất cả những thông tin chi tiết cần thiết. Bạn có thể chọn một trong hai định dạng khi xuất dữ liệu của mình, nhưng dữ liệu thô chỉ có sẵn để xuất cho đến khi kết thúc thời gian lưu trữ.

Dữ liệu thô có sẵn để xuất trong bao lâu?

Trong mặc định, dữ liệu thô có sẵn trong 10 ngày. Sau khoảng thời gian này, sẽ không thể xuất được dữ liệu thô cũ hơn. Nếu cần thời gian lưu trữ dài hơn, bạn có thể liên hệ với đội ngũ hỗ trợ của chúng tôi để yêu cầu gia hạn.

Thời gian lưu trữ cho dữ liệu được nhóm là bao lâu?

Dữ liệu được nhóm với các khoảng thời gian nhỏ hơn (ví dụ: nhóm 5 phút hoặc 30 phút) được lưu giữ trong tối đa 150 ngày. Sau đó, chỉ các nhóm lớn hơn (ví dụ: 1 giờ, 1 tuần) mới vẫn có sẵn để phân tích và xuất.

Làm cách nào để tôi có thể kéo dài thời gian lưu trữ cho dữ liệu thô?

Nếu bạn cần lưu giữ dữ liệu thô lâu hơn 10 ngày mặc định, vui lòng liên hệ với đội ngũ hỗ trợ của chúng tôi. Họ có thể hỗ trợ bạn kéo dài thời gian lưu trữ theo nhu cầu.

Tôi có thể xuất dữ liệu bằng điện thoại thông minh hoặc máy tính bảng không?

Có, bạn có thể xuất dữ liệu bằng điện thoại thông minh hoặc máy tính bảng. Tuy nhiên, để có trải nghiệm thoải mái và hiệu quả hơn, đặc biệt khi quản lý các bộ dữ liệu lớn hơn, chúng tôi khuyến nghị nên sử dụng máy tính. Ngoài ra, bạn có thể cần các ứng dụng cụ thể như Google Sheets hoặc Excel để mở và tác vụ với các tệp CSV đã xuất trên thiết bị di động.

Tại sao tôi gặp lỗi 404 khi cố gắng xuất dữ liệu?

Nếu bạn gặp lỗi 404 khi cố gắng xuất dữ liệu, có thể là do không có dữ liệu nào cho khoảng thời gian đã chọn. Điều này có thể xảy ra nếu khoảng ngày đã chọn nằm ngoài thời gian lưu trữ cho dữ liệu thô hoặc nếu không có dữ liệu nào được ghi lại trong thời gian đó.

Bạn có thể kiểm tra xem khoảng thời gian đã chọn có chứa dữ liệu hay không bằng cách trực quan hóa nó trên Bảng điều khiển. Để kiểm tra xem thời gian lưu trữ có phải là nguyên nhân gây ra sự cố hay không, hãy thử tải xuống khoảng thời gian đã chọn với kích thước nhóm lớn hơn.

Tôi cần chương trình nào để mở tệp CSV?

Tệp CSV có thể được mở trong các chương trình như Excel, Google Sheets, Open Office hoặc bất kỳ ứng dụng bảng tính nào. Một số chương trình có thể được sử dụng trực tuyến, trong khi những chương trình khác dùng trên máy tính để bàn và cần được cài đặt trước.

Tôi có thể tìm tài liệu API và các điểm cuối ở đâu?

Tất cả các điểm cuối API có sẵn đều có thể được tìm thấy trong AirGradient Swagger Documentation, nơi bạn có thể khám phá và thử nghiệm các điểm cuối này.

Làm cách nào để lấy ID vị trí cho các yêu cầu API?

Để tìm ID Vị trí, hãy vào trang Locations Administration (Quản trị Vị trí) trong bảng điều khiển của bạn. ID Vị trí được hiển thị ở cột đầu tiên của bảng liệt kê tất cả các vị trí của bạn.

Làm cách nào để lấy mã token API cho API AirGradient?

Để lấy mã token API, bạn cần kích hoạt quyền truy cập API trên trang General Settings (Cài đặt chung) của bảng điều khiển AirGradient trong thẻ Connectivity (Kết nối). Sau khi được kích hoạt, bạn sẽ nhận được một mã token API duy nhất có thể dùng để thực hiện các yêu cầu API.

Tôi có cần kích hoạt lại quyền truy cập API mỗi lần không?

Không, sau khi quyền truy cập API được kích hoạt và có mã token API của mình, bạn có thể sử dụng nó cho các yêu cầu API trong tương lai mà không cần kích hoạt lại.

Dữ liệu đã xuất có được hiệu chỉnh không?

Không, dữ liệu được xuất ở định dạng CSV hoặc qua API ở định dạng JSON không bao gồm các hiệu chỉnh được áp dụng cho các phép đo PM, độ ẩm tương đối và nhiệt độ trên bảng điều khiển của bạn. Dữ liệu xuất ra là dạng thô. Để biết thêm thông tin về các thuật toán hiệu chỉnh, vui lòng truy cập Tài liệu Thuật toán Hiệu chỉnh.

Developed by AirGradient in Collaboration with the UNDP Global Centre Singapore CC-BY-SA