Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Readme #37

Merged
merged 2 commits into from
Aug 30, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
49 changes: 46 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,36 @@
# ipyopenlayers

[![Build Status](https://travis-ci.org/QuantStack/ipyopenlayers.svg?branch=master)](https://travis-ci.org/QuantStack/ipyopenlayers)
[![codecov](https://codecov.io/gh/QuantStack/ipyopenlayers/branch/master/graph/badge.svg)](https://codecov.io/gh/QuantStack/ipyopenlayers)
[![Documentation](http://readthedocs.org/projects/ipyopenlayers/badge/?version=latest)](https://ipyopenlayers.readthedocs.io/en/latest/?badge=latest)
[![JupyterLite Badge](https://jupyterlite.rtfd.io/en/latest/_static/badge.svg)](https://ipyopenlayers.readthedocs.io/en/latest/lite/lab/index.html)

OpenLayers Jupyter Widget
A Jupyter / Openlayers bridge enabling interactive maps in the Jupyter notebook.

## Usage

### Adding Raster Tile Layers and Controlling Zoom on the Map

![Zoom Raster](https://github.com/Nour-Cheour10/Ipy-openlayers/blob/Readme/media/RasterZoom.gif)

This GIF demonstrates how to add Raster Tile layers to the map and control the zoom functionality.

### Adding Vector Tile Layers and Changing Their Style

![Exemple de Vecteur](https://github.com/Nour-Cheour10/Ipy-openlayers/blob/Readme/media/Vector.gif)

This GIF shows how to add Vector Tile layers to the map and modify their style.

### GeoJSON Layer

![Exemple GeoJson](https://github.com/Nour-Cheour10/Ipy-openlayers/blob/Readme/media/GeoJson.png)

This image illustrates how to add a GeoJSON layer to the map.


## Example Repository

For a real-world example of how to use `ipyopenlayers`, check out this [electricity dashboard project](https://github.com/Nour-Cheour10/electricitymap_dashboard.git).

This project showcases the integration of `ipyopenlayers` in an electricity dashboard application, demonstrating a use case of the library.

## Installation

Expand Down Expand Up @@ -75,6 +102,22 @@ After a change wait for the build to finish and then refresh your browser and th

If you make a change to the python code then you will need to restart the notebook kernel to have it take effect.

## Documentation

To get started with using `ipyopenlayers`, check out the full documentation

https://ipyopenlayers.readthedocs.io/

## Try it Online

You can try ipyopenlayers below, or open many other live examples in a new browser tab with JupyterLite.

- [JupyterLite](https://ipyopenlayers.readthedocs.io/en/latest/lite/lab/index.html)

[![JupyterLite Badge](https://jupyterlite.rtfd.io/en/latest/_static/badge.svg)](https://ipyopenlayers.readthedocs.io/en/latest/lite/lab/index.html)



## Updating the version

To update the version, install tbump and use it to bump the version.
Expand Down
Binary file added media/GeoJson.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added media/RasterZoom.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added media/Vector.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading