eco-movement.com

Attribute definition

Attributes definition

Attributes

Description

Example

Type

timestamp

The time this message was generated.

2021-02-26T20:21:06

DateTime

status_code

Response code, as listed in Status Codes, indicates how the request was handled. To avoid confusion with HTTP codes, at least four digits are used.

1000

int

status_message

 An optional status message which may help when debugging.

Success

String

Object

String

data

Location data. Contains the actual response data object or list of objects from each request.


Array

data.object.id

Unique id on Location level

42d70872-4d93-11e8-b792-42010a840002

String

data.object.name

Name of the location

EVnetNL AL106

String

data.object.type.

Parking type

• ON_STREET

• PARKING_GARAGE

• UNDERGROUND_GARAGE

• PARKING_LOT

• OTHER

• UNKNOWN

Enum

String

data.object.location_type

Type of location where the charging station is located

• ALONG_MOTORWAY

• PARKING_GARAGE

• PARKING_LOT

• ON_STREET

• OTHER

Enum

String

data.object.access_type

Type of access to the charging station

• Public

• Restricted

• Private

Enum

String

data.object.address

Address including number

Dorine Verschureplein 9

String

data.object.city

City or town name

Elsloo

String

data.object.postal_code

Postal Code of the location

6181 AS

String

data.object.country

ISO 3166-1 alpha-3 code for the country of this location

NLD

String

data.object.coordinates

Coordinates of the location

GeoLocation

data.object.coordinates.latitude

Latitude

50.94745451

Number

data.object.coordinates.longitude

Longitude

5.7745846

Number

data.object.time_zone

One of IANA tzdata’s TZ-values representing the time zone of the location.

Europe/Oslo

String

data.object.opening_times

Shows if the location is always opened or has opening times

twentyfourseven: true/false

Hours

data.object.derived_opening_times

Derived opening times, based on history algorithm, per weekday from 1 to 7

• weekday: 1

• weekday: 2

• weekday: 3

Hours

data.object.derived_opening_

times.object.regular_hours

Gives the derived openingtimes, based on regular usage hours, per weekday from 1 to 7

period_begin: 07:00

period_end: 20:00


period_begin: 07:00

period_end: 20:00


period_begin: 07:00

period_end: 20:00

Array with Strings

data.object.derived_opening_

times.object.twentyfourseven

Shows if the location is always opened or has opening times.

true

Boolean

data.object.derived_opening_

times.object.charging_when_closed

Indicates if the EVSEs can be used for charging outside the opening hours of the location. E.g. when the parking garage closes its barriers overnight, it will indicate if you can still charge until the next morning

true

Boolean

data.object.predicted_occupancy

Predicts the occupancy of the location. The complex algorithm takes into account trend lines of seasons, years, months, weeks and days.


Only available in EVSE endpoint.

weekday: 1

occupancy: 3

period_end: 00:59Z

period_begin: 00:00Z


weekday: 1

occupancy: 3

period_end: 01:59Z

period_begin: 01:00Z

Array

data.object.predicted_occupancy.

object.weekday

Weekday is from Monday to Sunday, 1 to 7

1

2

3

4

5

6

7

Enum

data.object.predicted_occupancy.

period_begin

Period_begin indicate the start of the period. The Z after the time indicates that it is in UTC

07:00Z

String

data.object.predicted_occupancy.

period_end

Period_end indicate the end of the period. The Z after the time indicates that it is in UTC.

23:00Z

String

data.object.predicted_occupancy.

occupancy

Occupancy is on a scale from 1 to 10, where 1 means free for charging and 10 means fully occupied


1

2

3

4

5

6

7

8

9

10

Enum


Number

data.object.charging_behaviour

Charging behavior of station


Object

data.object.charging_behaviour.

code

Charging behavior of users divided in groups, based on real-time information

• URBAN_CHARGING

• FAST_CHARGING

• MIXED_CHARGING

• NOISE_CHARGING

•OVERNIGHT_CHARGING

• OFFICE_CHARGING

String

data.object.charging_behaviour.

description

Explanation of charging behaviour

Mainly morning charging, and some mixed afternoon and evening charging.

String

data.object.facilities

