Quali parametri posso trasmettere?

 

La trasmissione dei parametri a Remote Control avviene mediante l'URL:

https://mginter.mapandguide.com/v7.10/remote/remote_control.html?<Parametername1>=<Wert>&<Parametername2>=<Wert>, ecc.

 

Avvertenze importanti

  • Tutti i valori trasmessi devono essere codificati per l’URL. Ad esempio, uno spazio deve essere sostituito da %20. Le funzioni per la codifica URL sono presenti in tutti i comuni linguaggi di programmazione.

  • L'URL può essere lungo al massimo 32.768 caratteri.

  • Tutti i valori trasmessi tramite URL possono essere trasmessi anche in un modulo HTML.

  • Se viene aperto PTV Map&Guide internet tramite Remote Control, il programma si apre in una finestra separata. Pertanto nelle impostazioni del browser deve essere disattivato il blocco pop-up per PTV Map&Guide internet.

Suggerimento: Prova trasmissione

È possibile testare la trasmissione dei parametri tramite un modulo HTML.

La pagina di prova si apre al seguente URL: https://mginter.mapandguide.com/v7.10/remote/remote_test.html

 

Nota: Per ragioni tecniche, non è possibile accedere con l'account di super amministratore (indirizzo e-mail). Per il login, sono necessari i dati di accesso di un utente creato nello strumento di amministrazione, per esempio "Company123.User".

 

I seguenti parametri possono essere trasmessi a Remote Control:

Dati di login

Nome del parametro

Descrizione / Valori

Esempio

 

login

Nome utente (obbligatorio) login=user
password

Password (obbligatorio)

password=secret

language

Lingua (obbligatorio)

Qui viene trasmessa la sigla dei Paesi della lingua con cui deve essere eseguito il login. I valori ammessi sono: CS, DE, EN, ES, FR, IT, NL, PL, RO, TR.

 language=EN

Parametri di routing

Nome del parametro

Descrizione / Valori

Esempio

remotetype=routing

Obbligatorio

Importante: il parametro remotetype deve essere trasmesso con il valore routing. Se il parametro manca, la trasmissione fallisce!

remotetype=routing

action

Obbligatorio

Questo parametro determina se vengono inserite solo tappe stazioni o se viene anche calcolato l’itinerario.

in_stationlist = aggiungere tappe

routing = aggiungere tappe e calcolare itinerario

action=in_stationlist

vehicle

Nome del veicolo (facoltativo)

Questo parametro può essere utilizzato per trasmettere il nome di un veicolo. Si tenga presente che il nome del veicolo deve essere trasmesso nella lingua in cui avviene il login.

In caso di veicoli di riferimento in inglese ad esempio RF%20truck%2040t, in spagnolo ad esempio Camión%20RF%2040%20t.

Nota: Anziché il nome del veicolo è possibile trasmettere l’ID del veicolo. Questo è utile ad esempio se il nome del veicolo contiene caratteri speciali o spazi che causano problemi con la trasmissione tramite URL. Utilizzando l’ID veicolo non è necessaria una codifica URL. L'ID veicolo viene visualizzato nell'applicazione Gestione veicoli attivando la colonna corrispondente nell'elenco dei veicoli.

vehicle=RF%20truck%2040t

timestamp Imposta l'ora di partenza (Unix Timestamp Format). timestamp=1628150657
clearlist

Cancellare elenco tappe (facoltativo)

1: prima dell’inserimento delle tappe viene cancellato un elenco di tappe esistente.

0 o assente: gli indirizzi trasmessi vengono aggiunti a un elenco di tappe esistente.

 clearlist=0

 

Tappe

Note: Deve sempre essere trasmessa almeno una tappa, è possibile calcolare un itinerario a partire da due tappe. Le tappe vengono geocodificate automaticamente durante l’importazione (vedere Nota per la geocodifica).

Le tappe vengono trasmesse mediante il parametro s<index>. <index> indica la sequenza di inserimento delle tappe nell’elenco tappe, s1=1a tappa, s2=2a tappa, ecc.

