Package google.maps.pollen.v1

색인

꽃가루

Pollen API의 서비스 정의입니다.

LookupForecast

rpc LookupForecast(LookupForecastRequest) returns (LookupForecastResponse)

65개 이상의 국가에서 최대 5일간 꽃가루 정보를 최대 1km 해상도로 반환합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 OAuth 2.0 개요를 참고하세요.

LookupHeatmapTile

rpc LookupHeatmapTile(LookupHeatmapTileRequest) returns (HttpBody)

타일 PNG 이미지의 데이터를 포함하는 바이트 배열을 반환합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 OAuth 2.0 개요를 참고하세요.

색인

색인 코드

열거형
INDEX_UNSPECIFIED 색인이 지정되지 않았습니다.
UPI 세계 꽃가루 지수

IndexInfo

이 객체에는 특정 꽃가루 색인 값, 카테고리 및 설명을 나타내는 데이터가 포함됩니다.

필드
code

Index

색인의 코드입니다. 이 필드는 공백 대신 스네이크 사례를 사용하여 프로그래밍 목적의 색인을 나타냅니다. 예: 'UPI'.

display_name

string

사람이 읽을 수 있는 색인 이름 표현입니다. 예: '세계 꽃가루 지수'

category

string

색인 숫자 점수 해석의 텍스트 분류입니다. 이 색인은 6가지 카테고리로 구성됩니다.

  • 0: '없음'
  • 1: '매우 낮음'
  • 2: '낮음'
  • 3: '보통'
  • 4: '높음'
  • 5: '매우 높음
index_description

string

현재 색인 수준에 대한 텍스트 설명입니다.

color

Color

꽃가루 지수 숫자 점수를 나타내는 데 사용되는 색상입니다.

value

int32

색인의 숫자 점수입니다. 숫자 범위는 0에서 5 사이입니다.

LookupForecastRequest

필드
location

LatLng

필수 항목입니다. API가 꽃가루 예보 데이터를 검색하는 위도 및 경도입니다.

days

int32

필수 항목입니다. 요청할 예측 일수를 나타내는 숫자입니다 (최솟값 1, 최댓값은 5).

page_size

int32

선택사항입니다. 페이지당 반환할 일일 정보 레코드의 최대 개수입니다. 기본값 및 최댓값은 5이며, 이는 5일간의 데이터를 나타냅니다.

page_token

string

선택사항입니다. 이전 일일 호출에서 수신된 페이지 토큰입니다. 후속 페이지를 검색하는 데 사용됩니다.

페이지 토큰의 값을 제공할 때 제공된 다른 모든 요청 매개변수는 페이지 토큰을 제공한 이전 호출과 일치해야 합니다.

language_code

string

선택사항입니다. 클라이언트가 응답의 언어를 선택할 수 있도록 합니다. 해당 언어에 대한 데이터를 제공할 수 없는 경우 API는 가장 근접한 일치 항목을 사용합니다. 허용되는 값은 IETF BCP-47 표준을 따릅니다. 기본값은 'en'입니다.

plants_description

bool

선택사항입니다. 계절성에 관한 세부정보, 특별한 모양과 색상, 알레르기 교차 반응에 관한 정보, 식물 사진 등 식물에 관한 일반적인 정보를 포함합니다. 기본값은 'true'입니다.

LookupForecastResponse

필드
region_code

string

요청에 제공된 위치에 해당하는 국가/지역의 ISO_3166-1 alpha-2 코드입니다. 요청에 제공된 위치가 분쟁 지역 내에 있는 경우 응답에서 이 필드가 생략될 수 있습니다.

daily_info[]

DayInfo

필수 항목입니다. 이 객체에는 요청된 각 날짜에 대한 일일 예보 정보가 포함됩니다.

next_page_token

string

선택사항입니다. 다음 페이지를 검색하기 위한 토큰입니다.

DayInfo

이 객체에는 요청된 각 날짜에 대한 일일 예보 정보가 포함됩니다.

필드
date

Date

꽃가루 예보 데이터가 표시되는 날짜입니다(UTC 기준).

pollen_type_info[]

PollenTypeInfo

이 목록에는 요청에 지정된 위치에 영향을 주는 꽃가루 유형 (GRASS, WEED, TREE)이 포함됩니다.

plant_info[]

PlantInfo

이 목록에는 요청에 지정된 위치에 영향을 주는 꽃가루 종류가 최대 15개까지 포함됩니다.

LookupHeatmapTileRequest

