camptocamp / ngeo Goto Github PK

View Code? Open in Web Editor NEW

134.0 27.0 88.0 428.25 MB

Library combining OpenLayers and AngularJS

Home Page: https://camptocamp.github.io/ngeo/master/examples

License: MIT License

JavaScript 79.25% Python 0.38% HTML 3.99% Makefile 0.45% CSS 1.20% Shell 0.13% SCSS 3.61% EJS 1.57% TypeScript 9.42%

javascript angularjs openlayers webgis-framework geomapfish gis ogc

ngeo's Introduction

ngeo

ngeo is a JS library that aims to ease the development of applications based on AngularJS and OpenLayers.

More specifically, ngeo is a collection of AngularJS Components and Services useful for developing applications combining AngularJS and OpenLayers.

ngeo uses webpack: webpack gives you the possibility to use easily only the specific part of JavaScript, css and html that you need for your application.

If you use ngeo we recommend that you also use webpack, because this is the way we design and use ngeo at Camptocamp. But using webpack is not strictly mandatory: standalone builds of ngeo can be created.

To know more about ngeo take a look at:

The examples
The Storybook
The documentation can be found in each file. There is currently no API web-documentation for this version (you may also use API documentation).

ngeo also includes a contribs directory where non-core contributions may be placed. ngeo currently includes one contrib: gmf. That contrib includes components specific to the GeoMapFish project, that is components that rely on GeoMapFish-specific web services. The gmf contrib examples are also available online.

Requirements

make – GNU Make.
node – nodejs JS runtime environment.
npm – npm package manager.

Go further

Developer guide – This guide is for ngeo developers.
Application development guidelines – This guide is for application developers using ngeo.

Other docs related to ngeo:

Transifex – Translation platform.

Contributing

Install the pre-commit hooks:

pip install pre-commit
pre-commit install --allow-missing-config

ngeo's People

Contributors

Stargazers

Watchers

Forkers

fgravin elemoine fredj pgiraud escribano tsauerwein psaile gberaudo chrmorais kailiii petzlux jhessu balpreetspankaj rbecheras mygu matjos kalbermattenm genievn fisyher ger-benjamin tymiles003 adube carsmie marionb tonio jdenisgiguere rmichaelis nubiofs glennvorhes oliviersemet mohamedhagag ezio47 gsollberger bdurand988 jlap ohvitorino xaadim mapgears bvpelt sakdahomhuan chillgis kentwalters danielquisbert oterral lopo977 sgavathe arnaud-morvan mxuninpho pfirpfel llienher alexbrault icezyburg vovoma lzuniujp08 julsbreakdown lewinmadrid josepfaneca geoatbspunktch henrynguyenithumg vvmruder zinnerrep loicgasser yodeski syldej machix haoyunzhou sm2x siszoey gavioto andyprasetya pepeysusmapas seusscz hauxon svaabs nstoykov rajkumar269 npi2loup saepul8 svareg renatamuellerc2c csipiemonte brunosr1985 wbboboan rbovard borisgautier isabella232 sbrunner vuilleumierc

ngeo's Issues

The sortable directive doesn't work on touch devices

Probably because the jQuery UI Sortable plugin does not support touch devices/events.

See http://camptocamp.github.io/ngeo/master/layerorder.html.

In my dragdrop branch the ngeoSortable directive uses goog.fx.DragListGroup instead of relying on the jQuery UI plugin. And goog.fx.DragListGroup does support touch devices, although I still have preventDefault-related issues. See http://erilem.net/ngeo/dragdrop/layerorder.html for a version of the layerorder example based on that branch.

Directives with templates

We will eventually add directives with templates/partials to ngeo. This issue discusses implications and the infrastructure work required for that.

We will want to use templateUrl and separate HTML template files. Writing HTML strings in the JS code is indeed too error-prone, inconvenient, hard to read, and ugly.

We need templateUrl to work for various cases:

Examples in development mode,
Examples with ngeo.js (a.k.a. "hosted examples"),
Non-compiled apps using ngeo.js (this case is more or less the same as the previous one),
Apps compiled together with ngeo,
Unit tests.

For the standalone build, ngeo.js, we'll need to have the HTML strings in the ngeo.js build file. This requires a build task that generates an Angular template cache pre-populated with HTML template strings.

Compilation fails

The compilation fails currently:

