Udostępnij przez


Obliczanie tras między punktami drogi na mapie (wersja zapoznawcza)

[Ten temat pochodzi ze wstępnej wersji dokumentacji i może ulec zmianie.]

Kontrolka mapy w aplikacji płóciennej umożliwia dodawanie punktów nawigacyjnych przy użyciu danych z tabeli zaimportowanych w skoroszycie programu Excel. Kontrolka może obliczyć trasy między punktami drogi, zmienić kolejność punktów drogi i ponownie obliczyć trasę, aby poprawić czas podróży lub odległość.

Ważne

  • Jest to funkcja w wersji zapoznawczej.
  • Funkcje w wersji zapoznawczej nie są przeznaczone do użytku w środowiskach produkcyjnych i mogą mieć ograniczoną funkcjonalność. Te funkcje są dostępne przed oficjalną wersją, aby klienci mogli uzyskać wczesny dostęp i przekazać opinię.

Będziesz potrzebować źródła danych zawierającego nazwaną tabelę z następującymi kolumnami. Każda kolumna odpowiada zaawansowanej właściwości kontrolki mapy. Każdy wiersz jest wykreślony jako pinezka do modelu.

Nazwa kolumny Odpowiada Wymagania
Nazwa (lub etykieta) RouteWaypointsLabels Opcjonalnie
Długość RouteWaypointsLongitudes Opcjonalnie (wymagane, jeśli adres nie jest podany)
Szerokość Szerokości geograficzne punktów trasy Opcjonalnie (wymagane, jeśli adres nie jest podany)
Address Adresy Punktów Trasowych Opcjonalne (wymagane, jeśli długość geograficzna i szerokość geograficzna nie są podane)

Uwaga / Notatka

Wszystkie właściwości są technicznie opcjonalne. Należy jednak podać co najmniej jeden z adresów lub pary szerokości/długości geograficznej, aby można było wykreślić lokalizację punktu wyjścia.

Importowanie punktów waypoint z tabeli programu Excel

W tym przykładzie zaimportujemy dane punktów waypoint z tabeli programu Excel o nazwie TestData.

Utwórz źródło danych

  1. Utwórz tabelę w programie Excel z następującymi danymi. Nadaj tabeli nazwę TestData.

    Name Długość Szerokość Address
    Praca -122.156481 47.663448 1 Microsoft Way, Redmond, WA 98052
    Spotkajmy się -122.221037 47.57137
    Pływanie -122.144133 47.600373
    Tenis -122.137265 47.616115

    Tabela powinna wyglądać mniej więcej tak:

    Przykładowy arkusz programu Excel z tabelą o nazwie TestData zawierającą informacje potrzebne do umieszczania punktów waypoint na mapie.

  2. Zapisz skoroszyt w usłudze OneDrive dla Firm i zamknij plik.

Wiązanie źródła danych z kontrolką mapy

  1. Utwórz aplikację Canvas. Upewnij się, że spełnia wymagania wstępne geoprzestrzenne.

  2. Wstaw kontrolkę mapy.

  3. Na karcie Właściwości kontrolki wybierz pole Route waypoints(Items) i wpisz excel.

    Zrzut ekranu przedstawiający wyszukiwanie źródła danych punktu wyjścia w celu nawiązania połączenia z kontrolką mapy w programie Power Apps Studio.

  4. Wybierz pozycję Importuj z programu Excel.

  5. Przejdź do usługi OneDrive dla Firm i wybierz zapisany wcześniej skoroszyt programu Excel.

  6. Wybierz tabelę TestData, a następnie wybierz pozycję Połącz.

    Zrzut ekranu przedstawiający panel wyboru tabeli.

  7. Na karcie Zaawansowane znajdź RouteWaypointsLabels, RouteWaypointsLatitudes, RouteWaypointsLongitudes oraz RouteWaypointsAddresses i wprowadź nazwę odpowiedniej kolumny w tabeli. (W tym przykładzie wprowadź Name w RouteWaypointsLabels, Latitude w RouteWaypointsLatitudes i tak dalej.) Ujmij nazwę kolumny w cudzysłowie.

    Uwaga / Notatka

    Adres jest wymienny z szerokością geograficzną i długością geograficzną. Jeśli podano szerokość geograficzną i długość geograficzną, adres nie jest używany. Jeśli podano adres, szerokość geograficzna i długość geograficzna nie są potrzebne. Istnieje ograniczenie liczby punktów nawigacyjnych, które mogą być wyświetlane podczas korzystania z adresu, dlatego, jeśli to możliwe, używaj współrzędnych geograficznych: szerokości i długości.

