Class: Graticule::Geocoder::GeocoderUs

Inherits:
Base
  • Object
show all
Defined in:
lib/graticule/geocoder/geocoder_us.rb

Overview

A library for lookup up coordinates with geocoder.us’ API.

geocoder.us/help/

Defined Under Namespace

Classes: Point

Constant Summary

Constants inherited from Base

Base::USER_AGENT

Instance Method Summary collapse

Constructor Details

#initialize(user = nil, password = nil) ⇒ GeocoderUs

Creates a new GeocoderUs object optionally using username and password.

You can sign up for a geocoder.us account here:

geocoder.us/user/signup



16
17
18
19
20
21
22
23
24
# File 'lib/graticule/geocoder/geocoder_us.rb', line 16

def initialize(user = nil, password = nil)
  if user && password
    @url = URI.parse 'http://geocoder.us/member/service/rest/geocode'
    @url.user = user
    @url.password = password
  else
    @url = URI.parse 'http://rpc.geocoder.us/service/rest/geocode'
  end
end

Instance Method Details

#locate(address) ⇒ Object

Locates address and returns the address’ latitude and longitude or raises an AddressError.



28
29
30
# File 'lib/graticule/geocoder/geocoder_us.rb', line 28

def locate(address)
  get :address => address.is_a?(String) ? address : location_from_params(address).to_s(:country => false)
end