Dataloy Distance Table XML Queries (xmlDDT)This set of services is designed so you can import Dataloy's ports and distances directly into your own shipping application. Subscribers with more than 10 licenses of our Dataloy Distance Table (DDT) can utilise all services, clients with less than 10 licenses are limited to queries without waypoints (sailing route) in XML format. The service is limited to 4000 distances/year/license. NOTE: To be implemented by someone having basic XML knowledge. Port and Distance ServicesAvailable for all subscribers:
Port Lookups Distance Lookups Distance Services With Sailing Route/Waypoint detailsAvailable for subscribers with more than 10 licenes:
|
Detailed Descriptions: |
Services Available For All Subscribers: |
XmlPortQuery Example URL: http://dataloy.com/ddt-server/XmlPort?port=TOKYO&username=USERNAME&password=PASSWORD Parameters:
This XML returns information about the port including its port_id to be included as parameter to XmlDistance. Query output: <PORTS> <PORT> <PORT_ID>100430</PORT_ID> <PORT_NAME>TOKYO</PORT_NAME> <LATITUDE>35.637</LATITUDE> <LONGITUDE>139.773</LONGITUDE> <LOCATION_CODE>TYO</LOCATION_CODE> <COUNTRY_NAME>JAPAN</COUNTRY_NAME> </PORT> </PORTS> |
XmlPort UN LocodeQuery Example URL: http://dataloy.com/ddt-server/XmlPortUNLocode?port=JPTYO&username=USERNAME&password=PASSWORD Parameters:
This XML returns information about the port including its port_id to be included as parameter to XmlDistance. Query output: <PORTS> <PORT> <PORT_ID>100430</PORT_ID> <PORT_NAME>TOKYO</PORT_NAME> <LATITUDE>35.637</LATITUDE> <LONGITUDE>139.773</LONGITUDE> <LOCATION_CODE>TYO</LOCATION_CODE> <COUNTRY_NAME>JAPAN</COUNTRY_NAME> <UN_LOCODE>JPTYO</UN_LOCODE> </PORT> </PORTS> |
XmlDistanceQuery Example URL: http://dataloy.com/ddt-server/XmlDistance?from=104146&to=100430&username=USERNAME&password=PASSWORD Parameters:
The XML this query returns the distance between the ports, and the main routing point it used when calculating the distance. Query output: <PORT_DISTANCE> <DISTANCE>11718.0</DISTANCE> <VIA>SUEZ CANAL</VIA> </PORT_DISTANCE> |
XmlDistance w/UNLocode as parameterQuery Example URL: http://dataloy.com/ddt-server/XmlDistance?from=NOBGO&to=JPTYO&username=USERNAME&password=PASSWORD&unlocode=true Parameters:
The XML this query returns the distance between the ports, and the main routing point it used when calculating the distance. Query output: <PORT_DISTANCE> <DISTANCE>11718.0</DISTANCE> <VIA>SUEZ CANAL</VIA> </PORT_DISTANCE> |
XmlDistance Point To PortQuery Example URL: http://dataloy.com/ddt-server/XmlPointToPort?from=0100N 00100E&to=100430&username=USERNAME&password=PASSWORD Parameters:
The XML this query returns the distance between the point and the port Query output: <PORT_DISTANCE> <DISTANCE>10858</DISTANCE> </PORT_DISTANCE> |
XmlDistance Port To PointQuery Example URL: http://dataloy.com/ddt-server/XmlPortToPoint?from=100430&to=0100N 00100E&username=USERNAME&password=PASSWORD Parameters:
The XML this query returns the distance between the point and the port Query output: <PORT_DISTANCE> <DISTANCE>10858</DISTANCE> </PORT_DISTANCE> |
Services Available For Subscribers With More Than 10 Licenses: |
XmlDistance w/WaypointsQuery Example URL: http://dataloy.com/ddt-server/XmlDistanceWithWp?from=104146&to=100430&username=USERNAME&password=PASSWORD Parameters:
The XML this query returns the distance between the ports, and all waypoints between. Query output: <PORT_DISTANCE> <TOTAL_DISTANCE>11718.0</TOTAL_DISTANCE> <WAYPOINTS> <WAYPOINT> <ROUTING_SEQUENCE_NO>1</ROUTING_SEQUENCE_NO> <WP_NAME>BERGEN</WP_NAME> <LATITUDE>60.392039</LATITUDE> <LONGITUDE>5.306605</LONGITUDE> <SUB_DISTANCE>0.99822</SUB_DISTANCE> </WAYPOINT> <WAYPOINT> <ROUTING_SEQUENCE_NO>2</ROUTING_SEQUENCE_NO> <WP_NAME>Bergen (Port)</WP_NAME> <LATITUDE>60.403558</LATITUDE> <LONGITUDE>5.282379</LONGITUDE> <SUB_DISTANCE>1.22086</SUB_DISTANCE> </WAYPOINT> [...] </WAYPOINTS> </PORT_DISTANCE> |
XmlPortToPoint w/WaypointsQuery Example URL: http://dataloy.com/ddt-server/XmlPortToPointWithWp?from=104146&to=100430&username=USERNAME&password=PASSWORD Parameters:
The XML this query returns the distance between the ports, and all waypoints between. Query output: <PORT_DISTANCE> <TOTAL_DISTANCE>11718.0</TOTAL_DISTANCE> <WAYPOINTS> <WAYPOINT> <ROUTING_SEQUENCE_NO>1</ROUTING_SEQUENCE_NO> <WP_NAME>BERGEN</WP_NAME> <LATITUDE>60.392039</LATITUDE> <LONGITUDE>5.306605</LONGITUDE> <SUB_DISTANCE>0.99822</SUB_DISTANCE> </WAYPOINT> <WAYPOINT> <ROUTING_SEQUENCE_NO>2</ROUTING_SEQUENCE_NO> <WP_NAME>Bergen (Port)</WP_NAME> <LATITUDE>60.403558</LATITUDE> <LONGITUDE>5.282379</LONGITUDE> <SUB_DISTANCE>1.22086</SUB_DISTANCE> </WAYPOINT> [...] </WAYPOINTS> </PORT_DISTANCE> |
XmlPointToPort w/WaypointsQuery Example URL: http://dataloy.com/ddt-server/XmlPointToPortWithWp?from=104146&to=100430&username=USERNAME&password=PASSWORD Parameters:
The XML this query returns the distance between the ports, and all waypoints between. Query output: <PORT_DISTANCE> <TOTAL_DISTANCE>11718.0</TOTAL_DISTANCE> <WAYPOINTS> <WAYPOINT> <ROUTING_SEQUENCE_NO>1</ROUTING_SEQUENCE_NO> <WP_NAME>BERGEN</WP_NAME> <LATITUDE>60.392039</LATITUDE> <LONGITUDE>5.306605</LONGITUDE> <SUB_DISTANCE>0.99822</SUB_DISTANCE> </WAYPOINT> <WAYPOINT> <ROUTING_SEQUENCE_NO>2</ROUTING_SEQUENCE_NO> <WP_NAME>Bergen (Port)</WP_NAME> <LATITUDE>60.403558</LATITUDE> <LONGITUDE>5.282379</LONGITUDE> <SUB_DISTANCE>1.22086</SUB_DISTANCE> </WAYPOINT> [...] </WAYPOINTS> </PORT_DISTANCE> |
All parameters must be written with lowercase letters. (See example URLs) |