Szpilki pojawiają się na mapie w lokalizacjach opisanych przez współrzędne lub adresy w tabeli. Jeśli tabela zawiera etykiety, pinezki są oznaczone. Przypiętych pinezek numeruje się w kolejności, w jaki lokalizacje punktów waypoint są wyświetlane w tabeli.

Zrzut ekranu przedstawiający mapę z przypiętymi i oznaczonymi punktami drogi widocznymi obok właściwości mapy.

Obliczanie tras między punktami drogi

Po wybraniu kontrolki mapy otwórz kartę Właściwości i włącz opcję Włącz routing.

Kontrolka oblicza trasy między przypiętymi punktami drogi.

Zrzut ekranu przedstawiający mapę z trasami między oznaczonymi punktami nawigacyjnymi.

Uwaga / Notatka

Domyślnie kontrolka mapy zmienia kolejność środkowych punktów drogi, aby zmniejszyć czas podróży lub odległość podróży. Pierwsze i ostatnie punkty drogi są uznawane za źródło i miejsce docelowe i nie można zmienić ich kolejności. Aby zachować punkty drogi w kolejności podanej w źródle danych, włącz właściwość Zachowaj kolejność punktów waypoint kontrolki.

Właściwości

Zmień sposób obliczania trasy przy użyciu właściwości.

Majątek Description Typ Tabulator
Włączanie routingu Oblicza trasy między punktami drogi. logiczny Właściwości; Zaawansowane: UseRouting
Maintain waypoint order Określa, czy obliczona trasa zachowuje punkty trasy w kolejności podanej w źródle danych. logiczny Właściwości; Zaawansowane: RouteMaintainOrder
Optymalizowanie trasy Określa, czy trasa obliczeniowa jest zoptymalizowana pod kątem odległości, czasu lub nie jest zoptymalizowana. Lista rozwijana Właściwości; Zaawansowane: RouteOptimization
Tryb podróży trasą Określa, czy trasa jest obliczana dla samochodu, czy ciężarówki, co może wymagać uniknięcia mostów z pewnymi ograniczeniami wysokości lub wagi. Lista rozwijana Właściwości; Zaawansowane: RouteTravelMode
Pokaż pinezki tras Określa, czy pinezki są pokazywane na punktach orientacyjnych trasy. logiczny Właściwości; Zaawansowane: ShowRoutePins

Właściwości wyjściowe

Niektóre właściwości stają się dostępne tylko wtedy, gdy zmienia się trasa obliczeniowa. Te właściwości wyjściowe są umieszczane w obiekcie RouteDirection . Zdarzenie OnRouteDirectionChange to zalecany sposób używania danych wyjściowych w innych kontrolkach lub dostosowywania środowiska aplikacji.

Majątek Description Typ Tabulator
OnRouteDirectionChange Zawiera kod uruchamiany po zmianie trasy. Event Zaawansowany
RouteDirection Opisuje dane wyjściowe routingu:
  • LengthInMeters: długość w metrach całej trasy
  • TravelTimeInSeconds: Oczekiwany czas podróży w sekundach całej trasy
  • RouteGeoJSON: ciąg opisujący trasę w formacie GeoJSON
  • RouteLegs: tabela opisującą każdą część trasy:
    • Indeks: liczba reprezentująca kolejność odcinka na trasie
    • LengthInMeters: długość nogi w metrach
    • TravelTimeInSeconds: Oczekiwany czas podróży nogi w sekundach
    • StartLabel: etykieta punktu początkowego
    • StartLatitude: szerokość geograficzna punktu początkowego odcinka
    • StartLongitude: długość geograficzna punktu początkowego odcinka
    • StartAddress: adres punktu początkowego etapu
    • EndLabel: Etykieta punktu końcowego nogi
    • EndLatitude: szerokość geograficzna punktu końcowego nogi
    • EndLongitude: długość geograficzna punktu końcowego odnogi
    • EndAddress: adres punktu końcowego etapu
  • OrderedWaypoints: tabela opisując każdy punkt drogi po uporządkowaniu punktów drogi:
    • Indeks: liczba reprezentująca kolejność punktu drogi w trasie
    • Etykieta: etykieta punktu drogi
    • Szerokość geograficzna: szerokość geograficzna punktu wyjścia
    • Długość geograficzna: długość geograficzna punktu wyjścia
    • Adres: adres punktu wyjścia
Object Nie dotyczy (tylko właściwość wyjściowa)

Zobacz także

Interaktywna kontrolka mapy