Samouczek: tworzenie routingu zamówień pracy w czasie rzeczywistym za pomocą usługi Fabric Maps

Usługa Microsoft Fabric Maps udostępnia wizualizację geoprzestrzenną i analizę w celu dostarczania praktycznych szczegółowych informacji z danych przestrzennych w czasie rzeczywistym i historycznych.

W tym samouczku dyspozytor prac polowych w zakładzie energetycznym używa usługi Microsoft Fabric Maps do tworzenia i zarządzania zleceniami prac naprawczych, gdy zgłaszane są awarie lub błędy zasobów. Scenariusz koncentruje się na zlokalizowaniu dotkniętych klientów, wizualizacji aktywnych zamówień pracy w czasie rzeczywistym i wydajnego wysyłania załóg na potrzeby przywracania usług.

W tym samouczku pokazano, jak lokalizacje klientów są mapowane, aktywne zlecenia pracy są wyświetlane na mapie, a optymalna trasa jest obliczana przy użyciu interfejsu API Route Directions usługi Azure Maps. Samouczek kończy się zoptymalizowaną trasą pokazaną na mapie.

Mapy sieci szkieletowej są uruchamiane w ramach Fabric Real‑Time Intelligence, pobierając strumieniową telemetrię za pomocą usług Eventstream i Eventhouse do monitorowania w czasie rzeczywistym. Ukończenia zleceń roboczych i wyniki operacyjne są przechowywane w usłudze OneLake, gdzie mogą być używane do optymalizacji tras i analiz wyświetlanych na mapie.

W tym samouczku nauczysz się następujących rzeczy:

  • Utwórz Lakehouse i prześlij przykładowe dane poleceń pracy.
  • Skonfiguruj strumień zdarzeń, aby zapisywać dane zlecenia roboczego w zdarzeniówce.
  • Stwórz funkcję Kusto, aby wyodrębnić współrzędne klienta z zaimportowanych danych zlecenia roboczego.
  • Utwórz mapę i dodaj funkcję jako warstwę mapy.
  • Oblicz optymalną trasę przy użyciu interfejsu API tras usługi Azure Maps.
  • Dodaj zoptymalizowaną trasę do mapy jako warstwę.
  • Konfigurowanie ustawień mapy i warstwy.

Wymagania wstępne

Przed rozpoczęciem tego tutorialu zapoznaj się z tutorialamiReal-Time Intelligence , aby zapoznać się z podstawowymi koncepcjami i procesami pracy.

Tworzenie magazynu lakehouse i przekazywanie przykładowych danych zamówienia pracy

Aby symulować źródło przesyłania strumieniowego w czasie rzeczywistym, notes w poniższych krokach używa przykładowych danych przekazanych do usługi Lakehouse. W środowisku produkcyjnym te dane będą przesyłane strumieniowo, a nie statyczne.

Tworzenie pliku danych zamówienia pracy

Plik danych zlecenia pracy zawiera przykładowe rekordy zleceń pracy używane w tym samouczku do symulowania źródła strumieniowania w czasie rzeczywistym. Po utworzeniu pliku zaimportuj go do domku nad jeziorem w kolejnym kroku.

Skopiuj i wklej poniższą treść do pliku tekstowego, a następnie zapisz ją jako WorkorderLocations.csv. Używasz tego pliku w kolejnym kroku.

WorkorderID,Latitude,Longitude
100,48.22610712,16.32977412
101,48.23519063,16.37364699
102,48.19785896,16.38669028
103,48.18125837,16.37068261
107,48.15151126,16.41766590
108,48.20290349,16.32492121
104,48.23400591,16.4563533
105,48.18145603,16.40506946
106,48.16366378,16.36001083

Tworzenie lakehouse i importowanie pliku danych zlecenia produkcyjnego

Utwórz nowy lakehouse dla przychodzących danych o zleceniach roboczych i zaimportuj plik lokalizacji zleceń roboczych.

  1. W swoim obszarze pracy wybierz Nowy element, wpisz lakehouse w polu wyszukiwania i wybierz go, aby utworzyć nowy lakehouse.
  2. Wprowadź nazwę WorkorderLocationsLakehouse i wybierz pozycję Utwórz.
  3. W nowym lakehouse wybierz Prześlij pliki i przekaż plik WorkorderLocations.csv.
  4. W nowym lakehouse wybierz okienko Eksplorator po lewej stronie ekranu.
  5. W sekcji PlikiEksploratora wybierz pozycję WorkorderLocations.csv, aby wyświetlić przekazany plik.
  6. W obszarze Ustawienia widoku wybierz pozycję Pierwszy wiersz jako nagłówek.
  7. (Opcjonalnie) Z listy rozwijanej widoku wybierz pozycję Widok tabeli.

Zrzut ekranu przedstawiający plik WorkorderLocations.csv po zaimportowaniu go do jeziora.

Tworzenie strumienia zdarzeń i zapisywanie danych w eventhouse

W tej sekcji projektujesz przepływ strumienia zdarzeń przy użyciu niestandardowego punktu końcowego i wysyłasz dane przy użyciu notesu w celu symulowania przesyłania strumieniowego w czasie rzeczywistym.

Microsoft Fabric Eventstream to usługa strumieniowania danych w czasie rzeczywistym, która umożliwia pozyskiwanie, przetwarzanie i kierowanie danymi zdarzeń w ekosystemie Microsoft Fabric. Zapewnia środowisko bez kodu do tworzenia przepływów pracy opartych na zdarzeniach, co umożliwia bezproblemową integrację danych w czasie rzeczywistym z różnych źródeł i kierowanie ich do wielu miejsc docelowych. Aby uzyskać więcej informacji o obsługiwanych źródłach danych lub sposobie połączenia z niestandardowym endpointem, zobacz Przegląd strumieni zdarzeń Microsoft Fabric.

Pobierając dane ze strumienia zdarzeń do eventhouse, udostępniasz streaming wydarzeń do przetwarzania w Kusto, gdzie możesz je przekształcać i analizować w czasie rzeczywistym za pomocą tabel lub funkcji. Aby uzyskać więcej informacji, zobacz Omówienie usługi Eventhouse.

