Description

This Structure defines the coordinates of a pixel on a map image.

Attributes

x
(integer)

The pixel offset from the upper-left corner of an image along the horizontal axis.

y
(integer)

The pixel offset from the upper-left corner of an image along the vertical axis.

Description

This Structure defines a geographic point in longitude and latitude values.

The geographic coordinates are encoded in WGS84.

Attributes

longitude
(double)

Contains the longitude value of the geographic point (a decimal degree in WGS84 encoded system).

latitude
(double)

Contains the latitude value of the geographic point (a decimal degree in WGS84 encoded system).

Description

This Structure contains a rectangle definition where the corner positions are expressed in geographic coordinates (in WGS84 encoded system).

Attributes

southEastPoint
( GeoCoordinates )

Contains the geographic coordinates of the south-east point.

northWestPoint
( GeoCoordinates )

Contains the geographic coordinates of the north-west point.

Description

This Structure contains a rectangle definition where the corner positions are expressed in pixels.

Attributes

lowerRightPoint
( PixelPoint )

Contains the pixel coordinates of the lower-right point.

upperLeftPoint
( PixelPoint )

Contains the pixel coordinates of the upper-left point.

Description

This Structure contains a cost definition.

Attributes

currency
(String)

Contains the currency in which the price is expressed.

price
(double)

Contains a price value.

Description

This Structure allows defines the size in pixels of an image.

Attributes

width
(integer)

Contains the width in pixels of the image (picture/icon/map)

height
(integer)

Contains the height in pixels of the image (picture/icon/map)

Description

This Structure defines any type of location (city/place, POI, geographic coordinates).

Use

This structure is used in many request parameters to define a specific location.

In the case there is a conflict between any of these properties, the geographic property has priority, then the location unique identifier and finally the POI identifier.

Attributes

geoCoordinates
( GeoCoordinates )

Contains the geographic coordinates (in WGS84 encoded system) of a location.

locationID
(String)

Contains the unique identifier of a location. This information can represent either address or a city, and it can be obtained from Geocoding or ReverseGeocoding ViaMichelin Web Services.

poiID
( POIId )

Contains the unique identifier of a Michelin POI or of a "static POI" (client POI stored in Database on ViaMichelin Server). It can be obtained from one of the search POI methods defined in FindPOI or FindMichelinPOI ViaMichelin Web Services.

Description

This structure contains a set of the map definitions.

Use

• pixelsToXY method defined in MapManagement Web Services (see mapDefinition attribute defined in PixelsToXYRequest structure)
• xyToPixels method defined in MapManagement Web Services (see mapDefinition attribute defined in XYToPixelsRequest structure)
• findRoadAlert method defined in FindPOI Web Services (see mapDefinition attribute defined in FindRoadAlertParams structure)

Attributes

byID
( MapDefinitionByID )

Contains the map definition defined by a unique map identifier.

Optional attribute

byScale
( MapDefinitionByScale )

Contains the map definition defined by a central point and a scale.

Optional attribute

Description

This Structure contains the specification of an address to geocode.

Use

Used in the GeocodingRequest structure to define an address to geocode.

Attributes

address
(String)

Contains an address (defined by street number and/or street name) or landmark.

This attribute must be initialised with a valid value (not null and a value different from empty string) if any valid value are defined for cityName attribute and for postalCode attribute.

cityName
(String)

Contains the city label.

This attribute must be initialised with a valid value (not null and a value different from empty string) if any valid value are defined for address attribute and for postalCode attribute.

postalCode
(String)

Contains a postal code.

This attribute must be initialised with a valid value (not null and a value different from empty string) if any valid value are defined for cityName attribute and for address attribute.

stateName
(String)

Contains an administrative area denomination.

countryCode
(String)

Contains the ISO country code.

Required attribute (not null, not empty, initialised with valid value)

Description

This Structure defines the addresses list to geocode and the geocoding method which should be used.

Use

Sent as main parameter to the getLocationsList method of the Geocoding ViaMichelin Web Services, this structure specifies the addresses list to geocode and the the geocoding method which should be used.

Attributes

addressesList
(Array of InputAddress )

Contains an array of InputAddress , which define the addresses list to geocode.

This list can contain up to 50 addresses. Beyond this limit a SOAP fault is returned.

Required attribute (not null & not empty)

mode
(integer)

Allows specifying the geocoding mode to use.

