# Charging station search

REST API, Service version 1.0.0

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

Returns the list of charging station (EVSE) around a coordinate.

## Summary
1. Request
 1. Mandatory parameters
2. Response
 1. Object hierarchy
 2. Matching between Charging Station API objects and OCPI objects
 3. Details of fields
 4. 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/chargingstation/search/1.0`

POST data:
```javascript
{
 "geoserver": "default",
 "providers": ["ocm"],
 "mode": "LOCAL_OR_REMOTE",
 "options": ["PATH_POINT"],
 "radius": 500,
 "coordinate": {
  "lon":2.3411999999999997,
  "lat":48.85693161206461
 }
}
```

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__

The parameters `coordinate`, `corridor`, and `boundingBox` are mutually exclusive. Use one of them is required.

- `geoserver` (string): Geoserver name.
- `swidx` (integer (int32), deprecated): Switch index.
- `mode` (enum): Mode of charging station research.
  - `LOCAL`: Perform the research only with the local database or cache.
  - `REMOTE`: Transfer and perform the request research to the provider database.
  - `LOCAL_AND_REMOTE`: Perform the research on local database/cache and on provider database (remote), the results are merged in single response.
  - `LOCAL_OR_REMOTE`: Capability preference between local and remote request. If the provider have the local capability mode, the request will executed only in local. If not, the remote mode will be used (if remote is available too).
  - `REMOTE_OR_LOCAL`: Capability preference between remote and local request. If the provider have the remote capability mode, the request will be send to remote provider. If not, the local mode will be used (if local is available too).
  - `LOCAL_IFNOPOOLS_REMOTE`: Capability preference between local and remote request. If the provider have the local capability mode, the request will executed on local database in first. If not pools are found, the remote mode will be used (if remote is available too).
  - `REMOTE_IFNOPOOLS_LOCAL`: Capability preference between remote and local request. If the provider have the remote capability mode, the request will be send to remote provider in first. If not pools are found, the local mode will be used (if local is available too).
- `options` (enum[]): Options of charging station service.
  - `AVAILABLE_CONNECTOR_TYPES`: Return the list of available connector type supported by the server.
  - `DEPRECATED_CONNECTOR`: Include all deprecated connector types.
  - `PATH_POOL_MAP`: Depth of path limited to the minimal pool information to display on map. Limited filtering capacity.
  - `PATH_POINT_MAP`: Depth of path limited to the minimal pool information to show on map. But allow filtering based on charging point.
  - `PATH_POOL`: Depth of path limited to the pool information.
  - `PATH_STATION`: Depth of path limited to the station information.
  - `PATH_POINT`: Depth of path limited to the charging point information.
  - `PATH_AUTO`: Automatic switching between PATH_POOL_MAP to PATH_POINT data precision. The depth of a path limits the charging point information.
- `pathAutoMaxPool` (integer (int32)): Define the maximum of pool found by request to automatic switching between DepthOfPath. The depth of a path limits the charging point information. See the option PATH_AUTO. 20 by default.
- `providers` (string[]): Provider names used by BeMap (bgis).
- `coordinate` (Coordinate): Coordinate research center in degrees decimal (WGS84). The `radius` parameter can be used with this parameter. The parameters `coordinate`, `corridor`, and `boundingBox` are mutually exclusive. Use one of them is required.
  - `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`.
- `corridor` (Coordinate[]): List of coordinate in degrees decimal (WGS84) represent the corridor of research. The `radius` parameter can be used with this parameter. The parameters `coordinate`, `corridor`, and `boundingBox` are mutually exclusive. Use one of them is required.
  - `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`.
- `radius` (integer (int32)): Define the radius in meters of search. Required by the center or corridor parameters.
- `bbox` (BoundingBox): Bounding box in degrees decimal (WGS84) represent the corridor of research. The parameters `coordinate`, `corridor`, and `boundingBox` are mutually exclusive. Use one of them is required.
  - `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)).