Tworzenie strumienia zdarzeń i eventhouse

  1. W swoim obszarze roboczym wybierz Nowy element i wpisz eventstream w polu wyszukiwania.

  2. Wybierz Eventstream.

  3. W oknie dialogowym Nowy strumień zdarzeń wprowadź nazwę: „WorkordersEventstream”, a następnie wybierz Utwórz.

  4. W ekranie "Zaprojektuj przepływ do pobierania, transformacji i trasowania zdarzeń strumieniowych" wybierz Użyj niestandardowego punktu końcowego.

    Zrzut ekranu przedstawiający ekran Projektowanie przepływu w celu pozyskiwania, przekształcania i kierowania zdarzeń przesyłania strumieniowego w Fabric z opcją

  5. W oknie dialogowym niestandardowego punktu końcowego Dodaj źródło wybierz Dodaj.

    Zrzut ekranu z oknem dialogowym

    Strumień zdarzeń został teraz utworzony. Następnie dodaj Eventhouse jako miejsce docelowe.

  6. W węźle WorkordersEventstream projektanta strumienia zdarzeń wybierz pozycję Eventhouse z listy rozwijanej Przekształć lub dodaj lokalizację docelową .

    Zrzut ekranu przedstawiający projektanta strumienia zdarzeń usługi Microsoft Fabric, który pokazuje diagram przepływu z CustomEndpoint-Source połączonego z węzłem WorkordersEventstream. Menu rozwijane jest rozwijane z kafelka 'Przekształć zdarzenia lub dodaj lokalizację docelową' po prawej stronie, wyświetlając sekcję Miejsca docelowe u dołu z kilkoma opcjami, w tym Eventhouse, wyróżnioną czerwonym prostokątem wskazującą, że powinna zostać wybrana.

  7. Okienko konfiguracji docelowej usługi Eventhouse zostanie wyświetlone po prawej stronie ekranu. Wypełnij żądane szczegóły w następujący sposób, a następnie wybierz pozycję Zapisz:

    1. Tryb pozyskiwania danych: ustaw wartość Przetwarzanie zdarzeń przed pozyskiwaniem.
    2. Nazwa miejsca docelowego: Ustawiono na WorkordersEventhouse.
    3. Obszar roboczy: lista rozwijana przedstawiająca nazwę obszaru roboczego.
    4. Eventhouse: wybierz Utwórz nową i utwórz eventhouse o nazwie WorkordersEventhouse.
    5. Baza danych KQL: Wybierz WorkordersEventhouse.
    6. Tabela docelowa KQL: wybierz link Utwórz nowy i wpisz nazwę nowej tabeli Workorders.
    7. Format danych wejściowych: wybierz Json.
    8. Aktywuj pobieranie po dodaniu źródła danych: Zaznacz pole zaznaczenia.

    Zrzut ekranu przedstawiający okienko konfiguracji docelowej usługi Eventhouse z wyświetlonym trybem pozyskiwania danych z przetwarzaniem zdarzeń przed pozyskaniem, nazwa docelowa ustawiona na wartość WorkordersEventhouse, lista rozwijana Mój obszar roboczy, lista rozwijana Eventhouse pokazuje WorkordersEventhouse z linkiem Utwórz nowy, lista rozwijana bazy danych KQL pokazująca WorkordersEventhouse, lista rozwijana tabela docelowa KQL pokazuje Nowa WorkordersEventhouse z linkiem Utwórz nowy, zaznaczone pole wyboru Aktywuj pozyskiwanie po dodaniu źródła danych i zielony przycisk Zapisz u dołu.

  8. Po dodaniu eventhouse jako miejsca docelowego, wybierz pozycję Publikuj, aby opublikować nowy eventstream.

    Zrzut ekranu przedstawiający projektanta Eventstream, pokazujący przepływ z CustomEndpoint-Workorders jako źródłem połączonym z węzłem Workorders-stream, który łączy się z celem WorkordersEventhouse. Przycisk Publikuj jest wyróżniony w prawym górnym rogu paska narzędzi. Baner trybu edycji wskazuje, że zmiany zostają aktywne po publikacji.

Uzyskaj wymagane klucze uwierzytelniania SAS

Potrzebujesz wartości nazwy centrum zdarzeń i ciągu połączenia - klucz podstawowy z sekcji klucz uwierzytelniania SAS w kodzie notesu.

  1. Wybierz właśnie dodany kafelek źródła niestandardowego punktu końcowego.

  2. W okienku Szczegóły wybierz pozycję SAS Key Authentication.

  3. Skopiuj następujące dwie wartości i zapisz je do użycia w kodzie notesu:

    • Nazwa centrum zdarzeń: używana dla zmiennej EVENT_HUB_NAME .
    • Klucz podstawowy parametrów połączenia: używany dla zmiennej CONNECTION_STR .

    Zrzut ekranu przedstawiający projektanta strumienia zdarzeń z wybraną opcją uwierzytelniania przy użyciu klucza sygnatury dostępu współdzielonego w okienku szczegółów, wyróżniając pola Nazwa centrum zdarzeń i Parametry połączenia – klucz podstawowy, wykorzystywane w kodzie notesu w dalszej części tego samouczka.

Symulowanie pozyskiwania danych w czasie rzeczywistym przy użyciu notesu

W tej sekcji utworzysz notes połączony z utworzonym wcześniej usługą Lakehouse, a następnie użyj podanego kodu, aby odczytać dane CSV i wysłać zdarzenia do strumienia zdarzeń. Proces ten symuluje pobieranie danych w czasie rzeczywistym. Na potrzeby demonstracji możesz uruchomić notatnik ręcznie lub zaplanować jego cykliczne uruchamianie.

Tworzenie notesu w obszarze roboczym usługi Fabric