Optional list of facilities this charge location directly belongs to.

• AIRPORT

• BUSINESS

• BUS_STOP

• CAFE

• CARPOOL_PARKING

• EDUCATION

• FINANCE

• FUEL_ STATION

• HEALTH

• HOTEL

• MALL

• MUSEUM

• NATURE

• OTHER

• RECREATION_AREA

• RESTAURANT

• SERVICE

• SPORT

• STORE

• SUPERMARKET

• TAXI_STAND

• TRAIN_STATION

Facility

data.object.related_locations

The facility closest to the location of the charge point

Object

data.object.related_locations.

latitude

Latitude of closest facility

50.94745

Number

data.object.related_locations.

longitude

Longitude of closest facility

5.77428

Number

data.object.related_locations.

name

Name of closest facility data


Object

data.object.related_locations.

name.language

Language 2 letter code

NL

String

data.object.related_locations.

name.text

Text of closest facility name

Bloemenspeciaalzaak Bergmans

String

data.object.owner

Charging station owner data

BusinessDetails

data.object.owner.name

Name of the owner of the charging station

EVnetNL

String

data.object.owner.website

Website of the owner of the charging station

https://evnet.nl

String

data.object.operator

Charging station operator data

BusinessDetails

data.object.operator.name

Name of the operator of the charging station

Ecotap

String

data.object.operator.website

Website of the operator of the charging station

https://www.ecotap.nl

String

data.object.support_phone_number

The phone number for assistance at the charge location.

+(31)-(800)-3522365

String

data.object.adhoc_authorisation_

method

Available ad hoc payment methods

• CREDIT_CARD

• DEBIT_CARD

• OTHER

• OTHER_Apple_Pay

• OTHER_Authentication_by_car

• OTHER_Google_Pay

• QR_CODE

• SMS

Array

String

data.object.roaming

A list of all major eMSP card accepted at this location, including links to their native apps

Array

data.object.roaming.object.emsp

Name of the EMSP provider of the charging station

Vattenfall

String

data.object.roaming.object.card

Card accepted at location

Incharge card

String

data.object.roaming.object.

android_app_link

Link to native app for card accepted at location for Android

https://play.google.com/store/apps/details?id=nl.nuon.laadpunten

String

data.object.roaming.object.

ios_app_link

Link to native app for card accepted at location for iOS

https://apps.apple.com/de/app/vattenfall-incharge/id885790133

String

data.object.reliability_score

Score shows how reliable a charging location is (1 to 5; 1 = unreliable, 5 = reliable), taking into account the charging behavior history and error values.

1

2

3

4

5

Enum

Number

data.object.last_updated

Timestamp when this Location or one of its EVSEs or Connectors were last updated (or created).

2021-02-26T14:11:20Z

DateTime

data.object.EVSEs

EVSE data


Array

data.object.EVSEs.object.uid

Unique id within system of the CPO.

9785

String

data.object.EVSEs.object.EVSE_id

Unique id for the outside world. Compliant with “eMI3standard version V1.0”

NL*EVN*E30332*9785

String

data.object.EVSEs.object.status

The realtime status of an EVSE.

• AVAILABLE

• BLOCKED

• CHARGING

• INOPERATIVE

• OUTOFORDER

• PLANNED

• REMOVED

• RESERVED

• UNKNOWN

Status

data.object.EVSEs.object.

capabilities

 List of functionalities that the EVSE is capable of, conform OCPI 2.1.1. Only filled if supplied by the CPO.

• CHARGING_PROFILE_CAPABLE

• REMOTE_START_STOP_CAPABLE

• CREDIT_CARD_PAYABLE

• RESERVABLE

• RFID_READER

• UNLOCK_CAPABLE

Capability

data.object.EVSEs.object.parking_

restrictions

Restriction to the parking spot for different purposes; Only filled if supplied by the CPO.

• EV_ONLY

• PLUGGED

• DISABLED

• CUSTOMERS

• MOTORCYCLES

ParkingRestrictions

data.object.EVSEs.object.connectors

List of available connectors on the EVSE.

Connector

data.object.EVSEs.object.connectors.