• - 0 : "Classic" geocoding mode.
• - 1 : "Extended" geocoding mode. This mode is especially suitable for mobile devices, because it allows to geocode "input addresses" defined with a reduced number of characters. In fact,when a characters string will exceeds the first three characters, the application will consider the remaining characters as if they are "Wildcards". (e.g. geocoding of the input address "Welli, Westm, GBR" returns all the addresses having in his street label a word starting by "Welli" and in his city label a word starting by "West" like "Wellington Close, Westminster" and "Duke Of Wellington Place, Westminster" ...)

Required attribute

Description

This structure defines the list of geographical coordinates for which you want to obtain the associated segments of road.

Use

Sent as main parameter to the getLocationsList method of the ReverseGeocoding ViaMichelin Web Services, this structure specifies the geographical coordinates for which you want to obtain the associated segments of road.

Attributes

geoCoordinatesList
(Array of GeoCoordinates )

Contains the list of geographic coordinates used to search locations.

This list can contain up to 200 geographic coordinates. Beyond this limita SOAP fault is returned.

Required attribute (not null, not empty)

Description

This structure contains the departure point and a set of arrival points for which you want to obtain the distance (as the crow flies) separating them.

Use

Sent as main parameter to the getDistances method of the DistanceCalculation ViaMichelin Web Services, thisstructure specifies the departure point and a set of arrival points for which you want to obtain the distance (as the crow flies) separating them.

Attributes

departurePoint
( GeoCoordinates )

Contains the geographic coordinates (in WGS84 encoded system) of the departure point.

Required attribute (not null, initialised with valid coordinates)

arrivalPoints
(Array of GeoCoordinates )

Contains the list of geographic coordinates (in WGS84 encoded system) of arrival points.

This list can contain up to 1000 geographic coordinates. Beyond this limita SOAP fault is returned.

Required attribute (not null, not empty)

Description

This Structure contains the description of all locations/POIs matching search criteria as well as information about the search (search status & number of found elements)

Use

This structure is used to store the results list corresponding to a POI search, a geocoding or a reverse-geocoding.

Attributes

searchStatus
(integer)

Contains the status flag of the search.

• 0: One or more locations or POIs have been found.
• 1: No location/POI found as no known location corresponds to the search request.
• 2: No location/POI found as supplied geographic coordinates are invalid. (This occurs when the "geographic coordinates" in supplied reverseGeocoding request is null or invalid)
• 3: No location/POI found as supplied address is invalid (This occurs when the "input address" in supplied geocoding request is null).
• 4: No location found as some required fields of input address are missing. (This occurs when an insufficient number of attributes is specified in the "input address" in supplied geocoding request).
• 5: No location found as supplied country value in input address is invalid. (This occurs when supplied countryCode field value of input address is null or equal to empty string or equal to unsupported country code).
• 8: search not computed, item out of bound. (This occurs when the number of input address in supplied geocoding request or the number of geographic coordinates in supplied reverse geocoding request exceed the defined limits).
• 9: No location found as an unexpected error occurs (the treatment will not be taken into account).
• 10: No location found as the supplied scale is not valid (findRoadAlert only)

size
(integer)

Contains the number of locations/POIS found matching a location search or a POI search.

foundLocations
(Array of FoundLocation )

Contains a range of FoundLocation , which defines the list of locations/POIs corresponding to the search.

Description

This Structure contains the complete description of a found location/POI as well as information about the accuracy of this result relative to the search.

Use

This structure is defined/used in FoundLocationList structure.

Attributes

distance
(integer)

Contains the distance from the search centre or from the route.

duration
(integer)

Contains the duration from the search centre or from the route.

locationDesc
( Location )

Contains the complete description of the location/POI found.

Description

This Structure contains the complete description of a found location/POI

Use

This structure is defined/used in FoundLocation structure.

Attributes

id
(String)

Contains a unique identifier of found location (It is initialised with null value for a POI search).

type
(integer)

Contains the found location type.

Available values are:

• 0: if the location describes a city level address (a city or a place).
• 1: if the location describes an administrative area (region, state, country...) ( For future use )
• 2: if the location describes a POI.
• 3: if the location describes a street level address.

geoCoordinates
( GeoCoordinates )

Contains the geographic coordinates (in WGS84 encoded system) of the found location.

address
( Address )

Contains the address description.

poi
( POI )

Contains the POI description.

Description

This Structure contains the complete address description of a found location/POI

Use

This structure is defined/used in Location structure.

Attributes

coherenceDegree
( CoherenceDegreeInfo )

Contains the coherent level of the found result compared the supplied request.

formattedCityLine
(String)

Contains the correctly formatted value of the city address line (e.g.: "Westminster SW1X 9PY").

It can be initialised with "null" value.

formattedStreetLine
(String)

Contains the correctly formatted value of the street address line.

It can be initialised with "null" value.