ERR! compile .build/examples/all.js:2419: ERROR - Bad type annotation. Unknown type olx.view.FitGeometryOptions
ERR! compile       /** @type {olx.view.FitGeometryOptions} */ ({maxZoom: 16}));
ERR! compile                  ^
ERR! compile 
ERR! compile 
ERR! compile 1 error(s), 0 warning(s)
ERR! compile 
ERR! Process exited with non-zero status, see log for more detail: 1

This related to change in ol3, where the fitExtent and fitGeometry functions were replaced by a fit function.

PR to come.

Add typeahead externs

I need to have typeahead externs in my project; should it be added there or in ngeo ?

Build is broken

The build is broken on Travis: https://travis-ci.org/camptocamp/ngeo/builds/65867203.

node buildtools/build.js buildtools/ngeo.json dist/ngeo.js

info ol Parsing dependencies

info ol Compiling 391 sources

ERR! compile /home/travis/build/camptocamp/ngeo/src/directives/search.js:71: ERROR - Bad type annotation. Unknown type jQuery.event

ERR! compile                * @param {jQuery.event} event Event.

ERR! compile                          ^

ERR! compile 

ERR! compile 

ERR! compile /home/travis/build/camptocamp/ngeo/src/directives/search.js:83: ERROR - Bad type annotation. Unknown type jQuery.event

ERR! compile                * @param {jQuery.event} event Event.

ERR! compile                          ^

ERR! compile 

ERR! compile /home/travis/build/camptocamp/ngeo/src/directives/search.js:95: ERROR - Bad type annotation. Unknown type jQuery.event

ERR! compile                * @param {jQuery.event} event Event.

ERR! compile                          ^

ERR! compile 

ERR! compile externs/ngeox.js:290: ERROR - Bad type annotation. Unknown type jQuery.event