object.id

 Identifies the connectors within the given EVSEs.. Two connectors may have the same id as long as they do not belong to the same EVSE object.

9785

String

data.object.EVSEs.object.connectors.

object.standard

The standard of the installed connector.

• CHADEMO

• DOMESTIC_A

• DOMESTIC_B

• DOMESTIC_C

• DOMESTIC_D

• DOMESTIC_E

• DOMESTIC_F

• DOMESTIC_G

• DOMESTIC_H

• DOMESTIC_I

• DOMESTIC_J

• DOMESTIC_K

• DOMESTIC_L

• IEC_60309_2_single_16

• IEC_60309_2_three_16

• IEC_60309_2_three_32

• IEC_60309_2_three_64

• IEC_62196_T1

• IEC_62196_T1_COMBO

• IEC_62196_T2

• IEC_62196_T2_COMBO

• IEC_62196_T3A

• IEC_62196_T3C

• TESLA_R

• TESLA_S

ConnectorType

data.object.EVSEs.object.connectors.

object.format

The format (socket/cable) of the installed connector. 

• SOCKET

• CABLE

ConnectorFormat

data.object.EVSEs.object.connectors.

object.power_type

Power type of connectors

• AC_3_PHASE

• AC_1_PHASE

• DC

PowerType

data.object.EVSEs.object.connectors.

object.voltage

Voltage of the connector (line to neutral for AC_3_PHASE), in volt [V]. 

230

int

data.object.EVSEs.object.connectors.

object.amperage

Maximum amperage of the connector, in ampere [A].

16

int

data.object.EVSEs.object.connectors.

object.max_power

Maximum power in kW, for example 20, valid up to this charging speed .

11040

Number

data.object.EVSEs.object.connectors.

object.tariff_id

 Identifier of the current charging tariff structure. For a “Free of Charge” tariff this field should be set, and point to a defined “Free of Charge” tariff.


This field corresponds to the tariffs module.reference tariffs endpoint

98c6f2c2287f4c73cea3d40ae7ec3ff2

String

data.object.EVSEs.object.connectors.

object.last_updated

Timestamp when this Connectors was last updated (or created).

2019-08-29T13:31:00Z

String

Attributes

Description

Default

Type

id

With the pricing_id behind the prices endpoint you can request all the prices for that id

9054ce03-5573-4fbf-aa37-afd47e7408d0

String

limit

With limit you can set the amount of locations that will be given. The maximal value is 1000 locations

1

Number

offset

The beginning of the next request. With this parameter you can request the following 1000 locations

0

Number

timestamp

The time this message was generated. 

2021-03-12T05:34:48

DateTime

status_code

Response code, as listed in Status Codes, indicates how the request was handled. To avoid confusion with HTTP codes, at least four digits are used. 

1000

int

status_message

An optional status message which may help when debugging.

Success

String

data.id

Unique id on Location level

98c6f2c2287f4c73cea3d40ae7ec3ff2

String

data.price_list

Price list data



data.price_list.partner

Partner name

EVBox

String

data.price_list.product

Name of the price product/tariff plan used at this location.



data.price_list.product.name

Product type

Adhoc price

String

data.price_list.product.

description

Product description

String

data.price_list.product.

subscription_type

Subscription type

Year

String

data.price_list.product.

subscription_fee_excl_vat

Subscription fee excluding VAT

0

Number

data.price_list.product.

currency

Currency

EUR

String

data.elements

List of tariff elements 

data.elements.type

Type of tarrif element

• ENERGY

•FLAT

• TIME

• PARKING_TIME

TarrifElement

data.elements.price_excl_vat

Price excluding VAT

0.17999999999999999

Number

data.elements.vat

VAT

21

Number

data.partner

Provider of the charging station's pricing product

MSP Company

String

data.product

Pricing product data

data.product.name

Product name

MSP Card E-MOVE

String

data.product.description

Description

Extra parking cost of 10 cent per minute apply after 240 minutes

String

data.product.subscritpion_type

Subscription type

Year

String

data.product.subscription_

fee_excl_vat

Subscription fee excluding VAT

15

Number

data.product.currency

Currency

EUR

String

CONTACT

Would you like to know more about our APIs?

Reach out via the form below!