VIAMICHELIN SOAP API


Reference Guide 03


 RoadAlertListFormat

Description

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

That allows to specify :
  • 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.

These formatting capabilities are available in the following methods :

Attributes

Name (type)

Description

language
(String)

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

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


 FindByKeywordRequest

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 SOAP API
  • findByKeyword method of FindMichelinPOI ViaMichelin SOAP API

Attributes

Name (type)

Description

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


 FindNearbyPOIRequest

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

Allows to define the search request used bythe methods which allow to find static POI(client POI stored in a Database on ViaMichelin Server)located nearby a central point:
  • findNearbyPOI method of FindPOI ViaMichelin SOAP API

Attributes

Name (type)

Description

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

 FindNearbyMichelinPOIRequest

Description

This Structure specifies the search request used tofind Michelin POI located nearby a central point.

Use

Allows to define the search request used bythe methods which allow to find Michelin POI located nearby a central point:
  • findNearby method of FindMichelinPOI ViaMichelin SOAP API

Attributes

Name (type)

Description

searchDataset
(String)

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

Required attribute (not null)

searchParams
FindNearbyParams )

Contains the specification of the search parameters.

Required attribute (not null)

searchFilter
MichelinPOISearchCriteria)

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

 FindMichelinPOINearRouteRequest

Description

This Structure specifies the search request used tofind Michelin POI located in a specific located near a route.

Use

Allows to define the search request used bythe methods which allow to Michelin located near a route:
  • findNearRoute method of FindMichelinPOI ViaMichelin SOAP API

Attributes

Name (type)

Description

searchDataset
(String)

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

Required attribute (not null)

searchParams
(FindNearRouteParams )

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 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


 DetailedPOICountRequest

Description

This Structure specifies the request used to count the number ofMichelin POI located in a city/place.

Use

Allows to define the request used by the methods which allow to count the number ofMichelin POI located in a city/place:
  • getDetailingCount method of FindMichelinPOI ViaMichelin SOAP API

Attributes

Name (type)

Description

searchDataset
(String)

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

Required attribute (not null)

locationId
(String)

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


 MapDefinition

Description

This structure is abstract and defines a common interface for all map definition.

Attributes

Name (type)

Description

mapSize
( ImgSize )

Contains the width and the height (expressed in pixels) of the map which should be generate.

The maximum map width is 900 pixels for Europe and 600 pixels for the other territories.

The minimum map width is 50 pixels. Under this limit, the value 50 is used.

The maximum map height is 900 pixels for Europe and 600 pixels for the other territories.

The minimum map height is 50 pixels. Under this limit, the value 50 is used.

Required attribute (not null)


 MapDefinitionByID (extends MapDefinition )

Description

This structure contains the attributes which defines a map by a unique identifier.

Use

This structure is used to specify the necessary parameters to generate a map from an unique map identifier (see MapByIdRequest structure).

This structure is returned in the structure which represents a generated map (see mapDefinitions attribute defined in GeneratedMap ).

This structure is returned in the structure which represents the best map definition found (see MapDefinitionList ).

Attributes

Name (type)

Description

mapSize
( ImgSize )

Contains the width and the height (expressed in pixels) of the map which should be generate.

The maximum map width is 900 pixels for Europe and 600 pixels for the other territories.

The minimum map width is 50 pixels. Under this limit, the value 50 is used.

The maximum map height is 900 pixels for Europe and 600 pixels for the other territories.

The minimum map height is 50 pixels. Under this limit, the value 50 is used.

Required attribute (not null)

mapId
(String)

Contains unique map identifier.

Required attribute (not null)


MapDefinitionByScale (extends MapDefinition )

Description

This structure contains the attributes which defines a map by a central point and a scale.

Use

This structure is used to specify the necessary parameters to generate a map from a central point and a scale(see MapByScaleRequest structure).

This structure is returned in the structure which represents a generated map (see mapDefinitions attribute defined in GeneratedMap ).

This structure is returned in the structure which represents the best map definition found (see MapDefinitionList ).

Attributes

Name (type)

Description

mapSize
( ImgSize )

Contains the width and the height (expressed in pixels) of the map which should be generate.

The maximum map width is 900 pixels for Europe and 600 pixels for the other territories.

The minimum map width is 50 pixels. Under this limit, the value 50 is used.

The maximum map height is 900 pixels for Europe and 600 pixels for the other territories.

The minimum map height is 50 pixels. Under this limit, the value 50 is used.

