module Datarank
  class Client

    # Module containing methods for interacting with geocoded data
    module Locations
      
      # Fetch location pins for a topic
      #
      # @param slug [String] A topic's unique identifier slug
      def location_pins(slug, options={})
        get "/topics/#{slug}/location/pins", options
      end

      # Fetch location provinces data for a topic
      #
      # @param slug [String] A topic's unique identifier slug
      def location_provinces(slug, options={})
        get "/topics/#{slug}/location/provinces", options
      end

      # Fetch location heatmap data for a topic
      #
      # @param slug [String] A topic's unique identifier slug
      def location_heatmap(slug, options={})
        get "/topics/#{slug}/location/heatmap", options
      end

    end

  end
end