Nome del parametro

Descrizione / Valori

Esempio
num_stations

Numero di tappe

Definisce il numero di tappe (da s1 a s<n>) che vengono trasmesse tramite URL.

 num_stations=4

s<index>

 

Trasmissione di una tappa

(vedere Costruzione di una tappa)

 

s1=places|town|DE|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

Costruzione di una tappa

I campi di una tappa devono essere trasmessi nella sequenza seguente:

<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>

Nota: Se nell'importazione vengono utilizzate le coordinate, esse verranno impiegate in via prioritaria per la geocodifica. Non avviene una comparazione tra le coordinate e l'indirizzo immesso. Assicurarsi dunque che le coordinate siano corrette.

 

Punto

Campo

Descrizione

0

external layer name

L’indicazione è richiesta per motivi di compatibilità retroattiva, il valore non viene attualmente analizzato.

1

internal layer name

L’indicazione è richiesta per motivi di compatibilità retroattiva, il valore non viene attualmente analizzato.

2

country

Indicazione delle sigle dei paesi

3

zipCode

Codice di avviamento postale

4

town

Località

5

district

Quartiere

6

street

Via

7

housenumber

Numero civico

8

id

Il trasferimento del parametro id è necessario per ragioni interne al programma. Un valore passato tramite id non viene valutato e nemmeno visualizzato nel programma, il contenuto del parametro può quindi essere vuoto.

Suggerimento: Se un identificatore di tappe deve essere visualizzato nel programma, potete passare questo valore tramite il parametro comment.

9

comment

Commento

10

x-coordinate

Coordinate in formato PTV Mercator o WGS84 (decimale)

11

y-coordinate

Coordinate in formato PTV Mercator o WGS84 (decimale)

12

timewindow start

Finestra temporale avvio

13

timewindow end

Finestra temporale fine

14

stay days

Tempo di sosta in giorni

15

stay hours 00:00

Tempo di sosta in ore

16

station fuzzy radius

Indicazione del raggio nel caso di una tappa intermedia
17 name Specifica di un nome, ad esempio il nome del cliente o della società

Parametri per l’esportazione

I risultati del calcolo dell’itinerario e le singole tappe vengono restituiti al sistema chiamante tramite un POST a un URL locale sul computer client.

 

 

Nome del parametro

Descrizione / Valori

Esempio

ticketid

Nome univoco del risultato del routing (obbligatorio)

Il ticketid è una catena di caratteri univoca tramite la quale il sistema di terzi che esegue il richiamo può assegnare la risposta alla richiesta in modo univoco.

In pratica si potrebbe trattare ad esempio del numero di ordine di un sistema di gestione degli itinerari.

ticketid=ticket0815

 
exportmode

Modalità esperto (obbligatorio)

0=Esportazione tramite un HTTPS-POST a un URL

È possibile specificare l'URL mediante il parametro exporturl.

exportmode=0

 

exporturl

 

URL della restituzione obbligatorio

Affinché la restituzione funzioni, il sistema di terzi chiamante deve essere impostato su https ed essere in grado di ricevere una risposta su questa porta. La risposta è costituita da due parametri POST: data e ticketid.

data contiene il risultato del routing come catena di caratteri nel formato selezionato, JSON o XML.

ticketid contiene l'identificazione univoca che è stata trasmessa dal sistema che ha eseguito il richiamo durante la richiesta.

exporturl=https://localhost:8888

exportformat

I risultati del calcolo dell’itinerario possono essere emessi in formato JSON o XML.

 

Esempio di restituzione in formato XML (exportformat=xml)

 

<ExportedRoute>

<totalDistance>972291</totalDistance>

<totalCosts>114.39</totalCosts>

<cO2e>1149.75</cO2e>

<totalTime>350089</totalTime>

</ExportedRoute>

 

Esempio di restituzione in formato JSON (exportformat=json)

{

"totalDistance": 972291,

"totalCosts": 114.39,

"cO2e": 1149.75,

"totalTime": 350089

}

 

exportformat=json