ymaps 0.0.1

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,23 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+doc
+pkg
+.yardoc
+
+## PROJECT::SPECIFIC

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Alexander Semyonov
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,17 @@
+= ymaps
+
+Description goes here.
+
+== Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+== Copyright
+
+Copyright (c) 2010 Alexander Semyonov. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,53 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "ymaps"
+    gem.summary = %Q{Helpers for using YMaps}
+    gem.description = %Q{Different helpers for generating YMapsML, using YMaps widgets and geocoding via Yandex.Maps}
+    gem.email = "rotuka@rotuka.com"
+    gem.homepage = "http://github.com/rotuka/ymaps"
+    gem.authors = ["Alexander Semyonov"]
+    gem.add_development_dependency "thoughtbot-shoulda", ">= 0"
+    gem.add_development_dependency "yard", ">= 0"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/test_*.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+task :test => :check_dependencies
+
+task :default => :test
+
+begin
+  require 'yard'
+  YARD::Rake::YardocTask.new
+rescue LoadError
+  task :yardoc do
+    abort "YARD is not available. In order to run yardoc, you must: sudo gem install yard"
+  end
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/init.rb

@@ -0,0 +1 @@
+require 'ymaps'

data/lib/geokit/geocoders/yandex_geocoder.rb

@@ -0,0 +1,105 @@
+require 'geokit'
+require 'geokit/geocoders'
+
+module Geokit
+  self.default_units = :kms
+
+  class LatLng
+    def pos
+      "#{lat} #{lng}"
+    end
+  end
+
+  module Geocoders
+    def self.yandex
+      YMaps.key
+    end
+
+    def self.yandex=(key)
+      YMaps.key = key
+    end
+
+    class YandexGeocoder < Geocoder
+
+    private
+      def self.call_geocoder_service(geocode)
+        res = super("http://geocode-maps.yandex.ru/1.x/?geocode=#{Geokit::Inflector::url_escape(geocode)}&key=#{Geocoders::yandex}")
+
+        unless res.is_a?(Net::HTTPSuccess) || res.is_a?(Net::HTTPOK)
+          return GeoLoc.new
+        end
+
+        xml = res.body
+        logger.debug "Yandex geocoding: '#{geocode}'. Result: #{xml}"
+        return xml2GeoLoc(xml)
+      end
+
+      def self.do_reverse_geocode(latlng)
+        latlng = LatLng.normalize(latlng)
+        call_geocoder_service(latlng.ll)
+      end
+
+      def self.do_geocode(address, options = {})
+        address_str = address.is_a?(GeoLoc) ? address.to_geocodable_s : address
+        call_geocoder_service(address_str)
+      end
+
+      def self.xml2GeoLoc(xml, address="")
+        doc = REXML::Document.new(xml)
+
+        if doc.elements['//GeocoderResponseMetaData/found'] != '0'
+          geoloc = nil
+          # Yandex can return multiple results as //featureMember elements.
+          # iterate through each and extract each placemark as geoloc
+          doc.each_element('//featureMember') do |e|
+            extracted_geoloc = extract_placemark(e)
+
+            if geoloc.nil?
+              geoloc = extracted_geoloc
+            else
+              geoloc.all.push(extracted_geoloc)
+            end
+          end
+
+          return geoloc
+        else
+          logger.ingo "Yandex was unable to geocode address: #{address}"
+          return GeoLoc.new
+        end
+      end
+
+      def self.extract_placemark(doc)
+        res = GeoLoc.new
+        res.provider = 'yandex'
+
+        # basics
+        coordinates = doc.elements['.//Point/pos'].text.to_s.split(' ')
+        res.lat = coordinates[0]
+        res.lng = coordinates[1]
+
+        # extended -- false if not available
+        res.city = doc.elements['.//LocalityName'].try(:text)
+        res.state = doc.elements['.//AdministrativeAreaName'].try(:text)
+        res.province = doc.elements['.//SubAdministrativeAreaName'].try(:text)
+        res.full_address = doc.elements['.//GeocoderMetaData/text'].try(:text)
+        res.zip = doc.elements['.//PostalCodeNumber'].try(:text)
+        res.street_address = doc.elements['.//ThoroughfareName'].try(:text)
+        res.country = doc.elements['.//CountryName'].try(:text)
+        res.district = doc.elements['.//DependentLocalityName'].try(:text)
+
+        # TODO: translate accuracy into Yahoo-style token address, street, zip, zip+4, city, state, country
+
+        if suggested_bounds = doc.elements['.//boundedBy']
+          res.suggested_bounds = Bounds.normalize(
+            suggested_bounds.elements['.//lowerCorner'].text.to_s.split(' '),
+            suggested_bounds.elements['.//upperCorner'].text.to_s.split(' ')
+          )
+        end
+
+        res.success = true
+
+        res
+      end
+    end
+  end
+end

