# Geocoding for batch job

REST API, Service version 1.0.0

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

Geocoding is the process of converting textual postal address 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. 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/geocodingBatch/1.0`

POST data:
```javascript
{
    "queries": [
        {
            "postalAddress": {
                "countryCode": "FR",
                "city": "aix en provence",
                "street": "95 rue docteur albert aynaud",
                "postalCode": "13100"
            }
        }
    ],
    "searchType": "FUZZY",
    "language": "fr",
    "maximumResult": 1
}
```

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__

- `queries` (GeocodingAreaQry[], required): Postal address splitted by comma.
  - `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)).
  - `postalAddress` (Address): Define a postal address according to the geocoding research.
    - `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.
- `maximumResults` (integer (int32), required): The maximum number of items used to perform the research and returned items by the server. Also accepted as `maximumResult`, `maximunResult`. Example: `2`.
- `language` (string, required): Define the language that will be used to perform the address lookup. Example: `fr`.
- `geoserver` (string): Geoserver name.
- `swidx` (integer (int32), deprecated): Switch index.
- `assetSearchType` (enum): Asset search type. Example: `ROAD`.
  - `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. Example: `FUZZY`.
  - `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).

## Response
It's the same response like the geocoding service.
But the fields `Extent` and `Elements` can be repeated in `XML` response format and encapsulated in `AreaAnswer` array for`JSON` format.
See the geocoding response here.

### Details of fields

- `answers` (GeocodingAreaAnswr[]): Define a geocoding for batch response according to the request.
  - `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.

### Response samples
JSON Sample:
```javascript
{
    "answers": [
        {
            "extent": {
                "minLon": 5.35107,
                "minLat": 43.48732,
                "maxLon": 5.35316,
                "maxLat": 43.492
            },
            "elements": [
                {
                    "boundingBox": {
                        "minLon": 5.35107,
                        "minLat": 43.48732,
                        "maxLon": 5.35316,
                        "maxLat": 43.492
                    },
                    "coordinate": {
                        "lon": 5.35123,
                        "lat": 43.4914
                    },
                    "exactCoordinate": {
                        "lon": 5.35124,
                        "lat": 43.4914
                    },
                    "distanceFromRequest": 0.0,
                    "postalAddress": {
                        "countryCode": "FRA",
                        "country": "France",
                        "state": "Provence-Alpes-Côte d'Azur",
                        "county": "Bouches-du-Rhône",
                        "city": "Aix-en-Provence",
                        "district": "Aix la Duranne",
                        "postalCode": "13290",
                        "street": "Rue du Docteur Albert Aynaud",
                        "streetNumber": "95"
                    },
                    "postalAddressClassType": "ROAD_FOURTH",
                    "postalAddressClassId": 4048,
                    "postalAddressExactStreeNumber": true,
                    "angle": -15.0,
                    "administrativeSpeedLimit": 0.0,
                    "relevanceScore": 0.92,
                    "countryRelevanceScore": 1.0,
                    "cityRelevanceScore": 1.0,
                    "postalCodeRelevanceScore": 0.67,
                    "streetRelevanceScore": 0.92,
                    "streetNumberRelevanceScore": 1.0,
                    "segmentId": 0
                }
            ]
        }
    ]
}
```