truck
image displayer

Truck'N Park Public XML Web Services API Documentation


Introduction


Welcome to the Truck'N Park: The I-95 Commercial Truck Parking Location System Public XML Web Services API Documentation. The Truck'N Park XML data feeds provide real-time information about truck parking spaces at selected parking facilities along the I-95 Corridor in an easy-to-use XML format for third party developers to use with their own sites, services, and applications.  The data feeds contain the same information as seen on the Truck'N Park website (www.i95truckparking.com).  The following describes how to access the various data types:

  • Real-Time Parking Lot Occupancy

Validating User Account

In order to obtain XML data, the user account must be validated using the getAuthenticationToken() method. The Truck Parking getAuthenticationToken request requires a 256 bit AES encryption key and an encrypted string to authenticate with the server. Sample code for generating the encrypted password can be found here. Upon sucessful validation, an encrypted authentication token will be returned and need to be passed to the desired web method found here, http://i95truckparking.com/Kapsch/WebServices.asmx

The data is returned in the following format.

  <AuthenticationResponse>
    <Status>SUCCESS</Status>
    <Token>WmVTDvh69kWxFP90Y7vs0vAv3TZ49slKi3NYacEtDBQvvilkIZSt6HGaD/tnqyjb3dOYp0kpzA1sOIYNInzJrg==</Token>
  </AuthenticationResponse>



The following details are specifics of the Event data elements:

Attribute

Type

Description

Status

string

Whether the user account was validated successfully.

Token

string

Authentication token that is returned upon successful validation



Real-Time Parking Lot Occupancy

Real-Time Parking Lot Occupancy data is accessed from http://i95truckparking.com/Kapsch/WebServices.asmx and the web method to use is getParkingData().

The data is returned in the following format and parking information can contain multiple parking lots.

  <parkingLot>
    <head>
      <updateTime>8/17/2017 9:36:42 AM</updateTime>
    </head>
    <location>
      <locationName>Ladysmith Safety Rest Area</locationName>
      <pointLocation>
        <geoLocationPoint>
          <latitude>37.98022 </latitude>
          <longitude>-77.49192 </longitude>
        </geoLocationPoint>
      </pointLocation>
    </location>
    <parkingFacilityID>100<parkingFacilityID>
    <parkingType>1<parkingType>
    <lotDetail>
      <spacesTotal>30<spacesTotal>
      <availability>19</availability>
      <spaces>
        <parkingArea>LS_001</parkingArea>
        <parkingAreaName>Lot 1</parkingAreaName>
        <type>1</type>
        <spaces>15</spaces>
        <availability>8</availability>
        <offlineSpaces>0</offlineSpaces>
        <unknownSpaces>0</unknownSpaces>
        <occupiedSpaces>7</occupiedSpaces>
      </spaces>
      <spaces>
        <parkingArea>LS_002</parkingArea>
        <parkingAreaName>Lot 2</parkingAreaName>
        <type>1</type>
        <spaces>15</spaces>
        <availability>11</availability>
        <offlineSpaces>0</offlineSpaces>
        <unknownSpaces>0</unknownSpaces>
        <occupiedSpaces>4</occupiedSpaces>
      </spaces>
      <lot-Name>Ladysmith Safety Rest Area</lot-Name>
    </lotDetail>
    ...
  </parkingLot>

 

The following are details on the data elements:

Attribute

Type

Description

updateTime

datetime

the last time the information for the parking lot was updated

locationName

string

the name of the parking lot

latitude/longitude

float

physical coordinates of the parking lot

parkingFacID

integer

the internal ID of the parking lot

parkingType

integer

the type of parking lot. The only value currently used is 1, for Trucks

spacesTotal

integer

the total spaces in the parking lot

availability

integer

the total parking spaces available at the current time

parkingArea

integer

the internal ID of the parking area

parkingAreaName

string

the name of the parking area.

type

integer

the type of parking lot. The only value currently used is 1, for Trucks

spaces

integer

the total number of parking spaces in the area

offlineSpaces

integer

the number of parking spaces that have been taken off-line in the area.

unknownSpaces

integer

the number of parking spaces for which a status is not available in the area. This is usually due to equipment failure

occupiedSpaces

integer

the number of parking spaces that are current occupied in the parking area

lot-Name

string

the name of the parking lot