Query

周边充电站

使用 stationAround 查询，您可以获取某个 GeoJSON 点特定半径范围内的充电站。当某个充电站繁忙，或您想提供多个充电选择时，此操作非常有用。

查询

按点搜索周边充电站需要 location（GeoJSON 点）和以米为单位的 distance。使用 filter 和 search 参数缩小结果范围，并使用 size 和 page 参数对结果进行分页。

参数

query· StationAroundQuery

Query parameters to filter stations.

filter· StationAroundFilter

Criteria to filter stations.

search· String

Search for stations around by name, id and external id.

size· Int

Number of elements (count) to return.

page· Int

Page number to return.

字段

id· ID

Unique ID of a station. This property is OCPI-compliant.

country_code· String

ISO-3166 alpha-2 country code of a station. This property is OCPI-compliant.

party_id· String

CPO ID of a CPO that 'owns' this station (following the ISO-15118 standard). This property is OCPI-compliant.

publish· Boolean

Defines if a location may be published on a website or app etc. When this is set to false, only tokens identified in the field: `publish_allowed_to` are allowed to show this location. When the same location has EVSEs that may be published and may not be published, two 'locations' should be created. This property is OCPI-compliant.

name· String

Name of a charging station. This property is OCPI-compliant.

address· String

Street/block name and house number if available. This property is OCPI-compliant.

city· String

City or town. This property is OCPI-compliant.

postal_code· String

Postal code of a location, may only be omitted when a location has no postal code: in some countries charging locations at highways don’t have postal codes. This property is OCPI-compliant.

state· String

State or province of a location, only to be used when relevant. This property is OCPI-compliant.

country· String

ISO 3166-1 alpha-3 code for the country of this station. This property is OCPI-compliant.

coordinates· OCPIGeoLocation

Coordinates of a location. This property is OCPI-compliant.

related_locations· OCPIAdditionalGeoLocation

Geographical location of related points relevant to a user. This property is OCPI-compliant.

parking_type· OCPIParkingType

Type of parking at a charge point location. This property is OCPI-compliant.

OCPIParkingType enum values

ALONG_MOTORWAY

Location on a parking facility/rest area along a motorway, freeway, interstate, highway etc.

PARKING_GARAGE

Multistorey car park.

PARKING_LOT

A cleared area that is intended for parking vehicles, i.e. at supermarkets, bars, etc.

ON_DRIVEWAY

Location is on the driveway of a house/building.

ON_STREET

Parking in public space along a street.

UNDERGROUND_GARAGE

Multistorey car park, mainly underground.

evses· EVSE

EVSEs that belong to a station. This property is OCPI-compliant.

directions· OCPIDisplayText

Human-readable directions on how to reach a station. This property is OCPI-compliant.

operator· Operator

Information about an operator. This property is OCPI-compliant.

suboperator· Operator

Information about a suboperator if applicable. This property is OCPI-compliant.

owner· Operator

Information about an owner if available. This property is OCPI-compliant.

facilities· OCPIFacility

Facilities a charging station belongs to. This property is OCPI-compliant.

OCPIFacility enum values

HOTEL

A hotel.

RESTAURANT

A restaurant.

CAFE

A cafe.

MALL

A mall or shopping center.

SUPERMARKET

A supermarket.

SPORT

Sport facilities: gym, field etc.

RECREATION_AREA

A recreation area.

NATURE

Located in, or close to, a park, nature reserve etc.

MUSEUM

A museum.

BIKE_SHARING

A bike/e-bike/e-scooter sharing location.

BUS_STOP

A bus stop.

TAXI_STAND

A taxi stand.

TRAM_STOP

A tram stop/station.

METRO_STATION

A metro station.

TRAIN_STATION

A train station.

AIRPORT

An airport.

PARKING_LOT

A parking lot.

CARPOOL_PARKING

A carpool parking.

FUEL_STATION

A Fuel station.

WIFI

Wifi or other type of internet available.

time_zone· String

