Geocode Service Request and Response Parameters

Copyright © 2002-2008 Open Geospatial Consortium, Inc. All Rights Reserved. 21 Address Y Address ADTs List of 1 Addresses. May be unstructured free form address, partial or complete addresses. Primary GeocodeResponse Parameters For each Address request, the response GeocodeResponseList will contain a collection of the following parameters: Name Mandatory? Data Type Description numberOfAddresses attribute of GeocodeResponseList Y Integer non- negative Number of valid responses GeocodedAddress found by the Geocoder Service for a given Address request; may be zero. List of 1 GeocodedAddresses sorted by the Accuracy of the match, with highest accuracy first, each with the following parameters: Point Y Point Geometry The position of the GeocodedAddress response resulting from the geocoding operation. Address Y Address ADT The actual Address for the GeocodedAddress response. These are normalised addresses. GeocodeMatchCode N GeocodingQOSType The QoS information for the GeocodedAddress response. Provides information on the quality of the match. These results consist of an Accuracy float value within the range 0.0 – 1.0 and a MatchCode MatchType Copyright © 2002-2008 Open Geospatial Consortium, Inc. All Rights Reserved. 22

15.3.2.2 Reverse Geocode Service

Primary ReverseGeocodeRequest Parameters Name Mandatory? Data Type Description Position Y Position ADT The starting position lat,long for Reverse Geocoder. ReverseGeocodePrefe rence N ReverseGeocodePref erenceType Describes the preference for the response from the Reverse Geocoder Service: StreetAddress, IntersectionAddress, or PositionOfInterest Place andor PostalCode. If not specified, then the service will return the nearest StreetAddress. Primary ReverseGeocodeResponse Parameters Name Mandatory? Data Type Description List of 0 ReverseGeocodedLocations sorted by the SearchCentreDistance the distance between the starting Position in the request and each Point-Address response, in order with shortest distance first, where each ReverseGeocodedLocation has the following parameters: Address Y Address ADT The actual Address for the ReverseGeocodedLocation response. These are normalised addresses. Point Y Point geometry The position lat, long of the ReverseGeocodedLocation response. Copyright © 2002-2008 Open Geospatial Consortium, Inc. All Rights Reserved. 23 SearchCentreDistance N Float decimal metres Distance of Point from starting Position. Notes: 1. SearchArea must contain starting Position; therefore the service must be capable of validating this. 2. All response lists are sorted in order of shortest to longest SearchCentreDistance default in metres. 3. If SearchArea is not specified, only the nearest valid response is returned.

15.4 Part 4: Presentation Service

This service renders geographic information for display on a Mobile Terminal. Any OpenLS Application may call upon this service to obtain a map of a desired area, with or without map overlays that depict one or more OpenLS ADTs, such as Route Geometry, Point of Interest, Area of Interest, Location, Position andor Address. The service may also be employed to render route directions from Route Maneuver List ADT andor Route Instructions List ADT. 15.4.1.1 Output Parameters Defines what the size and encoding of the portrayed map should be using the following criteria: Width – The width of the map in pixels. Height – The height of the map in pixels. Format – Parameter that specifies what the encoding of the map should be. This is specified as a mime-type. The mime-types supported are left up to the implementation. Transparency - Boolean that defines the opacity of the background of the map. Background Color – Defines the background color of a map if it is opaque. Content – Specifies what type of content would be returned, whether the URL or the data as base64