audumbla 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 85d96776f960b63fce1a6e0533f8e53d9afe9ae8
-  data.tar.gz: c9fa438ae3c3ff6e6ae06395f188b18872b44a6b
+  metadata.gz: 100602e369b80c14118de38514d6273bad179cde
+  data.tar.gz: 4e2e0efbf018f7d632d460b9727f691578016a90
 SHA512:
-  metadata.gz: f409960eca0091c5405aecbdafb6dab5d1eaf1e3383ac23c3ac32a40a38b24210ec57f8456be9d4f949498537d4e2bc4b678551c836f121f8c255ddc9b627571
-  data.tar.gz: d0d5b93cad7e668c0faae99ad5dca370baa9d3e15d7d22becb917aa62acfb438428bd66b9f9ab29c79aececd376950b52b244ce26c0b5c623a6f018685626d66
+  metadata.gz: 2ad72a4e8bb400e99d79e74c2fff277ec80d55cbed4ffb3771641e8f0bba56a2c20e8483201cdda17a16738fb389e04299ce925e40dcc384db73183c05b6632f
+  data.tar.gz: 34352f392ae17552d14511d630df1d50cdccec42d98a6193da0f5267a4e047855c033a9592ad181d1105d5008877449d1c521c306995736d93b24d7df3fc3aa6

data/lib/audumbla.rb

@@ -1,4 +1,8 @@
 module Audumbla
   autoload :Enrichment, 'audumbla/enrichment'
   autoload :FieldEnrichment, 'audumbla/field_enrichment'
+
+  module Enrichments
+    autoload :CoarseGeocode, 'audumbla/enrichments/coarse_geocode'
+  end
 end

data/lib/audumbla/enrichments.rb

@@ -1,4 +1 @@
-module Audumbla
-  module Enrichments
-  end
-end
+

data/lib/audumbla/enrichments/coarse_geocode.rb

