Hi everyone,
I’m happy to announce a new custom integration I’ve developed: Paris Markets!
If you live in or are interested in Paris, this integration allows you to bring information about the city’s vibrant food markets directly into your Home Assistant. It uses the official open data from the City of Paris.
Key Features:
- Discover Nearby Markets: Automatically finds markets based on your Home Assistant’s configured location.
- Real-Time Status: Sensor entities tell you if a market is currently
openorclosed. - Flexible Filtering: During setup, you can filter markets by:
- Distance radius from your location.
- A selection of arrondissements (districts).
- Product types (e.g., Food, Organic Food, Flowers, Flea Markets, etc.).
- Detailed Market Info: Sensors provide attributes like the market’s full name, short name, location description, arrondissement, product type, and coordinates.
- Calendar View: Each market gets its own calendar entity, making it easy to see upcoming opening days and times, and to use them in automations.
Data Source:
The integration pulls data from the Official Paris Open Data platform (Dataset: Marchés découverts). This data is sporadically updated (if ever), so the integration has a minimum polling rate of one single day.
Installation & Configuration:
Full installation and configuration instructions can be found in the README on GitHub.
Prerequisites: Ensure your Home Assistant’s latitude and longitude are set (Settings → System → General) if you configure distance-based search. Arrondissement-based configurations don’t need this.
Setup (after installation):
- Go to Settings → Devices & Services → Add Integration.
- Search for ‘Paris Markets’ and select it.
- Follow the prompts to configure your search radius and preferred market types.
- You can adjust the data update interval in the integration’s options after setup.
GitHub Repository:
You can find the code, full documentation, and issue tracker on GitHub: ork/hass-paris-markets.
Examples:
The README includes examples for:
- Creating a template sensor to count currently open markets.
- Setting up an automation to notify you about markets open today.
- Triggering an automation when a specific market opens using its calendar entity.
Feedback & Contributions:
This is the initial release, and I’d love to hear your feedback! If you encounter any issues or have ideas for new features, please open an issue on the GitHub repository. Contributions are also welcome.
Just a heads-up, I’ve mainly focused on testing food markets with this integration. I hope this integration is useful for fellow Paris-based Home Assistant users or anyone planning a visit with a Raspberry Pi running Home Assistant in their luggage!
The development of unit tests was significantly aided by GitHub Copilot, so there’s some chance to find odd things there.
Cheers,
ork