Welcome to the GPS Insight Wiki
This Wiki contains support information, helpful tips, and general information about the GPS Insight product.
If you are trying to login to our product, please login at GPS Insight Login

Table of Contents

MAP BOOK SOAP Services

GPS Insight provides some services for map books available in a standard SOAP format. Our SOAP server uses a standard WSDL connection. Create your SOAP client with the following WSDL URL:

Visit the same URL as a web page to see the current list of available services:

Available Services

Heartbeat

This service provides a way for you to test that the server is running normally.

  • Method Name: heartbeat
  • Parameters:
    • name A test string to return from our SOAP server
  • Example Response:
 <response type="heartbeat">
   <test>test</test>
   <errors count="0"/>
 </response>

ByAddress

This query returns mapbook, page, and location based on an address request. The address will be geocoded using either a Google or Yahoo! geocoder and the resulting latitude/longitude point will be looked up in our mapbook repository.

  • Method Name: ByAddress
  • Parameters:
    • address An address string in any format accepted by Google or Yahoo! geocoders
  • Example Response:
  <response type="ByAddress">
    <matches count="1">
      <match>
        Yellow 1 Phoenix: page 152, row LW, col 189
      </match>
    </matches>
    <errors count="0"/>
  </response>
  • Example Failure Response:
  <response type="odometer">
    <matches count="0"/>
    <errors count="1">
      <error code="602">Address not found in existing mapbooks.  Please request additional mapbooks from GPS Insight.</error>
    </errors>
  </response>

ByGeocode

This query returns mapbook, page, and location based on an address request. The latitude/longitude point will be looked up in our mapbook repository.

  • Method Name: ByGeocode
  • Parameters:
    • latitude
    • longitude
  • Example Response:
  <response type="ByGeocode">
    <matches count="1">
      <match>
        Yellow 1 Phoenix: page 152, row LW, col 189
      </match>
    </matches>
    <errors count="0"/>
  </response>
  • Example Failure Response:
  <response type="odometer">
    <matches count="0"/>
    <errors count="1">
      <error code="602">Address not found in existing mapbooks.  Please request additional mapbooks from GPS Insight.</error>
    </errors>
  </response>

Error Codes

  • 601 - Street-level address not found
  • 602 - Address not found in existing mapbooks
  • 603 - Bad Request

>>See also: GPS Web Services


Personal Tools