Utwórz notes z kodem, aby zaimportować plik lokalizacji zamówienia pracy z usługi Lakehouse do strumienia zdarzeń utworzonego w poprzedniej sekcji. Symuluje to źródło strumieniowania w czasie rzeczywistym, które w środowisku produkcyjnym przesyła dane, a nie wykorzystuje dane statyczne.

  1. W obszarze roboczym wybierz pozycję Nowy element i wprowadź notatnik w polu wyszukiwania.

  2. Wybierz pozycję Notebook.

    Zrzut ekranu przedstawiający okno dialogowe nowego elementu usługi Microsoft Fabric z polem wyszukiwania zawierającym tekst

  3. W oknie dialogowym Nowy notatnik wpisz WorkorderLocations w polu Nazwa, a następnie wybierz pozycję Utwórz.

  4. Aby połączyć notebook z lakehouse, wybierz pozycję Z wykazu OneLake z listy rozwijanej Dodaj elementy danych.

    Zrzut ekranu przedstawiający okienko Microsoft Fabric Explorer z zakładką Elementy danych wybraną, z komunikatem Nie dodano źródeł danych i pustą ikoną folderu. Poniżej komunikatu znajduje się przycisk listy rozwijanej Dodaj elementy danych rozwinięty, aby wyświetlić trzy opcje menu: Z katalogu OneLake z ikoną bazy danych, z centrum Real-Time z ikoną błyskawicy i Nowe Lakehouse ze znakiem plus. Opcja Z katalogu OneLake jest wyróżniona ciemnym obramowaniem wskazującym zaznaczenie.

  5. Wybierz pozycję WorkorderLocationsLakehouse z katalogu OneLake i wybierz przycisk Połącz . Ten domek nad jeziorem to ten, który wcześniej stworzyłeś.

  6. Po utworzeniu notatnika i podłączeniu go do Lakehouse, wklej poniższy kod do pierwszej komórki i uruchom go, aby zainstalować SDK Azure Event Hubs:

    # Install Azure Event Hubs SDK (only needed once per environment)
    %pip install azure-eventhub
    
  7. Wybierz + Kod, aby utworzyć nową komórkę w notebooku.

    Zrzut ekranu interfejsu notatnika Microsoft Fabric pokazujący komórkę kodu z dwoma liniami kodu Python. Linia 1 zawiera komentarz brzmiący Install Azure Event Hubs SDK potrzebny tylko raz na środowisko. Linia 2 pokazuje polecenie pip install percent pip install azure-eventhub. Pod komórką kodu znajduje się podpowiedź typu Add code cell wskazująca na przycisk plus Code oznaczony czerwonym prostokątem. Po prawej stronie pojawia się przycisk Plus Markdown. W prawym górnym rogu jako wybrane jądro jest PySpark Python.

  8. Wybierz nową komórkę i wprowadź do niej następujący kod:

    from azure.eventhub import EventHubProducerClient, EventData
    import pandas as pd
    import json
    import time
    
    # Replace with your actual connection string and Event Hub name
    CONNECTION_STR = "" # Connection string-primary key
    EVENT_HUB_NAME = "" # Event hub name
    producer = EventHubProducerClient.from_connection_string(conn_str=CONNECTION_STR, eventhub_name=EVENT_HUB_NAME)
    
    df = spark.read.csv("Files/WorkorderLocations.csv", header=True, inferSchema=True)
    pdf = df.toPandas()
    total_records = len(pdf)
    
    for index, row in pdf.iterrows():
        # Convert row to dictionary
        row_dict = row.to_dict()
    
        # Truncate coordinates to 5 decimal digits
        if 'lat' in row_dict:
            row_dict['Latitude'] = round(float(row_dict['Latitude']), 5)
        if 'lon' in row_dict:
            row_dict['Longitude'] = round(float(row_dict['Longitude']), 5)
    
        # Serialize to JSON
        payload = json.dumps(row_dict)
    
        # Send to Event Hub
        event_data = EventData(payload)
        with producer:
            producer.send_batch([event_data])
    
        # Wait 100ms
        time.sleep(0.1)
    
  9. Dodaj wartości zmiennych CONNECTION_STR i EVENT_HUB_NAME , które otrzymałeś w poprzedniej sekcji zatytułowanej Pobierz wymagane klucze uwierzytelniania SAS.

  10. Uruchom kod notesu. Spowoduje to utworzenie tabeli Workorders w bazie danych KQL w WorkordersEventhouse.

Zrzut ekranu przedstawiający interfejs Eventhouse w usłudze Microsoft Fabric z tabelą Workorders, z wybraną kartą Podgląd danych. W lewym panelu nawigacyjnym wyświetlane jest drzewo baz danych KQL z rozwiniętym elementem WorkordersEventhouse, zawierającym tabele z wybraną tabelą Workorders.

Tworzenie funkcji Kusto i dodawanie jej jako warstwy mapy

W tej sekcji utworzysz funkcję Kusto, która pobiera bieżące dane lokalizacji zleceń pracy z tabeli Workorders w eventhouse, a następnie używasz tej funkcji jako źródła danych dla mapy Fabric Maps. Funkcja umożliwia mapie wyświetlanie aktywnych zamówień pracy jako warstwy, zapewniając wizualny widok zadań, które należy zaplanować i przypisać do załóg terenowych.

Tworzenie funkcji Kusto

