https://github.com/op/hyde-geotag

Geotag resources in hyde
https://github.com/op/hyde-geotag

Last synced: about 1 month ago
JSON representation

Geotag resources in hyde

• Host: GitHub
• URL: https://github.com/op/hyde-geotag
• Owner: op
• License: other
• Created: 2010-09-13T20:21:57.000Z (over 14 years ago)
• Default Branch: master
• Last Pushed: 2010-10-08T19:37:29.000Z (about 14 years ago)
• Last Synced: 2024-10-14T10:57:18.623Z (2 months ago)
• Language: Python
• Homepage:
• Size: 97.7 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE

Awesome Lists containing this project

README

        
geotagger for hyde

==================

Automatically retrieves geodata for photos with required geodata in the EXIF

metadata. It depends on geolocation_ and the hyde's pre-processor

ImageMetadata or ImageMetadataPyExiv2.

.. _geolocation: http://github.com/op/geolocation/

The geodata retrieved will be cached in a DBM. Positions can be set to be

rounded down to a precision to make fewer requests to the provider of geodata.

There's also a simple rate-limiter in place to make sure we don't flood the

provider with too many queries.

Installation

------------

First you will need to make sure that you either use `image-metadata` or

`image-metadata2` to parse EXIF tags. For similicity, I'll show two blocks

which maps both the PIL and the PyExiv2 processors to a common base::

  # Python image library

  'hydeengine.site_pre_processors.ImageMetadata': {

      'mapping': {

          'exif.GPSInfo.GPSLatitude': 'gps.lat.value',

          'exif.GPSInfo.GPSLatitudeRef': 'gps.lat.ref',

          'exif.GPSInfo.GPSLongitude': 'gps.long.value',

          'exif.GPSInfo.GPSLongitudeRef': 'gps.long.ref'

      }

  },

  # PyExiv2

  'hydeengine.site_pre_processors.ImageMetadataPyExiv2': {

      'mapping': {

          'Ipct.Application2.Caption': 'caption',

          'Exif.GPSInfo.GPSLatitude': 'gps.lat.value',

          'Exif.GPSInfo.GPSLatitudeRef': 'gps.lat.ref',

          'Exif.GPSInfo.GPSLongitude': 'gps.long.value',

          'Exif.GPSInfo.GPSLongitudeRef': 'gps.long.ref',

      }

  },

Next, add the `GeoTagger` to your hyde `settings.py`-file, something like this::

  SITE_PRE_PROCESSORS = {

      'media': {

          'hydeengine.site_pre_processors.ResourcePairer': {},

          'hydeengine.site_pre_processors.ImageMetadata': {},

          'hydeengine.site_pre_processors.ImageMetadataPyExiv2': {},

          'hyde_geotag.GeoTagger': {}

      }

  }

The GeoTagger can be customized to use different DBMs. By default, the default

Python dbm module will be used. Options to this include anydbm, dbhash.

By setting the `source` to `bsd`, BDB will be used. First bsddb3 will be tried

to be used, if that module is not available it will fallback to bsddb.

For more information on how to customize it, please see the source code.

Usage

-----

Once the photo has been processed, you can retrieve the value by using

`resource.geotag.city` or `resource.geotag.city`.

Here's a simple example::

  


  {% for resource in page.node.media %}

      {% ifequal resource.file.kind "jpg" %}

          
{{resource.url}} ({{resource.meta.gps.lat.value}},{{resource.meta.gps.long.value}})

          
{{resource.geotag.city}}, {{resource.geotag.country}}

     {% endifequal %}

  {% endfor %}