¿Qué parámetros puedo transferir?

 

La transmisión de parámetros al Remote Control se realiza mediante la URL:

https://mginter.mapandguide.com/v7.10/remote/remote_control.html?<NombreParámetro1>=<Valor>&<NombreParámetro2>=<Valor>, etc.

 

Notas importantes

  • Todos los valores que se transmiten deben tener codificación URL. Por ejemplo, los caracteres blancos debe reemplazarse por %20. Existen funciones para la codificación URL en todos los lenguajes de programación habituales.

  • La URL puede tener un máximo de 32.768 caracteres.

  • Todos los valores que se transmiten mediante URL también pueden transmitirse en un formulario HTML.

  • Cuando se accede a PTV Map&Guide internet por Remote Control, el programa se abre en una ventana independiente. Para ello, se debe desactivar el bloqueador de ventanas emergentes para PTV Map&Guide internet en la configuración del navegador.

Consejo: compruebe la transmisión

Puede comprobar la transmisión de parámetros mediante un formulario HTML.

Use la siguiente URL para acceder a la página de prueba: https://mginter.mapandguide.com/v7.10/remote/remote_test.html

 

Nota: Por razones técnicas, no se puede iniciar la sesión con la cuenta de superadministrador (dirección de correo electrónico). Para el inicio de sesión, se requieren los datos de acceso de un usuario creado en la herramienta de administración, por ejemplo "Company123.User".

 

Pueden transmitirse al Remote Control los siguientes parámetros:

Datos de registro

Nombre del parámetro

Descripción/valores

Ejemplo

 

login

Nombre de usuario (entrada obligatoria) login=user
password

Contraseña (entrada obligatoria)

password=secret

language

Idioma (entrada obligatoria)

Aquí se transmite el código de país del idioma con el que se debe iniciar sesión. Los valores admitidos son: CS, DE, EN, ES, FR, IT, NL, PL, RO, TR.

 language=EN

Parámetros para planificar rutas

Nombre del parámetro

Descripción/valores

Ejemplo

remotetype=routing

Entrada obligatoria

Importante: el parámetro remotetype se debe transmitir con el valor routing. Si falta el parámetro, la transmisión fallará.

remotetype=routing

action

Entrada obligatoria

Este parámetro determina si solo se introducen estaciones o si además se calcula la ruta.

in_stationlist = Introducir estaciones

routing = Introducir estaciones y calcular rutas

action=in_stationlist

vehicle

Nombre del vehículo (opcional)

Se puede transmitir un nombre de vehículo con este parámetro. Tenga en cuenta que el nombre del vehículo debe transmitirse en la lengua en la que se realiza el registro.

En vehículos de referencia en inglés, por ejemplo, RF%20truck%2040t o en español, por ejemplo, Camión%20RF%2040%20t.

Nota: Como alternativa al nombre del vehículo, también puede transferir la ID del vehículo. Esto puede ser útil si el nombre del vehículo contiene caracteres especiales o vacíos que pueden ocasionar problemas en la transmisión de la URL. Cuando se utiliza un ID de vehículo, no es necesario codificar ninguna URL. El ID del vehículo se muestra en la aplicación seleccionada Gestión de vehículos mostrando la columna correspondiente en la lista de vehículos.

vehicle=RF%20truck%2040t

timestamp Establece la hora de salida (Unix Timestamp Format). timestamp=1628150657
clearlist