data/lib/ymaps.rb

@@ -0,0 +1,19 @@
+module YMaps
+  mattr_accessor :key
+  self.key = 'REPLACE_WITH_YOUR_YANDEX_KEY'
+
+  autoload :ActionView, 'ymaps/action_view'
+
+  def self.geocode(query)
+    require 'geokit/geocoders/yandex_geocoder'
+    Geokit::Geocoders::Yandex.geocode(query)
+  end
+end
+
+if defined? Mime
+  Mime::Type.register 'application/xml', :ymapsml
+end
+
+if defined? ActionView
+  ActionView::Base.send(:include, YMaps::ActionView::Helpers)
+end

data/lib/ymaps/action_view.rb

@@ -0,0 +1,11 @@
+module YMaps
+  module ActionView
+    autoload :YMapsMLHelper, 'ymaps/action_view/ymapsml_helper'
+    autoload :HtmlHelper, 'ymaps/action_view/html_helper'
+
+    module Helpers
+      include YMapsMLHelper
+      include HtmlHelper
+    end
+  end
+end

data/lib/ymaps/action_view/html_helper.rb

@@ -0,0 +1,102 @@
+module YMaps
+  module ActionView
+    module HtmlHelper
+      class StaticMapPoint < Struct.new('MapPoint', :style, :color, :size, :number, :lat, :lng)
+        def to_s
+          "#{ll},#{style}#{color}#{size}#{number}"
+        end
+
+        def ll
+          @ll ||= "#{lat},#{lng}"
+        end
+
+        def ll=(latlng)
+          @ll = latlng
+        end
+
+        def attributes=(attrs)
+          attrs.each do |key, value|
+            self[key] = value
+          end
+        end
+      end
+
+      def map_link(resource = nil, options = {})
+        resource, options = nil, resource if resource.is_a?(Hash)
+
+        href = if resource
+                 polymorphic_url(resource, :format => :ymapsml)
+               else
+                 url_for(:format => :ymapsml, :only_path => false, :time => Time.now)
+               end
+
+        tag(:link,
+            options.merge!(:id => 'alternate_ymapsml',
+                           :href => href,
+                           :rel => 'alternate',
+                           :type => 'application/ymapsml+xml'))
+      end
+
+      def ymaps_include_tag(key = nil)
+        key ||= YMaps.key
+        javascript_include_tag("http://api-maps.yandex.ru/1.1/index.xml?key=#{key}")
+      end
+
+      def static_map(resources, options = {})
+        title = options.delete(:title) { resources.to_s }
+        map_type = options.delete(:map) { 'map' }
+
+        common_point = StaticMapPoint.new(
+          options.delete(:style) { 'pm' },
+          options.delete(:color) { 'wt' },
+          options.delete(:size)  { 'm' },
+          options.delete(:number) { 0 }
+        )
+
+        collection = Array(resources).inject([]) do |result, resource|
+          common_point.ll = resource.latlng.ll
+          common_point.number += 1
+          result << common_point.to_s
+          result
+        end.join('~')
+
+        content_tag(:div, :class => 'b-map') do
+          image_tag("http://static-maps.yandex.ru/1.x/?key=#{YMaps.key}&l=#{map_type}&pt=#{collection}",
+                    :title => title,
+                    :alt => title,
+                    :class => 'static'
+                   )
+        end
+      end
+
+      def geo_microformat(resource)
+        latlng = resource.to_latlng
+        resource_class ||= resource.class
+
+        content_tag(:dl, :class => 'geo') do
+          content_tag(:dt, resource_class.human_attribute_name(:lat)) +
+            content_tag(:dd, latlng.lat, :class => 'latitude') +
+            content_tag(:dt, resource_class.human_attribute_name(:lng)) +
+            content_tag(:dd, latlng.lng, :class => 'longitude')
+        end
+      end
+
+      def adr_microformat(resource)
+        result = []
+        if resource.respond_to?(:country) && resource.country.present?
+          result << content_tag(:span, resource.country, :class => 'country-name')
+        end
+        if resource.respond_to?(:postal_code) && resource.postal_code.present?
+          result << content_tag(:span, resource.postal_code, :class => 'postal-code')
+        end
+        if resource.respond_to?(:city) && resource.city.present?
+          result << content_tag(:span, resource.city, :class => 'locality')
+        end
+        if resource.respond_to?(:street_address) && resource.street_address.present?
+          result << content_tag(:span, resource.street_address, :class => 'street-address')
+        end
+        content_tag(:div, result.join(', '), :class => 'adr')
+      end
+    end
+  end
+end

