<commit_before>===============
Mozilla Ichnaea
===============

**Mozilla Ichnaea** is a service to provide geo location coordinates in
response to user requests.

We currently provide two API:

- one for searching for your current location, given what you
  see around you.

- one for sending back information about what you see around you,
  given a location


API
===

.. services::
   :modules: ichnaea.views
   :service: location_search


.. services::
   :modules: ichnaea.views
   :service: location_measurement


Table of contents
=================

.. toctree::
   :maxdepth: 2

   changelog


Development
===========

All source code is available on `github under ichnaea
<https://github.com/mozilla/ichnaea>`_.

Bugs and support issues should be reported on the `ichnaea github issue tracker
<https://github.com/mozilla/ichnaea/issues>`_.

The developers of ``ichnaea`` can frequently be found on the Mozilla IRC
network in the #geo channel.


How to run your own server
==========================

Run the following commands to download the database and the server:

.. code-block:: bash

   git clone https://github.com/mozilla/ichnaea
   cd ichnaea
   make
   curl http://dump.opencellid.org/cells.txt.gz | gunzip > data/cells.txt
   bin/ichnaea_import ichnaea.ini data/cells.txt


Then run the server:

.. code-block:: bash

   bin/pserve ichnaea.ini


From there you can access the service on port 7001.<commit_msg>add some license text / attribution to opencellid.org<commit_after>===============
Mozilla Ichnaea
===============

**Mozilla Ichnaea** is a service to provide geo location coordinates in
response to user requests.

We currently provide two API:

- one for searching for your current location, given what you
  see around you.

- one for sending back information about what you see around you,
  given a location


API
===

.. services::
   :modules: ichnaea.views
   :service: location_search


.. services::
   :modules: ichnaea.views
   :service: location_measurement


Table of contents
=================

.. toctree::
   :maxdepth: 2

   changelog


Development
===========

All source code is available on `github under ichnaea
<https://github.com/mozilla/ichnaea>`_.

Bugs and support issues should be reported on the `ichnaea github issue tracker
<https://github.com/mozilla/ichnaea/issues>`_.

The developers of ``ichnaea`` can frequently be found on the Mozilla IRC
network in the #geo channel.


How to run your own server
==========================

Run the following commands to download the database and the server:

.. code-block:: bash

   git clone https://github.com/mozilla/ichnaea
   cd ichnaea
   make
   curl http://dump.opencellid.org/cells.txt.gz | gunzip > data/cells.txt
   bin/ichnaea_import ichnaea.ini data/cells.txt


Then run the server:

.. code-block:: bash

   bin/pserve ichnaea.ini


From there you can access the service on port 7001.


License
=======

The ``mozilla-ichnaea`` source code is offered under the Apache License 2.0.

The initial data is taken from `opencellid.org <http://opencellid.org/>`_
kindly offered under the `Creative Common Attribution-Share Alike 3.0 Unported
<http://creativecommons.org/licenses/by-sa/3.0/>`_ license.
{'fraction_non_alphanumeric': 0.13231631382316314, 'fraction_numerical': 0.0049813200498132005, 'mean_word_length': 3.8904109589041096, 'pattern_counts': {'":': 0, '<': 9, '<?xml version=': 0, '>': 11, 'https://': 6, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 4, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '4461176', 'n_tokens_mistral': 1011, 'n_tokens_neox': 926, 'n_words': 357}