details
( AddressDetails )

Contains more detailed information of address description.

Description

This Structure contains the coherent level of the found result compared the supplied request.

This information is only significant after an invocation of "Geocoding" or "ReverseGeocoding" Web Services.

Use

This structure is defined/used in Address structure.

Attributes

streetCoherence(integer)

Contains the coherent level of the found result compared to the street fields values of the supplied request.

Available values are:

• 0 : For "Geocoding" Web Services, this means that all supplied fields are used to find the result. For "ReverseGeocoding" Web Service, this means that the service has found a road segment.
• 1 : For "Geocoding" Web Services, this means that the street number is an approximation - the nearest known number is selected (e.g. geocoding of the input address "260 rue de Rivoli, Paris" returns the geographic coordinates of "258 rue de Rivoli, Paris")
• 2 : For "Geocoding" Web Services, this means that the supplied street number is unknown - this street number is ignored and a point in the street is selected (e.g. geocoding of the input address "20 rue de la paix, Neufchateau" returns the geographic coordinates of a point in the street "rue de la paix" in Neufchateau)
• 3 : For "Geocoding" Web Services, this means that the supplied street name is unknown – this street name is ignored and the town centre is selected (e.g. geocoding of the input address "Unknown street, London" returns the geographic coordinates of "London centre"). For ReverseGeocoding Web Service, this means that the service has not found a road segment but a city/place.

cityCoherence
(integer)

Contains the coherent level of the found result compared to the city fields values of the supplied request.

Available values are:

• 0: For "Geocoding" Web Services, this means that all supplied fields are used to find the result.
• 1: For "Geocoding" Web Services, this means that some supplied fields values are not coherent, therefore all supplied data are not taken into account (e.g. geocoding of the input address "Paris, 92150" ignores the city label and returns the geographic coordinates of "Suresnes, 92150").

Description

This Structure contains the detailed address information of a found location/POI

Use

This structure is defined/used in Address structure.

Attributes

streetNumber
(String)

Contains the street number associated with the address.

It can be initialised with "null" value if no street number is associated with the found location.

streetLabel
(String)

Contains the street denomination associated with the address.

It can be initialised with "null" value if no street denomination is associated with the found location (the location describes a town or a place).

district
(String)

Contains the district denomination associated with the address (e.g.: "Paris 01").

It can be initialised with "null" value if no district is associated with the found location.

city
(String)

Contains the city denomination associated with the address.

gathering
(String)

Contains the gathering denomination associated with the address (e.g.: "La Défense";"Bruxelles Métropole").

It can be initialised with "null" value if no gathering is associated with the found location.

state
(String)

Contains the major administrative area denomination (region, state ...) associated with the address (e.g.: "Hauts de Seine"; "Schleswig-Holstein"; "Westminster"; "Tennessee").

It can be initialised with "null" value if no administrative area is associated with the found location.

zipCode
(String)

Contains the postcode associated with the address (e.g.: "92150"; "SW1X 9PY").

countryCode
(String)

Contains the ISO country code associated with the address (e.g.: "DEU"; "USA"; "GBR").

officialCountryCode
(String)

Contains the official country code associated with the address (e.g.: "D" for Germany).

countryLabel
(String)

Contains the country denomination associated with the address (e.g.: "Deutschland"; "United States").

Diagrams

Description

This Structure contains the complete description of a POI.

Use

This structure is defined/used in Location structure.

Attributes

id
( POIId )

Contains a structure which defines a unique POI identifier.

name
(String)

Contains the name of the POI.

datasheet
(Array of KeyValuePair )

Contains a set of information/data items associated with the POI in the form of a list of key-value pair.

In the key-value pair, the key is a characters string which defines the type of the information/data stored in the value.

The list content is defined in the supplied request.

Available values for the key and associated information:

"iconId"

The icon identifier linked to the POI

"TranslatedName"

The name of the POI in the language specified in the supplied request.

"level"

Contains the level of geocoding.

• 1: city level
• 2: Street level
• 3: Street number level
• 4: arbitrary level

"tel"

The main phone number associated with the POI.

"intlTel"

The main phone number associated with the POI in international format.

"tel2"

The secondary phone number associated with the POI.

"intlTel2"

The secondary phone number associated with the POI in international format.

"fax"

The fax number associated with the POI.

"intlFax"

The fax number associated with the POI in international format.

"email"

The email address associated with the POI.

"web"

The web site URL associated with the POI.

metanumList
(Array of NumericPair )

Contains the list of numeric metadata associated with the POI in the form of a list of key-value pair.