@@ -0,0 +1,244 @@
+require 'twofishes'
+require 'geokit'
+require 'yaml'
+
+module Audumbla::Enrichments
+  ##
+  # Enriches a `DPLA::MAP::Place` node by running its data through external 
+  # geocoders, using heuristics to determine a matching feature from GeoNames,
+  # and repopulating the `Place` with related data.
+  #
+  # If the existing `Place` contains data other than a `providedLabel`, that 
+  # data will be used as context for evaluating interpretations. For example: 
+  # a `Place` with an existing latitude and longitude will verify that the
+  # point is within the bounding box for a candidate match.
+  # 
+  # `skos:exactMatch` are reserved for the GeoNames features returned by the 
+  # geocoder. Other matching URIs (currently: LC authorities) are included as
+  # `skos:closeMatch`
+  # 
+  # Configuration is handled through a YAML file passed into the initializer 
+  # (default: 'geocode.yml'). The options are:
+  #   - 'twofishes_host': the hostname for the twofishes server (default: 
+  #       'localhost')
+  #   - 'twofishes_port': the port of the twofishes geocode endpoint (default: 
+  #        8080)
+  #   - 'twofishes_timeout': request timeout in seconds (default: 3)
+  #   - 'twofishes_retries': request retry maximum for twofishes (default: 2)
+  #   - 'distance_threshold': the maximum distance between a set of coordinates
+  #        in the  input object and a candidate match before we judge it a 
+  #        false positive, given in kilometers. (default: 5)
+  #   - 'max_intepretations': the number of geocoded "interpretations" to 
+  #       request from the server; these are the places that will be considered
+  #       by the internal heuristics (defualt: 5).
+  #
+  # @example enriching from a `#providedLabel`
+  #   
+  #    place = DPLA::MAP::Place.new.tap { |p| p.providedLabel = 'Georgia' }
+  #    CoarseGeocode.new.enrich_value.dump :ttl
+  #    # [
+  #    #    a <http://www.europeana.eu/schemas/edm/Place>;
+  #    #    <http://dp.la/about/map/providedLabel> "Georgia";
+  #    #    <http://www.geonames.org/ontology#countryCode> "US";
+  #    #    <http://www.w3.org/2003/01/geo/wgs84_pos#lat> 3.275042e1;
+  #    #    <http://www.w3.org/2003/01/geo/wgs84_pos#long> -8.350018e1;
+  #    #    <http://www.w3.org/2004/02/skos/core#closeMatch> <http://id.loc.gov/authorities/names/n79023113>;
+  #    #    <http://www.w3.org/2004/02/skos/core#exactMatch> <http://sws.geonames.org/4197000/>;
+  #    #    <http://www.w3.org/2004/02/skos/core#prefLabel> "Georgia, United States"
+  #    # ] .
+  #
+  # @example enriching from a `#providedLabel` with lat/lng guidance
+  #   
+  #    place = DPLA::MAP::Place.new.tap do |p| 
+  #      p.providedLabel = 'Georgia'
+  #      p.lat = 41.9997
+  #      p.long = 43.4998
+  #    end
+  #    
+  #    CoarseGeocode.new.enrich_value.dump :ttl
+  #    # [
+  #    #    a <http://www.europeana.eu/schemas/edm/Place>;
+  #    #    <http://dp.la/about/map/providedLabel> "Georgia";
+  #    #    <http://www.geonames.org/ontology#countryCode> "GE";
+  #    #    <http://www.w3.org/2003/01/geo/wgs84_pos#lat> 4.199998e1;
+  #    #    <http://www.w3.org/2003/01/geo/wgs84_pos#long> 4.34999e1;
+  #    #    <http://www.w3.org/2004/02/skos/core#exactMatch> <http://sws.geonames.org/614540/>;
+  #    #    <http://www.w3.org/2004/02/skos/core#prefLabel> "Georgia"
+  #    # ] .
+  #
+  class CoarseGeocode
+    include Audumbla::FieldEnrichment
+
+    DEFAULT_DISTANCE_THRESHOLD_KMS = 100
+    DEFAULT_MAX_INTERPRETATIONS = 5
+    DEFAULT_TWOFISHES_HOST = 'localhost'
+    DEFAULT_TWOFISHES_PORT = 8080
+    DEFAULT_TWOFISHES_TIMEOUT = 10
+    DEFAULT_TWOFISHES_RETRIES = 2
+
+    ##
+    # @param [String] config_file  a path to a config file for the geocoder; 
+    #   default: 'geocode.yml'
+    def initialize(config_file = 'geocode.yml')
+      config = YAML.load_file(config_file)
+
+      @distance_threshold = config.fetch('distance_threshold', 
+                                         DEFAULT_DISTANCE_THRESHOLD_KMS)
+      @max_interpretations = config.fetch('max_interpretations', 
+                                          DEFAULT_MAX_INTERPRETATIONS)
+
+      Twofishes.configure do |twofish|
+        twofish.host = config.fetch('twofishes_host', DEFAULT_TWOFISHES_HOST)
+        twofish.port = config.fetch('twofishes_port', DEFAULT_TWOFISHES_PORT)
+        twofish.timeout = config.fetch('twofishes_timeout', 
+                                       DEFAULT_TWOFISHES_TIMEOUT)
+        twofish.retries = config.fetch('twofishes_retries', 
+                                       DEFAULT_TWOFISHES_RETRIES)
+      end
+    end
+
+    ##
+    # Enriches the given value against the TwoFishes coarse geocoder. This 
+    # process adds a `skos:exactMatch` for a matching GeoNames URI, if any, and
+    # populates the remaining place data to the degree possible from the matched
+    # feature.
+    #
+    # Considers a number of matches specified by `@max_interpretations` and 
+    # returned by Twofishes, via `#match?`.
+    # 
+    # @param [DPLA::MAP::Place] value  the place to geocode
+    #
+    # @return [DPLA::MAP::Place] the inital place, enriched via coarse geocoding
+    def enrich_value(value)
+      return value unless value.is_a? DPLA::MAP::Place
+      interpretations = geocode(value.providedLabel.first, 
+                                [],
+                                maxInterpretations: @max_interpretations)
+      match = interpretations.find { |interp| match?(interp, value) }
+      match.nil? ? value : enrich_place(value, match.feature)
+    end
+
+    ##
+    # Checks that we are satisfied with the geocoder's best matches prior to 
+    # acceptance. Most tweaks to the geocoding process should be taken care
+    # of at the geocoder itself, but a simple accept/reject of the points 
+    # offered is possible here. This allows existing data about the place
+    # to be used as context.
+    # 
+    # For example, this method returns false if `place` contains latitude
+    # and longitude, but the candidate match has a geometry far away from those
+    # given. "far away" is defined by `@distance_threshold` from the center of the 
+    # candidate feature to the point given by `#lat` and `#long` in `place`. 
+    #
+    # @param [GeocodeInterpretation] interpretation  a twofishes interpretation
+    # @param [#lat#long] place  a place to verify a match against
+    #
+    # @result [Boolean] true if the interpretation is accepted
+    def match?(interpretation, place)
+      return true if place.lat.empty? || place.long.empty?
+
+      point = Geokit::LatLng.new(place.lat.first, place.long.first)
+      if interpretation.geometry.bounds.nil?
+        # measure distance between point centers
+        distance = twofishes_point_to_geokit(interpretation.geometry.center)
+                   .distance_to(point, unit: :kms)
+        return distance < @distance_threshold
+      end
+        
+      twofishes_bounds_to_geokit(interpretation.geometry.bounds)
+        .contains?(point)
+    end
+
+    private
+
+    ##
+    # Populates a DPLA::MAP::Place with data from a given feature. This 
+    # overwrites existing data with the exception of the identity (URI or node 
+    # id) and the `providedLabel`. `exactMatch`, `closeMatch`, `label` 
+    # (skos:prefLabel)and all other geographic data is replaced.
+    # 
+    # @param [DPLA::MAP::Place] place  a place to enrich
+    # @param [GeocodeFeature] feature  a twofishes feature whose data should be
+    #   added to place.
+    #
+    # @return [DPLA::MAP::Place] the original place enriched
+    def enrich_place(place, feature)
+      place.label = feature.display_name
+      place.exactMatch = feature_to_geoname_uris(feature)
+      place.closeMatch = feature_to_close_matches(feature, 
+                                                  /^http\:\/\/id\.loc\.gov\/.*/)
+      place.countryCode = feature.cc
+      place.lat = feature.geometry.center.lat
+      place.long = feature.geometry.center.lng
+
+      place
+    end
+
+    ##
+    # Extracts geonameids for the given feature and converts them into URIs
+    #
+    # @param [GeocodeFeature] feature the feature to identify
+    #
+    # @return [Array<RDF::URI>] a list of geoname URIs. Generally, this will only 
+    #   contain one exactly matching geonameid in URI form.
+    def feature_to_geoname_uris(feature)
+      geoname_ids = feature.ids.select { |id| id.source == :geonameid.to_s }
+      geoname_ids.map { |id| RDF::URI('http://sws.geonames.org') / id.id + '/' }
+    end
+
+    ##
+    # Extracts URIs for closely matching terms in other authority or knowledege
+    # organization systems
+    #
+    # @param [GeocodeFeature] feature the feature to identify
+    # @param [Regexp] patterns a splat argument containing any number of 
+    #   patterns matching
+    #
+    # @return [Array<RDF::URI>] a list of matching ids
+    def feature_to_close_matches(feature, *patterns)
+      union = Regexp.union(patterns)
+      feature.attributes.urls.select { |str| union.match(str) }
+        .map { |id| RDF::URI(id) }
+    end
+    
+    ##
+    # Sends a geocode request. This is used in lieu of `Twofishes#geocode`, 
+    # since that method does not allow passing parameters other than 
+    # `responseIncludes`.
+    #
+    # @param [#to_s] location  the string to try to match
+    # @param [Array] includes  a list of twofishes include constants
+    # @param [Hash<Symbol, #to_s> params  property and value pairs for 
+    #   parameters to pass to the request
+    #
+    # @see Twofishes#geocode
+    # @see Twofishes::Client
+    def geocode(location, includes = [], params = {})
+      client = Twofishes::Client
+      client.send(:handle_response) do
+        request = GeocodeRequest.new(query: location, responseIncludes: includes)
+        params.each { |prop, val| request.send("#{prop}=".to_sym, val) }
+        client.thrift_client.geocode(request)
+      end
+    end
+
+    private
+
+    ##
+    # @param [#lat#long] point  a twofishes point to convert to Geokit
+    #
+    # @return [Geokit::LatLng]
+    def twofishes_point_to_geokit(point)
+      Geokit::LatLng.new(point.lat, point.lng)
+    end
+
+    ##
+    # @param [#ne#sw] bounds  a twofishes bounding box to convert to Geokit
+    #
+    # @return [Geokit::Bounds]
+    def twofishes_bounds_to_geokit(bounds)
+      Geokit::Bounds.new(twofishes_point_to_geokit(bounds.sw), 
+                         twofishes_point_to_geokit(bounds.ne))
+    end
+  end
+end