Z twojego eventhouse (bazy danych KQL):

  1. Otwórz bazę danych KQL skojarzoną z Twoim magazynem zdarzeń.

  2. Wybierz pozycję Funkcje , a następnie pozycję Nowa funkcja.

    Zrzut ekranu przedstawiający sekcję Funkcje w interfejsie bazy danych WorkordersEventhouse, wyświetlającą widok pustego stanu z dużą okrągłą ikoną zawierającą nachodzące na siebie kwadraty. Główny nagłówek brzmi „Brak funkcji”, a poniżej znajduje się tekst pomocniczy: „Po utworzeniu funkcji pojawią się tutaj”. Wyraźny zielony przycisk oznaczony etykietą „+ Nowa funkcja” znajduje się w dolnej środkowej części panelu i zachęca użytkowników do utworzenia pierwszej funkcji. Lewy pasek boczny pokazuje drzewo nawigacji bazy danych z wybranym folderem Funkcje, podświetlonym czerwoną ramką.

    Ten krok tworzy zapytanie, które po uruchomieniu tworzy nową funkcję o nazwie WorkordersFunction.

  3. Wprowadź następujące zapytanie:

    .create-or-alter function WorkordersFunction()
    {
        Workorders
        | project Latitude, Longitude, WorkorderID
    }
    
  4. Uruchamianie zapytania.

    Zrzut ekranu przedstawiający interfejs usługi Microsoft Fabric Eventhouse z sekcją Funkcje, w której jest tworzona nowa funkcja Kusto o nazwie WorkordersFunction. Lewy pasek boczny zawiera drzewo nawigacji z wybranym folderem Functions. Panel edytora głównego wyświetla kod zapytania KQL: .create-or-alter function WorkordersFunction() { Workorders | project Latitude, Longitude, WorkorderID }. Przycisk Uruchom jest widoczny na pasku narzędzi u góry, gotowy do wykonania zapytania tworzenia funkcji. Ten krok określa źródło danych wielokrotnego użytku, które wyodrębnia współrzędne klienta z danych zamówienia pracy do użycia w wizualizacjach mapy.

    1 i 2 — zapytanie KQL używane do tworzenia funkcji WorkordersFunction .

    3 - Nowo utworzona funkcja WorkordersFunction .

  5. W folderze Functions wybierz WorkordersFunction, a następnie Podgląd wyników , aby zweryfikować, czy zwraca rekordy zlecenia pracy z ważnymi polami lokalizacji.

    Zrzut ekranu przedstawiający interfejs Eventhouse Microsoft Fabric, pokazujący funkcję WorkordersFunction Kusto z wynikami wyświetlanymi w tabeli podglądu. Lewy pasek boczny wyświetla drzewo nawigacji bazy danych z wybranym folderem Functions, pokazując nowo utworzony element WorkordersFunction. Panel główny zawiera kod zapytania KQL .create-or-alter function WorkordersFunction() { Workorders | project Latitude, Longitude, WorkorderID }. Poniżej edytora zapytań, sekcja Podgląd wyników zawiera tabelę danych z kolumnami Latitude, Longitude i WorkorderID, zawierającą dziewięć rekordów zleceń pracy z wartościami współrzędnych w regionie Wiednia, Austria (około 48 stopni szerokości geograficznej północnej i 16 stopni długości geograficznej wschodniej). Obecność wielu prawidłowych rekordów lokalizacji pokazuje, że funkcja skutecznie wyodrębnia współrzędne klienta z tabeli Workorders na potrzeby wizualizacji mapy.

Ta funkcja służy jako źródło danych wielokrotnego użytku dla warstwy danych mapy Fabric Maps, która jest przedstawiona w następnej sekcji.

Tworzenie mapy i dodawanie funkcji jako warstwy

W tej sekcji utworzysz mapę Fabric Maps i użyjesz wcześniej utworzonej funkcji KQL jako warstwy danych. Mapa jest konfigurowana z interwałem odświeżania, dzięki czemu dane zamówień pracy przesyłane strumieniowo są automatycznie aktualizowane, zapewniając niemal w czasie rzeczywistym widok przestrzenny aktywnych zamówień roboczych. Następnie zmień nazwę warstwy i dostosuj jej ustawienia, aby kontrolować sposób wyświetlania danych na mapie. Ten dynamiczny kontekst geoprzestrzenny pomaga dyspozytorom monitorować aktywność pól, oceniać zapotrzebowanie w różnych obszarach usług i podejmować bardziej świadome decyzje dotyczące routingu i przypisywania.

Tworzenie nowej mapy

  1. W obszarze roboczym wybierz pozycję Nowy element.
  2. W panelu Nowe elementy wpisz mapę w polu wyszukiwania i wybierz Mapę.
  3. W oknie dialogowym Nowa mapa wprowadź WorkordersMap w polu Nazwa i wybierz Utwórz.

Dodaj eventhouse do mapy

  1. W okienku Eksplorator wybierz pozycję Elementy Fabric, a następnie przycisk Dodaj.

  2. Wybierz pozycję Baza danych KQL z menu wyświetlanego podczas wybierania przycisku Dodaj .

    Zrzut ekranu przedstawiający interfejs mapy usługi Microsoft Fabric z okienkiem Eksplorator po lewej stronie z kartami Elementy sieci szkieletowej i źródła zewnętrzne. Karta Elementy sieci szkieletowej jest zaznaczona z przyciskiem dodawania poniżej z menu rozwijanego, które zostało wyświetlone po wybraniu przycisku dodawania. Ma wybraną bazę danych KQL. W obszarze głównym jest wyświetlana domyślna mapa świata w obszarze mapy.

  3. W katalogu OneLake wybierz utworzoną wcześniej usługę WorkordersEventhouse , a następnie wybierz pozycję Dodaj.

Wskazówka

Jeśli pojawi się błąd taki jak baza danych KQL ma chronioną etykietę, która ogranicza dostęp. Prosimy o kontakt z właścicielem bazy danych w celu uzyskania pomocy. Sprawdź etykietę wrażliwości w bazie KQL, ponieważ może ona ograniczać dostęp. Aby uzyskać więcej informacji, zobacz Stosowanie etykiet poufności do elementów Fabric.

