Method: forecast.lookup

65'ten fazla ülkede 1 km'ye kadar çözünürlükle 5 güne kadar günlük polen bilgilerini 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

object (LatLng)

Zorunlu. API'nin polen tahmin verilerini aradığı boylam ve enlem.

days

integer

Zorunlu. İstenecek tahmin günü sayısını belirten sayı (minimum değer 1, maksimum değer 5'tir).

pageSize

integer

İ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 ve 5 günlük veriyi belirtir.

pageToken

string

İsteğe bağlı. Önceki bir günlük aramadan alınan sayfa jetonu. Sonraki sayfayı almak için kullanılır.

Sayfa jetonu için bir değer sağlanırken sağlanan diğer tüm istek parametrelerinin, sayfa jetonunu sağlayan önceki çağrıyla eşleşmesi gerektiğini unutmayın.

languageCode

string

İsteğe bağlı. İstemcinin yanıtın dilini seçmesine izin verir. Söz konusu dil için veri sağlanamıyorsa API en yakın eşleşmeyi kullanır. İzin verilen değerler IETF BCP-47 standardını temel alır. Varsayılan değer "en"dir.

plantsDescription

boolean

İsteğe bağlı. Bitkiler hakkında mevsim ayrıntıları, özel şekiller ve renkler gibi genel bilgiler, alerjik çapraz reaksiyonlar hakkında bilgi ve bitki fotoğrafları içerir. Varsayılan değer "true" (doğru) değeridir.

İ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 (DayInfo)
    }
  ],
  "nextPageToken": string
}
Alanlar
regionCode

string

İstekte sağlanan konuma karşılık gelen ülkenin/bölgenin ISO_3166-1 alpha-2 kodu. İstekte belirtilen konum itiraz edilen bir bölgedeyse bu alan yanıttan çıkarılabilir.

dailyInfo[]

object (DayInfo)

Zorunlu. Bu nesne, istenen her gün için günlük tahmin bilgilerini içerir.

nextPageToken

string

İsteğe bağlı. Sonraki sayfayı alma jetonu.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.

LatLng

Enlem/boylam çiftini temsil eden bir nesne. Bu, enlem ve boylam derecelerini temsil eden bir çift çift olarak 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

number

Derece cinsinden enlem. [-90,0, +90,0] aralığında olmalıdır.

longitude

number

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 (Date)
  },
  "pollenTypeInfo": [
    {
      object (PollenTypeInfo)
    }
  ],
  "plantInfo": [
    {
      object (PlantInfo)
    }
  ]
}
Alanlar
date

object (Date)

Polen tahmin verilerinin temsil edildiği, UTC saat diliminde.

pollenTypeInfo[]

object (PollenTypeInfo)

Bu liste, istekte belirtilen konumu etkileyen en fazla üç polen türünü (GRASS, ot, AĞA) içerir.

plantInfo[]

object (PlantInfo)

Bu liste, istekte belirtilen yeri etkileyen 15'e kadar polen türünü içerir.

Tarih