data/lib/audumbla/field_enrichment.rb

@@ -42,7 +42,19 @@ module Audumbla
       return record unless record.respond_to? field
       values = record.send(field)
       if field_chain.length == 1
-        new_values = values.map { |v| enrich_value(v) }.flatten.compact
+        new_values = values.map { |v| enrich_value(v) }
+        # We call #flatten twice, since under some circumstances it fails on 
+        # nested #to_ary calls the first time. This appears to be related to:
+        #
+        # http://yehudakatz.com/2010/01/02/the-craziest-fing-bug-ive-ever-seen/
+        #   and
+        # https://bugs.ruby-lang.org/issues/2494
+        begin
+          new_values = new_values.flatten.compact
+        rescue
+          new_values = new_values.flatten.compact
+        end
+
         record.send("#{field}=".to_sym, new_values)
       else
         resources(values).each { |v| enrich_field(v, field_chain[1..-1]) }

data/lib/audumbla/version.rb

@@ -1,3 +1,3 @@
 module Audumbla
-  VERSION = '0.1.0'.freeze
+  VERSION = '0.2.0'.freeze
 end

data/spec/fixtures/georgia.yml

@@ -0,0 +1,276 @@
+--- !ruby/object:GeocodeResponse
+interpretations:
+- !ruby/object:GeocodeInterpretation
+  what: ''
+  where: georgia
+  feature: !ruby/object:GeocodeFeature
+    woeType: 8
+    cc: US
+    geometry: !ruby/object:FeatureGeometry
+      center: !ruby/object:GeocodePoint
+        lat: 32.75042
+        lng: -83.50018
+      bounds: !ruby/object:GeocodeBoundingBox
+        ne: !ruby/object:GeocodePoint
+          lat: 35.000659
+          lng: -80.751429
+        sw: !ruby/object:GeocodePoint
+          lat: 30.355756999999997
+          lng: -85.605165
+      source: usa_adm1.shp
+    name: Georgia
+    displayName: Georgia, United States
+    ids:
+    - !ruby/object:FeatureId
+      source: geonameid
+      id: '4197000'
+    - !ruby/object:FeatureId
+      source: woeid
+      id: '2347569'
+    names:
+    - !ruby/object:FeatureName
+      flags:
+      - 2
+      name: GA
+      lang: abbr
+    - !ruby/object:FeatureName
+      flags:
+      - 16
+      name: State of Georgia
+      lang: en
+    - !ruby/object:FeatureName
+      flags:
+      - 64
+      - 16
+      name: Peach State
+      lang: en
+    - !ruby/object:FeatureName
+      flags:
+      - 128
+      - 16
+      - 1
+      name: Georgia
+      lang: en
+    highlightedName: "<b>Georgia</b>, United States"
+    matchedName: Georgia, United States
+    id: geonameid:4197000
+    attributes: !ruby/object:GeocodeFeatureAttributes
+      adm0cap: false
+      adm1cap: false
+      scalerank: 20
+      labelrank: 0
+      natscale: 0
+      population: 8975842
+      sociallyRelevant: false
+      worldcity: false
+      urls:
+      - http://id.loc.gov/authorities/names/n79023113
+      - http://en.wikipedia.org/wiki/Georgia_(U.S._state)
+    longId: 72057594042124936
+    parentIds:
+    - 72057594044179937
+- !ruby/object:GeocodeInterpretation
+  what: ''
+  where: georgia
+  feature: !ruby/object:GeocodeFeature
+    woeType: 12
+    cc: GE
+    geometry: !ruby/object:FeatureGeometry
+      center: !ruby/object:GeocodePoint
+        lat: 41.99998
+        lng: 43.4999
+      bounds: !ruby/object:GeocodeBoundingBox
+        ne: !ruby/object:GeocodePoint
+          lat: 43.586627
+          lng: 46.736119
+        sw: !ruby/object:GeocodePoint
+          lat: 41.054942
+          lng: 40.006604
+      source: gn-adm0-new3.json
+    name: Georgia
+    displayName: Georgia
+    ids:
+    - !ruby/object:FeatureId
+      source: geonameid
+      id: '614540'
+    names:
+    - !ruby/object:FeatureName
+      flags:
+      - 2
+      name: GE
+      lang: abbr
+    - !ruby/object:FeatureName
+      flags:
+      - 1024
+      name: Georgian Soviet Socialist Republic
+      lang: en
+    - !ruby/object:FeatureName
+      flags:
+      - 128
+      - 64
+      - 1
+      name: Georgia
+      lang: en
+    highlightedName: "<b>Georgia</b>"
+    matchedName: Georgia
+    id: geonameid:614540
+    attributes: !ruby/object:GeocodeFeatureAttributes
+      adm0cap: false
+      adm1cap: false
+      scalerank: 20
+      labelrank: 0
+      natscale: 0
+      population: 4630000
+      sociallyRelevant: false
+      worldcity: false
+      urls:
+      - http://ru.wikipedia.org/wiki/%D0%93%D1%80%D1%83%D0%B7%D0%B8%D1%8F
+      - http://en.wikipedia.org/wiki/Georgia_%28country%29
+    longId: 72057594038542476
+    parentIds:
+    - 72057594044183083
+    longIds:
+    - 72057594038542363
+- !ruby/object:GeocodeInterpretation
+  what: ''
+  where: georgia
+  feature: !ruby/object:GeocodeFeature
+    woeType: 10
+    cc: US
+    geometry: !ruby/object:FeatureGeometry
+      center: !ruby/object:GeocodePoint
+        lat: 44.72824
+        lng: -73.12763
+    name: Town of Georgia
+    displayName: Town of Georgia, VT, United States
+    ids:
+    - !ruby/object:FeatureId
+      source: geonameid
+      id: '5236379'
+    - !ruby/object:FeatureId
+      source: woeid
+      id: '2409718'
+    names:
+    - !ruby/object:FeatureName
+      flags:
+      - 16
+      - 1
+      name: Town of Georgia
+      lang: en
+    - !ruby/object:FeatureName
+      flags:
+      - 16
+      - 8
+      - 1
+      name: Georgia
+      lang: en
+    highlightedName: "<b>Georgia</b>, VT, United States"
+    matchedName: Georgia, VT, United States
+    id: geonameid:5236379
+    attributes: !ruby/object:GeocodeFeatureAttributes
+      adm0cap: false
+      adm1cap: false
+      scalerank: 20
+      labelrank: 0
+      natscale: 0
+      population: 0
+      sociallyRelevant: false
+      worldcity: false
+      urls: []
+    longId: 72057594043164315
+    parentIds:
+    - 72057594044179937
+    - 72057594043170219
+    - 72057594043164215
+- !ruby/object:GeocodeInterpretation
+  what: ''
+  where: georgia
+  feature: !ruby/object:GeocodeFeature
+    woeType: 7
+    cc: US
+    geometry: !ruby/object:FeatureGeometry
+      center: !ruby/object:GeocodePoint
+        lat: 40.18733
+        lng: -74.28459
+      bounds: !ruby/object:GeocodeBoundingBox
+        ne: !ruby/object:GeocodePoint
+          lat: 40.1990013123
+          lng: -74.2533340454
+        sw: !ruby/object:GeocodePoint
+          lat: 40.1450004578
+          lng: -74.3127212524
+    name: Georgia
+    displayName: Georgia, NJ, United States
+    ids:
+    - !ruby/object:FeatureId
+      source: geonameid
+      id: '5098392'
+    - !ruby/object:FeatureId
+      source: woeid
+      id: '2409714'
+    names:
+    - !ruby/object:FeatureName
+      flags:
+      - 16
+      - 1
+      name: Georgia
+      lang: en
+    highlightedName: "<b>Georgia</b>, NJ, United States"
+    matchedName: Georgia, NJ, United States
+    id: geonameid:5098392
+    attributes: !ruby/object:GeocodeFeatureAttributes
+      adm0cap: false
+      adm1cap: false
+      scalerank: 20
+      labelrank: 0
+      natscale: 0
+      population: 0
+      sociallyRelevant: false
+      worldcity: false
+      urls:
+      - http://en.wikipedia.org/wiki/Georgia%2C_New_Jersey
+    longId: 72057594043026328
+    parentIds:
+    - 72057594044179937
+    - 72057594043029696
+    - 72057594043029241
+- !ruby/object:GeocodeInterpretation
+  what: ''
+  where: georgia
+  feature: !ruby/object:GeocodeFeature
+    woeType: 0
+    cc: CM
+    geometry: !ruby/object:FeatureGeometry
+      center: !ruby/object:GeocodePoint
+        lat: 6.6
+        lng: 14.01667
+    name: Gorgia
+    displayName: Gorgia, Cameroon
+    ids:
+    - !ruby/object:FeatureId
+      source: geonameid
+      id: '2231063'
+    names:
+    - !ruby/object:FeatureName
+      flags:
+      - 16
+      - 1
+      name: Gorgia
+      lang: en
+    highlightedName: "<b>Georgia</b>, Cameroon"
+    matchedName: Georgia, Cameroon
+    id: geonameid:2231063
+    attributes: !ruby/object:GeocodeFeatureAttributes
+      adm0cap: false
+      adm1cap: false
+      scalerank: 20
+      labelrank: 0
+      natscale: 0
+      population: 0
+      sociallyRelevant: false
+      worldcity: false
+      urls: []
+    longId: 72057594040158999
+    parentIds:
+    - 72057594040161323
+    - 72057594040163951

