Sha256: 2397fdf150506f8eb169eca5b147a694e02c2dfcc957e2ef3baf44cf7f875c95

Contents?: true

Size: 1.91 KB

Versions: 27

Compression:

Stored size: 1.91 KB

Contents

# Geocoding

## Configuring geocoding

Decidim has the ability to geocode proposals and meetings using Open Street Maps, for instance, you can use [Here](http://here.com) service. We can't use the OSM server by their [tile usage policy](https://operations.osmfoundation.org/policies/tiles/). As an alternative, you may also want to use your own [self-hosted tile server](https://opentileserver.org/).

After generating your app, you'll see that your `config/initializers/decidim.rb` file has come commented code about geocoding:

```ruby
# Geocoder configuration
# config.geocoder = {
#   static_map_url: "https://image.maps.cit.api.here.com/mia/1.6/mapview",
#   here_app_id: Rails.application.secrets.geocoder[:here_app_id],
#   here_app_code: Rails.application.secrets.geocoder[:here_app_code]
# }
```

If you want to enable geocoding in your app:

1. Uncomment or add the previous code in your `config/initializers/decidim.rb`.
1. Make sure your `config/secrets.yml` file has the needed section (it should be added by the generator automatically).
1. Get your app ID and code from Here.com and set them as environment variables, as required by your `config/secrets.yml` file.
1. If you had your Rails server running, restart it so the changes apply.

## Enabling geocoding

Once geocoding is configured, you'll need to activate it. As of April 2017, only proposals and meetings have geocoding.

### Proposals

In order to enable geocoding for proposals you'll need to edit the feature configuration and set the global flag to true. This works for that specific component, so you can have geocoding enabled for meetings in a participatory process, and disabled for another one.

### Meetings

Meetings do not have a configuration option for geocoding. Instead, if geocoding is configured it will try to geocode the address every time you create or update a meeting.. As of April 2017 there's no way to enable or disable geocoding per meetings component.

Version data entries

27 entries across 27 versions & 1 rubygems

Version Path
decidim-0.12.1 docs/services/geocoding.md
decidim-0.13.0.pre1 docs/services/geocoding.md
decidim-0.12.0 docs/services/geocoding.md
decidim-0.11.2 docs/services/geocoding.md
decidim-0.12.0.pre docs/services/geocoding.md
decidim-0.11.1 docs/services/geocoding.md
decidim-0.11.0.pre1 docs/services/geocoding.md