Metadata-Version: 1.1
Name: yandex-hotspots
Version: 0.1
Summary: Generator of tiles and js for Yandex Maps Hotspots v2
Home-page: https://github.com/coagulant/yandex-hotspots
Author: coagulant
Author-email: baryshev@gmail.com
License: MIT
Description: Yandex Hotsposts
        ================
        
        Python library to generate tiles and js for `Yandex Maps Hotspots`_ version 2.
        Beware, hotspots js api is not documented well. Use at your own risk.
        Works on python 2.6-2.7.
        
        It's a fork of an app by Paul Koltyshev, called django-hotspots_.
        `yandex-hotspots` is written to support new version of hotspots API and
        *primarily* to be django-free package.
        
        This lib supports only simplest of hotspots: points.
        
        Usage
        =====
        
        Subclass ``HotspotsManager`` and define at least these methods::
        
            from PIL import Image
            from hotspots import HotspotsManager
        
        
            class MyHotspotsManager(HotspotsManager):
                img_big = Image.open('static/images/big_marker.png')
                img_small = Image.open('static/images/small_marker.png')
        
                def get_base_path(self):
                    """ Where to save tiles"""
                    return 'static/hotspots'
        
                def get_img(self, obj, scale):
                    """ Hotspot image object"""
                    return self.img_big if scale > 12 else self.img_small
        
                def get_lng(self, obj):
                    """ Latitude of your object"""
                    return obj.coordinates[0]
        
                def get_lat(self, obj):
                    """ Longitude """
                    return obj.coordinates[1]
        
        Run hotspot generator::
        
            # Obtain data for hotspots (some locations with data)
            data_iterable = [{'coordinates': (37.925288, 55.720903), 'title': 'My House'}, <...>]
        
            # Generate hotspots for zoom levels raging form 10 to 17
            MyHotspotsManager().generate_tiles(data_iterable, scale=(10, 17))
        
        
        And finally put together created hotspots and `some clientside`_.
        
        Ballon content and hint
        =======================
        
        Use `gett_descr(self, obj)` and `get_name(self, obj)` respectively.
        
        
        .. _django-hotspots: https://github.com/pkolt/django-hotspots
        .. _Yandex Maps Hotspots: http://api.yandex.ru/maps/features/?p=hotspot
        .. _some clientside: https://github.com/coagulant/yandex-hotspots/blob/master/example/hotspots.html
Platform: UNKNOWN
Requires: Pillow (== 1.7.7)
