spatial_features 3.12.0 → 3.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 992823b144d43f8a6c13f32ce0fbd71bb6bea5bafb1aadb7840767f18d2a8d9f
-  data.tar.gz: 45397ed799db69896d94a48e8c3958ab7026420587e9dd1a4755fe57a650132f
+  metadata.gz: 3b36a07cd400459369dcdaedd71899954e1a4687d94db1ac1d62e987a17c9552
+  data.tar.gz: '02101805b5ad1fee94e726fde4c24bba09e79641cc575361ff25ff51779f0fbc'
 SHA512:
-  metadata.gz: 9a9c533b9af654d339344dee13b62f14becf6e2c20fdd57868bfe5c185a5bede4657d130a6c9049d0557b274c1ed2a4a7cd70a8b826c3548824ed4b7bf7df76c
-  data.tar.gz: 7a9d9ecdd4f65b01e2cc3c0558ca3699205ecf783617e2adcd4958ca2639dd8240a99b883f1567199ce34ca5a3aad4d5bee4804902c9dddc3cf7e38690015fa5
+  metadata.gz: 3bf6e8b22a387558f09ec940d080403535ecfe89c178b8ddb3233f1d55c8107e312d6cd0f3300d43176f52d06fa41f4f490d7dc0a4c1fb3131268fdd5a3a7185
+  data.tar.gz: ef898f88ad2b999c4d363312ae6527e5cd05ba4e7a14ef8f43330862da8e6e9a73b48515ad21ab3539aa267d87bdded6d4817630a95edf2b7832c3b844e369b8

data/lib/spatial_features/download.rb

@@ -34,17 +34,19 @@ module SpatialFeatures
         fetch(path_or_url).read
       end
 
-      # Returns an open File for each source in `path_or_url`, unwrapping an archive when
+      # Returns an open file for each source in `path_or_url`, unwrapping an archive when
       # `unzip` is given a pattern its entries can match.
+      #
+      # @note A remote or IO-backed source is held in a `Tempfile`, which unlinks its path
+      #   when it is garbage collected. The `Tempfile` itself is returned, rather than a fresh
+      #   `File` opened on its path, so the path stays valid for as long as the caller holds
+      #   the result. Entries extracted from an archive are ordinary files on disk and are
+      #   opened by path.
       def open_each(path_or_url, unzip: nil, **unzip_options)
         file = Download.open(path_or_url)
-        files = if unzip && Unzip.is_zip?(file)
-          find_in_zip(file, find: unzip, **unzip_options)
-        else
-          [file]
-        end
+        return [file] unless unzip && Unzip.is_zip?(file)
 
-        return files.map { |f| File.open(f) }
+        find_in_zip(file, find: unzip, **unzip_options).map { |path| File.open(path) }
       end
 
       def normalize_file(file)

data/lib/spatial_features/importers/exif_photo.rb

@@ -0,0 +1,62 @@
+require 'exifr/jpeg'
+require 'ostruct'
+
+module SpatialFeatures
+  module Importers
+    class ExifPhoto < Base
+      JPEG_PATTERN = /\.jpe?g\z/i.freeze
+      NO_PHOTOS = "This archive doesn't contain any JPEG photos.".freeze
+      UNREADABLE_PHOTO = "This photo couldn't be read. It may be damaged, or saved in a JPEG format we don't support.".freeze
+
+      def self.create_all(data, **options)
+        Download.open_each(data, unzip: JPEG_PATTERN, tmpdir: options[:tmpdir]).map do |file|
+          new(file.path, **options)
+        end
+      rescue Unzip::PathNotFound
+        raise ImportError, NO_PHOTOS
+      end
+
+      def initialize(data, **options)
+        options[:source_identifier] ||= ::File.basename(data.to_s)
+        super(data, **options)
+      end
+
+      def cache_key
+        @cache_key ||= Digest::MD5.file(@data).hexdigest
+      end
+
+      private
+
+      def each_record
+        photo = EXIFR::JPEG.new(@data)
+        gps = photo.gps
+        unless usable_gps?(gps)
+          @warnings << 'No usable GPS coordinates were found in this photo.'
+          return
+        end
+
+        yield OpenStruct.new(
+          name: ::File.basename(@data),
+          geog: "POINT(#{gps.longitude} #{gps.latitude})",
+          metadata: metadata_from(photo, gps),
+          importable_image_paths: [@data]
+        )
+      rescue EXIFR::MalformedImage
+        raise ImportError, UNREADABLE_PHOTO
+      end
+
+      def usable_gps?(gps)
+        gps && gps.latitude.is_a?(Numeric) && gps.longitude.is_a?(Numeric) &&
+          (-90..90).cover?(gps.latitude) && (-180..180).cover?(gps.longitude)
+      end
+
+      def metadata_from(photo, gps)
+        {
+          'capture_time' => photo.date_time_original&.strftime('%Y-%m-%d %H:%M:%S'),
+          'altitude' => gps.altitude&.to_s,
+          'camera_model' => photo.model.presence
+        }.compact
+      end
+    end
+  end
+end

data/lib/spatial_features/version.rb

@@ -1,3 +1,3 @@
 module SpatialFeatures
-  VERSION = "3.12.0"
+  VERSION = "3.13.0"
 end

data/lib/spatial_features.rb

@@ -21,6 +21,7 @@ require 'spatial_features/has_spatial_features/queued_spatial_processing'
 require 'spatial_features/has_spatial_features/feature_import'
 
 require 'spatial_features/importers/base'
+require 'spatial_features/importers/exif_photo'
 require 'spatial_features/importers/file'
 require 'spatial_features/importers/geo_json'
 require 'spatial_features/importers/esri_geo_json'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: spatial_features
 version: !ruby/object:Gem::Version
-  version: 3.12.0
+  version: 3.13.0
 platform: ruby
 authors:
 - Ryan Wallace
@@ -114,6 +114,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: exifr
+  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: rails
   requirement: !ruby/object:Gem::Requirement
@@ -204,6 +218,7 @@ files:
 - lib/spatial_features/has_spatial_features/queued_spatial_processing.rb
 - lib/spatial_features/importers/base.rb
 - lib/spatial_features/importers/esri_geo_json.rb
+- lib/spatial_features/importers/exif_photo.rb
 - lib/spatial_features/importers/file.rb
 - lib/spatial_features/importers/geo_json.rb
 - lib/spatial_features/importers/geomark.rb