Pokaż funkcję na mapie

  1. W okienku Eksplorator w nowej mapie wybierz element WorkordersEventhouse , który został dodany w poprzednim kroku.

  2. Przejdź do funkcji KQL WorkordersFunction i wybierz wielokrop (...), aby otworzyć menu.

  3. Wybierz pozycję Pokaż na mapie z menu podręcznego.

    Zrzut ekranu przedstawia panel Eksploratora map Microsoft Fabric z widoczną hierarchiczną strukturą drzewa z rozwiniętą sekcją bazy danych KQL. Drzewo pokazuje WorkordersEventhouse, zawierające tabelę Workorders-Event i funkcję WorkordersFunction. Obok funkcji WorkordersFunction otwarte jest menu rozwijane, w którym opcja

  4. Zostanie wyświetlone okno dialogowe Wyświetlanie danych usługi Eventhouse na mapie z wybranymi danymi podglądu . Nie są wymagane żadne zmiany. Upewnij się, że jest ona poprawna, a następnie wybierz pozycję Dalej

    Zrzut ekranu przedstawiający okno dialogowe Wyświetlanie danych Eventhouse na mapie w usłudze Microsoft Fabric z trzema krokami po lewej stronie: wyświetlanie podglądu danych z zielonym znacznikiem wyboru, ustawianie geometrii i interwału odświeżania danych oraz przeglądanie i dodawanie do mapy. Na panelu głównym jest wyświetlana wizualizacja danych przestrzennych w czasie na mapie z listą rozwijaną Wybierz zapytanie KQL, ustawioną na WorkordersFunction. Poniżej znajduje się tabela podglądu wyników zapytania zawierająca kolumny Latitude (Szerokość geograficzna), Longitude (Długość geograficzna) i WorkorderID (Identyfikator zamówienia roboczego) przedstawiająca dziewięć rekordów zleceń roboczych ze współrzędnymi w obszarze Wiedeń w Austrii. Przyciski Wstecz i Dalej są wyświetlane w prawym dolnym rogu.

  5. W kroku Ustawianie geometrii i interwału odświeżania danych ustaw pola w następujący sposób, a następnie wybierz pozycję Dalej:

    • Nazwa warstwy danych: WorkordersFunction

    • Lokalizacja kolumn geometrycznych: Dane o szerokości geograficznej i długości są w osobnych kolumnach

    • Kolumna szerokości geograficznej: szerokość geograficzna

    • Kolumna długości geograficznej: długość geograficzna

    • Interwał odświeżania danych: 5 minut

      Zrzut ekranu przedstawiający okno dialogowe usługi Microsoft Fabric zatytułowane Wyświetlanie danych usługi Eventhouse na mapie przedstawiający krok konfiguracji Ustawianie geometrii i interwału odświeżania danych. Lewy pasek boczny wyświetla trzy kroki przepływu pracy ze znacznikami wyboru wskazującymi, że zapoznawanie się z danymi jest zakończone, a krok Ustawianie geometrii i interwału odświeżania danych jest obecnie aktywny. Panel główny zawiera sekcję Warstwa danych z polem Nazwa, które zawiera WorkordersFunction, a następnie sekcję kolumny danych Geometry z trzema listami rozwijanymi: Lokalizacja kolumny Geometry ustawiona na dane szerokości i długości geograficznej znajdujące się w osobnych kolumnach, kolumna szerokości geograficznej ustawiona na Szerokość geograficzna, a kolumna długości geograficznej na Długość geograficzna. Poniżej znajduje się sekcja Odświeżanie danych z listą rozwijaną Interwał odświeżania danych ustawioną na 5 minut. Przyciski Wstecz i Dalej są wyświetlane w prawym dolnym rogu.

  6. W kroku Przeglądaj i dodaj do mapy przejrzyj ustawienia i wybierz Dodaj do mapy.

    Zrzut ekranu przedstawiający okno dialogowe wyświetlania danych Eventhouse w Microsoft Fabric na mapie, pokazujące ostatni krok przeglądu i dodawania do mapy w przepływie pracy konfiguracji. Na lewym pasku bocznym wyświetlane są trzy sekwencyjne kroki przepływu pracy: Podgląd danych oraz Ustawienia geometrii i interwału odświeżania danych zakończone zielonymi znacznikami wyboru, a Przeglądanie i dodawanie do mapy aktualnie aktywne, oznaczone niebieskim wskaźnikiem. W głównym panelu znajduje się podsumowanie ustawień konfiguracji: sekcja Źródło danych wymienia bazę danych KQL jako WorkordersEventhouse i zestaw zapytań jako WorkordersFunction. W sekcji Warstwa danych wyświetlana jest nazwa warstwy WorkordersFunction, oznaczona jako wymagana czerwoną gwiazdką. Sekcja Kolumna danych Geometria zawiera trzy wymagane pola oznaczone czerwonymi gwiazdkami: Lokalizacja kolumny Geometria ustawiona na dane szerokości i długości geograficznej w oddzielnych kolumnach, Kolumna szerokości geograficznej ustawiona na Szerokość geograficzną, a kolumna długości geograficznej ustawiona na Długość geograficzną. Sekcja Odświeżanie danych wskazuje, że interwał odświeżania jest ustawiony na 5 minut, również oznaczony jako wymagany. Stopka okna dialogowego zawiera przyciski Wstecz i Dodaj do mapy umieszczone w prawym dolnym rogu, z wyróżnionym przyciskiem Dodaj do mapy gotowym do sfinalizowania dodawania warstwy danych Eventhouse do mapy.

Wyniki funkcji pojawiają się teraz na zaktualizowanej mapie.

Zrzut ekranu pokazujący interfejs Microsoft Fabric Maps wyświetlający mapę Wiednia, Austria, z czerwonymi okrągłymi markerami wskazującymi lokalizacje zleceń pracy. Okienko Eksploratora po lewej stronie pokazuje drzewo bazy danych KQL zawierające wpisy WorkordersEventhouse i WorkordersFunction. Panel Warstwy danych w lewym górnym rogu mapy pokazuje warstwę WorkordersFunction z przełącznikiem widoczności i menu opcji.

Wygeneruj zoptymalizowaną trasę wieloprzystankową za pomocą Azure Maps Route Directions API

W tej sekcji utworzysz nowy notatnik, który pobiera współrzędne zlecenia pracy z bazy danych KQL i wywołuje interfejs API REST kierunków tras usługi Azure Maps. Włączasz funkcję optymalizacji wielu przystanków usługi, aby określić najbardziej efektywną kolejność odwiedzania poszczególnych lokalizacji oraz zwrócić geometrię trasy w tej zoptymalizowanej sekwencji. Później użyjesz tych danych wyjściowych do wyświetlenia na mapie rekomendowanej trasy technika.

