Method: flights.computeFlightEmissions

Bezstanowa metoda pobierania szacowanych emisji. Szczegóły dotyczące obliczania szacowanej emisji: https://github.com/google/travel-impact-model

Odpowiedź będzie zawierać wszystkie wpisy pasujące do wejściowych etapów lotu w tej samej kolejności. Jeśli dla określonego etapu lotu nie ma danych szacunkowych, w odpowiedzi w odpowiedzi zostanie zwrócony obiekt etapu lotu z pustymi polami emisji. Żądanie nadal będzie uznawane za zrealizowane. Przyczyny braku szacowanych emisji:

  • Serwer nie rozpoznaje lotu.
  • Wejściowy etap lotu nie zawiera co najmniej 1 identyfikatora.
  • Data lotu już w przeszłości.
  • Ten model nie obsługuje tego typu samolotu.
  • Brak konfiguracji miejsc.

Prośba może zawierać do 1000 etapów lotu. Jeśli żądanie dotyczy więcej niż 1000 okresów bezpośrednich, w przeciwnym razie pojawi się błąd Część IARC.

Żądanie HTTP

POST https://travelimpactmodel.googleapis.com/v1/flights:computeFlightEmissions

Adres URL używa składni transkodowania gRPC.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "flights": [
    {
      object (Flight)
    }
  ]
}
Pola
flights[]

object (Flight)

To pole jest wymagane. Loty bezpośrednie, dla których szacowana emisja zostanie zwrócona.

Treść odpowiedzi

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Definicja wyjściowa odpowiedzi [flights.computeFlightEmissions][google.travel.sustainability.travelimpactmodel.v1.ComputeFlightEmissions].

Zapis JSON 
{
  "flightEmissions": [
    {
      object (FlightWithEmissions)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
Pola
flightEmissions[]

object (FlightWithEmissions)

Lista etapów lotu z szacowaną emisją.
modelVersion

object (ModelVersion)

Wersja modelu, w której obliczono szacowane emisje dla wszystkich lotów w tej odpowiedzi.

Termin wyświetlania

Wszystkie szczegóły związane z pojedynczym elementem żądania o szacowaną emisję w przypadku lotów bezpośrednich.

Zapis JSON 
{
  "origin": string,
  "destination": string,
  "operatingCarrierCode": string,
  "flightNumber": integer,
  "departureDate": {
    object (Date)
  }
}
Pola
origin

string

To pole jest wymagane. Kod lotniska IATA miejsca wylotu, np. „LHR”.
destination

string

To pole jest wymagane. Kod lotniska IATA miejsca przylotu, np. „JFK”.
operatingCarrierCode

string

To pole jest wymagane. Kod IATA operatora, np. „AA”.
flightNumber

integer

To pole jest wymagane. Numer lotu, np. 324.
departureDate

object (Date)

To pole jest wymagane. Data lotu w strefie czasowej lotniska wylotu. Musi to być data w obecnej lub przyszłości.

Data

Reprezentuje całą datę kalendarzową lub jej część, na przykład datę urodzin. Pora dnia i strefa czasowa są podane w innym miejscu lub są nieistotne. Data odnosi się do kalendarza gregoriańskiego. Może to być:

  • Pełna data oraz wartości roku, miesiąca i dnia inne niż zero.
  • Miesiąc i dzień z zerowym rokiem (na przykład rocznica).
  • Jeden rok z zerowym miesiącem i dniem zerowym.
  • Rok i miesiąc z zerowym dniem (na przykład data ważności karty kredytowej).

Podobne typy:

Zapis JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Pola
year

integer

Rok daty. Należy podać wartość z zakresu od 1 do 9999 lub 0, aby określić datę bez roku.
month

integer

Miesiąc w roku. Należy podać wartość z zakresu od 1 do 12 lub 0, aby określić rok bez miesiąca i dnia.
day

integer

Dzień miesiąca. Należy podać wartość z zakresu od 1 do 31 i ważną dla roku i miesiąca lub 0, aby określić sam rok lub rok i miesiąc, w którym dzień nie jest istotny.

FlightWithEmissions

Lot bezpośredni z szacowaną emisją.

Zapis JSON 
{
  "flight": {
    object (Flight)
  },
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  }
}
Pola
flight

object (Flight)

To pole jest wymagane. Pasuje do identyfikatorów lotów w żądaniu. Uwaga: wszystkie kody IATA pisane są wielkimi literami.
emissionsGramsPerPax

object (EmissionsGramsPerPax)

Opcjonalnie. Wartości szacunkowej emisji na pasażera. Wartość nie jest widoczna, jeśli nie można obliczyć emisji. Listę przyczyn, dla których nie można obliczyć emisji, znajdziesz na stronie [flights.computeFlightEmissions][google.travel.sustainability.travelimpactmodel.v1.ComputeFlightEmissions].

EmissionsGramsPerPax

Pogrupowana emisja według klasy podróży.

Zapis JSON 
{
  "first": integer,
  "business": integer,
  "premiumEconomy": integer,
  "economy": integer
}
Pola
first

integer

Emisja w gramach dla jednego pasażera w pierwszej klasie. To pole jest zawsze obliczane i wypełnione, niezależnie od tego, czy samolot ma miejsca pierwszej klasy, czy nie.
business

integer

Emisja dla jednego pasażera w klasie biznesowej w gramach. To pole jest zawsze obliczane i wypełnione, niezależnie od tego, czy samolot ma miejsca w klasie biznesowej.
premiumEconomy

integer

Emisja dla jednego pasażera w klasie ekonomicznej premium w gramach. To pole jest zawsze obliczane i wypełnione, niezależnie od tego, czy samolot ma siedziska w klasie ekonomicznej premium, czy nie.
economy

integer

Emisja dla jednego pasażera w klasie ekonomicznej w gramach. To pole jest zawsze obliczane i wypełnione, niezależnie od tego, czy samolot ma miejsca w klasie ekonomicznej.

ModelVersion

Wersja modelu wpływu podróży. Więcej informacji o obsłudze wersji modelu znajdziesz na stronie https://github.com/google/travel-impact-model/#versioning.

Zapis JSON 
{
  "major": integer,
  "minor": integer,
  "patch": integer,
  "dated": string
}
Pola
major

integer

Główne wersje: duże zmiany w metodologii (np. dodanie do modelu nowych źródeł danych, które spowodowały znaczne zmiany danych wyjściowych). Takie zmiany będą wprowadzane sporadycznie i zgłaszane z wyprzedzeniem. Może to wymagać zmiany wersji interfejsu API zgodnie z wytycznymi podanymi na stronie https://cloud.google.com/endpoints/docs/openapi/versioning-an-api#backwards-incompatible.
minor

integer

Wersje podrzędne: zmiany w modelu, które, choć są spójne w różnych wersjach schematu, zmieniają parametry modelu lub implementację.
patch

integer

Wersje poprawek: zmiany w implementacji mające na celu usunięcie błędów lub nieścisłości w implementacji modelu.
dated

string

Wersje z datą: zbiory danych modelu są odtworzone z odświeżonymi danymi wejściowymi, ale algorytm regularnie się nie zmienia.