Thislist which stores up to 50 pairs. The meaning of each value is defined by the client and depends on themetadata identifier and onthe type of the POI.

In the key-value pair, the key is an integer which defines the numeric metadata identifier. And the value is an integer which contains the value associated to this numeric metadata.

metastringList
(Array of AlphanumPair )

Contains the list of alphanumeric metadata associated with the POI in the form of a list of key-value pair.

Thislist which stores up to 15 pairs. The contents and the meaning of each value are defined by the client and depend on the metadata identifierand on the type of the POI.

In the key-value pair, the key is an integer which defines the alpha-numeric metadata identifier. The value is a characters string which contains the value associated to this alpha-numeric metadata.

descriptionList
(Array of AlphanumPair )

Contains the list of descriptions associated with the POI in the form of a list of key-value pair.

Thislist which stores up to 30 pairs. The contents and the meaning of each are defined by the client and depend on themetadata identifier (e.g. metadata 1 stores different information that metadata 2) andon the type of the POI.

In the key-value pair, the key is an integer which defines the description identifier. The value is a characters string which contains the value associated to this description.

photoList
(Array of String)

Contains a list of URL of the pictures/photos associated with the POI.

categoryList
(Array of String)

Contains the list of category codes to which belongs the POI.

Description

This Structure contains the elements whichdefine a unique POI identifier.

Use

This structure is sent as parameter to the getPoiInfo methods of the FindMichelinPOI and FindPOI ViaMichelin Web Services. Thisstructure specifies the POI for which you want to obtain a complete description.

This structure is also present in thecomplete description of a POI (see attribute id defined in the POI structure)

Attributes

Name (type)

Description

id
(String)

Contains a unique POI identifier for a POI database.

databaseId
(String)

Contains the POI database identifier.

language
(String)

Contains the language code used to translate the description fields of a POI.

• fra: French
• deu: German
• spa: Spanish
• ita: Italian
• eng: English

Description

This Structure defines a key-value pair.

Use

Attributes

key
(String)

Contains the characters string which defined the type of information stored in the value attribute.

value
(String)

Contains the value associated with the key.

Description

This Structure defines a key-value pair.

Use

Attributes

key
(integer)

Contains a numeric identifier.

value
(integer)

Contains the value associated with the key.

Description

This Structure defines a key-value pair.

Use

Attributes

key
(integer)

Contains a numeric identifier

value
(String)

Contains the value associated with the key.

Description

This Structure contains the specification of the search parameters for all the methods which allow POI to be found by keywords.

• the keywords list,
• the conditions to stop the POI search (number of expected results),
• the country in which the POI search will be restricted.

Use

• findByKeyword method of FindPOI ViaMichelin Web Services (see FindByKeywordRequest )
• findByKeyword method of FindMichelinPOI ViaMichelin Web Services (see FindByKeywordRequest )

Attributes

keywords
( TextCriteriaDefinition )

Specifies thekeywords list and their interaction mode.

Required attribute (not null, not empty)

maxResult
(integer)

Contains the maximum results which should be returned by the POI search.

A valid value must be included between 1 and a boundary value depending on the type of POI (usually 50 is used). Any invalid value will be replaced by the nearest boundary value.

Required attribute

countryCode
(String)

Contains the ISO code (three characters) of the countryin which the POI search will be restricted.

Required attribute (not null, not empty, initialised with valid value)

Description

This Structure containsthe specification of the search parameters for all the methods which find POI located nearby a central point.

• the search central point,
• the conditions to stop the POI search :
• the number of results expected,
• the distance limit to reach the POI (the search radius).

Use

• findNearbyPOI method of FindPOI ViaMichelin Web Services (see FindNearbyPOIRequest )
• findNearbyInputPOI method of FindPOI ViaMichelin Web Services (see FindNearbyInputPOIRequest )
• findNearby method of FindMichelinPOI ViaMichelin Web Services (see FindNearbyMichelinPOIRequest )

Attributes

searchCenter
( GeoCoordinates )

Contains the search central point defined bygeographic coordinates (WGS84 encoded system).

Required attribute (not null, initialised with valid value)

maxResult
(integer)

Contains the maximum results which should be returned by the POI search.

A valid value must be between 1 and a boundary value depending on the type of POI (usually 50 is used). Any invalid value will be replaced by the nearest boundary value.

Required attribute

maxDistance
(integer)

Contains the maximum distance of the search radius (expressed in metres).

The maximum search distance is 200 000 metres. Beyond this limit, any value will be treated as equal to 200 000.

The minimum search distance is 1 000 metres. Under this limit, any value will be treated as equal to 1 000.

Required attribute

Description