Required attribute (not null)

centerPoint
( GeoCoordinates )

Contains the geographic coordinates of the central point of the map.

Required attribute (not null)

pixelSize
(double)

Defines the scale of the map. (i.e. one pixel on the map is equal to "pixelSize" metres on the ground).

Required attribute


 MapDefinitionByRect(extends MapDefinition )

Description

This structure contains the attributes which defines a map by a rectangle.

Use

This structure is returned in the structure which represents a generated map (see mapDefinitions attribute defined in GeneratedMap ).

This structure is returned in the structure which represents the best map definition found (see MapDefinitionList ).

Attributes

Name (type)

Description

mapSize
( ImgSize )

Contains the width and the height (expressed in pixels) of the map which should be generate.

The maximum map width is 900 pixels for Europe and 600 pixels for the other territories.

The minimum map width is 50 pixels. Under this limit, the value 50 is used.

The maximum map height is 900 pixels for Europe and 600 pixels for the other territories.

The minimum map height is 50 pixels. Under this limit, the value 50 is used.

Required attribute (not null)

boundingRectangle
( GeoRectangle )

Contains the definition of the rectangle bordering the map.

Required attribute (not null)


 MapDefinitionList

Description

This Structure contains the description of a generated map.

Use

This structure is the result of the getBestMapDefinition method defined in MapManagement ViaMichelin SOAP API.

This structure is defined/used in GeneratedMap structure.

Attributes

Name (type)

Description

byID
( MapDefinitionByID )

Contains the map definition defined by a unique map identifier.

byScale
( MapDefinitionByScale )

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

byRectangle
( MapDefinitionByRect )

Contains the map definition defined by a rectangle.


 PinLogoInfo

Description

This Structure contains the description of a generated map.

Use

This structure is defined/used in GeneratedMap structure.

Attributes

Name (type)

Description

id
(integer)

Contains the supplied identifier of a pin-Logo.

position
( PixelPoint )

Contains the position (expressed in pixels) corresponding to the pin-Logo linked with identifier.

hotArea
( PixelRectangle )

Contains the hot area definition (expressed in pixels) corresponding to the pin-Logo linked with identifier.


 GeneratedMap

Description

This Structure contains the description of a generated map.

Use

This structure is the result of themethod which allow to generate a map :

  • getMapByID method defined in MapManagement ViaMichelin SOAP API,
  • getMapByScale method defined in MapManagement ViaMichelin SOAP API,
  • getBestMap method defined in MapManagement ViaMichelin SOAP API.

Attributes

Name (type)

Description

mapDefinitions
( MapDefinitionList )

Contains the map definition list corresponding to the generated map.

Note: This information can be reused to generate a new map.

url
(String)

Contains the URL to access to the generated map.

copyright
(String)

Contains the textual version of the copyright which must be associated with the generated map.

pinLogoInfo
(Array of PinLogoInfo )

Contains the information about each pin-Logo supplied (visible or not on the map).


 MapAction

Description

This structure contains the specification of the actions to be realised on a map.

Use

This structure is defined/used in MapOptions structure.

Attributes

Name (type)

Description

type 
(integer)

Contains the type of action to be realised.

Available values are:
  • 0: Horizontal shifting
  • 1: Vertical shifting
  • 2: Zoom in
  • 3: Zoom out

Required attribute

value
(integer)

Contains the value associated with the action type:

  • With horizontal shifting action, value contains a shifting factor. A shifting factor under zero specifies a west shifting, otherwise an east shifting.
  • With vertical shifting action, value contains a shifting factor. A shifting factor under zero specifies a south shifting, otherwise a north shifting.
  • With zoom in and zoom out actions, value will not be taken into account.

Required attribute


 MapOptions

Description

This structure is abstract and defines the attributes which all the requests of map generation have in common.

Use

This structure is defined/used in MapRequest , MapByIdRequest , MapByScaleRequest , BestMapRequest structures.

Attributes

Name (type)

Description

imgFormat
(integer)

Contains the picture format to generate.

Available values are:
  • 0: GIF normal palette.
  • 1: GIF reduce palette (Use this option to obtain maps to show on mobiles or PDA).

Note: the choice of the picture format affects the number of scale available.

Required attribute

actionsOnMap
(array of MapAction )

Contains a list of actions that will be realised on a map.

This list can contain up to 5 mapactions. Beyond this limitevery supplied map action is ignored.