- `maxPoolResult` (integer (int32)): Define the maximum pools will be returned in response.
- `maxProviderResult` (integer (int32)): Define the maximum of provider item researched.
- `connectorIdFilters` (integer (int32)[]): List of connector type ID to perform a filtration based on those values.
- `poolIdFilter` (string): Pool ID filter, return only the pool with the input ID.
- `stationIdFilter` (string): Station ID filter, return only the station with the input ID.
- `pointIdFilter` (string): Point ID filter, return only the point with the input ID.
- `filtersVersion` (base64 string): Represents the version of the filtering logic used in the charging station search query. This field determines which filtering implementation or algorithm is applied during processing. The default is 1.  The available values are: 1, 2.
- `filters` (string[]): Filters, return only the points matching the filters. [Documentation of available filters](https://benomad.com/dev/doc/bemap-api/guides/reference/chargingstation-filter-v1.md).
- `language` (string): Define the language that will be used to perform the address lookup.

## Response

### Object hierarchy

<table style="background-color:#F6F6F6;">
 <tr>
  <td>
   <p>
    <p>The response contains a list of <code>ChargingStationPool</code> objects.</p>
    <p>The <code>ChargingStationPool</code> object represents a group of stations like a parking (but not always). Each <code>ChargingStationPool</code> contains a list of <code>ChargingStation</code> objects.</p>
    <p>The <code>ChargingStation</code> object represents the physical charging station but not always, depending on the provider data. The field <code>nature</code> specifies if it is a real station or a simple hierarchical group. Each <code>ChargingStation</code> contains a list of <code>ChargingPoint</code>.</p>
    <p>The <code>ChargingPoint</code> object represents a charging point that can deliver the power charge. And each <code>ChargingPoint</code> contains a list of <code>ConnectorTypes</code>.</p>
    <p>The <code>ConnectorTypes</code> object represents the connector plug that can be plugged to the vehicle.</p>
   </p>
   

- **ChargingStationPool** → **ChargingStation**: 1..n
- **ChargingStation** → **ChargingPoint**: 1..n
- **ChargingPoint** → **ConnectorType**: 1..n

   
  </td>
  <td align="center"><img src="https://benomad.com/dev/doc/bemap-api/guides/images/chargingstation-station-illustration.svg"/></td>
 </tr>
</table>

### Matching between Charging Station API objects and OCPI objects

|  Charging Station   |   OCPI    |
|:-------------------:|:---------:|
| ChargingStationPool | Location  |
| ChargingStation     | -         |
| ChargingPoint       | EVSE      |
| ConnectorType       | Connector |

>NOTE: OCPI has no mapping for the ChargingStation object.

### Details of fields

- `pools` (ChargingStationPool[]): Pools of charging station.
  - `providerName` (string): Provider name used by BeMap (bgis).
  - `providerMode` (enum): Define if the data come from the local database or directly from provider API.
    - `LOCAL`: The charging station data come from the local database or cache (local request to spatial database).
    - `REMOTE`: The charging station data come directly from the provider database (remote request to provider API).
    - `NOT_SUPPORTED_VALUE`: Not supported value for this API version.
  - `id` (string): Unique identifier of pool, come from the provider.
  - `operatorId` (string): Operator unique identifier like eMI3 format.
  - `sourceProvider` (string): Name of the original provider.
  - `customerId` (string): Customer id.
  - `updateDate` (integer (int64)): Update date, time stamp in milliseconds.
  - `tags` (string[]): List of tags, will be used to perform some filtration based on provider or customer references.
  - `brand` (string): Brand name of pool.
  - `nameOfPool` (string): Name of pool.
  - `accessibility` (enum): Define the accessibility of a pool of charging station.
    - `UNSUPPORTED_VALUE`: Not found, not supported new value.
    - `NA`: Unspecified access to the area.
    - `PUBLIC`: Publicly accessible area.
    - `PUBLIC_WITH_MEMBERSHIP`: Public with membership.
    - `PUBLIC_UPON_PRESENTATION`: Public upon presentation.
    - `PRIVATE`: Private.
    - `PRIVATE_EMPLOYEES_ONLY`: Private employees only.
    - `PRIVATE_CUSTOMERS_ONLY`: Private customers only.
    - `PRIVATE_RESIDENTS_ONLY`: Private residents only.
    - `PRIVATE_UPON_PRESENTATION`: Private upon presentation.
    - `RESTRICTED`: Controlled or restricted area access.
    - `CAR_SHARING_ONLY`: Car sharing only.
    - `OTHER`: Other.
  - `availabilityStatus` (enum): Define the status of availability.
    - `UNSUPPORTED_VALUE`: Not found, not supported new value.
    - `NA`: Not specified.
    - `OUT_OF_ORDER`: Out Of Order.
    - `IN_SERVICE`: In service.
    - `IN_SERVICE_FREE`: In service and free.
    - `IN_SERVICE_BUSY`: In service but busy.
    - `IN_SERVICE_RESERVED`: In service but reserved.
    - `FUTURE`: Future.
  - `longitude` (number (double)): Longitude in degrees decimal (WGS84) (double).
  - `latitude` (number (double)): Latitude in degrees decimal (WGS84) (double).
  - `countryCode` (string): ISO country code, 2 or 3 letters depends on provider (ISO 3166-1 alpha-2 and alpha-3).
  - `country` (string): Country.
  - `postalCode` (string): Zip code.
  - `city` (string): City name.
  - `street` (string): Street name.
  - `streetNumber` (string): House number.
  - `addressComplement` (string): Pool complement of address.
  - `floorNumber` (string): Address floor number.
  - `siteType` (string): Textual description of site.
  - `siteCategory` (enum): Reflects the general category type of the pool.
    - `NA`: Not available.
    - `UNKNOWN`: Unknown category.
    - `OTHER`: Other, not categorized.
    - `ON_STREET`: Parking in public space along a street.
    - `ON_MOTORWAY`: Location on a parking facility/rest area along a motorway, freeway, interstate, highway etc.
    - `PARKING_LOT`: A cleared area that is intended for parking vehicles, i.e. at super markets, bars, etc.
    - `BUILDING_DRIVEWAY`: Location is on the driveway of a house/building.
    - `BUILDING_PARKING`: Multi-storey car park.
    - `UNDERGROUND_PARKING`: Multi-storey car park, mainly underground.
    - `UNSUPPORTED_VALUE`: Not found, not supported new value.
  - `phoneNumber` (string): Phone number.
  - `timeZone` (string): Time zone. One of IANA tzdata's TZ-values representing the time zone of the location. Examples: "Europe/Oslo", "Europe/Zurich". (http://www.iana.org/time-zones)
  - `open24x7` (boolean): Pool is opened 24x7 hours.
  - `openingHours` (PoolOpeningHour[]): List of opening hours.
    - `dayOfweek` (enum): Day of week.
      - `MONDAY`: MONDAY.
      - `TUESDAY`: TUESDAY.
      - `WEDNESDAY`: WEDNESDAY.
      - `THURSDAY`: THURSDAY.
      - `FRIDAY`: FRIDAY.
      - `SATURDAY`: SATURDAY.
      - `SUNDAY`: SUNDAY.
    - `start` (string): Start time of opened pool.
    - `end` (string): End time of opened pool.
  - `numberOfParkingSpace` (integer (int32)): Number of parking space in the pool (parking).
  - `comment` (string): Comment.
  - `images` (ImageUrl[]): Links to images related to the location such as photos or logos.
    - `url` (string): URL from where the image data can be fetched through a web browser.
    - `thumbnailUrl` (string): URL from where a thumbnail of the image can be fetched through a web browser.
    - `category` (enum): Describes what the image is used for. Values can be CHARGER, ENTRANCE, LOCATION, NETWORK, OPERATOR, OTHER, OWNER.
      - `CHARGER`: Charger
      - `ENTRANCE`: Entrance
      - `LOCATION`: Location
      - `NETWORK`: Network
      - `OPERATOR`: Operator
      - `OTHER`: Other
      - `OWNER`: Owner
      - `NOT_SUPPORTED_VALUE`: Not supported value for this API version.
    - `format` (string): Image format like gif, jpeg, png, svg.
    - `width` (integer (int32)): Width of the full-scale image.
    - `height` (integer (int32)): Height of the full-scale image.
  - `chargingStations` (ChargingStation[]): List of charging stations.
    - `id` (string): ID of station.
    - `operatorId` (string): Operator unique identifier like eMI3 format.
    - `nature` (enum): Nature define the interpretation and behavior. If VGROUP the data must be interpreted as an no reality object, just like a simple group. If is REAL, the object exist in the reality world.
      - `VGROUP`: The data must not be interpreted as an actual physical object, but as a simple group.
      - `REAL`: The object exists in the real world.
    - `availabilityStatus` (enum): Define the status of availability.
      - `UNSUPPORTED_VALUE`: Not found, not supported new value.
      - `NA`: Not specified.
      - `OUT_OF_ORDER`: Out Of Order.
      - `IN_SERVICE`: In service.
      - `IN_SERVICE_FREE`: In service and free.
      - `IN_SERVICE_BUSY`: In service but busy.
      - `IN_SERVICE_RESERVED`: In service but reserved.
      - `FUTURE`: Future.
    - `authenticationModes` (string[]): Authentication mode.
    - `authenticationInformation` (string): Information about the authentication.
    - `paymentModes` (string[]): Payment mode.
    - `paymentInformation` (string): Information about the payment mode.
    - `chargePasses` (ChargingTariffChargePassFront[]): List of charge pass available a station.
      - `hashId` (string, required): Unique identifier of charge pass.
      - `title` (string, required): Name of charge pass.
      - `networkName` (string): Unique name of charge network.
      - `description` (string): A brief description or summary of the station charge pass.
      - `currency` (string): Currency used for the subscription fee. This field stores the currency code or symbol used for the subscription fee.
      - `subscriptionType` (string): Type of subscription associated with the entity. This may denote the specific subscription model or tier for accessing the station service.
      - `subscriptionFeeExclVat` (number (float)): Subscription fee excluding VAT. This field stores the fee amount charged for a subscription before any value-added tax is applied.
      - `networkUrl` (string): URL link to the website of charge network.
      - `androidAppUrl` (string): URL link to the Android application of charge network.
      - `iosAppUrl` (string): URL link to the iOS application of charge network.
    - `bookable` (boolean): Bookable. Set to true if the station is bookable.
    - `images` (ImageUrl[]): Links to images related to the location such as photos or logos.
      - `url` (string): URL from where the image data can be fetched through a web browser.
      - `thumbnailUrl` (string): URL from where a thumbnail of the image can be fetched through a web browser.
      - `category` (enum): Describes what the image is used for. Values can be CHARGER, ENTRANCE, LOCATION, NETWORK, OPERATOR, OTHER, OWNER.
        - `CHARGER`: Charger
        - `ENTRANCE`: Entrance
        - `LOCATION`: Location
        - `NETWORK`: Network
        - `OPERATOR`: Operator
        - `OTHER`: Other
        - `OWNER`: Owner
        - `NOT_SUPPORTED_VALUE`: Not supported value for this API version.
      - `format` (string): Image format like gif, jpeg, png, svg.
      - `width` (integer (int32)): Width of the full-scale image.
      - `height` (integer (int32)): Height of the full-scale image.
    - `tags` (string[]): List of tags, will be used to perform some filtration based on provider or customer references.
    - `chargingPoints` (ChargingPoint[]): List of charging points.
      - `id` (string): ID of charging point.
      - `operatorId` (string): Operator unique identifier like eMI3 format.
      - `availabilityStatus` (enum): Define the status of availability.
        - `UNSUPPORTED_VALUE`: Not found, not supported new value.
        - `NA`: Not specified.
        - `OUT_OF_ORDER`: Out Of Order.
        - `IN_SERVICE`: In service.
        - `IN_SERVICE_FREE`: In service and free.
        - `IN_SERVICE_BUSY`: In service but busy.
        - `IN_SERVICE_RESERVED`: In service but reserved.
        - `FUTURE`: Future.
      - `availabilityUntil` (integer (int64)): Availability available until time (Time stamp in milliseconds).
      - `type` (integer (int32)): ID of first connector type.
      - `connectorTypes` (ConnectorTypeFront[]): List of connector type.
        - `id` (integer (int32)): BeMap unique identifier of connector.
        - `key` (string): BeMap unique identifier text key of connector. Same as id field but with string value.
        - `operatorId` (string): Operator unique identifier like eMI3 format.
        - `deprecated` (boolean): Set to true if the information is deprecated.
        - `name` (string): Name of connector.
        - `norm` (string): Norm of connector.
        - `maxPower` (number (double)): Maximal power in kW of connector. Unlimited is `0`.
        - `power` (number (double)): Available power in kW can be delivered by the station or charge point.
        - `voltage` (number (float)): Voltage of current.
        - `ampere` (number (float)): Ampere of current.
        - `acSingle` (boolean): AC single phase.
        - `acThree` (boolean): Current type AC three phases.
        - `dc` (boolean): Current type DC.
        - `cable` (boolean): The connector have a cable.
      - `currentType` (enum): Current type (AC/DC).
        - `NA`: Not available (NA).
        - `AC`: Alternating current (AC), but the number of phases is not available.
        - `AC_SINGLE_PHASE`: Alternating current (AC), single phase.
        - `AC_THREE_PHASES`: Alternating current (AC), three phases.
        - `DC`: Direct current (DC).
      - `voltage` (number (float)): Voltage of current.
      - `ampere` (number (float)): Ampere of current.
      - `power` (number (double)): Electrical power in kW.
      - `currency` (string): Currency ISO 4217 Code.
      - `remoteCharging` (boolean): True if a charging session can be started remotely.
      - `tariffsType` (string): Represents the type of tariffs, e.i. AD_HOC, MSP.
      - `tariffsChargePassHashId` (string): Represents a unique identifier hash associated with the tariffs used for calculating charges.
      - `tariffs` (ChargingTariffItemFront[]): List of tariff.
        - `prices` (ChargingPrice[], required): List of price.
          - `type` (enum, required): Type of price dimension.
            - `FLAT`: flat fee, no unit.
            - `PARKING_TIME`: time not charging, defined in hours.
            - `ENERGY`: defined in kWh.
            - `TIME`: time charging, defined in hours.
          - `price` (number (float), required): Price per unit (excluding VAT) for this tariff dimension.
          - `unit` (enum): Unit of price.
            - `NA`
            - `PER_HOUR`
            - `PER_KWH`
          - `vat` (number (float)): Applicable VAT percentage for this tariff dimension. If omitted, no VAT is applicable.
          - `minAmount` (number (float)): Minimum amount to be billed.
        - `restriction` (ChargingPriceRestriction): Restriction information of prices.
          - `startTime` (string): Start time of day (hh:mm).
          - `endTime` (string): End time of day (hh:mm).
          - `startDate` (string): Start date (AAAA-MM-DD).
          - `endDate` (string): End date (AAAA-MM-DD).
          - `minKwh` (number (float)): Minimum used energy in kWh for this tariff to be valid.
          - `maxKwh` (number (float)): Maximum used energy in kWh for this tariff to be valid.
          - `minPower` (number (double)): Minimum power in kW for this tariff to be valid.
          - `maxPower` (number (double)): Maximum power in kW for this tariff to be valid.
          - `minDuration` (integer (int32)): Minimum duration in seconds for this tariff to be valid.
          - `maxDuration` (integer (int32)): Maximum duration in seconds for this tariff to be valid.
          - `dayOfWeek` (enum[]): List of day of the week for this tariff to be valid. Values can be MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.
            - `MONDAY`
            - `TUESDAY`
            - `WEDNESDAY`
            - `THURSDAY`
            - `FRIDAY`
            - `SATURDAY`
            - `SUNDAY`
      - `parkingSpot` (ParkingVehicleAccessFront): Vehicle access restrictions and parking information for this charging point.
        - `maxHeight` (integer (int32)): Maximum height (in cm) of a vehicle to access the parking. Null if no restriction.
        - `maxWidth` (integer (int32)): Maximum width (in cm) of a vehicle to access the parking. Null if no restriction.
        - `maxLength` (integer (int32)): Maximum length (in cm) of a vehicle to access the parking. Null if no restriction.
        - `maxWeight` (integer (int32)): Maximum weight (in tenth of ton) of a vehicle to access the parking. Null if no restriction.
        - `dangerousGoodsAllowed` (boolean): Whether vehicles loaded with dangerous goods are allowed to park.
        - `overnightParkingAllowed` (boolean): Whether overnight parking is allowed for heavy vehicles.
        - `parkingOrientation` (enum): The direction in which vehicles are parked at the charging station.
          - `PARALLEL`: Parking happens parallel to the roadway on which vehicles approach the charging station.
          - `PERPENDICULAR`: Parking happens perpendicular to the roadway on which vehicles approach the charging station.
          - `ANGLE`: Parking happens at an angle to the roadway on which vehicles approach the charging station (i.e. echelon parking).
          - `DRIVE_THROUGH`: A vehicle can stop, charge, and proceed without reversing into or out of a parking bay. This is particularly important for heavy vehicles with trailers.
        - `transportTypes` (enum[]): List of transport types that can use this parking.
          - `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.
      - `tags` (string[]): List of tags, will be used to perform some filtration based on provider or customer references.
  - `summaryOfConnectorTypeIds` (integer (int32)[]): Summarized of connector type, used as cache of different connector types present in pool.
  - `maxNominalPower` (number (double)): Maximum of nominal power (in kW) present in pool.
  - `numberOfChargingPoint` (integer (int32)): Summarized of number of charging point present in pool.
  - `reliabilityScore` (integer (int32)): Reliability score of the pool. A score of 1 is the least reliable, and a score of 5 is the most reliable.
  - `predictedOccupancyTimeSlots` (PredictedOccupancyTimeSlot[]): List of predicted occupancy time slots for a charging station. Each time slot provides information about the predicted occupancy level within a specific time range on a given day.
    - `dayOfweek` (enum): Day of week.
      - `MONDAY`: MONDAY.
      - `TUESDAY`: TUESDAY.
      - `WEDNESDAY`: WEDNESDAY.
      - `THURSDAY`: THURSDAY.
      - `FRIDAY`: FRIDAY.
      - `SATURDAY`: SATURDAY.
      - `SUNDAY`: SUNDAY.
    - `start` (string): Start time of opened pool.
    - `end` (string): End time of opened pool.
    - `predictedOccupancy` (integer (int32)): Predicted occupancy. This value ranges from 0 to 10, where: `0` means the station is least occupied. `10` means the station is fully occupied.
  - `vehicleAccess` (SummaryParkingVehicleAccessFront): Restrictions regarding vehicles.
    - `maxHeight` (integer (int32)): Maximum height (in cm) of a vehicle to access the parking. Null if no restriction.
    - `maxWidth` (integer (int32)): Maximum width (in cm) of a vehicle to access the parking. Null if no restriction.
    - `maxLength` (integer (int32)): Maximum length (in cm) of a vehicle to access the parking. Null if no restriction.
    - `maxWeight` (integer (int32)): Maximum weight (in tenth of ton) of a vehicle to access the parking. Null if no restriction.
    - `dangerousGoodsAllowed` (boolean): Whether vehicles loaded with dangerous goods are allowed to park.
    - `overnightParkingAllowed` (boolean): Whether overnight parking is allowed for heavy vehicles.
    - `parkingOrientation` (enum): The direction in which vehicles are parked at the charging station.
      - `PARALLEL`: Parking happens parallel to the roadway on which vehicles approach the charging station.
      - `PERPENDICULAR`: Parking happens perpendicular to the roadway on which vehicles approach the charging station.
      - `ANGLE`: Parking happens at an angle to the roadway on which vehicles approach the charging station (i.e. echelon parking).
      - `DRIVE_THROUGH`: A vehicle can stop, charge, and proceed without reversing into or out of a parking bay. This is particularly important for heavy vehicles with trailers.
    - `transportTypes` (enum[]): List of transport types that can use this parking.
      - `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.
    - `parkingOrientations` (enum[])
      - `PARALLEL`
      - `PERPENDICULAR`
      - `ANGLE`
      - `DRIVE_THROUGH`

### Response samples

JSON Sample:
```javascript
{"pools": [
      {
      "id": "670AA62E-AA71-446F-9EA9-F3037FF33BD8",
      "brand": "Tesla Motors (Worldwide)",
      "nameOfPool": "Relais Christine",
      "accessibility": "NA",
      "availabilityStatus": "IN_SERVICE",
      "longitude": 2.340142,
      "latitude": 48.854369,
      "countryCode": "FR",
      "country": "France",
      "postalCode": "75006",
      "city": "Paris",
      "street": "3 Rue Christine",
      "phoneNumber": "+33 1 40 51 60 80",
      "chargingStations": [      {
         "id": "670AA62E-AA71-446F-9EA9-F3037FF33BD8-Station1",
         "availabilityStatus": "NA",
         "chargingPoints": [         {
            "id": "138680",
            "availabilityStatus": "NA",
            "type": 39,
            "connectorTypes": [            {
               "id": 39,
               "deprecated": false,
               "name": "Tesla S",
               "norm": "Tesla Model S (oval, 5 pin)",
               "cable": true
            }],
            "currentType": "AC_THREE_PHASES",
            "voltage": 400,
            "ampere": 16,
            "power": 11
         }]
      }]
   },
      {
      "id": "D8EC81E8-6B4A-4A72-BDC5-4118B8852342",
      "nameOfPool": "Rue de l'Amiral de Coligny",
      "accessibility": "NA",
      "availabilityStatus": "NA",
      "longitude": 2.3403485000000046,
      "latitude": 48.8599749,
      "countryCode": "FR",
      "country": "France",
      "postalCode": "",
      "city": "Paris",
      "street": "Rue de l'Amiral de Coligny",
      "phoneNumber": "+33 01 53 20 09 69 "
   },
      {
      "id": "ACA8D787-975D-400F-8291-37C2EE556D0A",
      "brand": "Belib’",
      "nameOfPool": "Quai du Marche Neuf",
      "accessibility": "NA",
      "availabilityStatus": "FUTURE",
      "longitude": 2.34556,
      "latitude": 48.854057,
      "countryCode": "FR",
      "country": "France",
      "postalCode": "75004",
      "city": "Paris",
      "street": "4 QUAI DU MARCHE NEUF",
      "chargingStations": [      {
         "id": "ACA8D787-975D-400F-8291-37C2EE556D0A-Station1",
         "availabilityStatus": "NA",
         "chargingPoints":          [
                        {
               "id": "111798",
               "availabilityStatus": "NA",
               "type": 23,
               "connectorTypes": [               {
                  "id": 23,
                  "deprecated": true,
                  "name": "Other",
                  "norm": "Other",
                  "cable": false
               }],
               "currentType": "AC_THREE_PHASES",
               "power": 3
            },
                        {
               "id": "111799",
               "availabilityStatus": "NA",
               "type": 36,
               "connectorTypes": [               {
                  "id": 36,
                  "deprecated": false,
                  "name": "Attached cable Type 4 / CHAdeMO",
                  "norm": "IEC 62196   / CHAdeMO",
                  "cable": true
               }],
               "currentType": "AC_THREE_PHASES",
               "voltage": 400,
               "ampere": 32,
               "power": 22
            },
                        {
               "id": "111800",
               "availabilityStatus": "NA",
               "type": 38,
               "connectorTypes": [               {
                  "id": 38,
                  "deprecated": false,
                  "name": "Cable Combo2",
                  "norm": "CCS with type 2 (Europe)",
                  "cable": true
               }],
               "currentType": "AC_THREE_PHASES",
               "voltage": 400,
               "ampere": 32,
               "power": 22
            },
                        {
               "id": "111801",
               "availabilityStatus": "NA",
               "type": 35,
               "connectorTypes": [               {
                  "id": 35,
                  "deprecated": false,
                  "name": "Type 3C",
                  "norm": "EC 62196 / Scame (single or three phases)",
                  "cable": false
               }],
               "currentType": "AC_THREE_PHASES",
               "voltage": 400,
               "ampere": 32,
               "power": 22
            },
                        {
               "id": "111802",
               "availabilityStatus": "NA",
               "type": 32,
               "connectorTypes": [               {
                  "id": 32,
                  "deprecated": false,
                  "name": "Attached cable Type 2",
                  "norm": "IEC 62196-2 / Mennekes",
                  "cable": true
               }],
               "currentType": "AC_THREE_PHASES",
               "voltage": 400,
               "ampere": 32,
               "power": 22
            },
                        {
               "id": "111803",
               "availabilityStatus": "NA",
               "type": 35,
               "connectorTypes": [               {
                  "id": 35,
                  "deprecated": false,
                  "name": "Type 3C",
                  "norm": "EC 62196 / Scame (single or three phases)",
                  "cable": false
               }],
               "currentType": "AC_THREE_PHASES",
               "power": 3
            },
                        {
               "id": "111804",
               "availabilityStatus": "NA",
               "type": 36,
               "connectorTypes": [               {
                  "id": 36,
                  "deprecated": false,
                  "name": "Attached cable Type 4 / CHAdeMO",
                  "norm": "IEC 62196   / CHAdeMO",
                  "cable": true
               }],
               "currentType": "DC",
               "power": 3
            },
                        {
               "id": "111805",
               "availabilityStatus": "NA",
               "type": 38,
               "connectorTypes": [               {
                  "id": 38,
                  "deprecated": false,
                  "name": "Cable Combo2",
                  "norm": "CCS with type 2 (Europe)",
                  "cable": true
               }],
               "currentType": "AC_THREE_PHASES",
               "voltage": 400,
               "ampere": 32,
               "power": 22
            }
         ]
      }]
   }
]}
```
