Package google.maps.pollen.v1

Chỉ mục

Phấn hoa

Định nghĩa dịch vụ cho API Phấn hoa.

LookupForecast

rpc LookupForecast(LookupForecastRequest) returns (LookupForecastResponse)

Trả về thông tin phấn hoa hằng ngày trong tối đa 5 ngày tại hơn 65 quốc gia, độ phân giải lên tới 1km.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/cloud-platform

Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.
LookupHeatmapTile

rpc LookupHeatmapTile(LookupHeatmapTileRequest) returns (HttpBody)

Trả về một mảng byte chứa dữ liệu của hình ảnh thẻ thông tin PNG.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/cloud-platform

Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.

Chỉ mục

Mã chỉ mục

Enum
INDEX_UNSPECIFIED Chỉ mục không xác định.
UPI Chỉ số phấn hoa toàn cầu.

IndexInfo

Đối tượng này chứa dữ liệu đại diện cho giá trị, danh mục và nội dung mô tả cụ thể của chỉ số phấn hoa.

Trường
code

Index

Mã của chỉ mục. Trường này biểu thị chỉ mục cho mục đích lập trình bằng cách sử dụng trường hợp rắn thay vì dấu cách. Ví dụ: "UPI".
display_name

string

Biểu thị tên chỉ mục mà con người có thể đọc được. Ví dụ: "Universal Phấn hoa Chỉ số".
category

string

Phân loại văn bản của diễn giải điểm số của chỉ mục. Chỉ mục này bao gồm 6 danh mục:

  • 0: "Không có"
  • 1: "Rất thấp"
  • 2: "Thấp"
  • 3: "Trung bình"
  • 4: "Cao"
  • 5: "Rất cao
index_description

string

Nội dung giải thích bằng văn bản về cấp chỉ mục hiện tại.
color

Color

Màu dùng để biểu thị điểm số của Chỉ mục phấn hoa.
value

int32

Điểm số của chỉ mục. Phạm vi số nằm trong khoảng từ 0 đến 5.

LookupForecastRequest

Trường
location

LatLng

Bắt buộc. Kinh độ và vĩ độ mà API dùng để tìm dữ liệu dự báo phấn hoa.
days

int32

Bắt buộc. Một con số cho biết số ngày dự đoán cần yêu cầu (giá trị tối thiểu là 1, giá trị tối đa là 5).
page_size

int32

Không bắt buộc. Số lượng bản ghi thông tin hằng ngày tối đa có thể trả lại trên mỗi trang. Giá trị mặc định và giá trị tối đa là 5, cho biết dữ liệu trong 5 ngày.
page_token

string

Không bắt buộc. Mã thông báo trang đã nhận được từ một cuộc gọi hằng ngày trước đó. Hàm này được dùng để truy xuất trang tiếp theo.

Xin lưu ý rằng khi cung cấp giá trị cho mã thông báo trang, tất cả các thông số yêu cầu khác được cung cấp phải khớp với lệnh gọi trước đó đã cung cấp mã thông báo trang.
language_code

string

Không bắt buộc. Cho phép khách hàng chọn ngôn ngữ cho câu trả lời. Nếu không thể cung cấp dữ liệu cho ngôn ngữ đó, API sẽ sử dụng kết quả phù hợp nhất. Các giá trị được phép dựa trên tiêu chuẩn BCP-47 của IETF. Giá trị mặc định là "en".
plants_description

bool

Không bắt buộc. Chứa thông tin chung về thực vật, bao gồm cả thông tin chi tiết về mùa vụ, hình dạng và màu sắc đặc biệt, thông tin về các phản ứng chéo gây dị ứng và ảnh thực vật. Giá trị mặc định là "true".

LookupForecastResponse

Trường
region_code

string

Mã ISO_3166-1 alpha-2 của quốc gia/khu vực tương ứng với vị trí được cung cấp trong yêu cầu. Trường này có thể bị bỏ qua trong phản hồi nếu vị trí được cung cấp trong yêu cầu nằm ở lãnh thổ tranh chấp.
daily_info[]