Note: Some platforms (Pocket PC, Smart Phone, platforms using compact .Net framework...) do not support arrays whose value is null. They throw exceptions during serialisation/deserialisation of null arrays. This can be avoided by using empty arrays instead of null arrays.

Optional attribute

withCopyright
(boolean)

Specifies if the copyright associated with the generated map should be displayed on the map.

Required attribute


 IconDef

Description

This structure contains the definition of the picture which will be associated with thepin-logo.

Use

This structure is defined/used in PinLogo structure.

Attributes

Name (type)

Description

name
(String)

Contains the name of the picture/icon file to associate with a pin-logo (name without file extension).

Required attribute

size
( ImgSize )

Contains the width and the height in pixels of the picture/icon of the pin-logo.

This attribute is used to compute the interactive zone associated with the pin-logo.

The maximum icon width is 50 pixels. Beyond this limit, the value 50 is used.

The maximum icon height is 50 pixels. Beyond this limit, the value 50 is used.

Required attribute


 PinLogo

Description

This structure contains the definition of the graphic element which represents a geographic point (location, POI ...) on a map.

Use

This structure is defined/used in GraphicItems structure.

Attributes

Name (type)

Description

id
(integer)

Contains the pin-logo identifier.

This attribute is used to make the connection between pin-logo and hot area.

Required attribute

pixelpos
( PixelPoint )

Contains the pixel coordinates of the position where the pin-logo should be drawn.

Optional attribute

geopos
( GeoCoordinates )

Contains the geographic coordinates(in WGS84 encoded system)of the position where the pin-logo should be drawn.

Optional attribute

displayMode
(integer)

Defines the graphic representation mode of the pin-logo.

Available values are:
  • 0: a point below an identifier, below a logo.
  • 1: a point below a logo.
  • 2: a logo.

Required attribute

icon
( IconDef )

Contains the definition of the picture which should be associated with thepin-logo.

Required attribute

returnHotArea
(Boolean)

Allows specifying if an interactive zone associated with the pin-logo must be returned.

Required attribute


 InputTrace

Description

This structure contains the definition of the graphic element which represents on a map a graphic representation of a route defined by a list of pixels coordinates or a list of geographic coordinates.

Use

This structure is defined/used in GraphicItems structure.

Attributes

Name (type)

Description

pixelPointList
(array of PixelPoint )

Contains the positions (expressed in pixels coordinates) of the points which define the graphic representation of a route.

Optional attribute

geoCoordinatesList
(array of GeoCoordinates )

Contains the positions (expressed in geographic coordinates) of the points which define the graphic representation of a route.

Optional attribute

color
(String)

Contains the colour of thegraphic representation of a route.

The colour is specified by an RGB value (red, green, and blue), expressed with six digits in hexadecimal format.

Required attribute

thickness
(integer)

Contains the thickness(expressed in pixels)of thegraphic representation of a route.

Required attribute


 GraphicItems

Description

This structure contains the list of graphic elements to draw on the map.

Use

This structure is defined/used in MapRequest , MapByIdRequest , MapByScaleRequest , BestMapRequest structures.

Attributes

Name (type)

Description

pinLogos
(Array of PinLogo )

Contains the list of the pin-logo to draw on the map.

This list can contain up to 100pin-logos. Beyond this limit aSOAP fault is returned.

Note: Some platforms (Pocket PC, Smart Phone, platforms using compact .Net framework...) do not support arrays whose value is null. They throw exceptions during serialisation/deserialisation of null arrays. This can be avoided by using empty arrays instead of null arrays.

Optional attribute

itineraryTrace
(ItineraryTrace)

Contains the binary description of graphic representation of the calculated route to be displayed on the map.

Note: to obtain a valid graphic representation of a calculated route, you must invoke the RouteCalculation ViaMichelin Web Service.

Optional attribute

inputTraceList
(array of InputTrace )

Contains a set of graphic route representation which are defined by a list of pixels coordinates or a list of geographic coordinates.

The sum of the points used to define the set of input trace can not exceed 300.Beyond this limit aSOAP fault is returned.

Optional attribute


 MapRequest

Description

This structure is abstract and defines the attributes which all the requests of map generation have in common.

Use

 

Attributes

Name (type)

Description

options
( MapOptions )

Contains the parameters to specify the format of the generated map, as well as the list of the actions to be performed on map before generation.

Required attribute (not null)

graphicItems
( GraphicItems )

