Přehled dat o počasí

Počasí je vysoce demokratizovaná služba v zemědělství. Data Manager for Agriculture nabízí zákazníkům možnost pracovat s poskytovatelem počasí podle jejich výběru.

Data Manager for Agriculture poskytuje aktuální počasí a data předpovědi prostřednictvím přístupu založeného na rozšíření a přístupu nezávislém na poskytovateli. Zákazníci můžou spolupracovat s poskytovatelem podle svého výběru podle těchto kroků.

Přehled návrhu

Data Manager for Agriculture poskytuje data o počasí prostřednictvím přístupu nezávislého na poskytovateli, kdy uživatel nemusí znát rozhraní API poskytovatele. Místo toho můžou používat stejná rozhraní API Data Manageru for Agriculture bez ohledu na poskytovatele.

Chování rozhraní API nezávislá na poskytovateli

• Vyžádejte si data o počasí až pro 50 míst v rámci jednoho hovoru.
• Poskytnutá data prognózy nejsou starší než 15 minut a aktuální data o podmínkách nejsou starší než 10 minut.
• Jakmile se provede počáteční volání pro umístění, data se pro definovanou hodnotu TTL ukládají do mezipaměti.
• Pokud chcete mezipaměť udržovat v teple, můžete v rozšíření použít parametr s názvem apiFreshnessTimeInMinutes . Platforma ponechá úlohu spuštěnou po definovanou dobu a aktualizuje mezipaměť. Výchozí hodnota je nula, což znamená, že mezipaměť se ve výchozím nastavení nezahřeje.

Kroky pro načtení dat o počasí a ingestování do platformy Data Manager for Agriculture

Krok 1: Instalace rozšíření o počasí

Spusťte příkaz install prostřednictvím nástroje Azure Resource Manager ARM Client. Příkaz k instalaci rozšíření je uvedený tady:

Příkaz k instalaci

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

Další informace najdete v dokumentaci k rozhraní API.

Poznámka

Všechny hodnoty v rámci <> se nahradí příslušnými hodnotami prostředí.

Ukázkový výstup

{
      "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 dokončení instalace rozšíření můžete ingestovat datum počasí.

Pokud chcete aktualizovat apiFreshnessTimeInMinutes rozšíření pomocí následujícího příkazu PowerShellu

Příkaz Aktualizovat

armclient put /subscriptions/<subscriptionid>/resourceGroups/<resource-group-name>/providers/Microsoft.AgFoodPlatform/farmBeats/<farmbeats-resource-name>/<extensionid>?api-version=2021-09-01-preview '{"additionalApiProperties": {""15-day-daily-forecast"": {"apiFreshnessTimeInMinutes": <time>}, ""currents-on-demand"": {"apiFreshnessTimeInMinutes": <time>},""15-day-hourly-forecast"":{"apiFreshnessTimeInMinutes": <time>}}}'

Poznámka

Všechny hodnoty v rámci <> se nahradí příslušnými hodnotami prostředí. Výše uvedený příkaz update provede operaci sloučení opravy, což znamená, že aktualizuje čas aktuálnosti pouze pro rozhraní API uvedené v příkazu a zachová hodnoty Času aktuálnosti pro ostatní rozhraní API jako předtím.

Ukázkový výstup

{
  "id": "/subscriptions/<subscriptionid>/resourceGroups/<resource-group-name>/providers/Microsoft.AgFoodPlatform/farmBeats/<farmbeats-resource-name>/extensions/<extensionid>",
  "type": "Microsoft.AgFoodPlatform/farmBeats/extensions",
  "systemData": {
    "createdBy": "50e74af5-3b8f-4a8c-9521-4f506b4e0c16",
    "createdByType": "User",
    "createdAt": "2022-10-10T21:28:05Z",
    "lastModifiedBy": "50e74af5-3b8f-4a8c-9521-4f506b4e0c16",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2022-11-08T13:10:17Z"
  },
  "properties": {
    "extensionId": "provider",
    "extensionCategory": "Weather",
    "installedExtensionVersion": "2.0",
    "extensionApiDocsLink": "https://go.microsoft.com/fwlink/?linkid=2192974",
    "additionalApiProperties": {
      "15-day-daily-forecast": {
        "apiFreshnessTimeInMinutes": 1600
      },
      "currents-on-demand": {
        "apiFreshnessTimeInMinutes": 1600
      },
       "15-day-hourly-forecast": {
        "apiFreshnessTimeInMinutes": 1600
      }
    }
  },
  "eTag": "ea0261d0-0000-0700-0000-636a55390000",
  "name": "provider"
}

Krok 2: Načtení dat o počasí

Jakmile získáte přihlašovací údaje potřebné pro přístup k rozhraním API, budete muset zavolat rozhraní API pro načtení dat o počasí, abyste mohli načíst data o počasí.