This Structure contains the specification of the search parameters for all the methods which find by road the POI located nearby a central point.

• the search central point,
• the itinerary options,
• the search mode,
• the conditions to stop the POI search :
• the number of results expected,
• the distance limit to reach the POI (the search radius),
• the time limit to reach the POI.

Use

• findNearbyPOIByRoad method of FindPOI ViaMichelin Web Services (see FindNearbyPOIByRoadRequest structure)
• findNearbyInputPOIByRoad method of FindPOI ViaMichelin Web Services (see FindNearbyInputPOIByRoadRequest structure)
• findNearbyByRoad method of FindMichelinPOI ViaMichelin Web Services (see FindNearbyMichelinPOIByRoadRequest structure)

Attributes

searchCenter
( GeoCoordinates )

Contains the search central point defined bygeographic coordinates (WGS84 encoded system).

Required attribute (not null, initialised with valid value)

maxResult
(integer)

Contains the maximum results which should be returned by the POI search.

A valid value must be included between 1 and a boundary value depending on the type of POI (usually 50 is used). Any invalid value will be replaced by the nearest boundary value.

Required attribute

maxDistance
(integer)

Contains the maximum distance of the search radius (expressed in metres).

The maximum search distance is 200 000 metres. Beyond this limit, any value will be treated as equal to 200 000.

The minimum search distance is 1 000 metres. Under this limit, any value will be treated as equal to 1 000.

Required attribute

maxDuration
(integer)

Contains the time limit to reach the POI (expressed in seconds).

The maximum time is 7200 seconds. Beyond this limit, any value will be treated as equal to 7200.

The minimum time is 60 seconds. Under this limit, any value will be treated as equal to 60.

Required attribute

itineraryOptions
( ItineraryOptions )

Specifies the options that influence the computation method of the route.

Required attribute (not null)

mode
(integer)

Specifies the direction in which the POI search should be performed.

• 0: normal mode finds the closest POI which they can reach from the central point.
• 1: reverse mode finds the closest POI to reach the search central point.

Required attribute

Description

This structure contains the specification of a route. It specifies the list of stopover and the route computation options.

Use

• findNearRoute method of FindPOI ViaMichelin Web Services (see FindNearRouteParams structure)
• findNearRoute method of FindMichelinPOI ViaMichelin Web Services (see FindNearRouteParams structure)

Attributes

itinerarySteps
(Array of ItineraryStep )

Contains the departure point (first item in the array), the list of intermediate stages and the arrival point (last item in the array).

The minimum number of elements is fixed at 2 (a Departure point and an arrival point). If the table contains less than one element, a SOAP fault is returned.

This list can contain up to 10stopovers. Beyond this limita SOAP fault is returned.

Required attribute (not null, not empty)

itineraryOptions
( ItineraryOptions )

Specifies the options that influence the computation method of the route.

Required attribute (not null)

Description

This Structure containsthe specification of the search parameters for all the methods which find POI located near a route.

• the route definition,
• the conditions to stop the POI search :
• the number of results expected,
• the distance limit to reach the POI from the route,
• the time limit to reach the POI from the route.

Use

• findNearRoute method of FindPOI ViaMichelin Web Services (see FindPOINearRouteRequest structure)
• findNearRoute method of FindMichelinPOI ViaMichelin Web Services (see FindMichelinPOINearRouteRequest structure)

Attributes

routeDefinition
( RouteDefinition )

Contains the definition of the route near which the POI search should be performed.

Required attribute (not null, initialised with valid value)

maxResult
(integer)

Contains the maximum results which should be returned by the POI search.

• A valid value must be between 1 and a boundary value depending on the type of POI (usually 50 is used). Any invalid value will be replaced by the nearest boundary value.

Required attribute

maxDistance
(integer)

Contains the maximum distance of the search radius (expressed in metres).

• The maximum search distance is 200 000 metres. Beyond this limit, any value will be treated as equal to 200 000.
• The minimum search distance is 1 000 metres. Under this limit, any value will be treated as equal to 1 000.

Required attribute

maxDuration
(integer)

Contains the time limit to reach the POI (expressed in seconds).

• The maximum time is 7200 seconds. Beyond this limit, any value will be treated as equal to 7200.
• The minimum time is 60 seconds. Under this limit, any value will be treated as equal to 60.

Required attribute

Description

This Structure containsthe specification of the search parameters for the methods which find daily services located nearby a central point.

• the search central point,
• the conditions to stop the POI search :
• the number of results expected,
• the distance limit to reach the POI (the search radius),
• the categories of daily services to find.

Use

• findDailyServices method of FindPOI ViaMichelin Web Services Services (see FindDailyServicesRequest structure)