ERR! compile  *   cursorchanged: (function(jQuery.event, Object,

ERR! compile                               ^

ERR! compile 

ERR! compile externs/ngeox.js:292: ERROR - Bad type annotation. Unknown type jQuery.event

ERR! compile  *   selected: (function(jQuery.event, Object,

ERR! compile                          ^

ERR! compile 

ERR! compile externs/ngeox.js:294: ERROR - Bad type annotation. Unknown type jQuery.event

ERR! compile  *   autocompleted: (function(jQuery.event, Object,

ERR! compile                               ^

ERR! compile 

ERR! compile externs/ngeox.js:314: ERROR - Bad type annotation. Unknown type jQuery.event

ERR! compile  * @type {function(jQuery.event, Object, TypeaheadDataset)|undefined}

ERR! compile                    ^

ERR! compile 

ERR! compile externs/ngeox.js:320: ERROR - Bad type annotation. Unknown type jQuery.event

ERR! compile  * @type {function(jQuery.event, Object, TypeaheadDataset)|undefined}

ERR! compile                    ^

ERR! compile 

ERR! compile externs/ngeox.js:326: ERROR - Bad type annotation. Unknown type jQuery.event

ERR! compile  * @type {function(jQuery.event, Object, TypeaheadDataset)|undefined}

ERR! compile                    ^

ERR! compile 

ERR! compile 9 error(s), 0 warning(s)

ERR! compile 

ERR! Process exited with non-zero status, see log for more detail: 9 

make: *** [dist/ngeo.js] Error 1

remove externs/angular-local-storage.js ?

We're not using this library anymore (in schweizmobil_re3) . Do we want to keep the extern?

Use closure-util version 1.0.0

See openlayers/openlayers@04e7a81.

I'm on it.

ngeoLayertreenode creates layer eagerly

Currently the ngeoLayertreenode eagerly creates the layer for the node. Instead, the layer could be created lazily, i.e. the first it is actually needed.

Add translation support

https://angular-gettext.rocketeer.be/ ?

Use Closure and Angular together

There's interesting information and style/guide lines in http://google-styleguide.googlecode.com/svn/trunk/angularjs-google-style.html. We need to consider it.

measure azimut interaction doesn't allow panning or zooming

Adding service providers (with module.provider)

We do not declare service providers currently in ngeo. And there is nothing in the Google Angular Style Guide for that. There's a discussion about that on the Closure mailing list.

Use oli.js as an input file

oli.js should be used as an input file in example.json and examples-all.json.

Add new gmf.source.Swisstopo

To access tiles from swisstopo, see https://api3.geo.admin.ch/services/sdiservices.html#wmts

Add the link to the GMF examples somewhere in README

It would be cool to have a direct link in the README file to the GMF example page:

https://github.com/camptocamp/ngeo/tree/master/contribs/gmf

(Like the link to the NGEO main example...)

Compilation of ngeo examples fails with new CC version

@fredj merged an OpenLayers PR to use the newest versions of Closure Compiler and Closure Library. I just run rm -rf node_modules/openlayers && npm install && make check in ngeo and I get errors when compiling the examples code:

node buildtools/build.js buildtools/examples-all.json .build/examples/all.min.js
info ol Parsing dependencies
info ol Compiling 371 sources
ERR! compile .build/examples/all.js:27: ERROR - Closure dependency methods(goog.provide, goog.require, etc) must be called at file scope.
ERR! compile goog.provide('animation');
ERR! compile ^
ERR! compile 
ERR! compile .build/examples/all.js:92: ERROR - Closure dependency methods(goog.provide, goog.require, etc) must be called at file scope.
ERR! compile goog.provide('control');
ERR! compile ^
ERR! compile 
ERR! compile 
ERR! compile .build/examples/all.js:142: ERROR - Closure dependency methods(goog.provide, goog.require, etc) must be called at file scope.
ERR! compile goog.provide('geolocation');
ERR! compile ^
ERR! compile 
ERR! compile .build/examples/all.js:209: ERROR - Closure dependency methods(goog.provide, goog.require, etc) must be called at file scope.
ERR! compile goog.provide('interactionbtngroup');
ERR! compile ^
ERR! compile 
ERR! compile .build/examples/all.js:305: ERROR - Closure dependency methods(goog.provide, goog.require, etc) must be called at file scope.
ERR! compile goog.provide('interactiontoggle');
ERR! compile ^
ERR! compile 
ERR! compile .build/examples/all.js:366: ERROR - Closure dependency methods(goog.provide, goog.require, etc) must be called at file scope.
ERR! compile goog.provide('layercatalog');
ERR! compile ^
ERR! compile 
ERR! compile .build/examples/all.js:524: ERROR - Closure dependency methods(goog.provide, goog.require, etc) must be called at file scope.
ERR! compile goog.provide('layermanager');
ERR! compile ^
ERR! compile 
ERR! compile .build/examples/all.js:662: ERROR - Closure dependency methods(goog.provide, goog.require, etc) must be called at file scope.
ERR! compile goog.provide('layeropacity');
ERR! compile ^
ERR! compile 
ERR! compile .build/examples/all.js:703: ERROR - Closure dependency methods(goog.provide, goog.require, etc) must be called at file scope.
ERR! compile goog.provide('layervisibility');
ERR! compile ^
ERR! compile 
ERR! compile .build/examples/all.js:755: ERROR - Closure dependency methods(goog.provide, goog.require, etc) must be called at file scope.
ERR! compile goog.provide('permalink');
ERR! compile ^
ERR! compile 
ERR! compile .build/examples/all.js:862: ERROR - Closure dependency methods(goog.provide, goog.require, etc) must be called at file scope.
ERR! compile goog.provide('simple');
ERR! compile ^
ERR! compile 
ERR! compile 11 error(s), 0 warning(s)
ERR! compile 
ERR! Process exited with non-zero status, see log for more detail: 11 
make: *** [.build/examples/all.min.js] Error 1

ngeoDecorate*: two way binding ?

For now, the ngeoDecorate* services offer a one way binding (angular to ol3).
Is it planned to have a two way binding (ol3 to angular) ?

dependencies versus devDependencies

In package.json we define dependencies and devDependencies. I think we need to be clearer on what needs to be a dependency and what needs to be a dev dependency.

For example, d3.js and typeahead.js are currently devDependencies while ngeo includes directives that depend on these librairies. So we may want to change them to regular dependencies.

Compile the examples all at once

Currently we compile each example individually. Although this sort of works for now this will quickly get very painful because of the compilation time. Instead we should combine the examples into a single file and compile that combined file.

Remove ngeo-simple.js and ngeo-whitespace.js

This issue suggests to remove the ngeo-simple.js and ngeo-whitespace.js builds and replace them by ngeo-debug.js, which is just a concatenation of the ngeo scripts.

Run closure-util/install.js at postinstall time

This is to avoid errors when we update closure-util.json.

gmf.searchDirective: can't set listeners

The directive should be able to handle custom listeners, just like ngeo.searchDirective:
https://github.com/camptocamp/ngeo/blob/master/src/directives/search.js#L10

Compilation issue related to angular-1.4.js externs file

The compilation currently fails with this error:

ode buildtools/build.js buildtools/ngeo.json dist/ngeo.js
info ol Parsing dependencies
info ol Compiling 395 sources
ERR! compile .build/externs/angular-1.4.js:2234: ERROR - Bad type annotation. missing closing )
ERR! compile  * @typedef {function(Function, number=, boolean=, ...*=):!angular.$q.Promise}
ERR! compile                                                        ^
ERR! compile 
ERR! compile 
ERR! compile 1 error(s), 0 warning(s)
ERR! compile 
ERR! Process exited with non-zero status, see log for more detail: 1 
make: *** [dist/ngeo.js] Error 1

The "ol" node package changed name again

See openlayers/openlayers#2839.

The gmf examples are not on github.io

It is expected that the gmf examples are published on github.io at http://camptocamp.github.io/ngeo/master/contribs/gmf. But this URL gives a 404.

Measure tooltips not displayed on touch devices

The measure tooltips are displayed on pointermove (when dragging is false really), so they're not displayed at all on touch devices.

backgroundlayer example not working

http://camptocamp.github.io/ngeo/master/backgroundlayer.html

The select element is empty

Double modules in ngeo

I saw that we have "two modules per module" in the object "ngeo" Once (empty object) with a capitalize first letter. Once without it. Was that intentional ?

Layer tree example is broken

It seems to me.
I don't see any tree in the page :http://camptocamp.github.io/ngeo/master/layertree.html

Examples don't reload automatically

Socket warnings in javascript console.

Uncaught TypeError: Cannot set property 'version' of undefined socket.io.js:28object.module.io socket.io.js:28(anonymous function) socket.io.js:107(anonymous function)

Update angular js version

Change goDecorateInteraction to use setActive/getActive

We may want to change goDecorateInteraction to use ol.interaction.Interaction#setActive instead of adding/removing the interaction to/from the map. See openlayers/openlayers#2740.

I've started to work on a branch for this https://github.com/elemoine/ngeo/compare/interaction. This is WIP, I've found issues in ol3 while working on this.

goBtnGroup directive - write tests

Write test for goBtnGroup and goBtn directives

asitvd example broken

The example dose not work on github.io: http://camptocamp.github.io/ngeo/master/contribs/gmf/asitvd.html.

The "go" prefix is confusing, use "ngeo"

During the "ngeo" workshop people expressed that the "go" namespace was confusing. And it was suggested to be explicit and use "ngeo" instead.

Use jQuery 2 in the examples

This issue suggests to use jQuery 2 in the ngeo examples. See camptocamp/c2cgeoportal#1687 for a similar change in c2cgeoportal.

mapfishprint example is broken

Printing does not work, because of a CORS-related issue. See http://camptocamp.github.io/ngeo/master/mapfishprint.html.

Update typeahead to the latest version

Travis build is broken

The Travis build is broken because of changes to ol3.

The error is:

node buildtools/build.js buildtools/ngeo.json dist/ngeo.js
info ol Parsing dependencies
ERR! Unsatisfied dependency "ol.ext.rbush" in script: /home/travis/build/elemoine/ngeo/node_modules/openlayers/src/ol/structs/rbush.js
make: *** [dist/ngeo.js] Error 1

Add permalink support

Create ol.control.ScaleLine directive

ol.FeatureOverlay removal

ol.FeatureOverlay has been removed. ngeo uses ol.FeatureOverlay in examples and in the ol-ext measure interactions. Examples are not a problem, as we can just replace the feature overlay by a vector layer in each example. For the ol-ext measure interactions we may want to use the immeditate API instead of using an "unmanaged" vector layer.

Missing requires

https://github.com/camptocamp/ngeo/blob/master/src/directives/map.js#L12
goog.require('ol.Map');

Remove ngeoResizemap

This issue suggests removing the ngeoResizemap directive. Because of bugs in Angular animate the directive won't work in some cases. See Geoportail-Luxembourg/geoportailv3#664 for more details.

Change ngeoLayercatalog to ngeoLayertree

I wonder whether the "ngeoLayercatalog" directive should be renamed "ngeoLayertree". What the directive creates is a tree. "catalog" is an application-specific term describing how the tree is used in the application.

Add angular-1.3-http-promise.js externs

This externs is now needed to build the library

[apidoc] Use tag to split or mark the angular components types?

Use the tag @ngdoc defied by angular-jsdoc https://github.com/allenhwkim/angular-jsdoc#tags-available
Takes car about it in buildNav: https://github.com/camptocamp/ngeo/blob/master/jsdoc-template/publish.js#L341
To group by angular types or add a mark.

This error message comes from closure-util.