Eliminar lista de estaciones (opcional

1: antes de introducir las estaciones se elimina una lista de estaciones existente.

0 o inexistente: las direcciones transferidas se añaden a una lista de estaciones existente.

 clearlist=0

 

Estaciones

Notas: Debe transferirse siempre al menos una estación, el cálculo de ruta es posible a partir de dos estaciones. Las estaciones se geocodifican automáticamente al importar (véase Notas para la geocodificación).

Las estaciones se transfieren mediante el parámetro s<index>. <index> indica con qué secuencia se han introducido las estaciones en la lista de estaciones, s1=1.ª estación, s2=2.ª estación, etc.

Nombre del parámetro

Descripción/valores

Ejemplo
num_stations

Número de estaciones

Determine el número de estaciones (de s1 a s<n>) que se transfieren por URL.

 num_stations=4

s<index>

 

Transferir una estación

(véase Creación de una estación)

 

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

Creación de una estación

Los campos de una estación deben transferirse con la siguiente secuencia:

<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: Si utiliza coordenadas al importar, estas se utilizan de forma prioritaria para la geocodificación. No se establece una comparación entre las coordenadas y una dirección determinada. Preste atención a que las coordenadas sean correctas.

 

Ubicación

Campo

Descripción

0

external layer name

Por razones de compatibilidad con versiones anteriores, es necesario introducir un valor, aunque actualmente no se tiene en cuenta.

1

internal layer name

Por razones de compatibilidad con versiones anteriores, es necesario introducir un valor, aunque actualmente no se tiene en cuenta.

2

country

Indicación del código de país

3

zipCode

Código postal

4

town

Población

5

district

Distrito

6

street

Calle

7

housenumber

N.º dirección

8

id

La transferencia del parámetro id es necesaria por razones internas del programa. Un valor pasado a través del id no se evalúa y tampoco se muestra en el programa, por lo que el contenido del parámetro puede estar vacío.

Si hay que mostrar un identificador de la sala en el programa, puede pasar este valor a través del parámetro comment.

9

comment

Comentario

10

x-coordinate

Coordenada en formato PTV Mercator o WGS84 (decimal)

11

y-coordinate

Coordenada en formato PTV Mercator o WGS84 (decimal)

12

timewindow start

Inicio de intervalo de tiempo

13

timewindow end

Fin del intervalo de tiempo

14

stay days

Tiempo de estancia en días

15

stay hours 00:00

Tiempo de estancia en horas

16

station fuzzy radius

Indicación del radio en una parada intermedia
17 name Especificación de un nombre, por ejemplo, nombre del cliente o de la empresa

Parámetro de exportación

El resultado del cálculo de rutas y las estaciones individuales se devolverán al sistema llamado mediante un POST en una URL local del equipo cliente.

 

 

Nombre del parámetro

Descripción/valores

Ejemplo

ticketid

Designación unívoca del resultado del cálculo de ruta (entrada obligatoria)

Ticketid es una cadena de caracteres unívoca mediante la cual el sistema externo al que se accede puede asignar una respuesta unívoca a las consultas.

En la práctica, puede tratarse por ejemplo del número de pedido de un sistema de gestión de rutas.

ticketid=ticket0815

 
exportmode

Modo exportación (entrada obligatoria)

0=Exportar mediante HTTPS POST a una URL

Puede indicar la URL con el parámetro exporturl.

exportmode=0

 

exporturl

 

URL de respuesta Entrada obligatoria

Para que se devuelvan los resultados, el servidor web al que se accede debe estar adaptado al protocolo https y debe poder recibir respuestas en este puerto. La respuesta incluye dos parámetros POST: data y ticketid.

data contiene el resultado del cálculo de rutas como cadena de caracteres en el formato seleccionado (JSON o XML).

ticketid contiene la referencia unívoca que se transmitirá desde el sistema llamado al realizar la consulta.

exporturl=https://localhost:8888

exportformat

Los resultados del cálculo de rutas pueden devolverse en formato JSON o formato XML.

 

Ejemplo de devolución de resultados en formato XML (exportformat=xml)

 

<ExportedRoute>

<totalDistance>972291</totalDistance>

<totalCosts>114.39</totalCosts>

<cO2e>1149.75</cO2e>

<totalTime>350089</totalTime>

</ExportedRoute>

 

Ejemplo de devolución de resultados en formato JSON (exportformat=json)

{

"totalDistance": 972291,

"totalCosts": 114.39,

"cO2e": 1149.75,

"totalTime": 350089

}

 

exportformat=json