Attributes

searchCenter
( GeoCoordinates )

Contains the search central point defined bygeographic coordinates (WGS84 encoded system).

Required attribute (not null, initialised with valid value)

maxResult
(integer)

Contains the maximum results which should be returned by the POI search.

• A valid value must be included between 1 and a boundary value depending on the type of POI (usually 50 is used). Any invalid value will be replaced by the nearest boundary value.

Required attribute

maxDistance
(integer)

Contains the maximum distance of the search radius (expressed in metres).

• The maximum search distance is 200 000 metres. Beyond this limit, any value will be treated as equal to 200 000.
• The minimum search distance is 1 000 metres. Under this limit, any value will be treated as equal to 1 000.

Required attribute

categories
(array of String)

Contains the daily services categories in which the POI should be found.

This attribute defines the search data set.

This list can contain up to 15categories. Beyond this limit a SOAP fault is returned.

Required attribute (not null, not empty)

Description

This Structure contains the specification of the search parameters for the methods which find "road alert" located on map.

• the definition of the map on which the POI search should be performed,
• a date

Use

• findRoadAlert method of FindPOI ViaMichelin Web Services (see FindRoadAlertRequest structure)

Attributes

mapDefinition
( InputMapDefinitionList )

Contains the definition of the map on which the "road alert" should be found.

Required attribute (not null, initialised with a valid map definition)

date
(Date)

Contains the date of the search.

It's used because the major road events, such as roadwork and road opening/closures, are defined with a validity period.

A valid value must be equal or later than the current date.

Required attribute (not null, initialised with a valid value)

Description

This Structurecontains the definition of a numeric criterion.

Use

This structure is defined/used in NumCriteriaDefinition structure.

Attributes

id
(integer)

Contains the identifier of the numeric metadata on which the criterion should be applied.

Required attribute

value
(integer)

Contains the numeric value which should be compared with the value of the numeric metadata.

Required attribute

compop
(integer)

Contains the comparison operator.

• 0: "equals" operator

Available values for other POI search type :
• 0: "equals" operator
• 1: "not equals" operator

Required attribute

Description

This Structurecontains the specification of a filter defined by a set of numeric criteria, which applies a filter on the result data set according to the values of the numeric metadata.

Use

Associated with some methods which allow to findMichelin POI or static POI (client POI stored in a Database on ViaMichelin Server), this structure is used to apply a filter on the result data set according to the values of the numeric metadata.

• findNearbyPOI , findNearbyPOIByRoad , findNearRoute and  findByKeyword methods of FindPOI ViaMichelin Web Services
• findNearby , findNearbyByRoad , findNearRoute and findByKeyword methods of the FindMichelinPOI ViaMichelin Web services.

This structure is used in BasicSearchCriteria & SearchCriteria & MichelinPOISearchCriteria structure.

Attributes

criteriaList
(Array of NumCriteria )

Contains the list of numeric criteria.

Required attribute

mode
(integer)

Contains the value which specifies the interaction between several numeric criteria.

• 0 : POI search method begins to search for POI corresponding to all the numeric criteria. If the number of found POI is insufficient (equals 0), it completes the search with corresponding POI that in certain numeric criteria. If the number of found elements is still insufficient (equals 0), it completes the POI search without taking into account numeric criteria.
• 1 : POI search method begins to search for POI corresponding to all the numeric criteria. If the number of found POI is insufficient (equals 0), it completes the search with corresponding POI that in certain numeric criteria.
• 2 : POI search method search only for POI corresponding to all the numeric criteria.

Required attribute

Description

This Structurecontains the specification of a filter defined by a set of textual criteria (keywords). This means that it allows to filter the result data set according to the POI name value, and for Michelin POI only, according to the content of alphanumeric fields

Use

Associated with some methods which allow to findMichelin POI or static POI (client POI stored in a Database on ViaMichelin Server), this structure is used to apply a filter on the result data set according to the content of alphanumeric fields.

• findNearbyPOI method of FindPOI ViaMichelin Web Services
• findNearby method of the FindMichelinPOI ViaMichelin Web services.

This structure is also used in the search parameters of the methods which allow to find POI by keywords:
• findByKeyword method of FindPOI ViaMichelin Web Services
• findByKeyword method of FindMichelinPOI ViaMichelin Web Services

This structure is defined/used in SearchCriteria & MichelinPOISearchCriteria structure.

Attributes

keywords
(String)

Contains the list of keywords separate by space character.

Required attribute

mode
(integer)

Contains the value which specifies the interaction between several keywords.

