- HTTP isteği
- Sorgu parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- LatLng
- DayInfo
- Tarih
- PollenTypeInfo
- PollenType
- IndexInfo
- Dizin
- Renk
- PlantInfo
- Bitki
- PlantDescription
65'ten fazla ülkede 1 km'ye kadar çözünürlükte günlük polen bilgilerini 5 güne kadar döndürür.
HTTP isteği
GET https://pollen.googleapis.com/v1/forecast:lookup
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Sorgu parametreleri
Parametreler | |
---|---|
location |
Zorunlu. API'nin polen tahmini verilerini aradığı boylam ve enlemdir. |
days |
Zorunlu. İstenecek tahmin günü sayısını belirten sayı (minimum değer 1, maksimum değer 5'tir). |
pageSize |
İsteğe bağlı. Sayfa başına döndürülecek maksimum günlük bilgi kaydı sayısı. Varsayılan ve maksimum değer 5'tir (5 günlük veri). |
pageToken |
İsteğe bağlı. Önceki günlük bir çağrıdan alınan sayfa jetonu. Sonraki sayfayı getirmek için kullanılır. Sayfa jetonu için bir değer sağlarken sağlanan diğer tüm istek parametrelerinin, sayfa jetonunu sağlayan önceki çağrıyla eşleşmesi gerektiğini unutmayın. |
languageCode |
İsteğe bağlı. İstemcinin yanıtın dilini seçmesine olanak tanır. Bu dil için veri sağlanamazsa API en yakın eşleşmeyi kullanır. İzin verilen değerler IETF BCP-47 standardını kullanır. Varsayılan değer "en"dir. |
plantsDescription |
İsteğe bağlı. Sezona ilişkin ayrıntılar, özel şekiller ve renkler, alerjik çapraz reaksiyonlarla ilgili bilgiler ve bitki fotoğrafları dahil olmak üzere bitkilerle ilgili genel bilgiler içerir. |
İstek içeriği
İstek metni boş olmalıdır.
Yanıt gövdesi
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{
"regionCode": string,
"dailyInfo": [
{
object ( |
Alanlar | |
---|---|
regionCode |
İstekte sağlanan konuma karşılık gelen ülkenin/bölgenin ISO_3166-1 alfa-2 kodu. İstekte belirtilen konum ihtilaflı bir bölgede bulunuyorsa bu alan yanıttan çıkarılabilir. |
dailyInfo[] |
Zorunlu. Bu nesne, istenen her gün için günlük tahmin bilgilerini içerir. |
nextPageToken |
İsteğe bağlı. Sonraki sayfayı almak için kullanılan jeton. |
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamını gerektirir:
https://www.googleapis.com/auth/cloud-platform
Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleye bakın.
LatLng
Enlem/boylam çiftini temsil eden bir nesne. Bu, enlem ve boylam derecelerini temsil eden bir çift çiftle ifade edilir. Aksi belirtilmedikçe bu nesne WGS84 standardına uygun olmalıdır. Değerler normalleştirilmiş aralıklar içinde olmalıdır.
JSON gösterimi |
---|
{ "latitude": number, "longitude": number } |
Alanlar | |
---|---|
latitude |
Derece cinsinden enlem. [-90.0, +90.0] aralığında olmalıdır. |
longitude |
Derece cinsinden boylam. [-180.0, +180.0] aralığında olmalıdır. |
DayInfo
Bu nesne, istenen her gün için günlük tahmin bilgilerini içerir.
JSON gösterimi |
---|
{ "date": { object ( |
Alanlar | |
---|---|
date |
Polen tahmini verilerinin UTC saat diliminde gösterildiği tarih. |
pollenTypeInfo[] |
Bu liste, istekte belirtilen konumu etkileyen (en fazla) üç polen türü (çim, ot, ağaç) içerir. |
plantInfo[] |
Bu listede, istekte belirtilen konumu etkileyen 15 (en fazla) polen türü yer alacaktır. |
Tarih
Takvim tarihinin tamamını veya bir kısmını (ör. doğum günü) temsil eder. Günün saati ve saat dilimi, başka bir yerde belirtilmiş veya önemsiz. Tarih, Miladi Takvim ile görecelidir. Aşağıdakilerden birini gösterebilir:
- Sıfır olmayan yıl, ay ve gün değerleriyle tam tarih.
- Sıfır yıllı bir ay ve gün (örneğin, yıl dönümü).
- Tek başına bir yıl (sıfır ay ve sıfır gün).
- Sıfır gün içeren bir yıl ve ay (örneğin, kredi kartı son kullanma tarihi).
İlgili türler:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
JSON gösterimi |
---|
{ "year": integer, "month": integer, "day": integer } |
Alanlar | |
---|---|
year |
Tarihin yılı. 1 ile 9999 arasında veya yıl içermeyen bir tarih belirtmek için 0 olmalıdır. |
month |
Yılın ayı. 1 ile 12 arasında veya ay ve gün olmadan bir yıl belirtmek için 0 olmalıdır. |
day |
Ayın günü. 1 ile 31 arasında olup yıl ve ay için geçerli olmalıdır veya tek başına yıl ya da günün önemli olmadığı yıl ve ay belirtmek için 0 olmalıdır. |
PollenTypeInfo
Bu nesne, polen türü dizinini ve belirli polen türüyle ilgili sağlık önerisi bilgilerini içerir.
JSON gösterimi |
---|
{ "code": enum ( |
Alanlar | |
---|---|
code |
Polen türünün kod adı. Örneğin: "GRASS" |
displayName |
Polen türü adının insanlar tarafından okunabilir temsili. Örnek: "Çimen" |
indexInfo |
Polen türü için Evrensel Polen Endeksi (UPI) verilerini içerir. |
healthRecommendations[] |
Mevcut polen seviyesine göre sağlık analizleriyle ilgili metinsel açıklama listesi. |
inSeason |
Bitkinin mevsimde olup olmadığını belirtir. |
PollenType
Polen Türü Kodu
Sıralamalar | |
---|---|
POLLEN_TYPE_UNSPECIFIED |
Bitki türü belirtilmedi. |
GRASS |
Çim poleni türü. |
TREE |
Ağaç poleni türü. |
WEED |
Yabancı ot poleni türü. |
IndexInfo
Bu nesne, belirli polen endeksi değerini, kategorisini ve açıklamasını temsil eden veriler içerir.
JSON gösterimi |
---|
{ "code": enum ( |
Alanlar | |
---|---|
code |
Dizinin kodu. Bu alan, boşluklar yerine yılan kılıfları kullanılarak programlama amacıyla dizini temsil eder. Örnek: "UPI". |
displayName |
Dizin adının kullanıcılar tarafından okunabilen temsili. Örnek: "Evrensel Polen İndeksi". |
category |
Dizin sayısal puanı yorumlamanın metin sınıflandırması. Dizin altı kategoriden oluşur:
|
indexDescription |
Geçerli dizin düzeyinin metinsel açıklaması. |
color |
Polen Endeksi sayısal puanını göstermek için kullanılan renk. |
value |
Dizinin sayısal puanı. Sayısal aralık 0 ile 5 arasındadır. |
Dizin
Dizin Kodu
Sıralamalar | |
---|---|
INDEX_UNSPECIFIED |
Belirtilmemiş dizin. |
UPI |
Evrensel Polen İndeksi. |
Renk
RGBA renk alanındaki bir rengi temsil eder. Bu temsil, kompaktlık yerine çeşitli dillerdeki renk temsillerine geçişin basit olması için tasarlanmıştır. Örneğin, bu temsilin alanları Java'daki java.awt.Color
oluşturucuya basit bir şekilde sağlanabilir; ayrıca iOS'teki UIColor'ın +colorWithRed:green:blue:alpha
yöntemine önemsiz bir şekilde sağlanabilir ve sadece küçük bir çalışmayla JavaScript'te bir CSS rgba()
dizesine kolayca dönüştürülebilir.
Bu referans sayfasında, RGB değerini yorumlamak için kullanılması gereken mutlak renk alanı hakkında bilgi yoktur (ör. sRGB, Adobe RGB, DCI-P3 ve BT.2020). Uygulamalarda varsayılan olarak sRGB renk alanı kullanılmalıdır.
Renk eşitliğinin belirlenmesi gerektiğinde, aksi belirtilmediği sürece tüm kırmızı, yeşil, mavi ve alfa değerleri arasında en fazla 1e-5
fark olması durumunda, uygulamalarda iki renk eşit olarak ele alınır.
Örnek (Java):
import com.google.type.Color;
// ...
public static java.awt.Color fromProto(Color protocolor) {
float alpha = protocolor.hasAlpha()
? protocolor.getAlpha().getValue()
: 1.0;
return new java.awt.Color(
protocolor.getRed(),
protocolor.getGreen(),
protocolor.getBlue(),
alpha);
}
public static Color toProto(java.awt.Color color) {
float red = (float) color.getRed();
float green = (float) color.getGreen();
float blue = (float) color.getBlue();
float denominator = 255.0;
Color.Builder resultBuilder =
Color
.newBuilder()
.setRed(red / denominator)
.setGreen(green / denominator)
.setBlue(blue / denominator);
int alpha = color.getAlpha();
if (alpha != 255) {
result.setAlpha(
FloatValue
.newBuilder()
.setValue(((float) alpha) / denominator)
.build());
}
return resultBuilder.build();
}
// ...
Örnek (iOS / Obj-C):
// ...
static UIColor* fromProto(Color* protocolor) {
float red = [protocolor red];
float green = [protocolor green];
float blue = [protocolor blue];
FloatValue* alpha_wrapper = [protocolor alpha];
float alpha = 1.0;
if (alpha_wrapper != nil) {
alpha = [alpha_wrapper value];
}
return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
}
static Color* toProto(UIColor* color) {
CGFloat red, green, blue, alpha;
if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
return nil;
}
Color* result = [[Color alloc] init];
[result setRed:red];
[result setGreen:green];
[result setBlue:blue];
if (alpha <= 0.9999) {
[result setAlpha:floatWrapperWithValue(alpha)];
}
[result autorelease];
return result;
}
// ...
Örnek (JavaScript):
// ...
var protoToCssColor = function(rgb_color) {
var redFrac = rgb_color.red || 0.0;
var greenFrac = rgb_color.green || 0.0;
var blueFrac = rgb_color.blue || 0.0;
var red = Math.floor(redFrac * 255);
var green = Math.floor(greenFrac * 255);
var blue = Math.floor(blueFrac * 255);
if (!('alpha' in rgb_color)) {
return rgbToCssColor(red, green, blue);
}
var alphaFrac = rgb_color.alpha.value || 0.0;
var rgbParams = [red, green, blue].join(',');
return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
};
var rgbToCssColor = function(red, green, blue) {
var rgbNumber = new Number((red << 16) | (green << 8) | blue);
var hexString = rgbNumber.toString(16);
var missingZeros = 6 - hexString.length;
var resultBuilder = ['#'];
for (var i = 0; i < missingZeros; i++) {
resultBuilder.push('0');
}
resultBuilder.push(hexString);
return resultBuilder.join('');
};
// ...
JSON gösterimi |
---|
{ "red": number, "green": number, "blue": number, "alpha": number } |
Alanlar | |
---|---|
red |
[0, 1] aralığındaki bir değer olarak renkteki kırmızı miktarı. |
green |
[0, 1] aralığındaki bir değer olarak renkteki yeşil miktarı. |
blue |
[0, 1] aralığındaki bir değer olarak renkteki mavi miktarı. |
alpha |
Bu rengin piksele uygulanması gereken oranı. Yani, nihai piksel rengi şu denklemle tanımlanır:
Bu, 1,0 değerinin düz bir renge, 0,0 değerinin ise tamamen şeffaf bir renge karşılık geldiği anlamına gelir. Bu yöntemde basit bir kayan skaler yerine sarmalayıcı mesajı kullanılır, böylece varsayılan değer ile ayarlanmamış olan değer birbirinden ayırt edilebilir. Atlanırsa, bu renk nesnesi düz renk olarak oluşturulur (alfa değerine açık bir şekilde 1,0 değeri verilmiş gibi). |
PlantInfo
Bu nesne, belirli bir bitkiyle ilgili günlük bilgileri içerir.
JSON gösterimi |
---|
{ "code": enum ( |
Alanlar | |
---|---|
code |
Bitki kodu adı. Örneğin: "COTTONWOOD". Kullanılabilir tüm kodların listesini burada bulabilirsiniz. |
displayName |
Bitki adının kullanıcılar tarafından okunabilen temsili. Örnek: "Pamuk ağacı". |
indexInfo |
Bu nesne, belirli polen endeksi değerini, kategorisini ve açıklamasını temsil eden veriler içerir. |
plantDescription |
Sezona ilişkin ayrıntılar, özel şekiller ve renkler, alerjik çapraz reaksiyonlarla ilgili bilgiler ve bitki fotoğrafları dahil olmak üzere bitkilerle ilgili genel bilgiler içerir. |
inSeason |
Bitkinin mevsimde olup olmadığını belirtir. |
Bitki
Konumlara göre değişen stok durumları gösteren mevcut bitkileri listeler.
Sıralamalar | |
---|---|
PLANT_UNSPECIFIED |
Belirtilmemiş bitki kodu. |
ALDER |
Kızılağaç, ağaç poleni türü olarak sınıflandırılır. |
ASH |
Kül, ağaç poleni türü olarak sınıflandırılır. |
BIRCH |
Huş ağacı, ağaç poleni türü olarak sınıflandırılır. |
COTTONWOOD |
Kavak ağacı, ağaç poleni türü olarak sınıflandırılır. |
ELM |
Karaağaç, ağaç poleni türü olarak sınıflandırılır. |
MAPLE |
Akçaağaç, ağaç poleni türü olarak sınıflandırılır. |
OLIVE |
Zeytin, ağaç poleni türü olarak sınıflandırılır. |
JUNIPER |
Ardıç, ağaç poleni türü olarak sınıflandırılır. |
OAK |
Meşe, ağaç poleni türü olarak sınıflandırılır. |
PINE |
Çam, ağaç poleni türü olarak sınıflandırılır. |
CYPRESS_PINE |
Servi çamı, ağaç poleni türü olarak sınıflandırılır. |
HAZEL |
Fındık, ağaç poleni türü olarak sınıflandırılır. |
GRAMINALES |
Graminale, çimen poleni türü olarak sınıflandırılır. |
RAGWEED |
Kanarya otu ot poleni türü olarak sınıflandırılır. |
MUGWORT |
Misk otu bir ot poleni türü olarak sınıflandırılır. |
PlantDescription
Sezona ilişkin ayrıntılar, özel şekiller ve renkler, alerjik çapraz reaksiyonlarla ilgili bilgiler ve bitki fotoğrafları dahil olmak üzere bitkilerle ilgili genel bilgiler içerir.
JSON gösterimi |
---|
{
"type": enum ( |
Alanlar | |
---|---|
type |
Bitkinin polen türü. Örneğin: "GRASS". Kullanılabilir tüm kodların listesini burada bulabilirsiniz. |
family |
Bitki soyadının kullanıcılar tarafından okunabilir bir temsili. Örnek: "Betulaceae (huş ağacı ailesi)". |
season |
Polenin etkin olduğu mevsimlerin metin halinde açıklamalarının listesi. Örnek: "Kış sonu, ilkbahar". |
specialColors |
Bitkinin yaprak, kabuk, çiçek veya tohum renklerini belirten ve bitkinin tanımlanmasına yardımcı olan metinsel bir açıklama. |
specialShapes |
Bitkinin yaprak, kabuk, çiçek veya tohum şekillerini belirten, bitkinin tanımlanmasına yardımcı olan yazılı açıklama. |
crossReaction |
Polen çapraz reaksiyonlu bitkilerin metinsel açıklaması. Örnek: Kızılağaç, fındık, gürgen, kayın, söğüt ve meşe poleni. |
picture |
Bitkinin resminin bağlantısı. |
pictureCloseup |
Bitkinin yakın çekim fotoğrafının bağlantısını verin. |