Do ukończenia tej sekcji potrzebne jest konto platformy Azure z kontem usługi Azure Maps i kluczem subskrypcji. Jeśli nie masz konta w usłudze Azure, utwórz darmowe konto. Aby uzyskać więcej informacji na temat tworzenia konta usługi Azure Maps, zobacz Tworzenie konta usługi Azure Maps. Aby uzyskać więcej informacji na temat uzyskiwania klucza subskrypcji usługi Azure Maps, zobacz Get the subscription key for your account in the Azure Maps quickstart (Uzyskiwanie klucza subskrypcji dla twojego konta w przewodniku Szybki start usługi Azure Maps).

Utwórz notatnik w obszarze roboczym Fabric, który pobiera optymalną trasę

  1. Z poziomu swojego obszaru roboczego otwórz wcześniej utworzony eventhouse WorkordersEventhouse.

  2. W panelu nawigacyjnym po lewej stronie w obszarze Bazy danych KQL wybierz pozycję WorkordersEventhouse.

  3. Górny pasek menu wyświetla teraz opcję Notatnik. Wybierz go, aby utworzyć nowy zeszyt.

    Zrzut ekranu przedstawiający interfejs Microsoft Fabric Eventhouse z wybraną bazą danych WorkordersEventhouse w panelu nawigacyjnym po lewej stronie w obszarze baz danych KQL. Górny pasek menu zawiera kilka opcji, w tym Notebook, który jest wyróżniony czerwonym prostokątem, oznacza, że jest to element do wybrania. Na głównym panelu pokazano monitor aktywności danych wraz ze statystykami dotyczącymi pobierania i zapytań.

  4. W nowym notesie zapisz wartość zmiennej kustoUri . Ta wartość jest używana w nowym kodzie notesu utworzonym w kroku 6.

  5. Połącz swój notatnik z WorkorderLocationsLakehouse, wybierając pozycję Z katalogu OneLake z listy rozwijanej Dodaj elementy danych.

    Zrzut ekranu przedstawiający interfejs notesu Microsoft Fabric pokazujący komórkę kodu z kodem PySpark w języku Python. W panelu po lewej stronie wyświetlany jest przycisk Dodaj elementy danych, wyróżniony czerwonym polem, przy braku dodanych źródeł danych. W głównym obszarze kodu przedstawiono przykładowe zapytanie do odczytu danych z Kusto ze zmiennymi: kustoQuery ustawioną na wartość Workorders, kustoUri zawierającą adres URL Microsoft Fabric, oraz bazę danych ustawioną na WorkordersEventhouse. kustoUri jest wyróżniona czerwonym polem, aby wskazać, że wartość musi zostać skopiowana i użyta w kodzie notesu podanym w tym samouczku.

    Uwaga / Notatka

    Podczas tworzenia usługi Lakehouse w usłudze Microsoft Fabric punkt końcowy analizy SQL o tej samej nazwie jest tworzony automatycznie.

    Oba elementy są wyświetlane w obszarze roboczym, ale służą one różnym celom:

    • Usługa Lakehouse służy do notesów, przetwarzania platformy Spark i pozyskiwania danych.
    • Punkt końcowy analizy SQL jest interfejsem zapytań T-SQL tylko do odczytu w danych Lakehouse.

    Podczas dołączania lub tworzenia notatnika upewnij się, że wybierasz Lakehouse, a nie endpoint analityki SQL. Jeśli element WorkorderLocationsLakehouse pojawia się dwa razy w katalogu OneLake, przefiltruj według lakehouse .

  6. Gdy nowy notes zostanie utworzony i podłączony do domku nad jeziorem, wpisz następujący kod do drugiej komórki notesu, zastępując domyślny kod. Następnie dodaj wartości zmiennych, które zapisałeś w poprzednim kroku:

    import os, json, requests
    from pyspark.sql import types as T
    from pyspark.sql.functions import col
    
    # ---- Configuration ----
    AZMAPS_SUBSCRIPTION_KEY = os.environ.get(
        'AZMAPS_SUBSCRIPTION_KEY',
        '<Your Azure Maps subscription key>'
    )
    API_VERSION = '2025-01-01'
    BASE_URL    = 'https://atlas.microsoft.com'
    
    # KQL query that invokes the stored function
    kustoQuery = """WorkordersFunction()"""
    # Your Kusto URI
    kustoUri = "" 
    # Your KQL database name
    database = "WorkordersEventhouse" 
    
    # The access credentials.
    accessToken = mssparkutils.credentials.getToken(kustoUri)
    kustoDf  = spark.read\
        .format("com.microsoft.kusto.spark.synapse.datasource")\
        .option("accessToken", accessToken)\
        .option("kustoCluster", kustoUri)\
        .option("kustoDatabase", database)\
        .option("kustoQuery", kustoQuery).load()
    
    # Write transformed response to a new file so the raw output is preserved
    OUTPUT_GEOJSON_PATH_TRANSFORMED = (
        'Files/OptimizedRoute.geojson' # GeoJSON output file 
    )
    
    # ---- Read Stores from KQL database table ----
    stores_df  = spark.read\
        .format("com.microsoft.kusto.spark.synapse.datasource")\
        .option("accessToken", accessToken)\
        .option("kustoCluster", kustoUri)\
        .option("kustoDatabase", database)\
        .option("kustoQuery", kustoQuery).load()\
        .select(
                    col("WorkorderID").alias("workorder_id"),
                    col("Latitude").alias("lat"),
                    col("Longitude").alias("lon")
                )
    
    # Ordered waypoints: origin first, then the rest by workorder_id
    # (API will re-order when optimizeWaypointOrder=True)
    stores_pd = stores_df.orderBy('workorder_id').toPandas()
    waypoints_lonlat = [[float(r['lon']), float(r['lat'])] for _, r in stores_pd.iterrows()]
    
    # ---- Build Directions request body (GeoJSON) ----
    features = []
    for idx, (lon, lat) in enumerate(waypoints_lonlat):
        features.append({
            "type": "Feature",
            "geometry": {"type": "Point", "coordinates": [lon, lat]},
            "properties": {"pointIndex": idx, "pointType": "waypoint"}
        })
    
    dir_body = {
        "type": "FeatureCollection",
        "features": features,
        "optimizeRoute": "fastestWithTraffic",
        "routeOutputOptions": ["routePath"],  # ensures route path geometry in response
        "travelMode": "truck",
        "optimizeWaypointOrder": True
    }
    
    # ---- Call Azure Maps Directions (POST) ----
    url     = f"{BASE_URL}/route/directions"
    params  = {"api-version": API_VERSION}
    headers = {
        "Accept": "application/geo+json",
        "Content-Type": "application/geo+json",
        "subscription-key": AZMAPS_SUBSCRIPTION_KEY
    }
    
    resp = requests.post(url, params=params, data=json.dumps(dir_body), headers=headers)
    resp.raise_for_status()
    resp_json = resp.json()  # exact payload as returned by the API
    
    # ---- Transform: move order.optimizedIndex -> properties.optimizedIndex for all Waypoint features to add as a data label in the map----
    for feat in resp_json.get("features", []):
        props = feat.get("properties") or {}
        if props.get("type") == "Waypoint":
            order = props.get("order") or {}
            opt_idx = order.pop("optimizedIndex", None)
            if opt_idx is not None:
                props["optimizedIndex"] = opt_idx + 1
            # reassign possibly-updated order (still contains inputIndex if present)
            props["order"] = order
            feat["properties"] = props
    
    # ---- Write transformed GeoJSON ----
    from notebookutils import mssparkutils
    mssparkutils.fs.put(OUTPUT_GEOJSON_PATH_TRANSFORMED, json.dumps(resp_json), True)
    
    print(f"Transformed Directions GeoJSON (waypoints carry properties.optimizedIndex) written to {OUTPUT_GEOJSON_PATH_TRANSFORMED}")
    
  7. Wprowadź klucz subskrypcji usługi Azure Maps w kodzie notatniku dla zmiennej AZMAPS_SUBSCRIPTION_KEY, zastępując ciąg "<Twój klucz subskrypcji usługi Azure Maps>" kluczem subskrypcji usługi Azure Maps.

    Ważne

    W tym przykładzie na stałe koduje klucz subskrypcji usługi Azure Maps dla uproszczenia. Nie zapisuj na stałe tajnych danych w środowiskach produkcyjnych. Bezpieczne przechowywanie i zarządzanie tajemnicami przy użyciu usługi Azure Key Vault oraz ich odwoływanie się do nich w czasie wykonywania. Aby uzyskać więcej informacji, zobacz Najlepsze rozwiązania dotyczące ochrony wpisów tajnych.

  8. Wybierz przycisk Zapisz jako w menu i zapisz notes jako OptimizeRoute.

  9. Uruchom notes, aby utworzyć plik OptimizedRoute.geojson w katalogu Files twojego lakehouse.

    Zrzut ekranu interfejsu Microsoft Fabric pokazujący komórkę kodu notesu po prawej stronie z kodem Pythona, który pobiera dane trasy i zapisuje plik GeoJSON. W okienku Eksploratora po lewej stronie wyświetlany jest OneLake z rozwiniętym WorkorderLocation pokazującym foldery Tabele i Pliki. Folder Pliki zawiera WorkorderLocations.csv i OptimizedRoute.geojson, które są wyróżnione czerwonym polem wskazującym nowo utworzony plik wyjściowy. W środkowym panelu Pliki widoczne są oba pliki, z wyróżnionym OptimizedRoute.geojson. Dane wyjściowe z notesu na dole pokazują komunikat o powodzeniu:

