This is the documentation of version 0.59.0. Go to the latest version, 1.0.0-rc.5.

Function getPlacesWithEVAvailability

getPlacesWithEVAvailability<P extends CommonPlaceProps = CommonPlaceProps>(
    places: Places<P>,
    options?: Omit<ChargingStationsAvailabilityParams, "id"> & {
        excludeIfAvailabilityUnknown: true;
    },
): Promise<Places<EVChargingStationWithAvailabilityPlaceProps>>
Enhance multiple places with real-time EV charging availability data.

Fetches availability information for all EV charging stations in a collection and merges it into their properties. Non-EV places and EV stations without availability data are returned unchanged.
Type Parameters
- P extends CommonPlaceProps = CommonPlaceProps
Parameters
- places: Places<P>
  Collection of places to enhance
- Optionaloptions: Omit<ChargingStationsAvailabilityParams, "id"> & {
  excludeIfAvailabilityUnknown: true;
  }
  Configuration options, including common service parameters (e.g. apiKey, onAPIRequest, signal) forwarded to each availability request
Returns Promise<Places<EVChargingStationWithAvailabilityPlaceProps>>
Promise resolving to places collection with merged availability
Remarks
Important: Availability requests are made sequentially to avoid exceeding API rate limits (QPS - Queries Per Second). For large result sets, this may take some time. Pass a signal to stop early: aborting it cancels the in-flight request, skips the remaining ones and rejects with SDKAbortError.

Needs the same API key access as evChargingStationsAvailability. A place whose request fails, including for a key without that access, counts as having unknown availability.
Example
```
// Search for charging stations and add availability
const results = await discoverPlaces({
  query: 'EV charging',
  geoBias: { position: [4.9, 52.3], radiusMeters: 5000 }
});

const withAvailability = await getPlacesWithEVAvailability(results, {
  excludeIfAvailabilityUnknown: true  // Filter out stations with unknown availability
});

// Display only stations with known availability
withAvailability.features.forEach(place => {
  const { count, statusCounts } = place.properties.chargingPark.availability.chargingPointAvailability;
  console.log(`${place.properties.poi?.name}: ${statusCounts.Available ?? 0} of ${count} chargers available`);
});
```
getPlacesWithEVAvailability<P extends CommonPlaceProps = CommonPlaceProps>(
    places: Places<P>,
    options?: Omit<ChargingStationsAvailabilityParams, "id"> & {
        excludeIfAvailabilityUnknown?: false;
    },
): Promise<Places<P | EVChargingStationWithAvailabilityPlaceProps>>
Enhance multiple places with real-time EV charging availability data.

Fetches availability information for all EV charging stations in a collection and merges it into their properties. Non-EV places and EV stations without availability data are returned unchanged.
Type Parameters
- P extends CommonPlaceProps = CommonPlaceProps
Parameters
- places: Places<P>
  Collection of places to enhance
- Optionaloptions: Omit<ChargingStationsAvailabilityParams, "id"> & {
  excludeIfAvailabilityUnknown?: false;
  }
  Configuration options, including common service parameters (e.g. apiKey, onAPIRequest, signal) forwarded to each availability request
  - OptionalexcludeIfAvailabilityUnknown?: false
    
    If true, places with unknown availability will be filtered out. Otherwise, they will be included.
    
    Default
    false
Returns Promise<Places<P | EVChargingStationWithAvailabilityPlaceProps>>
Promise resolving to places collection with merged availability
Remarks
Important: Availability requests are made sequentially to avoid exceeding API rate limits (QPS - Queries Per Second). For large result sets, this may take some time. Pass a signal to stop early: aborting it cancels the in-flight request, skips the remaining ones and rejects with SDKAbortError.

Needs the same API key access as evChargingStationsAvailability. A place whose request fails, including for a key without that access, counts as having unknown availability.
Example
```
// Search for charging stations and add availability
const results = await discoverPlaces({
  query: 'EV charging',
  geoBias: { position: [4.9, 52.3], radiusMeters: 5000 }
});

const withAvailability = await getPlacesWithEVAvailability(results, {
  excludeIfAvailabilityUnknown: true  // Filter out stations with unknown availability
});

// Display only stations with known availability
withAvailability.features.forEach(place => {
  const { count, statusCounts } = place.properties.chargingPark.availability.chargingPointAvailability;
  console.log(`${place.properties.poi?.name}: ${statusCounts.Available ?? 0} of ${count} chargers available`);
});
```