Contains the specification of the graphic items/elements which should be drawn on the generated map.

Optional attribute


 MapByIdRequest (extends MapRequest )

Description

This structure contains the necessary parameters to generate a map from a unique map identifier.

Use

Allows to define the request used by the method which allow to generate a map from an unique map identifier:
  • getMapByID method of MapManagement ViaMichelin SOAP API

Attributes

Name (type)

Description

mapDefinition
( MapDefinitionByID )

Contains the map definition to be used to generate the map.

Required attribute (not null)

options
( MapOptions )

Contains the parameters to specify the format of the generated map, as well as the list of the actions to be performed on map before generation.

Required attribute (not null)

graphicItems
( GraphicItems )

Contains the specification of the graphic items/elements which should be drawn on the generated map.

Optional attribute


 MapByScaleRequest(extends MapRequest )

Description

This structure contains the necessary parameters to generate a map from a central point and a scale.

Use

Allows to define the request used by the method which allow to generate a map from an unique map identifier:
  • getMapByScale method of MapManagement ViaMichelin SOAP API

Attributes

Name (type)

Description

mapDefinition
( MapDefinitionByScale )

Contains the map definition to be used to generate the map.

Required attribute (not null)

options
( MapOptions )

Contains the parameters to specify the format of the generated map, as well as the list of the actions to be performed on map before generation.

Required attribute (not null)

graphicItems
( GraphicItems )

Contains the specification of the graphic items/elements which should be drawn on the generated map.

Optional attribute


 BestMapRequest (extends MapRequest )

Description

This structure contains the necessary parameters to generate a map from a list of specific locations.

Use

Allows to define the request used by the method which allow to generate a map froma list of specific locations:
  • getBestMap method of MapManagement ViaMichelin SOAP API

Attributes

Name (type)

Description

mapSize
( ImgSize )

Contains the width and the height (expressed in pixels) of the map which should be generate.

The maximum map width is 900 pixels for Europe and 600 pixels for the other territories.

The minimum map width is 50 pixels. Under this limit, the value 50 is used.

The maximum map height is 900 pixels for Europe and 600 pixels for the other territories.

The minimum map height is 50 pixels. Under this limit, the value 50 is used.

Required attribute (not null)

locations
(Array of LocationDefinition )

Contains the locations list which should be displayed on the generated map.

Required attribute (not null)

options
( MapOptions )

Contains the parameters to specify the format of the generated map, as well as the list of the actions to be performed on map before generation.

Required attribute (not null)

graphicItems
( GraphicItems )

Contains the specification of the graphic items/elements which should be drawn on the generated map.

Optional attribute


 MapDefinitionRequest

Description

This structure contains the necessary parameters to compute the best map definition which displays a list of specific locations.

Use

Allows to define the request used by the method whichcompute the best map definition which allows to display a list of specific locations:
  • getBestMapDefinition method of MapManagement ViaMichelin SOAP API

Attributes

Name (type)

Description

mapSize
( ImgSize )

Contains the width and the height (expressed in pixels) of the map which should be generate.

The maximum map width is 900 pixels for Europe and 600 pixels for the other territories.

The minimum map width is 50 pixels. Under this limit, the value 50 is used.

The maximum map height is 900 pixels for Europe and 600 pixels for the other territories.

The minimum map height is 50 pixels. Under this limit, the value 50 is used.

Required attribute (not null)

imgFormat
(integer)

Contains the picture format to generate.

Note: the choice of the picture format affects the number of scale available.

Required attribute

locations
(Array of LocationDefinition )

Contains the locations list which should be displayed on the generated map.

Required attribute (not null)


 XYToPixelsRequest

Description

This structure contains the necessary parameters to convert geographic positions into pixels positions.

Use

This structure allows to define the request used by the method whichconvert geographic positions into pixels positions:
  • xyToPixels method of MapManagement ViaMichelin SOAP API

Attributes

Name (type)

Description

geoCoordinatesList
(array of GeoCoordinates )

Contains the list of geographic coordinates (WGS84) to convert into corresponding Pixel positions on a given map.

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

This list can contain less than one geographic coordinates. Under this limita SOAP fault is returned.

Required attribute (not null, not empty)

mapDefinition
( InputMapDefinitionList )

Contains the definition of the map from which the conversion must be applied.

Required attribute


 PixelsToXYRequest

Description

This structure contains the necessary parameters to convert pixels positions into geographic positions.

Use