Takvimin tamamını veya bir kısmını temsil eder (ör. doğum günü). Günün saati ve saat dilimi başka bir yerde belirtilmiş veya önemsiz. Tarih, Miladi Takvim'e göredir. Bu, aşağıdakilerden birini temsil edebilir:

  • Sıfır olmayan yıl, ay ve gün değerleriyle tam tarih.
  • Bir ay ve gün ile sıfır yıl (örneğin, bir 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:

JSON gösterimi
{
  "year": integer,
  "month": integer,
  "day": integer
}
Alanlar
year

integer

Tarihin yılı. 1 ile 9999 arasında veya yıl içermeyen bir tarihi belirtmek için 0 arasında olmalıdır.

month

integer

Bir yılın ayı. 1 ile 12 arasında veya ay ve gün içermeyen bir yılı belirtmek için 0 arasında olmalıdır.

day

integer

Ayın günü. 1 ile 31 arasında bir değer olmalı ve yıl ve ay için geçerlidir. Yalnızca yılı belirtmek için 0 değerini veya günün önemli olmadığı bir yılı ve ayı belirtmek için 0 değerini girin.

PollenTypeInfo

Bu nesne, polen türü indeksi ve belirli polen türüyle ilgili sağlık önerisi bilgilerini içerir.

JSON gösterimi
{
  "code": enum (PollenType),
  "displayName": string,
  "indexInfo": {
    object (IndexInfo)
  },
  "healthRecommendations": [
    string
  ],
  "inSeason": boolean
}
Alanlar
code

enum (PollenType)

Polen türünün kod adı. Örneğin: "GRASS"

displayName

string

Polen türü adının kullanıcılar tarafından okunabilecek şekilde gösterilmesi. Örnek: "Çimen"

indexInfo

object (IndexInfo)

Polen türü için Evrensel Polen İndeksi (UPI) verilerini içerir.

healthRecommendations[]

string

Mevcut polen düzeylerine dayalı olarak sağlık analizleriyle ilgili metin biçimindeki açıklamaların listesi.

inSeason

boolean

Bitkinin mevsiminde olup olmadığının gösterilmesi.

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çıklamayı temsil eden veriler içerir.

JSON gösterimi
{
  "code": enum (Index),
  "displayName": string,
  "category": string,
  "indexDescription": string,
  "color": {
    object (Color)
  },
  "value": integer
}
Alanlar
code

enum (Index)

Dizinin kodu. Bu alan, programlama amacıyla dizini boşluk yerine yılan durumlar kullanılarak gösterir. Örnek: "UPI".

displayName

string

Dizin adının kullanıcılar tarafından okunabilen temsili. Örnek: "Evrensel Polen İndeksi".

category

string

Dizin sayısal puan yorumunun metin sınıflandırması. Dizin altı kategoriden oluşur:

  • 0: "Hiçbiri"
  • 1: "Çok düşük"
  • 2: "Düşük"
  • 3: "Orta"
  • 4: "Yüksek"
  • 5: "Çok yüksek
indexDescription

string

Geçerli dizin düzeyinin metinsel açıklaması.

color

object (Color)

Polen İndeksi sayısal puanını göstermek için kullanılan renk.

value

integer

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 sunum, kompaktlık yerine, çeşitli dillerdeki renk gösterimlerine ve bu gösterimlerden dönüştürmenin basitleştirilmesi için tasarlanmıştır. Örneğin, bu temsilin alanları, Java'da java.awt.Color oluşturucuya standart bir şekilde sağlanabilir; Ayrıca, iOS'te UIColor'ın +colorWithRed:green:blue:alpha yöntemine de sağlanabilir; ve küçük bir çalışmayla, JavaScript'te bir CSS rgba() dizesi olarak kolayca biçimlendirilebilir.

Bu referans sayfasında, RGB değerini yorumlamak için kullanılması gereken mutlak renk alanıyla ilgili bilgiler (ör. sRGB, Adobe RGB, DCI-P3 ve BT.2020) yer almaz. Varsayılan olarak uygulamalar sRGB renk alanını kabul etmelidir.

Renk eşitliğinin belirlenmesi gerektiğinde, aksi belirtilmediği sürece uygulamalarda iki rengin tamamının kırmızı, yeşil, mavi ve alfa değerlerinin her biri en fazla 1e-5 farklılık gösterdiği takdirde eşit kabul edilir.

Ö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

number

[0, 1] aralığındaki bir değer olarak renkteki kırmızı miktarı.

green

number

[0, 1] aralığındaki bir değer olarak renkteki yeşilin miktarı.

blue

number

[0, 1] aralığındaki bir değer olarak renkteki mavi miktarı.

alpha

number

Bu rengin piksele uygulanması gereken oranı. Yani son piksel rengi denklemle tanımlanır:

pixel color = alpha * (this color) + (1.0 - alpha) * (background color)

Bu, 1,0 değeri düz bir renge karşılık gelirken, 0.0 değeri tamamen şeffaf bir renge karşılık gelir. Bu yöntem, varsayılan değer ile ayarlanmayan değeri birbirinden ayırt edebilmek için basit bir kayan skaler yerine bir sarmalayıcı mesajı kullanır. 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 (Plant),
  "displayName": string,
  "indexInfo": {
    object (IndexInfo)
  },
  "plantDescription": {
    object (PlantDescription)
  },
  "inSeason": boolean
}
Alanlar
code