Value from the IANA time zone database representing the time zone of a location. Examples: "Europe/Oslo", "Europe/Zurich". (http://www.iana.org/time-zones). This property is OCPI-compliant.

opening_times· OCPIHours

Times when an EVSEs at a location can be accessed for charging. This property is OCPI-compliant.

charging_when_closed· Boolean

Indicates if the EVSEs are still charging outside the opening hours. E.g. when a parking garage closes its barriers overnight, is it allowed to charge till the next morning? Default: true. This property is OCPI-compliant.

images· OCPIImage

Links to images related to a location such as photos or logos. This property is OCPI-compliant.

energy_mix· OCPIEnergyMix

Details of the energy supplied at a location. This property is OCPI-compliant.

last_updated· DateTime

Timestamp when a location, or one of its EVSEs or Connectors was last updated (or created). This property is OCPI-compliant.

external_id· String

ID provided by a station data source.

location· Point

GeoJSON location of a charging station.

elevation· Int

Elevation (altitude) level.

chargers· Charger

Groups of EVSEs by power and type.

amenities· JSON

Amenities located at this location.

physical_address· Address

Enriched information about the physical address of a station.

heavy_vehicles_properties· StationHeavyVehiclesProperties

Describes the heavy vehicle properties at the location.

heavy_vehicles_restrictions· StationHeavyVehiclesRestrictions

Describes the heavy vehicle restrictions at the location.

vehicle_restrictions· StationVehicleRestrictions

Describes the vehicle restrictions at the location.

location_category· String

Type of location where the charge point is located. For example: "shop".

entrance_for_navigation· OCPIAdditionalGeoLocation

Coordinates for the location's entrances in decimal degrees. If available, there can be more than one entrance to the location.

properties· JSON·

Optional object where you can store custom data you need in your application. This extends the current functionalities we offer.

realtime· Boolean

A flag that indicates if a station has real-time information about the availability of its connectors.

power· JSON

Connectors grouped by power.

predicted_occupancy· StationPredictedOccupancy

Predicted station occupancy.

speed· StationSpeedType

Charging speed for a station.

StationSpeedType enum values

slow

Slow charging (below 43 kW).

fast

Fast charging stations (above 43 kW and below 150 kW).

turbo

Ultra fast charging stations (above 150 kW).

status· ChargerStatus

Global status for a station.

ChargerStatus enum values

free

The charger is free.

busy

The charger is occupied/busy.

unknown

The charger is unknown.

error

The charger has an error.

custom_properties· StationCustomProperties

Custom properties of a station. These are vendor specific and will return null values on the fields that are not supported by your station database.

review· ReviewStats

Review of a station.

roaming· StationRoaming

List of eMSP cards accepted at a charging station.

support_phone_number· String

Phone number for assistance at a charging station.

charging_behaviour· ChargingBehaviour

Charging behavior of a station.

reliability_score· Int

Shows how reliable a charging station is (1 to 5; 1 = unreliable, 5 = reliable), taking into account the charging behaviour history and error values.

adhoc_authorisation_payment_method· StationAdhocAuthorisationPaymentMethod

Indicates the authentication and payment methods.

StationAdhocAuthorisationPaymentMethod enum values

AUTH_BY_CAR_PLUG_AND_CHARGE

Authentication by car through Plug and Charge.

ONLINE_APPLE_PAY

Apple Pay.

TERMINAL_IN_APP

Terminal in-app.

ONLINE_PAYPAL

PayPal.

SERVICE_PROVIDER_RFID_CARD

Service Provider RFID Card.

TERMINAL_QR_CODE

Terminal QR Code.

TERMINAL_CREDIT_CARD

Terminal Credit Card.

TERMINAL_DEBIT_CARD

Terminal Debit Card.

TERMINAL_SMS

Terminal SMS.

ONLINE_CREDIT_CARD

Credit Card.

OTHER_OTHER

Other.

TERMINAL_CONTACTLESS

Terminal Contactless.

ONLINE_GOOGLE_PAY

Google Pay.

ONLINE_BANK_PAYMENT

Bank Payment.

AUTH_BY_CAR_AUTOCHARGE

Authentication by car through Auto Charge.

access_type· AccessType

Type of access to the charging station.

AccessType enum values

Public

Restricted

Private

boosting_group_ids· ID· beta

List of active boosting groups to which the station belongs.

错误

操作可能会失败。请考虑以下错误场景以正确处理。有关错误的更多信息 here.

error_forbidden_message: You are forbidden to execute this operation.
missing_required_parameters: Missing required parameter(s): $PARAMETERS.
operation_not_allowed: You are not allowed to execute this operation. Enable it for the current application in the dashboard or reach out to customer support.
pagination_invalid_page: Page must be an INT value higher than 0.
pagination_invalid_size: Size must be an INT value between 1 and 1000.
rate_limit_exceeded: Rate limit exceeded.
station_distance_above_allowed: The provided distance is too big. The value must be less than or equal to 10.000 meters.
station_distance_below_allowed: The provided distance is too small. The value must be greater than 0.
station_power_below_allowed: The provided power is too small. The value must be greater than 0 kwh.

此内容是否有帮助？

查询示例

x-client-id

x-app-id

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443

query {
  stationAround {
    id
    country_code
    party_id
    publish
    name
    address
    city
    postal_code
    state
    country
    coordinates {
      latitude
      longitude
    }
    related_locations {
      latitude
      longitude
      name {
        language
        text
      }
    }
    parking_type
    evses {
      uid
      evse_id
      status
      status_schedule {
        period_begin
        period_end
        status
      }
      capabilities
      connectors {
        id
        standard
        format
        power_type
        max_voltage
        max_amperage
        max_electric_power
        power
        tariff_ids
        terms_and_conditions
        last_updated
        properties
        tariff {
          country_code
          party_id
          id
          currency
          type
          tariff_alt_text {
            language
            text
          }
          tariff_alt_url
          min_price {
            excl_vat
            incl_vat
          }
          max_price {
            excl_vat
            incl_vat
          }
          elements {
            price_components {
              type
              price
              vat
              step_size
            }
            restrictions {
              start_time
              end_time
              start_date
              end_date
              min_kwh
              max_kwh
              min_current
              max_current
              min_power
              max_power
              min_duration
              max_duration
              day_of_week
              reservation
            }
          }
          start_date_time
          end_date_time
          energy_mix {
            is_green_energy
            energy_sources {
              source
              percentage
            }
            environ_impact {
              category
              amount
            }
            supplier_name
            energy_product_name
          }
          last_updated
        }
        prices {
          external_id
          partner
          partner_id
          product {
            name
            type
            description
            subscription_type
            subscription_fee_excl_vat
            currency
          }
          elements {
            components {
              type
              price_excl_vat
              vat
              step_size
            }
            restrictions {
              start_time
              end_time
              start_date
              end_date
              minimum_kwh
              maximum_kwh
              minimum_power
              maximum_power
              minimum_current
              maximum_current
              minimum_price
              maximum_price
              overstay_battery_percentage {
                minimum
                maximum
                unit
              }
              overstay_time {
                minimum
                maximum
                unit
              }
              minimum_duration
              maximum_duration
              day_of_week
              emsp_contract_date {
                name
                from
                to
              }
              reservation
            }
          }
          last_updated
        }
        custom_properties {
          oicp {
            dynamic_power_level
            charging_modes
          }
        }
      }
      floor_level
      coordinates {
        latitude
        longitude
      }
      physical_reference
      parking_restrictions
      images {
        url
        thumbnail
        category
        type
        width
        height
      }
      last_updated
      parking_cost
      cpo_external_id
      properties
      custom_properties {
        oicp {
          authentication_modes
          max_capacity
          payment_options
          value_added_services
          additional_info {
            lang
            value
          }
          is_hubject_compatible
          hardware_manufacturer
        }
      }
    }
    directions {
      language
      text
    }
    operator {
      id
      external_id
      name
      website
      logo {
        url
        thumbnail
        category
        type
        width
        height
      }
      countries
      contact {
        phone
        email
        website
        facebook
        twitter
        properties
      }
      ranking_levels {
        low
        medium
        high
      }
      excluded_countries
      avoided_countries
    }
    suboperator {
      id
      external_id
      name
      website
      logo {
        url
        thumbnail
        category
        type
        width
        height
      }
      countries
      contact {
        phone
        email
        website
        facebook
        twitter
        properties
      }
      ranking_levels {
        low
        medium
        high
      }
      excluded_countries
      avoided_countries
    }
    owner {
      id
      external_id
      name
      website
      logo {
        url
        thumbnail
        category
        type
        width
        height
      }
      countries
      contact {
        phone
        email
        website
        facebook
        twitter
        properties
      }
      ranking_levels {
        low
        medium
        high
      }
      excluded_countries
      avoided_countries
    }
    facilities
    time_zone
    opening_times {
      twentyfourseven
      regular_hours {
        weekday
        period_begin
        period_end
      }
      exceptional_openings {
        period_begin
        period_end
      }
      exceptional_closings {
        period_begin
        period_end
      }
    }
    charging_when_closed
    images {
      url
      thumbnail
      category
      type
      width
      height
    }
    energy_mix {
      is_green_energy
      energy_sources {
        source
        percentage
      }
      environ_impact {
        category
        amount
      }
      supplier_name
      energy_product_name
    }
    last_updated
    external_id
    location {
      type
      coordinates
    }
    elevation
    chargers {
      standard
      power
      price
      speed
      status {
        free
        busy
        unknown
        error
      }
      total
    }
    amenities
    physical_address {
      continent
      country
      county
      state_province
      municipality
      city
      street
      number
      postal_code
      formatted_address
    }
    heavy_vehicles_properties {
      is_dedicated
      facilities
      is_trailer_accessible
      is_drive_through
      allows_dangerous_goods
      allows_rigid_vehicles
      allows_overnight_parking
    }
    heavy_vehicles_restrictions {
      height
      width
      length
      mass
      allowed_types_EU
    }
    vehicle_restrictions {
      mass
      width
      height
      length
    }
    location_category
    entrance_for_navigation {
      latitude
      longitude
      name {
        language
        text
      }
    }
    realtime
    power
    predicted_occupancy {
      weekday
      occupancy
      period_begin
      period_end
    }
    speed
    status
    custom_properties {
      oicp {
        parking_facility
        parking_spot
        calibration_law_data_availability
        clearinghouse_id
      }
    }
    review {
      rating
      count
    }
    roaming {
      partner_id
      ema_id
      emsp
      card
      android_app_link
      ios_app_link
    }
    support_phone_number
    charging_behaviour {
      code
      description
    }
    reliability_score
    adhoc_authorisation_payment_method
    access_type
    boosting_group_ids
  }
}

需要帮助? 联系支持。