Udostępnij za pośrednictwem


Pozyskiwanie danych prognozy pogody w usłudze Azure Data Manager for Agriculture

Pogoda jest wysoce zdemokratyzowaną usługą w przemyśle rolniczym. Usługa Azure Data Manager for Agriculture oferuje klientom możliwość pracy z wybranym dostawcą pogody.

Usługa Azure Data Manager for Agriculture udostępnia aktualne i prognozowane dane pogodowe za pomocą podejścia opartego na rozszerzeniu i niezależnego od dostawcy. Możesz pracować z wybranym dostawcą, wykonując kroki pisania rozszerzenia pogody.

Omówienie projektu

Ponieważ usługa Azure Data Manager for Agriculture udostępnia dane pogodowe za pośrednictwem niezależnego od dostawcy podejścia, nie musisz znać interfejsów API dostawcy. Zamiast tego możesz użyć tego samego interfejsu API usługi Azure Data Manager for Agriculture niezależnie od dostawcy.

Poniżej przedstawiono kilka uwag dotyczących zachowania interfejsów API niezależnego od dostawcy:

  • Możesz zażądać danych pogodowych dla maksymalnie 50 lokalizacji w jednym wywołaniu.
  • Dane prognozy nie są starsze niż 15 minut. Dane dotyczące bieżących warunków nie są starsze niż 10 minut.
  • Po utworzeniu początkowego wywołania dla lokalizacji dane są buforowane dla zdefiniowanego czasu wygaśnięcia (TTL).

W poniższych sekcjach przedstawiono polecenia pobierania danych pogodowych i pozyskiwania ich do usługi Azure Data Manager for Agriculture.

Krok 1. Instalowanie rozszerzenia pogody

Aby zainstalować rozszerzenie, uruchom następujące polecenie przy użyciu narzędzia ARMClient usługi Azure Resource Manager.

Zastąp wszystkie wartości w nawiasach kątowych (<>) odpowiednimi wartościami środowiska. Identyfikator rozszerzenia, który jest obecnie obsługiwany, to IBM.TWC.

armclient PUT /subscriptions/<subscriptionid>/resourceGroups/<resource-group-name>/providers/Microsoft.AgFoodPlatform/farmBeats/<farmbeats-resource-name>/extensions/<extensionid>?api-version=2020-05-12-preview '{}'

Oto przykładowe dane wyjściowe polecenia instalacji:

{
      "id": "/subscriptions/<subscriptionid>/resourceGroups/<resource-group-name>/providers/Microsoft.AgFoodPlatform/farmBeats/<farmbeats-resource-name>/extensions/<extensionid>",
      "type": "Microsoft.AgFoodPlatform/farmBeats/extensions",
      "systemData": {
        "createdBy": "testuser@abc.com",
        "createdByType": "User",`        
        "createdAt": "2021-03-17T12:36:51Z",
        "lastModifiedBy": "testuser@abc.com",
        "lastModifiedByType": "User",
        "lastModifiedAt": "2021-03-17T12:36:51Z"
      },
      "properties": {
        "category": "Weather",
        "installedExtensionVersion": "1.0",
        "extensionAuthLink": "https://www.<provider.com/integration/",
        "extensionApiDocsLink": "https://docs.<provider>.com/documentation/Weather_Data/Historical_and_Climatological_Weather/latest#_daily_historical_ag_weather_v1_0"
      },
      "eTag": "92003c91-0000-0700-0000-804752e00000",
      "name": "<provider>"
}

Po zakończeniu instalowania rozszerzenia można pozyskiwać dane pogodowe.

Krok 2. Pobieranie danych pogodowych

Po otrzymaniu poświadczeń wymaganych do uzyskania dostępu do interfejsów API należy wywołać interfejs API danych pogodowych w celu pobrania danych pogodowych.