data/lib/ymaps/action_view/ymapsml_helper.rb

@@ -0,0 +1,135 @@
+require 'geokit/geocoders/yandex_geocoder'
+
+module YMaps
+  module ActionView
+    YMAPS_XMLNS = 'http://maps.yandex.ru/ymaps/1.x'
+    GML_XMLNS = 'http://www.opengis.net/gml'
+    REPR_XMLNS = 'http://maps.yandex.ru/representation/1.x'
+
+    module YMapsMLHelper
+      def ymapsml(options = {}, &block)
+        xml = options.delete(:xml) { eval('xml', block.binding)  }
+        xml.instruct!
+
+        ymapsml_opts = {
+          'xml:lang' => options.fetch(:language) { 'en-US' },
+          'xmlns' => YMAPS_XMLNS,
+          'xmlns:gml' => GML_XMLNS,
+          'xmlns:repr' => REPR_XMLNS
+        }
+        ymapsml_opts.merge!(options).reject! { |key, value| !key.match(/^xml/) }
+
+        xml.ymaps(ymapsml_opts) do
+          yield YMapsBuilder.new(xml, self, options)
+        end
+      end
+    end
+
+    class Builder
+      YMAPS_TAG_NAMES = %w(GeoObject GeoObjectCollection style ymaps AnyMetaData).map(&:to_sym)
+      GML_TAG_NAMES = %w(boundedBy description Envelope exterior featureMember
+        featureMembers interior LineString LinearString lowerCorner
+        metaDataProperty name Point Polygon pos posList upperCorner).map(&:to_sym)
+      REPR_TAG_NAMES = %w(balloonContentStyle fill fillColor hintContentStyle iconContentStyle
+        lineStyle href iconStyle mapType offset outline parentStyle polygonStyle
+        Representation shadow size strokeColor strokeWidth Style Template
+        template text View).map(&:to_sym)
+
+      def initialize(xml)
+        @xml = xml
+      end
+
+    private
+      def method_missing(method, *arguments, &block)
+        @xml.__send__(*xmlns_prefix!(method, arguments), &block)
+      end
+
+      def xmlns_prefix!(method, arguments)
+        if GML_TAG_NAMES.include?(method)
+          [:gml, method, *arguments]
+        elsif REPR_TAG_NAMES.include?(method)
+          [:repr, method, *arguments]
+        else
+          [method, *arguments]
+        end
+      end
+    end
+
+    class YMapsReprBuilder < Builder
+      def view(options = {})
+        View {
+          if options[:type]
+            mapType(options[:type].to_s.upcase)
+          end
+          yield if block_given?
+        }
+      end
+
+      def style(id, options = {})
+        Style(options.merge('gml:id' => id.to_s)) {
+          yield
+        }
+      end
+
+      def template(id, template_text = nil)
+        Template('gml:id' => id.to_s) do
+          text do
+            cdata!(template_text || yield)
+          end
+        end
+      end
+
+      def balloon_content(template)
+        balloonContentStyle {
+          @xml.repr(:template, "\##{template}")
+        }
+      end
+    end
+
+    class YMapsBuilder < Builder
+      def initialize(xml, view, ymaps_options = {})
+        @xml, @view, @ymaps_options = xml, view, ymaps_options
+      end
+
+      def collection(options = {})
+        GeoObjectCollection do
+          if options.key?(:style)
+            @xml.style("\##{options.delete(:style)}")
+          end
+          featureMembers { yield }
+        end
+      end
+
+      def object(object, options = {})
+        GeoObject do
+          if options.key?(:style)
+            @xml.style("\##{options.delete(:style)}")
+          end
+          point(object.latlng)
+          name(options.delete(:name) { object.to_s })
+          yield self
+        end
+      end
+
+      def point(latlng)
+        Point {
+          pos(latlng.pos)
+        }
+      end
+
+      def meta_data
+        metaDataProperty {
+          AnyMetaData {
+            yield(@xml)
+          }
+        }
+      end
+
+      def representation
+        Representation {
+          yield(YMapsReprBuilder.new(@xml))
+        }
+      end
+    end
+  end
+end

