Jakie parametry mogę udostępnić?

 

Udostępnienie parametrów do Remote Control następuje przez URL:

https://mginter.mapandguide.com/v7.10/remote/remote_control.html?<nazwaparametru>=<wartość>&<nazwaparametru2>=<wartość> itd.

 

Ważne wskazówki

  • Wszystkie wartości podawane przez adres URL muszą być zakodowane w postaci adresu URL. Przykładowo spacja musi zostać zastąpiona %20. Funkcje do kodowania URL istnieją we wszystkich powszechnie dostępnych językach programowania.

  • Adres URL może mieć długość maksymalnie 32 768 znaków.

  • Wszystkie wartości udostępniane przez URL mogą być też udostępniane w formularzu HTML.

  • Wywołanie PTV Map&Guide internet poprzez Remote Control, powoduje otwarcie programu w nowym oknie. Dlatego w ustawieniach wyszukiwarki należy zdezaktywować blokadę wyskakujących okienek dla PTV Map&Guide internet.

Rada: Testowanie przekazywania

Możesz przetestować przekazywanie parametrów za pomocą formularza HTML.

Stronę testową można wywołać pod adresem: https://mginter.mapandguide.com/v7.10/remote/remote_test.html

 

Wskazówka: Z przyczyn technicznych nie można zalogować się za pomocą konta super administratora (adres e-mail). Do logowania wymagane są dane dostępowe użytkownika utworzonego w narzędziu administracyjnym, na przykład "Company123.User".

 

Do funkcji Remote Control można przekazać następujące parametry:

Dane logowania

Nazwa parametru

Opis / wartości

Przykład

 

login

Nazwa użytkownika (pole obowiązkowe) login=user
password

Hasło (pole obowiązkowe)

password=secret

language

Język (pole obowiązkowe)

Tutaj przekazuje się symbol języka, w którym ma nastąpić logowanie. Dopuszczalnymi wartościami są: CS, DE, EN, ES, FR, IT, NL, PL, RO, TR.

 language=EN

Parametry planowania trasy

Nazwa parametru

Opis / wartości

Przykład

remotetype=routing

pole obowiązkowe

Ważne: Parametr remotetype musi zostać przekazany z wartością routing. Jeżeli brakuje parametru, przekazanie nie uda się!

remotetype=routing

action

pole obowiązkowe

Parametr precyzuje, czy zostaną tylko przekazane stacje lub czy dodatkowo zostanie obliczona trasa.

in_stationlist = dodaj stacje

routing = dodaj stacje i oblicz trasę

action=in_stationlist

vehicle

Nazwa pojazdu (opcjonalnie)

Poprzez ten parametr można przekazać nazwę pojazdu. Uważaj, ponieważ nazwa pojazdu musi być przekazana w języku, w którym nastąpił komunikat.

Przykładowo nazwy pojazdów referencyjnych po angielsku RF%20truck%2040t, po hiszpańsku Camión%20RF%2040%20t.

Wskazówka: Alternatywnie do nazwy pojazdu można podać ID pojazdu. Jest to przydatne, gdy nazwa pojazdu zawiera znaki szczególne lub spacje, które mogą powodować kłopoty przy przekazywaniu za pomocą URL. Użycie ID pojazdu nie wymaga kodowania URL. ID pojazdu wyświetla się w menu aplikacji Zarządzanie pojazdami po wybraniu odpowiedniej kolumny na liście pojazdów.

vehicle=RF%20truck%2040t

timestamp Ustawia czas odjazdu (Unix Timestamp Format). timestamp=1628150657
clearlist

Kasowanie listy stacji (opcjonalnie)

1: Przed dodaniem stacji istniejąca lista stacji zostanie skasowana.

0 lub nie istnieje: Przekazane adresy zostają dodane do istniejącej listy stacji.

 clearlist=0

 

Stacje

Wskazówki: Należy przekazać przynajmniej jedna stację, ponieważ obliczanie trasy jest możliwe od dwóch stacji. Stacje podczas importu są automatycznie geokodowane (patrz Wskazówki dotyczące geokodowania).

Stacje są przekazywane za pomocą parametru s<index>. <index> podaje, w jakiej kolejności stacje są dodawane do listy stacji, s1=1. stacja, s2=2. stacja, itd.

Nazwa parametru

Opis / wartości

Przykład
num_stations

Liczba stacji

Ustala liczbę stacji (s1 bis s<n>), które można przekazać przez URL.

 num_stations=4

s<index>

 

