Package google.maps.pollen.v1

Chỉ mục

Phấn hoa

Định nghĩa dịch vụ cho API Pollen.

LookupForecast

rpc LookupForecast(LookupForecastRequest) returns (LookupForecastResponse)

Trả về tối đa 5 ngày thông tin phấn hoa hằng 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 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 PNG cho thẻ thông tin.

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 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 chung.

IndexInfo

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

Các 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 các 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ụ: "Chỉ số phấn hoa toàn cầu".
category

string

Phân loại văn bản diễn giải điểm số chỉ mục. Chỉ mục 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 nhiều
index_description

string

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

Color

Màu sắc dùng để thể hiện điểm số của Chỉ số 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

Các trường
location

LatLng

Bắt buộc. Kinh độ và vĩ độ mà API tìm kiế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ự báo cần yêu cầu (giá trị tối thiểu 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ả về trên mỗi trang. Giá trị mặc định và giá trị tối đa là 5 (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ừ lệnh gọi hằng ngày trước đó. Tham số 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ả 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 phản hồi. Nếu không thể cung cấp dữ liệu cho ngôn ngữ đó thì API sẽ sử dụng kết quả khớp gần 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 thông tin chi tiết về tính thời vụ, hình dạng và màu sắc đặc biệt, thông tin về phản ứng chéo gây dị ứng và ảnh về cây cối.

LookupForecastResponse

Các 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 trong 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.

Các trường
date

Date

Ngày thể hiện dữ liệu dự báo phấn hoa (theo giờ UTC).
pollen_type_info[]

PollenTypeInfo

Danh sách này sẽ bao gồm (tối đa) 3 loại phấn hoa (cỏ, cỏ dại, cây cối) ả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 địa điểm được nêu 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ủ ô 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]

Các trường
map_type

MapType

Bắt buộc. Loại bản đồ nhiệt phấn hoa. Xác định sự kết hợp loại phấn hoa và chỉ mục mà bản đồ sẽ biểu diễn bằng đồ hoạ.
zoom

int32

Bắt buộc. Mức thu phóng của bản đồ. Xác định xem nội dung của một bản đồ hiển thị lớn hay nhỏ trong một chế độ xem bản đồ.

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

Các giá trị cho phép: 0-16
x

int32

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

int32

Bắt buộc. Xác định điểm bắc-nam trong thẻ thông tin được yêu cầu.

MapType

Loại bản đồ nhiệt phấn hoa. Xác định sự kết hợp loại phấn hoa và chỉ mục mà bản đồ sẽ biểu diễn bằng đồ hoạ.

Enum
MAP_TYPE_UNSPECIFIED Loại bản đồ chưa được chỉ định.
TREE_UPI Loại bản đồ nhiệt sẽ đại diện cho bản đồ đồ hoạ chỉ mục cây.
GRASS_UPI Loại bản đồ nhiệt sẽ đại diện cho bản đồ đồ hoạ chỉ mục cỏ.
WEED_UPI Loại bản đồ nhiệt sẽ biểu thị chỉ mục cỏ dại bằng bản đồ đồ hoạ.

Thực vật

Liệt kê các loại cây có sẵn ở nhiều địa điểm.

Enum
PLANT_UNSPECIFIED Mã cây trồng không xác định.
ALDER Cây dương tía được phân loại là một loại phấn hoa dạng cây.
ASH Cây tần bì được phân loại là một loại phấn hoa dạng cây.
BIRCH Bạch dương được phân loại là một loại phấn hoa dạng cây.
COTTONWOOD Cây gỗ dương được phân loại là một loại phấn hoa dạng cây.
ELM Cây du được phân loại là một loại phấn hoa dạng cây.
MAPLE Cây phong được phân loại là một loại phấn hoa dạng cây.
OLIVE Ôliu được phân loại là một loại phấn hoa dạng cây.
JUNIPER Cây bách xù được phân loại là một loại phấn hoa dạng cây.
OAK Gỗ sồi được phân loại là một loại phấn hoa dạng cây.
PINE Thông được phân loại là một loại phấn hoa dạng cây.
CYPRESS_PINE Cây thông được phân loại là một loại phấn hoa dạng cây.
HAZEL Phấn hoa cây phỉ được phân loại là một loại phấn hoa.
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 như 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ỏ dại.

PlantDescription

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

Các 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

Tên đại diện mà con người có thể đọc được của họ thực vật. Ví dụ: "Betu hiệuae (họ Bạch dương)".
season

string

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

string

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

string

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

string

Nội dung mô tả bằng văn bản về 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 ảnh của cây cối.
picture_closeup

string

Đường liên kết đến ảnh cận cảnh của 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ể.

Các trường
code

Plant

Tên mã của 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

Biểu thị 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 biểu thị 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 thông tin chi tiết về tính thời vụ, hình dạng và màu sắc đặc biệt, thông tin về phản ứng chéo gây dị ứng và ảnh về cây cối.
in_season

bool

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

PollenType

Mã loại phấn hoa

Enum
POLLEN_TYPE_UNSPECIFIED Loại cây chưa xác định.
GRASS Loại phấn hoa cỏ.
TREE Loại phấn hoa cây.
WEED Loại phấn hoa cỏ dại.

PollenTypeInfo

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

Các trường
code

PollenType

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

string

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

IndexInfo

Chứa dữ liệu Chỉ số phấn hoa chung (UPI) cho loại phấn hoa.
health_recommendations[]

string

Danh sách văn bản 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 trong mùa hay không.