• 0 : POI search method searches for POI which contain all the specifiedkeywords.
• 1 : POI search method searches for POI which contain at least one of specifiedkeywords.

Required attribute

scope
(integer)

Contains the value which specifies the scope of the keywords search.

• 0 : POI search method searches the keywords only in the name field.
• 1 : POI search method searches the keywords in the name field and in all alphanumeric fields (descriptions & alphanumeric metadata)

Available values for static POI(client POI stored in a Database on ViaMichelin Server)search are:
• 0 : POI search method searches the keywords only in the name field.

Required attribute

Description

This Structure contains the specification of a filter to apply in a POI search.

Use

Associated with some methods which allow to findMichelin POI or static POI (client POI stored in a Database on ViaMichelin Server), this structure is used to apply a filter on the result data set according to the values of the numeric metadata.

• findNearbyPOIByRoad method of FindPOI ViaMichelin Web Services
• findNearRoute method of FindPOI ViaMichelin Web Services
• findByKeyword method of FindPOI ViaMichelin Web Services
• findNearbyByRoad method of the FindMichelinPOI ViaMichelin Web services
• findNearRoute method of the FindMichelinPOI ViaMichelin Web services
• findByKeyword method of the FindMichelinPOI ViaMichelin Web services

Attributes

numCriteria
( NumCriteriaDefinition )

Contains the specification of a filter defined by a set of numeric criteria, which applies a filter on the result data set according to the values of the numeric metadata.

Optional attribute

Description

This Structure contains the specification of a filter to apply in a POI search.

Use

Associated with some methods which allow to findstatic POI (client POI stored in a Database on ViaMichelin Server), this structure is used to apply a filter on the result data set according to the values of the numeric metadata and/or according to the content of alphanumeric fields.

• findNearbyPOI method of FindPOI ViaMichelin Web Services

Attributes

numCriteria
( NumCriteriaDefinition )

Contains the specification of a filter defined by a set of numeric criteria, which applies a filter on the result data set according to the values of the numeric metadata.

Optional attribute

textCriteria
( TextCriteriaDefinition )

Contains the specification of a filter defined by a set of textual criteria (keywords). This means that it allows filtering the result data set according to the POI name or according to the alphanumeric fields’ content.

Optional attribute

Description

This Structure contains the specification of a filter to apply in a POI search.

Use

Associated with some methods which allow findingMichelin POI, this structure is used to apply a filter on the result data set according to the values of the numeric metadata and/or according to the content of alphanumeric fields.

• findNearby method of the FindMichelinPOI ViaMichelin Web services.

Attributes

numCriteria
( NumCriteriaDefinition )

Contains the specification of a filter defined by a set of numeric criteria, which allow applying a filter on the result data set according to the values of the numeric metadata.

Optional attribute

textCriteria
( TextCriteriaDefinition )

Contains the specification of a filter defined by a set of textual criteria (keywords). This means that it allows filtering the result data set according to the POI name or according to the alphanumeric fields’ content.

Optional attribute

restrictedSearch
(boolean)

Specifies if the POI search have to be restricted to the place where the search centre has been defined.

Description

This Structure contains the specification to format a search result data set.

That allows specifying the sort order (implicit order by default) of the search result data set.

Use

This Structure is used to specify the sort order of the results which were obtained by a search of dynamic POI (POI defined by geographical co-ordinates) located nearby a central point.

• findNearbyInputPOI method of FindPOI ViaMichelin Web Services (see FindNearbyInputPOIRequest ),
• findNearbyInputPOIByRoad method of FindPOI ViaMichelin Web Services (see FindNearbyInputPOIByRoadRequest ).

Attributes

orderBy
(integer)

Allows specifying the sort order to apply on the list of found locations.

• 0 : the found locations list will be sorted by "implicit order". This means that the items in the list will be sortedaccording to the order in which they will have been found.
• 1 : the found locations list will be sorted by "distance".
• 2 : the found locations list will be sorted by "duration".

Diagrams

Description

This Structurecontains the specification to format a search result data set.

• the elements of the found location (all by default) which should be returned in the result structure,
• the language (English by default) to which the POI descriptions should be returned,
• the sort order (implicit order by default) of the search result data set.

Use

This Structure is used to specify the format of the result data set which was obtained by the search of Michelin POI or static POI (client POI stored in a Database on ViaMichelin Server).

• findByKeyword method of FindPOI ViaMichelin Web Services (see FindByKeywordRequest ),
• findDailyServices method of FindPOI ViaMichelin Web Services (see FindDailyServicesRequest ),
• findNearbyPOI method of FindPOI ViaMichelin Web Services (see FindNearbyPOIRequest ),
• findNearbyPOIByRoad method of FindPOI ViaMichelin Web Services (see findNearbyPOIByRoad ),
• findNearRoute method of FindPOI ViaMichelin Web Services (see FindNearRouteRequest ).

