semvec/pypi-packages huggingface dataset:
yandex-hotspots 0.1
Generator of tiles and js for Yandex Maps Hotspots v2
License: MIT

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