ianByrne / HASS-ukho_tides

Home Assistant integration for tide information
MIT License
28 stars 6 forks source link

Channel Islands #28

Closed zarss closed 2 months ago

zarss commented 2 months ago

Hi. If I may ask, could you please add Guernsey, Channel Islands to the list please? Thank you.

ianByrne commented 2 months ago

Hi @zarss - I think they should be coming up in the list under the following names:

Please let me know if they aren't showing up under these names for you

zarss commented 2 months ago

I went trough the list three times, maybe I am blind, but didn't find neither of them.

ianByrne commented 2 months ago

Hmm yes I can't seem to find them either 😕

Can you try setting them up via the configuration.yaml method?

sensor:
  - platform: ukho_tides
    api_key: <api_key>
    stations:
      - station_id: '1604'
        station_name: 'St Peter Port'
      - station_id: '1603A'
        station_name: 'Maseline Pier'

I haven't tried this method in a long time so not sure how well it still works. You may need to first remove any stations you have already setup through the UI flow

zarss commented 2 months ago

They appeared in HA, but status "unavailable"

ianByrne commented 2 months ago

Dang. I will see if I can find some time tonight to dig into what's happening with those stations

zarss commented 2 months ago

Thank you very much!

ianByrne commented 2 months ago

Hi @zarss - it would appear that none of the Channel Islands stations are being returned by the UKHO API. This is a bit confusing, considering they show up fine on their website, so I have reached out to a contact there to see if we can find out what is happening. I can't imagine these stations would be restricted to the paid tiers, so it is possibly just a bug on their end. I will keep you posted on any updates

ianByrne commented 2 months ago

Scratch that, re-reading the docs, it looks like the Channel Islands are only available to the paid tiers 😱

Discovery (free) tier:

The ADMIRALTY UK Tidal API provides authoritative source of tidal height predictions for Standard and Secondary tidal level stations around the United Kingdom. Discovery provides a free 1-year subscription to access the current plus 6 days’ worth of tidal events for 607 tidal stations around the United Kingdom. • 10 calls per second • 10,000 calls per month

Foundation (Paid) tier:

The Tidal API provides an authoritative source of tidal height predictions for Standard and Secondary tidal level stations. Foundation provides a 1-year subscription to access the current plus 13 days’ worth of tidal height for a wide range of tidal height stations around the British Isles and Ireland. This includes The Isle of Man and The Channel Islands consisting of the Bailiwicks of Jersey and Guernsey. • 20 calls per second • 20,000 calls per month 1 year subscription - £120 ex VAT

I'm sorry that this appears to be the case. Do please let me know if you end up deciding to go with a paid subscription - I have not personally done this, so those endpoints are all untested for this integration, but they should in theory all still work fine.

zarss commented 2 months ago

Thank you for your research. Unfortunately, usual case - Channel Islands are part of the UK, but really nobody cares about them.