# Geocoding for batch job `POST https://bemap.benomad.com/bgis/service/geocodingBatch/1.0` Part of [Geocoding](https://benomad.com/dev/doc/bemap-api/search/geocoding.md). > **Place many addresses at once.** The positions of a whole list of addresses in one call, to import a customer or delivery file. Geocoding is the process of converting textual postal addresses to a geographical longitude and latitude coordinates. Provisioned per account: without it, BeMap answers `400 Access Denied`. ## Request body JSON, `Content-Type: application/json`. Schema `GeocodingForBatchRequest`. - `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 `200`, schema `GeocodingForBatchResponse`. - `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. ## Errors - `400`: Bad Request - `302`: no credentials were sent. Do not follow the redirect. - `401`: the account or the API key is wrong. How to read each one: [Errors](https://benomad.com/dev/doc/bemap-api/getting-started/errors.md). ## Example ```bash curl -X POST 'https://bemap.benomad.com/bgis/service/geocodingBatch/1.0' \ -u 'YOUR_ACCOUNT:YOUR_API_KEY' \ --fail-with-body \ -H 'Content-Type: application/json' \ -d '{ "queries": [ { "postalAddress": { "country": "France", "city": "Paris", "street": "Rue de Rivoli", "streetNumber": "164" } }, { "postalAddress": { "country": "France", "city": "Lyon", "street": "Rue de la République" } } ], "maximumResults": 1 }' ``` Response captured from production: ```json { "answers": [ { "extent": { "minLon": 2.32341, "minLat": 48.85852, "maxLon": 2.3482, "maxLat": 48.86637 }, "elements": [ { "boundingBox": { "minLon": 2.32341, "minLat": 48.85852, "maxLon": 2.3482, "maxLat": 48.86637 }, "coordinate": { "lon": 2.33869, "lat": 48.86163 }, "exactCoordinate": { "lon": 2.33877, "lat": 48.86174 }, "distanceFromRequest": 0, "postalAddress": { "countryCode": "FRA", "country": "France", "state": "Île-de-France", "county": "Paris", "city": "Paris", "district": "Paris 1er Arrondissement", "postalCode": "75001", "street": "Rue de Rivoli", "streetNumber": "164" }, "postalAddressClassType": "ROAD_TERTIARY", "postalAddressClassId": 4304, "postalAddressExactStreeNumber": true, "angle": -64, "administrativeSpeedLimit": 0, "relevanceScore": 1, "countryRelevanceScore": 1, "cityRelevanceScore": 0.75, "postalCodeRelevanceScore": 1, "streetRelevanceScore": 1, "streetNumberRelevanceScore": 1, "segmentId": 0 } ] }, { "extent": { "minLon": 4.83591, "minLat": 45.76529, "maxLon": 4.83601, "maxLat": 45.76751 }, "elements": [ { "boundingBox": { "minLon": 4.83591, "minLat": 45.76529, "maxLon": 4.83601, "maxLat": 45.76751 }, "coordinate": { "lon": 4.83601, "lat": 45.76735 }, "distanceFromRequest": 0, "postalAddress": { "countryCode": "FRA", "country": "France", "state": "Auvergne-Rhône-Alpes", "county": "Rhône", "city": "Lyon", "district": "Lyon 1er Arrondissement", "postalCode": "69001", "street": "Rue de la République" }, "postalAddressClassType": "ROAD_FOURTH_PEDESTRIAN", "postalAddressClassId": 4000, "postalAddressExactStreeNumber": false, "angle": 0, "administrativeSpeedLimit": 0, "relevanceScore": 1, "countryRelevanceScore": 1, "cityRelevanceScore": 0.75, "postalCodeRelevanceScore": 1, "streetRelevanceScore": 1, "streetNumberRelevanceScore": 0, "segmentId": 0 } ] } ] } ``` ## Reference pages - [Geocoding for batch job](https://benomad.com/dev/doc/bemap-api/guides/services/geocodingbatch.md)