data/spec/lib/audumbla/enrichments/coarse_geocode_spec.rb

@@ -0,0 +1,105 @@
+require 'spec_helper'
+
+describe Audumbla::Enrichments::CoarseGeocode do
+  it_behaves_like 'a field enrichment'
+
+  before do
+    allow(Twofishes::Client)
+      .to receive(:handle_response)
+           .and_return(Twofishes::Result.from_response(georgia_response))
+  end
+
+  let(:georgia_response) { YAML::load_file('spec/fixtures/georgia.yml') }
+
+  describe '#enrich_value' do
+    let(:place) do
+      build(:place,
+            providedLabel: 'georgia',
+            label: nil,
+            exactMatch: nil,            
+            countryCode: nil,
+            parentFeature: nil,
+            lat: nil,
+            long: nil,
+            alt: nil)
+    end
+
+    let(:prefLabel) { 'Georgia, United States' }
+    let(:geoname_uri) { RDF::URI('http://sws.geonames.org/4197000/') }
+    let(:country_code) { 'US' }
+    let(:lat) { 32.75042 }
+    let(:lng) { -83.50018 }
+    let(:lcname_uri) do
+      RDF::URI('http://id.loc.gov/authorities/names/n79023113')
+    end
+
+    describe '#enrich_value' do
+      it 'returns the same place entity' do
+        expect(subject.enrich_value(place)).to eq place
+      end
+
+      it 'retains providedLabel' do
+        expect(subject.enrich_value(place))
+          .to have_attributes(providedLabel: contain_exactly('georgia'))
+      end
+
+      it 'it gives the geoname as skos:exactMatch' do
+        expect(subject.enrich_value(place).exactMatch.map(&:rdf_subject))
+          .to contain_exactly(geoname_uri)
+      end
+
+      it 'adds LC closeMatches, if appropriate' do
+        expect(subject.enrich_value(place).closeMatch.map(&:rdf_subject))
+          .to contain_exactly(lcname_uri)
+      end
+
+      it 'enriches place with new data' do
+        expect(subject.enrich_value(place))
+          .to have_attributes(
+                label: contain_exactly(prefLabel),
+                countryCode: contain_exactly(country_code),
+                lat: contain_exactly(be_within(0.01).of(lat)),
+                long: contain_exactly(be_within(0.01).of(lng))
+              )
+      end
+
+      context 'with lat/lng' do
+        context 'and label' do
+          let(:place) do
+            build(:place,
+                  providedLabel: 'georgia',
+                  label: nil,
+                  exactMatch: nil,            
+                  countryCode: nil,
+                  parentFeature: nil,
+                  lat: lat,
+                  long: lng,
+                  alt: nil)
+          end
+
+          it 'gives result matching lat/lng' do
+            expect(subject.enrich_value(place).exactMatch.map(&:rdf_subject))
+              .to contain_exactly(geoname_uri)
+          end
+
+          it 'skips result not matching lat/lng' do
+            place.lat = 41.9997
+            place.long = 43.4998
+
+            georgia_country_uri = RDF::URI('http://sws.geonames.org/614540/')
+
+            # points are in bounding box for Georgia but not equal to center
+            expect(subject.enrich_value(place).exactMatch.map(&:rdf_subject))
+              .to contain_exactly(georgia_country_uri)
+          end
+
+          it 'selects no match if none match lat/lng' do
+            place.lat = 41.9997
+            place.long = -43.4998
+            expect(subject.enrich_value(place).exactMatch).to be_empty
+          end
+        end
+      end
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: audumbla
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Audrey Altman
@@ -11,7 +11,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-05-29 00:00:00.000000000 Z
+date: 2015-07-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: dpla-map
@@ -27,6 +27,34 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 4.0.0.0.pre.10
+- !ruby/object:Gem::Dependency
+  name: twofishes
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: geokit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -41,6 +69,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: pry
   requirement: !ruby/object:Gem::Requirement
