# Natural Geocoding service

REST API, Service version 1.0.0

> API reference: [`POST /geocoding/1.0/natural`](https://benomad.com/dev/doc/bemap-api/api/search/geocoding-natural.md)

Natural Geocoding is the process of converting textual postal address (1 line / free text) to a geographical longitude and latitude coordinates.

_For more details: [Wikipedia](https://en.wikipedia.org/wiki/Geocoding)_

## Summary
1. Request
 1. Mandatory parameters
 2. Optional parameters
2. Response
 1. Details of fields
 2. Response samples

## Request
The request must be sent with the HTTP method `POST` and the HTTP header `Content-Type` set to `application/json`. 

Sample:
URI: `/bgis/service/geocoding/1.0/natural`

POST data:
```javascript
{
	"geoserver": "herehlp",
	"naturalQuery": "Villa des pyrénées paris france"
}
```

All coordinates are defined by longitude and latitude, see the [coordinate system](https://benomad.com/dev/doc/bemap-api/guides/reference/glossary-coordinate-system.md) glossary for more details.

### __Parameters__

- `naturalQuery` (string, required): The free-textual postal address request.
- `geoserver` (string): Geoserver name.
- `swidx` (integer (int32), deprecated): Switch index.
- `boundingBox` (BoundingBox): Define a bounding box (in WGS84 format) to restrict the geocoding research.
  - `minLon` (number (double)): Minimum longitude, in degrees decimal ([WGS84](https://benomad.com/dev/doc/bemap-api/guides/reference/glossary-coordinate-system.md)).
  - `minLat` (number (double)): Minimum latitude, in degrees decimal ([WGS84](https://benomad.com/dev/doc/bemap-api/guides/reference/glossary-coordinate-system.md)).
  - `maxLon` (number (double)): Maximum longitude, in degrees decimal ([WGS84](https://benomad.com/dev/doc/bemap-api/guides/reference/glossary-coordinate-system.md)).
  - `maxLat` (number (double)): Maximum latitude, in degrees decimal ([WGS84](https://benomad.com/dev/doc/bemap-api/guides/reference/glossary-coordinate-system.md)).
- `assetSearchType` (enum): Define the search type of asset.
  - `OBJECT`: OBJECT.
  - `POI`: POI.
  - `CITY_CENTER`: CITY_CENTER.
  - `ROAD`: ROAD.
- `searchType` (enum): Defines all the possible types of research that can be applied to a textual pattern.
  - `CONTAINS`: Means that the pattern must be contained in the required strings.
  - `FUZZY`: Means that the pattern will be used to perform a fuzzy search based on. the pattern. (Fuzzy searching can be useful when you are searching text that may contain misspelled words).
  - `KEY_SEARCH`: Specifies a search on key ids. This criteria can be used for retrieving an item by its numerical key.
  - `STRICT`: Means that the required string must be strictly equal to the pattern.
  - `STRICT_BEGINNING`: Means that the required strings must begin with the pattern.
  - `WORD_BEGINNING`: Means that one word of required strings must begin with the pattern (characters ' ', '-' and '/' are considered as word separators).
- `maximumResults` (integer (int32)): The maximum number of items used to perform the research and returned items by the server. Also accepted as `maximunResult`.
- `language` (string): Define the language that will be used to perform the address lookup.
- `locIdEnable` (boolean): Used by HERE HLP geo-server to define the location ID.

## Response

### Details of fields

- `extent` (BoundingBox): Define a bounding box (in WGS84 format) to restrict the geocoding research.
  - `minLon` (number (double)): Minimum longitude, in degrees decimal ([WGS84](https://benomad.com/dev/doc/bemap-api/guides/reference/glossary-coordinate-system.md)).
  - `minLat` (number (double)): Minimum latitude, in degrees decimal ([WGS84](https://benomad.com/dev/doc/bemap-api/guides/reference/glossary-coordinate-system.md)).
  - `maxLon` (number (double)): Maximum longitude, in degrees decimal ([WGS84](https://benomad.com/dev/doc/bemap-api/guides/reference/glossary-coordinate-system.md)).
  - `maxLat` (number (double)): Maximum latitude, in degrees decimal ([WGS84](https://benomad.com/dev/doc/bemap-api/guides/reference/glossary-coordinate-system.md)).
- `elements` (GeocodingItem[]): Define geocoding elements for a featured road.
  - `boundingBox` (BoundingBox): Define a bounding box (in WGS84 format) to restrict the geocoding research.
    - `minLon` (number (double)): Minimum longitude, in degrees decimal ([WGS84](https://benomad.com/dev/doc/bemap-api/guides/reference/glossary-coordinate-system.md)).
    - `minLat` (number (double)): Minimum latitude, in degrees decimal ([WGS84](https://benomad.com/dev/doc/bemap-api/guides/reference/glossary-coordinate-system.md)).
    - `maxLon` (number (double)): Maximum longitude, in degrees decimal ([WGS84](https://benomad.com/dev/doc/bemap-api/guides/reference/glossary-coordinate-system.md)).
    - `maxLat` (number (double)): Maximum latitude, in degrees decimal ([WGS84](https://benomad.com/dev/doc/bemap-api/guides/reference/glossary-coordinate-system.md)).
  - `coordinate` (Coordinate): Matched coordinate on a road.
    - `lon` (number (double), required): Longitude in degrees decimal ([WGS84](https://benomad.com/dev/doc/bemap-api/guides/reference/glossary-coordinate-system.md)). Also accepted as `longitude`.
    - `lat` (number (double), required): Latitude in degrees decimal ([WGS84](https://benomad.com/dev/doc/bemap-api/guides/reference/glossary-coordinate-system.md)). Also accepted as `latitude`.
  - `exactCoordinate` (Coordinate): Exact coordinate is a non map-matched coordinate on road.
    - `lon` (number (double), required): Longitude in degrees decimal ([WGS84](https://benomad.com/dev/doc/bemap-api/guides/reference/glossary-coordinate-system.md)). Also accepted as `longitude`.
    - `lat` (number (double), required): Latitude in degrees decimal ([WGS84](https://benomad.com/dev/doc/bemap-api/guides/reference/glossary-coordinate-system.md)). Also accepted as `latitude`.
  - `distanceFromRequest` (number (double)): Distance in meters between the request coordinate and the matched coordinate.
  - `postalAddress` (Address): Postal address.
    - `countryCode` (string): ISO code of country.
    - `country` (string): Country name.
    - `state` (string): State name.
    - `county` (string): County name.
    - `city` (string): City name.
    - `district` (string): District name of city.
    - `postalCode` (string): Postal code.
    - `roadNumber` (string): Road number.
    - `street` (string): Street name.
    - `streetNumber` (string): House number.
    - `oppositeStreetNumber` (string, deprecated): Opposite street number.
  - `oppositePostalAddress` (Address): Opposite postal address. Optional field, can be enable with option OPPOSITE_POSTAL_ADDRESS of OPPOSITE_POSTAL_ADDRESS_ALWAYS.
    - `countryCode` (string): ISO code of country.
    - `country` (string): Country name.
    - `state` (string): State name.
    - `county` (string): County name.
    - `city` (string): City name.
    - `district` (string): District name of city.
    - `postalCode` (string): Postal code.
    - `roadNumber` (string): Road number.
    - `street` (string): Street name.
    - `streetNumber` (string): House number.
    - `oppositeStreetNumber` (string, deprecated): Opposite street number.
  - `postalAddressClassType` (enum): Postal address.
    - `__NOT_MAPPED`: Not mapped value.
    - `EARTH_SURFACE`: Earth surface.
    - `COUNTRY`: Country.
    - `ORDRE_1_AREA`: State, Region, etc.
    - `ORDRE_2_AREA`: Area 2.
    - `ORDRE_3_AREA`: Area 3.
    - `ORDRE_4_AREA`: Area 4.
    - `ORDRE_5_AREA`: Area 5.
    - `ORDRE_6_AREA`: Area 6.
    - `ORDRE_7_AREA`: Department, etc.
    - `ORDRE_8_AREA`: City.
    - `ORDRE_9_AREA`: District.
    - `POSTAL_DISTRICT`: Postal district.
    - `EXT_POSTAL_CODE`: Extended Digit Postal Code (ie 7-Digit PC on UK).
    - `ISLAND`: Island.
    - `BUILT_UP_AREA`: Urban area, not an administrative area.
    - `BUILT_UP_AREA_2`: Secondary urban areas (not an administrative area).
    - `BUILT_UP_AREA_3`: Other urban areas (not an administrative area).
    - `LOW_EM_ZONE`: Low Emission Zone (LEZ).
    - `LAND_USAGE`: Parc/garden, industrial area, industrial harbour area.
    - `LAND_COVERAGE`: Woodland, moor/heathland, beach/dune/sand.
    - `WATER_ELEMENT`: Ocean, sea, lac, river, etc. Main.
    - `WATER_ELEMENT_2`: Ocean, sea, lac, river, etc. Secondary.
    - `WATER_ELEMENT_3`: Ocean, sea, lac, river, etc. Third.
    - `WATER_ELEMENT_4`: Ocean, sea, lac, river, etc. Fourth.
    - `OTHER_AREAS`: Military base, native american reserve, etc.
    - `AIRPORT_AREA`: Airport contour, ports.
    - `AIRCRAFT_ROAD`: Aircraft roads.
    - `BUILDING`: Building contour.
    - `RAILWAY_ELEMENT`: Railway.
    - `ROAD_ELEMENT_MIN`: Min value for road elements (Range : 4000 - 6899).
    - `ROAD_FOURTH_PEDESTRIAN`: Fourth - Pedestrian.
    - `ROAD_FOURTH_ROUNDABOUT`: Fourth - Roundabout.
    - `ROAD_FOURTH_SLIPROAD`: Fourth - Slip road.
    - `ROAD_FOURTH`: SUNDAY.
    - `ROAD_FOURTH_MOTORWAY`: Fourth - Motorway.
    - `ROAD_FOURTH_FERRY`: Fourth - Ferry.
    - `ROAD_TERTIARY_PEDESTRIAN`: Tertiary - Pedestrian.
    - `ROAD_TERTIARY_ROUNDABOUT`: Tertiary - Roundabout.
    - `ROAD_TERTIARY_SLIPROAD`: Tertiary - Slip road.
    - `ROAD_TERTIARY`: Tertiary.
    - `ROAD_TERTIARY_MOTORWAY`: Tertiary - Motorway.
    - `ROAD_TERTIARY_FERRY`: Tertiary - Ferry.
    - `ROAD_SECONDARY_PEDESTRIAN`: Secondary - Pedestrian.
    - `ROAD_SECONDARY_ROUNDABOUT`: Secondary - Roundabout.
    - `ROAD_SECONDARY_SLIPROAD`: Secondary - Slip road.
    - `ROAD_SECONDARY`: Secondary.
    - `ROAD_SECONDARY_MOTORWAY`: Secondary - Motorway.
    - `ROAD_SECONDARY_FERRY`: Secondary - Ferry.
    - `ROAD_MAIN_PEDESTRIAN`: Main - Pedestrian.
    - `ROAD_MAIN_ROUNDABOUT`: Main - Roundabout.
    - `ROAD_MAIN_SLIPROAD`: Main - Slip road.
    - `ROAD_MAIN`: Main Road.
    - `ROAD_MAIN_MOTORWAY`: Main - Motorway.
    - `ROAD_MAIN_FERRY`: Main - Ferry.
    - `ROAD_ELEMENT_MAX`: Max value for road elements (Range : 4000 - 6899).
    - `KB_ROUTE_CLASS`: Class for dynamic route forms.
    - `TRAFFIC_FLOW`: Class for dynamic traffic flow forms.
    - `UNDETAILED_MAIN_MOTORWAY`: Duplication of ROAD_MAIN_MOTORWAY for undetailed zoom level display.
    - `TOLL_SYSTEM`: Toll Sys.
    - `TOLL_STRUCTURE`: Toll Structures.
    - `TMC_LOCATION`: Class of TMC locations.
    - `COMPLEX_RESTRICTION`: Complex restriction (chained, time dependent, vehicle profile dependent) definitions for manoeuvres in road network.
    - `POINT_ADDRESS`: Point Addresses.
    - `SIGN_POST_COLOR`: Sign Post colors for panels display.
    - `LANE_CONNECTION`: Lane to lane connections in road network.
    - `SIGN_POST_NUMBER`: Sign post number (an exit number).
    - `RESTRICTION`: Restriction definitions for manoeuvres in road network.
    - `JUNCTION`: Border nodes of road network.
    - `NODE`: Nodes of road network.
    - `CAPITAL`: National or regional capitals (cities).
    - `WORLD_CAPITALS`: World capitals (from world.svs file).
    - `POLICE_RADAR`: Police radars (Not contained in default SVS datasets).
    - `LANDMARKS_2D`: 2D Landmarks.
    - `VEHICLE_REPAIR`: Vehicle repair facility.
    - `PETROL_STATION`: Petrol station.
    - `RENT_A_CAR`: Rent a car facility.
    - `PARKING_GARAGE`: Parking garage.
    - `HOTEL_MOTEL`: Hotel or motel.
    - `RESTAURANT`: Restaurant.
    - `TOURIST_OFFICE`: Tourist office.
    - `MUSEUM`: Tourist office.
    - `THEATRE`: Theatre.
    - `CULTURAL_CENTRE`: Cultural centre.
    - `SPORTS_ACTIVITY`: Sports activity.
    - `HOSPITAL`: Hospital polyclinic.
    - `POLICE_STATION`: Police station.
    - `CITY_HALL`: City hall.
    - `POST_OFFICE`: Post office.
    - `PHARMACY`: Pharmacy.
    - `BANK`: Bank.
    - `SKI_RESORT`: Ski resort.
    - `PANORAMIC_VIEW`: Scenic / panoramic view.
    - `SWIMMING_POOL`: Swimming pool.
    - `WORSHIP_PLACE`: Place of worship.
    - `FERRY_TERMINAL`: Ferry terminal.
    - `AIRLINE_ACCESS`: Airline access.
    - `CAMPING_GROUND`: Camping ground.
    - `COMMUNITY_CENTRE`: Community centre.
    - `EMBASSY`: Embassy.
    - `FRONTIER_CROSSING`: Frontier crossing.
    - `GOVERNMENT_OFFICE`: Government office.
    - `MOTORING_ORG_OFFICE`: Motoring organization office.
    - `OPEN_PARKING_AREA`: Open parking area.
    - `RECREATION_FACILITY`: Recreation facility.
    - `SCHOOL`: School.
    - `SHOPPING_CENTRE`: Shopping centre.
    - `STADIUM`: Stadium.
    - `TOURIST_ATTRACTION`: Tourist attraction.
    - `UNIVERSITY`: University or college.
    - `BUSINESS_FACILITY`: Business facility.
    - `CITY_CENTER`: City center.
    - `RAILWAY_STATION`: Railway station.
    - `HAMLET`: Hamlet.
    - `AIRPORT`: Airport.
    - `BUS_STATION`: Bus station.
    - `EXHIBITION_CENTER`: Exhibition centre.
    - `PARK_AND_RIDE`: Park and ride.
    - `REST_AREA`: Rest area.
    - `KB_GOLF_COURSE`: Golf course.
    - `ATM`: ATM.
    - `GROCERY_STORE`: Grocery store.
    - `LIBRARY`: Library.
    - `MARINA`: Marina.
    - `COMMUTER_RAIL_STATION`: Commuter rail station.
    - `COURT_HOUSE`: Court house.
    - `HISTORICAL_MONUMENT`: Historical monument.
    - `BOWLING_CENTRE`: Bowling centre.
    - `CASINO`: Casino.
    - `CINEMA`: Cinema.
    - `ICE_SKATING_RINK`: Ice skating rink.
    - `NIGHTLIFE`: Nightlife.
    - `PUBLIC_SPORT_AIRPORT`: Public sport airport.
    - `SPORTS_CENTRE`: Sports centre.
    - `WINERY`: Winery.
    - `AUTOMOBILE_DEALERSHP`: Automobile/Motorcycle dealership.
    - `COMPANY`: Company.
    - `BEACH`: Beach.
    - `SHOP`: Shop.
    - `PARK_AND_RECREATION_AREA`: Park and recreation area.
    - `MOUNTAIN_PEAK`: Mountain peak.
    - `OPERA`: Opera.
    - `CONCERT_HALL`: Concert hall.
    - `TENNIS_COURT`: Tennis court.
    - `WATER_SPORT`: Water sport.
    - `MUSIC_CENTER`: Music center.
    - `DOCTOR`: Doctor.
    - `DENTIST`: Dentist.
    - `VETERINARIAN`: Veterinarian.
    - `CONVENTION_CENTER`: Convention center.
    - `LEISURE_CENTRE`: Leisure centre.
    - `YACHT_BASIN`: Yacht basin.
    - `BAR_PUB`: Bar/Pub.
    - `ENTERTAINMENT`: Entertainment.
    - `ABBEY`: Abbey.
    - `AMUSEMENT_PARK`: Amusement park.
    - `ARTS_CENTER`: Arts center.
    - `BUILDING_FOOTPRINT`: Building footprint.
    - `CASTLE`: Castle.
    - `CHURCH`: Church.
    - `FORTRESS`: Fortress.
    - `CAR_DEALER`: Car dealer.
    - `HOLIDAY_AREA`: Holiday area.
    - `LIGHTHOUSE`: Lighthouse.
    - `MILITARY_CEMETERY`: Military cemetery.
    - `MONASTERY`: Monastery.
    - `MONUMENT`: Monument.
    - `NATURAL_RESERVE`: Natural reserve.
    - `PRISON`: Prison.
    - `ROCKS`: Rocks.
    - `WALKING_AREA`: Walking area.
    - `WATER_MILL`: Water mill.
    - `WINDMILL`: Windmill.
    - `ZOO`: Zoo.
    - `RENT_A_CAR_PARKING`: Rent-a-Car parking.
    - `MOUNTAIN_PASS`: Mountain pass.
    - `HIGHLIGHT_CLASS`: Highlight.
  - `postalAddressClassId` (integer (int64)): Postal address.
  - `postalAddressExactStreeNumber` (boolean): Indicates if the location corresponds exactly to the required street number.
  - `angle` (number (double)): Angle.
  - `administrativeSpeedLimit` (number (float)): Speed limit.
  - `relevanceScore` (number (double)): Global matching error.
  - `countryRelevanceScore` (number (double)): Matching error of the country.
  - `cityRelevanceScore` (number (double)): Matching error of the city.
  - `postalCodeRelevanceScore` (number (double)): Matching error of the postal code (zip code).
  - `streetRelevanceScore` (number (double)): Matching error of the place.
  - `streetNumberRelevanceScore` (number (double)): Matching error of the house number (street number).
  - `roadInfo` (RoadInfo): Road information.
    - `urban` (boolean): Urban / not urban flag.
    - `tunnel` (boolean): A flag that indicates if road is part of a tunnel or not.
    - `bridge` (boolean): A flag that indicates if road is part of a bridge or not.
    - `maxSpeedVerified` (boolean): Maximum speed verified flag (true: verified, false: calculated).
    - `carPool` (boolean): A flag that indicates if road is reserved to carpooling.
    - `mainCategory` (boolean): A flag that enables discrimination within road's of a same FCC type (depends of map provider).
    - `dualCarriageway` (integer (int32)): A flag that indicates if road is part of a dual carriageway (e.g. with physical separation between opposite traffic sides).
    - `noThroughTr` (integer (int32)): No through traffic restriction.
    - `toll` (integer (int32)): Toll information.
    - `tax` (integer (int32)): Indicates if road is submitted to a government tax (like German MAUT, etc). 0 means no tax, 1-3 defines the tax category (country dependent).
    - `matchDir` (enum): The matching direction.
      - `CLOSE`: 0 : Undefined matched direction and closed in both directions.
      - `OPEN_POS`: 1 : open in positive direction.
      - `OPEN_NEG`: 2 : open in negative direction.
      - `OPEN`: 3 : Undefined matched direction and open in both directions.
    - `nbLanePos` (integer (int32)): Number of lanes in positive direction. 0 if traffic closed in positive direction or if lane information is not available.
    - `nbLaneNeg` (integer (int32)): Number of lanes in negative direction. 0 if traffic closed in negative direction or if lane information is not available.
    - `pedestrianInfrastructureType` (enum): Enum of pedestrian type.
      - `UNDEFINED`: Undefined.
      - `ZONE`: Pedestrian Zone.
      - `HIKING`: Hiking.
      - `UNPAVED_ROAD`: Unpaved Road.
      - `ROUGH_ROAD`: Rough Road.
      - `CONDITION_ROAD`: Poor Condition Road.
      - `STAIRS`: Stairs.
      - `TUNNEL`: Tunnel.
      - `ELEVATOR`: Elevator.
      - `ESCALATOR`: Escalator.
      - `FOOTBRIDGE`: Footbridge.
    - `maxSpeed` (number (float)): Speed limit in kph (0 if not available).
    - `averageSpeed` (number (float)): Average speed in kph.
    - `conditionalMaxSpeeds` (ConditionalSpdLimit[]): Optional conditional speed limit.
      - `speed` (number (float), required): The speed limit in kph.
      - `type` (enum, required): Condition type.
        - `NONE`: No speed situation.
        - `HAZMAT`: Hazardous material.
        - `TRAILER`: Trailer.
        - `WEIGHT`: Weight.
        - `WEATHER`: Weather.
        - `VEHICLE_TYPE`: Vehicle type.
        - `VEHICULE_TYPE`: Vehicle type. Deprecated use VEHICLE_TYPE instead.
        - `SCHOOL`: School.
        - `ADVISORY`: Advisory.
      - `value` (string, required): Condition value (see HAZMAT, WEATHER, WEIGHT...)
    - `length` (integer (int32)): Length in meters.
    - `directionFlow` (enum): The direction of traffic flow per transportation modes (use CartoConst to access to corresponding mode in dirFlow).
      - `CLOSE`: 0 : closed in both directions.
      - `OPEN_POS`: 1 : open in positive direction.
      - `OPEN_NEG`: 2 : open in negative direction.
      - `OPEN`: 3 : open in both directions.
  - `geoElementTypes` (enum[]): .
    - `ALL_ROAD`: Road types.
    - `PEDESTRIAN`
    - `ROUNDABOUT`
    - `SLIP_ROAD`
    - `ROAD`
    - `MOTORWAY`
    - `FERRY`
    - `MAIN_ROAD`: Road levels.
    - `SECONDARY_ROAD`
    - `TERTIARY_ROAD`
    - `FOURTH_ROAD`
    - `COUNTRY`: Administrative.
    - `STATE`
    - `COUNTY`
    - `CITY`
    - `DISTRICT`
    - `POSTAL_CODE`
    - `BUILT_UP_AREA_NA`: Urban area information not available.
    - `BUILT_UP_AREA_NONE`: No urban area.
    - `BUILT_UP_AREA_MAIN`: Urban area coverage size main, not an administrative area.
    - `BUILT_UP_AREA_MEDIUM`: Urban area coverage size medium (not an administrative area).
    - `BUILT_UP_AREA_SMALL`: Urban area coverage size small (not an administrative area).
    - `VEHICLE_REPAIR`: POI.
    - `PETROL_STATION`
    - `RENT_A_CAR`
    - `PARKING_GARAGE`
    - `HOTEL_MOTEL`
    - `RESTAURANT`
    - `TOURIST_OFFICE`
    - `MUSEUM`
    - `THEATRE`
    - `CULTURAL_CENTRE`
    - `SPORTS_ACTIVITY`
    - `HOSPITAL`
    - `POLICE_STATION`
    - `CITY_HALL`
    - `POST_OFFICE`
    - `PHARMACY`
    - `BANK`
    - `CAMPING`
    - `SHOPPING_CENTRE`
    - `STADIUM`
    - `TOURIST_ATTRACTION`
    - `BUS_STATION`
    - `EXHIBITION_CENTER`
    - `GOLF_COURSE`
    - `GROCERY_STORE`
    - `LIBRARY`
    - `MARINA`
    - `HISTORICAL_MONUMENT`
    - `BOWLING`
    - `CASINO`
    - `CINEMA`
    - `SPORTS_CENTRE`
    - `BEACH`
    - `SHOP`
    - `OPERA`
    - `TENNIS_COURT`
    - `MUSIC_CENTER`
    - `AMUSEMENT_PARK`
    - `ZOO`
  - `polyline` (Coordinate[]): Polyline.
    - `lon` (number (double), required): Longitude in degrees decimal ([WGS84](https://benomad.com/dev/doc/bemap-api/guides/reference/glossary-coordinate-system.md)). Also accepted as `longitude`.
    - `lat` (number (double), required): Latitude in degrees decimal ([WGS84](https://benomad.com/dev/doc/bemap-api/guides/reference/glossary-coordinate-system.md)). Also accepted as `latitude`.
  - `segmentId` (integer (int64)): Segment id.
  - `trafficElements` (TrafficItem[]): .
    - `info` (TrafficElementInfo): Traffic information of element.
      - `id` (string)
      - `countryCode` (string)
      - `copyright` (string)
      - `releaseDate` (string (date-time))
      - `lastUpdateDate` (string (date-time))
    - `elementId` (string): Element ID.
    - `reverseDirection` (boolean): True for inverse road direction.
    - `boundingBox` (BoundingBox): Bounding box of geometry in WGS84.
      - `minLon` (number (double)): Minimum longitude, in degrees decimal ([WGS84](https://benomad.com/dev/doc/bemap-api/guides/reference/glossary-coordinate-system.md)).
      - `minLat` (number (double)): Minimum latitude, in degrees decimal ([WGS84](https://benomad.com/dev/doc/bemap-api/guides/reference/glossary-coordinate-system.md)).
      - `maxLon` (number (double)): Maximum longitude, in degrees decimal ([WGS84](https://benomad.com/dev/doc/bemap-api/guides/reference/glossary-coordinate-system.md)).
      - `maxLat` (number (double)): Maximum latitude, in degrees decimal ([WGS84](https://benomad.com/dev/doc/bemap-api/guides/reference/glossary-coordinate-system.md)).
    - `jamFactor` (number (float)): Percent (%) of traffic jam. Between 0.00 (free way) to 100.00 (full jam).
    - `reason` (enum): TrafficReason.
      - `NA`: Not available.
      - `CONGESTION`: traffic congestion (jam).
      - `CARRIAGEWAY_REDUCED`: Carriage-way reduced.
      - `ACCIDENT`: Accident.
      - `INCIDENT`: Incident.
      - `INFORMATION`: Information.
      - `NON_RECOMMANDED_ROAD`: Non re-commanded road.
      - `ROAD_CONDITION_DETERIORATED`: Road condition deteriorated.
      - `BLOCKED_ROAD`: Blocked road.
      - `ROAD_UNDER_CONTRUCTION`: Road under construction.
    - `reasonComments` (TrafficResComment[]): List of reason comments.
      - `language` (string)
      - `comment` (string)
    - `reasonCoordinate` (Coordinate): Coordinate of the reason event.
      - `lon` (number (double), required): Longitude in degrees decimal ([WGS84](https://benomad.com/dev/doc/bemap-api/guides/reference/glossary-coordinate-system.md)). Also accepted as `longitude`.
      - `lat` (number (double), required): Latitude in degrees decimal ([WGS84](https://benomad.com/dev/doc/bemap-api/guides/reference/glossary-coordinate-system.md)). Also accepted as `latitude`.
    - `polyline` (Coordinate[]): Polyline.
      - `lon` (number (double), required): Longitude in degrees decimal ([WGS84](https://benomad.com/dev/doc/bemap-api/guides/reference/glossary-coordinate-system.md)). Also accepted as `longitude`.
      - `lat` (number (double), required): Latitude in degrees decimal ([WGS84](https://benomad.com/dev/doc/bemap-api/guides/reference/glossary-coordinate-system.md)). Also accepted as `latitude`.
    - `segmentInfos` (TrafficSegInfo[]): Segment Info.
      - `id` (string): Unique identifier of road segment.
      - `reverseDirection` (boolean): The route travel is in opposite way of geometry.
    - `tmcInternalId` (integer (int64)): AlertcTrafficElement.
    - `alertcEbuCountryCode` (string): AlertcTrafficElement.
    - `alertcTableId` (integer (int64)): AlertcTrafficElement.
    - `alertcLocationId` (integer (int64)): AlertcTrafficElement.
    - `alertcExtend` (integer (int32)): AlertcTrafficElement.
    - `alertcCode` (integer (int32)): AlertcTrafficElement.
    - `openLrBase64` (string): OpenLrTrafficElement.
- `maximunResult` (integer (int32)): The maximum number of items used to perform the research and returned items by the server.

### Response samples
JSON Sample:
```javascript
{
    "elements": [
        {
            "boundingBox": {
                "minLon": 2.40498,
                "minLat": 48.85325,
                "maxLon": 2.40587,
                "maxLat": 48.85351
            },
            "coordinate": {
                "lon": 2.40542,
                "lat": 48.85339
            },
            "distanceFromRequest": 0.0,
            "postalCode": {
                "countryCode": "FRA",
                "country": "France",
                "state": "Île-de-France",
                "county": "Paris",
                "city": "Paris",
                "district": "20e Arrondissement",
                "postalCode": "75020",
                "street": "Villa des Pyrénées"
            },
            "postalAddressClassId": 0,
            "postalAddressExactStreeNumber": false,
            "angle": 0.0,
            "administrativeSpeedLimit": 0.0,
            "relevanceScore": 1.0,
            "countryRelevanceScore": 0.0,
            "cityRelevanceScore": 0.0,
            "postalCodeRelevanceScore": 0.0,
            "streetRelevanceScore": 0.0,
            "streetNumberRelevanceScore": 0.0,
            "segmentId": 0
        }
    ],
    "maximumResult": 0
}
```