# Reverse geocoding for batch job REST API, Service version 1.0.0 > API reference: [`POST /geocodingBatch/1.0/reverse`](https://benomad.com/dev/doc/bemap-api/api/search/geocodingbatch-reverse.md) This service can process a several coordinates in same request. Reverse geocoding is the process of back (reverse) coding of a point location (latitude, longitude) to a readable address or place name. This permits the identification of nearby street addresses, places, and/or areal subdivisions such as neighbourhoods, county, state, or country. Combined with geocoding and routing services, reverse geocoding is a critical component of mobile location-based services and Enhanced 911 to convert a coordinate obtained by GPS to a readable street address which is easier to understand by the end user. _For more details: [Wikipedia](https://en.wikipedia.org/wiki/Reverse_geocoding)_ ## Summary 1. Request 1. 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/reverse` POST data: ```javascript { "radius" : 50, "language" : "fr", "coordinatesSat" : [ { "lon" : 2.29555, "lat" : 48.87384 }, { "lon" : 2.29258, "lat" : 48.87474 } ], "maximumResults" : 2 } ``` 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__ - `coordinatesSat` (CoordinateSat[], required): GPS coordinates. Example: `&coordinatesSat=lon,lat`. - `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`. - `heading` (number (double)): Heading in degrees. - `speed` (number (float)): Speed in km/h. - `time` (integer (int64)): GPS time in milliseconds (EPOCH). - `sat` (integer (int32)): Number of GPS satellites available. - `radius` (integer (int64), required): Maximum search radius around GPS point. The value is in meter.. Example: `1000`. - `geoserver` (string): Geoserver name. - `swidx` (integer (int32), deprecated): Switch index. - `transportMode` (enum): Transportation mode: Car, pedestrian, truck, etc... Example: `CAR`. - `PEDESTRIAN`: Pedestrian. - `BICYCLE`: Bicycle. - `MOTORCYCLE`: Motorcycle. - `CAR`: Passenger car. - `TAXI`: Taxi. - `PUBLIC_BUS`: Public bus. - `EMERGENCY`: Emergency vehicle. - `DELIVERY_TRUCK`: Delivery truck. Deprecated, use `TRUCK` instead. - `TRUCK`: Truck. - `maximumResults` (integer (int32)): The maximum number of items used to perform the research and returned items by the server.. Also accepted as `maximunResult`. Example: `2`. - `language` (string): Define the language that will be used to perform the address lookup. Objects for which defined language code is not available, default language will be used. Values language Code - An US-ASCII string that defines an ISO 639-1 (2-letter) language code. The specials "IC" (no sensitive case) language code allows you to search for a country depending on its ISO-3166 Alpha-3 or Alpha-2 country code. Example: `fr`. - `options` (enum[]): Comma-separated list of one or more reverse-geocoding options. Example: `POLYLINE`. - `START_AT_RADIUS`: Force to start research directly at radius passed in parameter. - `THROUGH_POINT_ADDRESS`: This option will first attempt to locate a point address within the given radius around the given location. In case a point address is found, the service will return a unique result corresponding to the road-matched location of the point address. Otherwise, the search process behaves as if this option was not enabled. - `SKIP_EMPTY_STREETNAME`: Skip elements without a street name if other element(s) have a street name. - `OPPOSITE_POSTAL_ADDRESS`: Return the opposite postal address only if different from the postal address field. - `OPPOSITE_POSTAL_ADDRESS_ALWAYS`: Return the opposite postal address, always even if the values are the same as the postal address field. - `URBAN_AREA`: Set this flag to true if you need to know if the resulting matched point is in an urban area. - `ROAD_FEATURE`: Return the network information of a road segment. - `SEGMENTID`: Return the segment ID (like link ID). - `POLYLINE`: Return the list of coordinates of a road segment. - `TRAFFIC`: Return the traffic information. - `TRAFFIC_PREDICTIVE`: Return the predictive traffic information. The timestamp defined in each coordinate is used. - `TRAFFIC_HISTORICAL`: (Beta) Return the historical traffic information. The timestamp defined in each coordinate is used. ## Response ### Details of fields - `revGeoBatchMatcheds` (RevGeocodingBatchMatched[]): Matched elements. - `extent` (BoundingBox, required): 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[], required): Geocoding for batch elements list found on the matched road segment. - `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 { "revGeoBatchMatcheds": [ { "extent": { "minLon": 2.29565, "minLat": 48.8738, "maxLon": 2.29593, "maxLat": 48.8739 }, "elements": [ { "coordinate": { "lon": 2.29565, "lat": 48.8739 }, "distanceFromRequest": 9.91, "postalCode": { "countryCode": "FRA", "country": "France", "state": "Île-de-France", "county": "Paris", "city": "Paris", "district": "Paris 17e Arrondissement", "postalCode": "75017", "roadNumber": "", "street": "Souterrain Étoile" }, "postalAddressClassType": "ROAD_FOURTH", "postalAddressClassId": 4048, "postalAddressExactStreeNumber": false, "angle": -40.0, "administrativeSpeedLimit": 50.0, "relevanceScore": 0.11856886623241761, "countryRelevanceScore": 0.0, "cityRelevanceScore": 0.0, "postalCodeRelevanceScore": 0.0, "streetRelevanceScore": 0.0, "streetNumberRelevanceScore": 0.0, "geoElementTypes": [ "ROAD", "FOURTH_ROAD", "DISTRICT", "CITY", "COUNTY", "STATE", "COUNTRY" ], "segmentId": 0 }, { "coordinate": { "lon": 2.29593, "lat": 48.8738 }, "distanceFromRequest": 28.18, "postalCode": { "countryCode": "FRA", "country": "France", "state": "Île-de-France", "county": "Paris", "city": "Paris", "district": "Paris 8e Arrondissement", "postalCode": "75008", "roadNumber": "", "street": "Place Charles de Gaulle" }, "postalAddressClassType": "ROAD_TERTIARY_ROUNDABOUT", "postalAddressClassId": 4272, "postalAddressExactStreeNumber": false, "angle": 10.0, "administrativeSpeedLimit": 50.0, "relevanceScore": 0.09100349287265173, "countryRelevanceScore": 0.0, "cityRelevanceScore": 0.0, "postalCodeRelevanceScore": 0.0, "streetRelevanceScore": 0.0, "streetNumberRelevanceScore": 0.0, "geoElementTypes": [ "ROUNDABOUT", "TERTIARY_ROAD", "DISTRICT", "CITY", "COUNTY", "STATE", "COUNTRY" ], "segmentId": 0 } ] }, { "extent": { "minLon": 2.29258, "minLat": 48.87474, "maxLon": 2.29263, "maxLat": 48.87482 }, "elements": [ { "coordinate": { "lon": 2.29258, "lat": 48.87474 }, "distanceFromRequest": 0.0, "postalCode": { "countryCode": "FRA", "country": "France", "state": "Île-de-France", "county": "Paris", "city": "Paris", "district": "Paris 17e Arrondissement", "postalCode": "75017", "roadNumber": "", "street": "" }, "postalAddressClassType": "ROAD_FOURTH", "postalAddressClassId": 4048, "postalAddressExactStreeNumber": false, "angle": -65.0, "administrativeSpeedLimit": 50.0, "relevanceScore": 0.13526771735726956, "countryRelevanceScore": 0.0, "cityRelevanceScore": 0.0, "postalCodeRelevanceScore": 0.0, "streetRelevanceScore": 0.0, "streetNumberRelevanceScore": 0.0, "geoElementTypes": [ "ROAD", "FOURTH_ROAD", "DISTRICT", "CITY", "COUNTY", "STATE", "COUNTRY" ], "segmentId": 0 }, { "coordinate": { "lon": 2.29263, "lat": 48.87482 }, "distanceFromRequest": 9.63, "postalCode": { "countryCode": "FRA", "country": "France", "state": "Île-de-France", "county": "Paris", "city": "Paris", "district": "Paris 17e Arrondissement", "postalCode": "75017", "roadNumber": "", "street": "Avenue de la Grande Armée", "streetNumber": "10", "oppositeStreetNumber": "10" }, "postalAddressClassType": "ROAD_FOURTH", "postalAddressClassId": 4048, "postalAddressExactStreeNumber": false, "angle": -65.0, "administrativeSpeedLimit": 30.0, "relevanceScore": 0.13145809414466128, "countryRelevanceScore": 0.0, "cityRelevanceScore": 0.0, "postalCodeRelevanceScore": 0.0, "streetRelevanceScore": 0.0, "streetNumberRelevanceScore": 0.0, "geoElementTypes": [ "ROAD", "FOURTH_ROAD", "DISTRICT", "CITY", "COUNTY", "STATE", "COUNTRY" ], "segmentId": 0 } ] } ] } ```