히트맵 타일 요청입니다. 구조가 표준 카드 서버 GET 호출(예: https://pollen.googleapis.com/v1/mapTypes/{map_type}/heatmapTiles/{zoom}/{x}/{y})을 준수합니다.

예: [https://pollen.googleapis.com/v1/mapTypes/TREE_UPI/heatmapTiles/0/0/0]

필드
map_type

MapType

필수 항목입니다. 꽃가루 히트맵의 유형입니다. 지도에서 그래픽으로 나타낼 꽃가루 유형 및 색인의 조합을 정의합니다.

zoom

int32

필수 항목입니다. 지도의 확대/축소 수준입니다. 지도뷰에 표시되는 지도 콘텐츠의 크기 또는 크기를 정의합니다.

  • 확대/축소 수준 0은 전 세계를 단일 타일로 표시합니다.
  • 확대/축소 수준 1은 4개의 타일로 전 세계를 나타냅니다.
  • 확대/축소 수준 2는 16개의 타일로 전 세계를 나타냅니다.
  • 확대/축소 수준 16은 전 세계 65,536개의 타일로 표현됩니다.

허용되는 값: 0~16

x

int32

필수 항목입니다. 요청된 타일의 동서 지점을 정의합니다.

y

int32

필수 항목입니다. 요청된 타일의 남북 지점을 정의합니다.

지도 유형

꽃가루 히트맵의 유형입니다. 지도에서 그래픽으로 나타낼 꽃가루 유형 및 색인의 조합을 정의합니다.

열거형
MAP_TYPE_UNSPECIFIED 지정되지 않은 지도 유형입니다.
TREE_UPI 히트맵 유형은 트리 색인 그래픽 맵을 나타냅니다.
GRASS_UPI 히트맵 유형은 잔디 색인 그래픽 지도를 나타냅니다.
WEED_UPI 히트맵 유형은 잡초 색인 그래픽 맵을 나타냅니다.

식물

위치별로 이용 가능성이 다른 식물을 나열합니다.

열거형
PLANT_UNSPECIFIED 지정되지 않은 식물 코드입니다.
ALDER 오리나무는 나무 꽃가루 유형으로 분류됩니다.
ASH 물푸레나무는 나무 꽃가루 유형으로 분류됩니다.
BIRCH 자작나무는 나무 꽃가루 유형으로 분류됩니다.
COTTONWOOD 미루나무는 나무 꽃가루 유형으로 분류됩니다.
ELM 느릅나무는 나무 꽃가루 유형으로 분류됩니다.
MAPLE 단풍나무는 나무 꽃가루 유형으로 분류됩니다.
OLIVE 올리브는 나무 꽃가루 유형으로 분류됩니다.
JUNIPER 향나무는 나무 꽃가루 유형으로 분류됩니다.
OAK 참나무는 나무 꽃가루 유형으로 분류됩니다.
PINE 소나무는 나무 꽃가루 유형으로 분류됩니다.
CYPRESS_PINE 편백나무는 나무 꽃가루 유형으로 분류됩니다.
HAZEL 헤이즐은 나무 꽃가루 유형으로 분류됩니다.
GRAMINALES 그래미널은 풀 꽃가루 유형으로 분류됩니다.
RAGWEED 돼지풀은 잡초 꽃가루 유형으로 분류됩니다.
MUGWORT 쑥은 잡초 꽃가루 유형으로 분류됩니다.

PlantDescription

계절성에 관한 세부정보, 특별한 모양과 색상, 알레르기 교차 반응에 관한 정보, 식물 사진 등 식물에 관한 일반적인 정보를 포함합니다.

필드
type

PollenType

식물의 꽃가루 유형입니다. 예: 'GRASS'. 사용 가능한 모든 코드의 목록은 여기에서 확인할 수 있습니다.

family

string

사람이 읽을 수 있는 방식으로 표현된 식물군 이름입니다. 예: '자작나무과 식물'

season

string

꽃가루가 생기는 계절에 대한 텍스트 설명입니다. 예: '늦겨울, 봄'

special_colors

string

식물에 대한 텍스트 설명 나뭇잎, 나무껍질, 꽃, 씨앗의 색상 등 식물을 식별하는 데 도움이 됩니다.

special_shapes

string

식물에 대한 텍스트 설명 식물을 식별하는 데 도움이 되는 나뭇잎, 나무껍질, 꽃 또는 씨의 모양입니다.

cross_reaction

string

꽃가루 교차 반응 식물에 관한 텍스트 설명입니다. 예: 오리나무, 헤이즐나무, 서어나무, 너도밤나무, 버드나무, 참나무 꽃가루가 있습니다.

picture

string

식물 사진 링크

picture_closeup

string

식물의 근접 사진 링크

PlantInfo

이 객체에는 특정 식물에 관한 일일 정보가 포함됩니다.

필드
code

Plant

식물 코드 이름입니다. 예: 'COTTONWOOD' 사용 가능한 모든 코드의 목록은 여기에서 확인할 수 있습니다.

display_name

string

사람이 읽을 수 있는 식물 이름 표현입니다. 예: '미루'

index_info

IndexInfo

이 객체에는 특정 꽃가루 색인 값, 카테고리 및 설명을 나타내는 데이터가 포함됩니다.

plant_description

PlantDescription

계절성에 관한 세부정보, 특별한 모양과 색상, 알레르기 교차 반응에 관한 정보, 식물 사진 등 식물에 관한 일반적인 정보를 포함합니다.

in_season

bool

식물이 제철인지 여부를 나타냅니다.

PollenType

꽃가루 유형 코드

열거형
POLLEN_TYPE_UNSPECIFIED 지정되지 않은 식물 유형입니다.
GRASS 풀 꽃가루 유형입니다.
TREE 나무 꽃가루 유형입니다.
WEED 잡초 꽃가루 유형.

PollenTypeInfo

이 객체에는 꽃가루 유형 색인과 특정 꽃가루 유형에 관한 건강 권장사항 정보가 포함됩니다.

필드
code

PollenType

꽃가루 유형의 코드 이름입니다. 예: 'GRASS'

display_name

string

꽃가루 유형 이름을 사람이 읽을 수 있는 표현으로 나타냅니다. 예: '잔디'

index_info

IndexInfo

꽃가루 유형의 세계 꽃가루 지수 (UPI) 데이터가 포함되어 있습니다.

health_recommendations[]

string

현재 꽃가루 수준을 기준으로 건강 인사이트와 관련된 설명 텍스트 목록입니다.

in_season

bool

식물이 제철인지 여부 표시