data/test/helper.rb

@@ -0,0 +1,10 @@
+require 'rubygems'
+require 'test/unit'
+require 'shoulda'
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'ymaps'
+
+class Test::Unit::TestCase
+end

data/test/test_ymaps.rb

@@ -0,0 +1,7 @@
+require 'helper'
+
+class TestYmaps < Test::Unit::TestCase
+  should "probably rename this file and start testing for real" do
+    flunk "hey buddy, you should probably rename this file and start testing for real"
+  end
+end

data/ymaps.gemspec

@@ -0,0 +1,62 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{ymaps}
+  s.version = "0.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Alexander Semyonov"]
+  s.date = %q{2010-03-12}
+  s.description = %q{Different helpers for generating YMapsML, using YMaps widgets and geocoding via Yandex.Maps}
+  s.email = %q{rotuka@rotuka.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "init.rb",
+     "lib/geokit/geocoders/yandex_geocoder.rb",
+     "lib/ymaps.rb",
+     "lib/ymaps/action_view.rb",
+     "lib/ymaps/action_view/html_helper.rb",
+     "lib/ymaps/action_view/ymapsml_helper.rb",
+     "test/helper.rb",
+     "test/test_ymaps.rb",
+     "ymaps.gemspec"
+  ]
+  s.homepage = %q{http://github.com/rotuka/ymaps}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.6}
+  s.summary = %q{Helpers for using YMaps}
+  s.test_files = [
+    "test/helper.rb",
+     "test/test_ymaps.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<thoughtbot-shoulda>, [">= 0"])
+      s.add_development_dependency(%q<yard>, [">= 0"])
+    else
+      s.add_dependency(%q<thoughtbot-shoulda>, [">= 0"])
+      s.add_dependency(%q<yard>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<thoughtbot-shoulda>, [">= 0"])
+    s.add_dependency(%q<yard>, [">= 0"])
+  end
+end
+

metadata

@@ -0,0 +1,101 @@
+--- !ruby/object:Gem::Specification 
+name: ymaps
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Alexander Semyonov
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-03-12 00:00:00 +03:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: thoughtbot-shoulda
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: yard
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id002
+description: Different helpers for generating YMapsML, using YMaps widgets and geocoding via Yandex.Maps
+email: rotuka@rotuka.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- .document
+- .gitignore
+- LICENSE
+- README.rdoc
+- Rakefile
+- VERSION
+- init.rb
+- lib/geokit/geocoders/yandex_geocoder.rb
+- lib/ymaps.rb
+- lib/ymaps/action_view.rb
+- lib/ymaps/action_view/html_helper.rb
+- lib/ymaps/action_view/ymapsml_helper.rb
+- test/helper.rb
+- test/test_ymaps.rb
+- ymaps.gemspec
+has_rdoc: true
+homepage: http://github.com/rotuka/ymaps
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: Helpers for using YMaps
+test_files: 
+- test/helper.rb
+- test/test_ymaps.rb