Dodawanie usługi Lakehouse do mapy

  1. W okienku Eksplorator wybierz pozycję Elementy Fabric, a następnie przycisk Dodaj.
  2. Wybierz pozycję Lakehouse z menu wyświetlanego podczas wybierania przycisku Dodaj .
  3. W katalogu OneLake wybierz wcześniej utworzoną pozycję Lakehouse WorkorderLocationsLakehouse , a następnie wybierz pozycję Dodaj.

Pokaż zoptymalizowaną trasę na mapie

  1. W okienku Eksplorator w nowej mapie wybierz pozycję lakehouse WorkorderLocationsLakehouse , który został dodany w poprzednim kroku.

  2. Przejdź do OptimizedRoute.geojson w katalogu Files w swoim lakehouse i wybierz trzy kropki (...), aby wyświetlić menu kontekstowe.

  3. Wybierz pozycję Pokaż na mapie z menu podręcznego.

    Zrzut ekranu przedstawiający panel Eksploratora map usługi Microsoft Fabric przedstawiający kartę Lakehouse wybraną z rozwiniętą pozycją WorkorderLocationsLakehouse. Folder Pliki zawiera pliki OptimizedRoute.geojson i WorkorderLocations.csv. Menu kontekstowe jest otwarte obok pozycji OptimizedRoute.geojson z opcją Pokaż na mapie, wyróżnioną czerwonym prostokątem. Panel Warstw danych przedstawia pozycję WorkordersFunction jako istniejącą warstwę z przełącznikiem widoczności.

  4. W panelu Warstwy danych wyłącz widoczność dla warstwy WorkordersFunction.

Po zakończeniu nowa warstwa mapy pojawi się na Twojej mapie Fabric Maps.

Zrzut ekranu map Microsoft Fabric przedstawiający mapę ulic w Wiedniu, Austria, ze zoptymalizowaną trasą pokazaną jako niebieskie linie łączące dziewięć numerowanych punktów drogi. Okienko Eksploratora po lewej stronie pokazuje rozwiniętą kartę Lakehouse z folderem WorkorderLocationsLakehouse, zawierającym folder Files z plikami OptimizedRoute.geojson i WorkorderLocations.csv. Na panelu Warstwy danych są wyświetlane dwie warstwy: WorkordersFunction z widocznością wyłączoną i ZoptymalizowanaTrasa pokazującą połączoną ścieżkę trasy z numerowanymi przystankami od 1 do 9, wskazującą zoptymalizowaną kolejność odwiedzin.

Ustawienia warstwy mapy

Fabric Maps oferuje różne ustawienia warstw, które pozwalają kontrolować sposób prezentacji danych na mapie. W tej sekcji dostosujesz warstwę utworzoną na podstawie procesu optymalizacji tras, zmieniając nazwę warstwy, dostosowując styl symboli i konfigurując etykiety na podstawie wartości pól. Te ustawienia pomagają poprawić czytelność i ułatwić interpretowanie danych zlecenia roboczego na pierwszy rzut oka.