Przekazanie stacji

(patrz Struktura stacji)

 

s1=places|town|PL|76131|Karlsruhe|Oststadt|Haid-und-Neu-Strasse|15|1|PTV%20Planung%20Transport%20Verkehr%20GmbH|937141|6270078|00:00|00:00|0|00:00|0|Snyder

Struktura stacji

Pola stacji muszą być przekazywane w następującej kolejności:

<external layer name>|<internal layer name>|<country>|<zipCode>|<town>|<district>|<street>|<housenumber>|<id>|<comment>|<x-coordinate>|<y-coordinate>|<timewindow start>|<timewindow end>|<stay days>|<stay hours>|<station fuzzy radius>|<name>

Wskazówka: Jeśli podczas importowania użyto współrzędnych, zostaną one zastosowane głównie do geokodowania. Współrzędne nie są dostosowywane do wprowadzonego adresu. Należy zatem mieć na uwadze, że współrzędne muszą być poprawne.

 

Pozycja

Pole

Opis

0

external layer name

Podanie jest konieczne ze względu na kompatybilność wsteczną, jego wartość obecnie nie podlega analizie.

1

internal layer name

Podanie jest konieczne ze względu na kompatybilność wsteczną, jego wartość obecnie nie podlega analizie.

2

country

Podanie symbolu literowego kraju

3

zipCode

Kod pocztowy

4

town

Miejscowość

5

district

Dzielnica

6

street

Ulica

7

housenumber

Numer domu

8

id

Przekazanie parametru id jest konieczne z wewnętrznych powodów programowych. Wartość przekazana poprzez id nie jest analizowana i nie jest wyświetlana w programie, zawartość parametru może być zatem pusta.

Rada: Jeżeli w programie ma być wyświetlany identyfikator stacji, można przekazać tę wartość za pomocą parametru comment.

9

comment

Komentarz

10

x-coordinate

Współrzędne w formacie PTV Mercator lub WGS84 (dziesiętnym)

11

y-coordinate

Współrzędne w formacie PTV Mercator lub WGS84 (dziesiętnym)

12

timewindow start

Start okna czasowego

13

timewindow end

Koniec okna czasowego

14

stay days

Czas pobytu w dniach

15

stay hours 00:00

Czas pobytu w godzinach

16

station fuzzy radius

Podanie otoczenia przy stacji przelotowej
17 name Określenie nazwy, na przykład nazwy klienta lub firmy

Parametry eksportu

Wyniki obliczania trasy oraz poszczególne stacje zostaną przekazane do systemu wywołującego za pośrednictwem POST do lokalnego adresu URL na komputerze klienta.

 

 

Nazwa parametru

Opis / wartości

Przykład

ticketid

Jednoznaczne nazwanie wyników planowania trasy (Pole obowiązkowe)

Ticketid to jednoznaczny łańcuch znaków, za pośrednictwem którego obcy system wywołujący może jednoznacznie przyporządkować odpowiedź do zapytania.

W praktyce może to być na przykład numer zlecenia systemu administracji podróżami.

ticketid=ticket0815

 
exportmode

Tryb eksportu (pole obowiązkowe)

0=Eksport przez HTTP POST na adres URL

Adresy URL można wprowadzić przez parametr exporturl.

exportmode=0

 

exporturl

 

URL informacji zwrotnej pole obowiązkowe

Aby działała możliwość informacji zwrotnej, wywołujący serwer sieciowy musi być ustawiony na https i mieć możliwość odbioru odpowiedzi na tym porcie. Odpowiedź składa się z dwóch parametrów: data i ticketid.

data zawiera wynik planowania trasy w postaci łańcucha znaków w wybranym formacie . JSON lub .XML.

ticketid zawiera jednoznaczny identyfikator, przekazany przez wywołujący system podczas wysyłania zapytania.

exporturl=https://localhost:8888

exportformat

Wyniki obliczania trasy można wyeksportować w formacie .JSON lub .XML.

 

Przykład informacji zwrotnej w formacie .XML (exportformat=xml)

 

<ExportedRoute>

<totalDistance>972291</totalDistance>

<totalCosts>114.39</totalCosts>

<cO2e>1149.75</cO2e>

<totalTime>350089</totalTime>

</ExportedRoute>

 

Przykład informacji zwrotnej w formacie .JSON (exportformat=json)

{

„totalDistance”: 972291,

„totalCosts”: 114.39,

"cO2e": 1149.75,

„totalTime”: 350089

}

 

exportformat=json