This structure allows to define the request used by the method whichconvert pixels positions into geographic positions:
  • pixelsToXY method of MapManagement ViaMichelin SOAP API

Attributes

Name (type)

Description

pixelsList
(array of PixelPoint )

Contains the list of pixel positions on a given map to convert into corresponding geographic coordinates (WGS84).

This list can contain up to 1000 pixel positions. Beyond this limita SOAP fault is returned.

This list can contain less than one pixel positions. Under this limita SOAP fault is returned.

Required attribute (not null, not empty)

mapDefinition
( InputMapDefinitionList )

Contains the definition of the map from which the conversion must be applied.

Required attribute


 ItineraryStepLocation (extends Location )

Description

This structure contains the descriptionof an itinerary stopover really used to compute the route.

Use

This structure is defined/used in ItinerarySummary structure.

Attributes

Name (type)

Description

name
(String)

Contains the supplied stopover identifier.

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.


 ItinerarySummary

Description

This structure contains the route summary.

Use

This structure is defined/used in ItineraryResult structure.

Attributes

Name (type)

Description

itinerarySteps
(Array of ItineraryStepLocation)

Contains the list of the itinerary stopover description really used to compute the route.

tripDuration
(integer)

Contains the itinerary total trip/travel time in seconds.

tripDistance
(integer)

Contains the itinerary total trip/travel distance in metres.

drivingDuration
(integer)

Contains the itinerary total driving time in seconds.

drivingDistance
(integer)

Contains the itinerary total driving distance in metres.

drivingDurationOnMotorway
(integer)

Contains the itinerary total driving time on motorway/highway in seconds.

drivingDistanceOnMotorway
(integer)

Contains the itinerary total driving distance on motorway/highway in metres.

fuelCost
( Cost )

Contains the estimated amount of the cost (in Euro) of the fuel consumed on the route.

tollCost
(Array of Cost )

Contains the list of tolls amount grouped by currency for the category of vehicle supplied in the route calculation request.

Note: The array is empty when there is no toll.

roadTaxAreasCost
(Array of Cost )

Contains the total amount of the costs ofroad tax areas.

messages
(Array of String)

Contains the global messages associated to the route.

mainMapDefinition
( MapDefinitionList )

Contains the best map definition to display the entire itinerary trace on a map.

Note: This information is available only if its production was specified in the route calculation request (see mapDefinitionCalculated attributed defined in ResponseOptions structure)


 ItineraryItem

Description

This structurecontains the information related to a part of the route (the driving instructions corresponding to a line in the roadmap).

Use

This structure is defined/used in ItineraryResult structure.

Attributes

Name (type)

Description

geoCoordinates
( GeoCoordinates )

Contains the geographic coordinates (WGS84) of the starting point of this part of route.

duration
(integer)

Contains the duration on this part of route.

distance
(integer)

Contains the distance covered on this part of route.

partialTripDuration
(integer)

Contains the time since the departure to reach this part of route.

partialDrivingDistance
(integer)

Contains the distance since the departure to reach this part of route.

gatheringID
(integer)

Contains the identifier of the gathering to which this part of route belongs.

Each gathering contains a level 1 driving instruction and the list of related secondary driving instructions.

level
(integer)

Contains the level of the driving instructions

Available values are :
  • 1: main driving instruction
  • 2: secondary driving instruction (details) which contain the instructions and information related to a level one driving instruction.

instructions
(String)

Contains the driving instructions in the format supplied in the route calculation request (see instructionsFormat attribute defined in ExtendedPresentationOptions and PresentationOptions structures)

picto
(String)

Contains the name of the pictogram related to the driving instruction.

mapDefinition
( MapDefinitionList )

Contains the best map definition to display a part of the itinerary trace related to the driving instruction.

This information is available only for the driving instructions of level 1 and if its production was specified in the route calculation request (see mapDefinitionCalculated attributed defined in ResponseOptions structure)


 ItineraryTracePart

Description

This structure contains a binary descriptionof a part of the graphic representation of a calculated route.

Use

This structure is defined/used in ItineraryTrace & SimpleItineraryTrace structures.

Attributes

Name (type)

Description

part
(array of byte)

Contains an array of binary corresponding to the binary description of a part of the graphic representation of the calculated route.


 ItineraryTrace

Description

This structure contains the binary description of graphic representation of the calculated route.

Use

This structure is defined/used in ItineraryResult structure.

Attributes

Retour haut de page-->