DayInfo

Bắt buộc. Đối tượng này chứa thông tin dự báo hằng ngày cho mỗi ngày được yêu cầu.
next_page_token

string

Không bắt buộc. Mã thông báo để truy xuất trang tiếp theo.

DayInfo

Đối tượng này chứa thông tin dự báo hằng ngày cho mỗi ngày được yêu cầu.

Trường
date

Date

Ngày theo giờ UTC mà dữ liệu dự báo phấn hoa được trình bày.
pollen_type_info[]

PollenTypeInfo

Danh sách này sẽ bao gồm tối đa 3 loại phấn hoa (GRASS, WEED, TREE) có ảnh hưởng đến vị trí được chỉ định trong yêu cầu.
plant_info[]

PlantInfo

Danh sách này sẽ bao gồm tối đa 15 loài phấn hoa ảnh hưởng đến vị trí đã chỉ định trong yêu cầu.

LookupHeatmapTileRequest

Yêu cầu thẻ thông tin bản đồ nhiệt. Cấu trúc này tuân thủ lệnh gọi GET của máy chủ thẻ thông tin tiêu chuẩn, tức là https://pollen.googleapis.com/v1/mapTypes/{map_type}/heatmapTiles/{zoom}/{x}/{y}

Ví dụ: [https://pollen.googleapis.com/v1/mapTypes/TREE_UPI/heatmapTiles/0/0/0]

Trường
map_type

MapType

Bắt buộc. Loại bản đồ nhiệt phấn hoa. Xác định tổ hợp loại phấn hoa và chỉ số mà bản đồ sẽ thể hiện dưới dạng đồ hoạ.
zoom

int32

Bắt buộc. Mức thu phóng của bản đồ. Xác định độ lớn hoặc nhỏ của nội dung bản đồ xuất hiện trong chế độ xem bản đồ.

  • Thu phóng mức 0 là toàn bộ thế giới trong một ô duy nhất.
  • Thu phóng cấp độ 1 là toàn bộ thế giới trong 4 ô.
  • Thu phóng cấp độ 2 là toàn bộ thế giới trong 16 ô.
  • Thu phóng cấp độ 16 là toàn bộ thế giới với 65.536 ô.

Giá trị được phép: 0-16
x

int32

Bắt buộc. Xác định điểm đông tây trong ô được yêu cầu.
y

int32

Bắt buộc. Xác định điểm từ Bắc đến Nam trong thẻ thông tin được yêu cầu.

MapType

Loại bản đồ nhiệt phấn hoa. Xác định tổ hợp loại phấn hoa và chỉ số mà bản đồ sẽ thể hiện bằng đồ hoạ.

Enum
MAP_TYPE_UNSPECIFIED Loại bản đồ không xác định.
TREE_UPI Loại bản đồ nhiệt sẽ đại diện cho một bản đồ biểu đồ chỉ số cây.
GRASS_UPI Loại bản đồ nhiệt sẽ đại diện cho một bản đồ biểu đồ chỉ số cỏ.
WEED_UPI Loại bản đồ nhiệt sẽ đại diện cho một bản đồ biểu đồ chỉ số cỏ dại.

Thực vật

Liệt kê các nhà máy hiện có với phạm vi cung cấp khác nhau giữa các địa điểm.

Enum
PLANT_UNSPECIFIED Mã cây chưa xác định.
ALDER Cây dương tía được phân loại là một loại phấn hoa cây.
ASH Cây tần bì được phân loại là một loại phấn hoa cây.
BIRCH Bạch dương được phân loại là một loại phấn hoa cây.
COTTONWOOD Cây gỗ dương được phân loại là một loại phấn hoa cây.
ELM Cây du được phân loại là một loại phấn hoa cây.
MAPLE Cây phong được phân loại là một loại phấn hoa cây.
OLIVE Cây ôliu được phân loại là một loại phấn hoa cây.
JUNIPER Cây bách xù được phân loại là một loại phấn hoa cây.
OAK Cây sồi được phân loại là một loại phấn hoa cây.
PINE Thông được phân loại là một loại phấn hoa cây.
CYPRESS_PINE Thông bách được phân loại là một loại phấn hoa cây.
HAZEL Cây phỉ được phân loại là một loại phấn hoa cây.
GRAMINALES Cỏ ngũ cốc được phân loại là một loại phấn hoa cỏ.
RAGWEED Cỏ phấn hương được phân loại là một loại phấn hoa cỏ dại.
MUGWORT Ngải cứu được phân loại là một loại phấn hoa cỏ.

PlantDescription

Chứa thông tin chung về thực vật, bao gồm cả thông tin chi tiết về mùa vụ, hình dạng và màu sắc đặc biệt, thông tin về các phản ứng chéo gây dị ứng và ảnh thực vật.

Trường
type

PollenType

Loại phấn hoa của cây. Ví dụ: "GRASS". Bạn có thể tìm thấy danh sách tất cả các mã hiện có tại đây.
family

string

Một hình minh hoạ tên họ thực vật mà con người có thể đọc được. Ví dụ: "Tên khoa học (họ Bạch dương)".
season

string

Danh sách dạng văn bản giải thích các mùa có nhiều phấn hoa hoạt động. Ví dụ: "Mùa đông muộn, mùa xuân".
special_colors

string

Mô tả bằng văn bản về cây cối màu sắc của lá, vỏ cây, hoa hoặc hạt giúp xác định cây.
special_shapes

string

Mô tả bằng văn bản về cây cối hình dạng của lá, vỏ cây, hoa hoặc hạt giúp xác định cây.
cross_reaction

string

Nội dung mô tả bằng văn bản về các loài thực vật phản ứng chéo phấn hoa. Ví dụ: Phấn hoa cây dương tía, cây phỉ, cây trăn, cây gỗ dẻ, cây liễu và cây sồi.
picture

string

Đường liên kết đến hình ảnh của cái cây.
picture_closeup

string

Đường liên kết đến ảnh cận cảnh về cái cây.

PlantInfo

Đối tượng này chứa thông tin hằng ngày về một loại cây cụ thể.

Trường
code

Plant

Tên mã cây. Ví dụ: "COTTONWOOD". Bạn có thể tìm thấy danh sách tất cả các mã hiện có tại đây.
display_name

string

Một hình minh hoạ tên cây mà con người có thể đọc được. Ví dụ: "Cottonwood".
index_info

IndexInfo

Đối tượng này chứa dữ liệu đại diện cho giá trị, danh mục và nội dung mô tả cụ thể của chỉ số phấn hoa.
plant_description

PlantDescription

Chứa thông tin chung về thực vật, bao gồm cả thông tin chi tiết về mùa vụ, hình dạng và màu sắc đặc biệt, thông tin về các phản ứng chéo gây dị ứng và ảnh thực vật.
in_season

bool

Cho biết cây đang vào mùa hay chưa.

PollenType

Mã loại phấn hoa

Enum
POLLEN_TYPE_UNSPECIFIED Một loại thực vật chưa xác định.
GRASS Loại phấn hoa cỏ.
TREE Loại phấn hoa.
WEED Loại phấn hoa cỏ dại.

PollenTypeInfo

Đối tượng này chứa chỉ số loại phấn hoa và thông tin khuyến nghị về sức khoẻ đối với từng loại phấn hoa.

Trường
code

PollenType

Tên mã của loại phấn hoa. Ví dụ: "GRASS"
display_name

string

Hình ảnh mô tả tên loại phấn hoa mà con người có thể đọc được. Ví dụ: "Cỏ"
index_info

IndexInfo

Chứa dữ liệu về Chỉ số phấn hoa phổ quát (UPI) cho loại phấn hoa.
health_recommendations[]

string

Danh sách bằng văn bản nội dung giải thích, liên quan đến thông tin chi tiết về sức khoẻ dựa trên lượng phấn hoa hiện tại.
in_season

bool

Cho biết cây có đang vào mùa hay không.