enum (Plant)

Bitki kodunun adı. Örneğin: "COTTONWOOD". Kullanılabilen tüm kodların listesini burada bulabilirsiniz.

displayName

string

Bitki adının insanlar tarafından okunabilecek bir şekilde gösterilmesi. Örnek: “Kottonwood".

indexInfo

object (IndexInfo)

Bu nesne, belirli polen endeksi değerini, kategorisini ve açıklamayı temsil eden veriler içerir.

plantDescription

object (PlantDescription)

Bitkiler hakkında mevsimsel ayrıntılar, özel şekiller ve renkler, alerjik çapraz reaksiyonlar hakkında bilgiler ve bitki fotoğrafları gibi genel bilgiler içerir.

inSeason

boolean

Bitkinin mevsiminde olup olmadığını belirtir.

Bitki

Konumlara göre değişkenlik gösteren kullanılabilir bitkileri listeler.

Sıralamalar
PLANT_UNSPECIFIED Belirtilmemiş bitki kodu.
ALDER Kızılağaç bir 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ı bir ağaç poleni türü olarak sınıflandırılır.
COTTONWOOD Kavak kabuğu, ağaç poleni türü olarak sınıflandırılır.
ELM Karaağaç bir ağaç poleni türü olarak sınıflandırılır.
MAPLE Akçaağaç bir ağaç poleni türü olarak sınıflandırılır.
OLIVE Zeytin, bir ağaç poleni türü olarak sınıflandırılır.
JUNIPER Ardıç, bir ağaç poleni türü olarak sınıflandırılır.
OAK Meşe bir ağaç poleni türü olarak sınıflandırılır.
PINE Çam, bir ağaç poleni türü olarak sınıflandırılır.
CYPRESS_PINE Servi çamı bir 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 Graminales, çim poleni türüne göre sınıflandırılır.
RAGWEED Kanarya otu bir ot poleni türü olarak sınıflandırılır.
MUGWORT Misk otu, ot poleni türü olarak sınıflandırılır.

PlantDescription

Bitkiler hakkında mevsimsel ayrıntılar, özel şekiller ve renkler, alerjik çapraz reaksiyonlar hakkında bilgiler ve bitki fotoğrafları gibi genel bilgiler içerir.

JSON gösterimi
{
  "type": enum (PollenType),
  "family": string,
  "season": string,
  "specialColors": string,
  "specialShapes": string,
  "crossReaction": string,
  "picture": string,
  "pictureCloseup": string
}
Alanlar
type

enum (PollenType)

Bitkinin polen türü. Örneğin: "GRASS". Kullanılabilen tüm kodların listesini burada bulabilirsiniz.

family

string

Bitki ailesinin adının insanlar tarafından okunabilecek temsili. Örnek: "Betulaceae (huş ağacı ailesi)".

season

string

Polenin aktif olduğu mevsimlerin açıklamalarını metin halinde içeren liste. Örnek: "Kış sonu, ilkbahar".

specialColors

string

Bitkilerin yazılı açıklaması yaprak, kabuk, çiçek veya tohumların renklerini gösterir.

specialShapes

string

Bitkilerin yazılı açıklaması yaprak, kabuk, çiçek veya tohum şekillerini kullanarak bitkiyi tanımlamaya yardımcı olur.

crossReaction

string

Polen çapraz reaksiyona giren bitkilerin metinsel açıklaması. Örnek: kızılağaç, fındık, gürgen, kayın, söğüt ve meşe poleni.

picture

string

Bitkinin resminin bağlantısı.

pictureCloseup

string

Bitkinin yakın çekim bir resmine bağlantı verin.