@@ -69,15 +111,17 @@ files:
 - lib/audumbla/enrichment.rb~
 - lib/audumbla/enrichments.rb
 - lib/audumbla/enrichments.rb~
-- lib/audumbla/enrichments/geocode.rb~
+- lib/audumbla/enrichments/coarse_geocode.rb
 - lib/audumbla/enrichments/version.rb~
 - lib/audumbla/field_enrichment.rb
 - lib/audumbla/field_enrichment.rb~
 - lib/audumbla/spec/enrichment.rb
 - lib/audumbla/version.rb
 - lib/audumbla/version.rb~
+- spec/fixtures/georgia.yml
 - spec/lib/audumbla/enrichment_spec.rb
 - spec/lib/audumbla/enrichment_spec.rb~
+- spec/lib/audumbla/enrichments/coarse_geocode_spec.rb
 - spec/lib/audumbla/enrichments/geocode_spec.rb~
 - spec/lib/audumbla/field_enrichment_spec.rb
 - spec/lib/audumbla/field_enrichment_spec.rb~
@@ -103,7 +147,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.2.1
+rubygems_version: 2.4.5
 signing_key: 
 specification_version: 4
 summary: A toolkit for enhancement of RDF Metadata
@@ -112,7 +156,8 @@ test_files:
 - spec/lib/audumbla/field_enrichment_spec.rb
 - spec/lib/audumbla/field_enrichment_spec.rb~
 - spec/lib/audumbla/enrichment_spec.rb~
+- spec/lib/audumbla/enrichments/coarse_geocode_spec.rb
 - spec/lib/audumbla/enrichments/geocode_spec.rb~
 - spec/spec_helper.rb
+- spec/fixtures/georgia.yml
 - spec/spec_helper.rb~
-has_rdoc: 

data/lib/audumbla/enrichments/geocode.rb~

@@ -1,11 +0,0 @@
-module Krikri::Enrichments
-  ##
-  #
-  class Geocode
-    include Krikri::FieldEnrichment
-
-    def enrich_value(value)
-      value
-    end
-  end
-end