Attributes

language
(String)

Contains the language code used to translate the description fields of a POI.

• fra: French
• deu: German
• spa: Spanish
• ita: Italian
• eng: English

datasheetContent
(Array of String)

Contains the identifier list of the elements which should be returned in the datasheet of the POI.

If this attribute is null, all the available information of the POI datasheet will be returned.

If this attribute is empty, the POI datasheet will be empty.

Available elements identifier are :

"iconId":

The icon identifier linked to the POI

"TranslatedName":

The name of the POI in the language specified in the supplied request.

"level":

Contains the level of geocoding.

• 1: city level
• 2: Street level
• 3: Street number level
• 4: arbitrary level

"tel":

The main phone number associated with the POI.

"intlTel":

The main phone number associated with the POI in international format.

"tel2":

The secondary phone number associated with the POI.

"intlTel2":

The secondary phone number associated with the POI in international format.

"fax":

The fax number associated with the POI.

"intlFax":

The fax number associated with the POI in international format.

"email":

The email address associated with the POI.

"web":

The web site URL associated with the POI.

withAddress
(boolean)

Specifies if the address associated with found location should be returned in the response structure.

withAddressDetails
(boolean)

Specifies if the address details associated with found location should be returned in the response structure.

withMetanumList
(boolean)

Specifies if the numeric metadata associated with found location should be returned in the response structure.

withMetastringList
(boolean)

Specifies if the alphanumeric metadata associated with found location should be returned in the response structure.

withDescriptionList
(boolean)

Specifies if the descriptions associated with found location should be returned in the response structure.

withCategoryList
(boolean)

Specifies if the categories associated with found location should be returned in the response structure.

withPhotoList
(boolean)

Specifies if the photos/pictures associated with found location should be returned in the response structure.

orderBy
(integer)

Specifies the sort order to apply on the list of found locations.

• 0 : the found locations list will be sorted by "implicit order". This means that the items in the list will be sortedaccording to the order in which they will have been found.
• 1 : the found locations list will be sorted by "distance".
• 2 : the found locations list will be sorted by "duration".
• 3 : the found locations list will be sorted by "name".

Description

This Structurecontains the specification to format a search result data set.

• the language (English by default) to which the POI descriptions should be returned.

Use

This Structure is used to specify the format (language of descriptions fields)of the result data set which was obtained by the search of"road alert" located on map.

• findRoadAlert method of FindPOI ViaMichelin Web Services (see FindDailyServicesRequest structure).

Attributes

language
(String)

Contains the language code used to translate the description fields of a POI.

• fra: French
• deu: German
• spa: Spanish
• ita: Italian
• eng: English

Description

This Structure contains the search request to use withthe methods which allow finding POI by keywords.

Use

Allows to define the search request used bythe methods which allow to find POI by keywords :

• findByKeyword method of FindPOI ViaMichelin Web Services
• findByKeyword method of FindMichelinPOI ViaMichelin Web Services

Attributes

searchDataset
(String)

Contains the specification of the data set on which to perform search. In this case, a POI database identifier.

Required attribute (not null)

searchParams
( FindByKeywordsParams )

Contains the specification of the search parameters.

Required attribute (not null)

searchFilter
( BasicSearchCriteria )

Contains the specification of the filter to apply on the search result data set.

Optional attribute

resultFormat
( FoundLocationListFormat )

Contains the specification of the format of the search result data set.

That allows to specify the elements of the found location (all by default) which should be returned, the language (English by default) to which they should be returned and the sort order (implicit order by default) of the search result data set.

Optional attribute

Description

This Structure specifies the search request used tofind static POI(client POI stored in a Database on ViaMichelin Server)located nearby a central point.

Use

• findNearbyPOI method of FindPOI ViaMichelin Web Services

Attributes

searchDataset
(String)

Contains the specification of the data set on which to perform search. In this case, a POI database identifier.

Required attribute (not null)

searchParams
( FindNearbyParams )

Contains the specification of the search parameters.

Required attribute (not null)

searchFilter
( SearchCriteria )

Contains the specification of the filter to apply on the search result data set.

Optional attribute

resultFormat
( FoundLocationListFormat )

Contains the specification of the format of the search result data set.

That allows to specify the items list of the found location (all by default) which should be returned, the language (English by default) to which they should be returned and the sort order (implicit order by default) of the search result data set.

Optional attribute