Zmienianie nazwy warstwy

  1. W panelu warstw danych otwórz menu opcji OptimizedRoute , wybierając elipsę (...).

  2. Wybierz Zmień nazwę.

    Zrzut ekranu przedstawiający panel warstw danych map w usłudze Microsoft Fabric, pokazujący dwie warstwy: WorkordersFunction i OptimizedRoute. Warstwa OptimizedRoute ma rozwinięte menu opcji z wyróżnioną na czerwono opcją Zmień nazwę. Wśród innych widocznych opcji menu znajdują się Dopasuj do widoku, Zduplikuj i Usuń. Panel pojawia się nad tłem mapy ulicy, przedstawiającym obszar Wiednia w Austrii.

Usuwanie etykiet na poziomie mapy

Gdy włączasz lub wyłączasz etykiety na poziomie mapy, wpływa to na etykiety tekstowe mapy. Etykiety te pochodzą z bazowego stylu mapy i obejmują:

  • Nazwy miast i miasteczek
  • Nazwy krajów i regionów
  • Nazwy dróg i autostrad
  • Nazwy cech wody (rzeki, jeziora, oceany)
  • Inne nazwy miejsc administracyjnych lub geograficznych

Gdy etykiety nie są wyświetlane, mapa podstawowa wygląda na "czystsza" i bardziej minimalna, bez tekstu nazw miejsc renderowanego na mapie podstawowej.

Aby wyłączyć etykiety mapy bazowej:

  1. Otwórz mapę w aplikacji Fabric Maps.

  2. Wybierz pozycję Ustawienia mapy na pasku menu.

  3. Znajdź pole Etykiety i odznacz je.

    Zrzut ekranu przedstawiający interfejs Microsoft Fabric Maps pokazujący mapę ulic Wiednia, Austria z fioletowymi liniami tras, które łączą wiele punktów pośrednich. Po lewej stronie jest wyświetlone okienko Eksploratora z panelem Warstwy danych zawierającym listę warstw WorkordersFunction i Zoptymalizowana trasa. Górny pasek narzędzi wyróżnia przycisk Ustawienia mapy oznaczony czerwonym prostokątem. Po prawej stronie widoczny jest panel Ustawienia mapy bazowej z niezaznaczoną opcją 'Etykiety' oznaczoną czerwonym prostokątem.

Aby uzyskać więcej informacji o ustawieniach map w Fabric Maps, zobacz Konfiguruj ustawienia mapy w Fabric Maps.

Dodawanie etykiet danych do warstwy

Etykiety danych to adnotacje oparte na danych pochodzące z co najmniej jednego pola w zestawie danych warstwy. Są one powiązane bezpośrednio z funkcjami mapy na poziomie warstwy, takimi jak punkty na mapie reprezentujące lokalizacje zamówień pracy. Więcej informacji o etykietach danych Fabric Maps można znaleźć w sekcji Ustawienia etykiet danych.

  1. Wybierz Zoptymalizowaną trasę w panelu warstw danych . Panel ustawień Zoptymalizowanej Trasy pojawia się po prawej stronie ekranu.

  2. W panelu ustawień Zoptymalizowanej trasy wybierz > ustawienia etykiet danych.

  3. Wybierz przełącznik Włącz etykiety danych , aby włączyć etykiety danych. Spowoduje to wyświetlenie większej liczby ustawień etykiety danych.

  4. Zmień następujące ustawienia etykiety danych:

    • Etykiety danych: optimizedIndex
    • Kolor tekstu: biały
    • Suwak rozmiaru tekstu jest ustawiony na 20.
    • Kolor pociągnięcia tekstu: Czarny
    • Suwak szerokości pociągnięcia tekstu ustawiony na 2

    Zrzut ekranu Microsoft Fabric Maps przedstawiający panel Ustawień etykiet danych rozwinięty po prawej stronie z przełącznikiem Włącz etykiety danych, listą rozwijaną Etykiety danych ustawioną na wartość optimizedIndex, biały selektor kolorów w Kolorze tekstu, suwak Rozmiar tekstu ustawiony na 20, Kolor obrysowania tekstu pokazujący czerń, a suwak Szerokości obrysowania tekstu ustawiony na 2. Główny obszar mapy przedstawia mapę ulic Wiednia, Austria, z fioletowymi liniami tras łączącymi numerowane punkty drogi oznaczone etykietą od 1 do 9, wskazującą zoptymalizowaną kolejność wizyt. Panel Warstwy danych po lewej stronie pokazuje WorkordersFunction z widocznością ukrytą i Optymalizowaną Trasą jako aktywną warstwą.

Podsumowanie

Ten samouczek pokazał, jak zbudować kompleksowy, real-time scenariusz routowania zleceń roboczych, korzystając z Microsoft Fabric Real-Time Intelligence i Fabric Maps. Pobierasz, transformujesz i zapytujesz dane z przesyłanych zleceń roboczych za pomocą KQL, a następnie wizualizujesz dane na mapie, tworząc dynamiczny, stale aktualizowany widok lokalizacji zleceń roboczych. Dzięki integracji logiki routingu i optymalnych obliczeń ścieżek rozwiązanie pokazuje, jak analiza geoprzestrzenna w czasie rzeczywistym może pomóc dyspozytorom i zespołom ds. operacji terenowych szybciej podejmować lepsze decyzje.

Ten wzorzec można rozszerzyć na inne scenariusze lokalizacyjne, takie jak śledzenie floty, monitorowanie zasobów czy reagowanie na incydenty. Dzięki połączeniu danych opartych na zdarzeniach, analizy opartej na języku KQL i wizualizacji opartej na mapie usługa Microsoft Fabric umożliwia przejście z nieprzetworzonych danych przesyłanych strumieniowo do praktycznych szczegółowych informacji geograficznych niemal w czasie rzeczywistym.

Dalsze kroki

Aby uzyskać więcej informacji na temat artykułów Fabric Maps omówionych w tym samouczku, zobacz: