Module: SpatialFeatures::InstanceMethods

Defined in:
lib/spatial_features/has_spatial_features.rb

Instance Method Summary collapse

Instance Method Details

#acts_like_spatial_features? ⇒ Boolean 



184
185
186
 
# File 'lib/spatial_features/has_spatial_features.rb', line 184

def acts_like_spatial_features?
  true
end

#aggregate_features ⇒ Object

Scope to perform SQL-only calculations on a record’s aggregate feature. This avoids loading the large data payload if all that is needed is metadata



263
264
265
 
# File 'lib/spatial_features/has_spatial_features.rb', line 263

def aggregate_features
  self.class.where(id: id).aggregate_features
end

#bounds ⇒ Object 



216
217
218
219
220
221
222
223
224
225
226
 
# File 'lib/spatial_features/has_spatial_features.rb', line 216

def bounds
  @bounds ||=
    if has_attribute?(:north) && has_attribute?(:east) && has_attribute?(:south) && has_attribute?(:west)
      slice(:north, :east, :south, :west).with_indifferent_access.transform_values!(&:to_f)
    elsif association(:aggregate_feature).loaded?
      # Aggregate features can be very large and take a while to load. Avoid loading one just to load the bounds.
      aggregate_feature&.bounds
    else
      aggregate_features.bounds
    end
end

#features? ⇒ Boolean 



204
205
206
207
208
209
210
 
# File 'lib/spatial_features/has_spatial_features.rb', line 204

def features?
  if features.loaded?
    features.present?
  else
    features.exists?
  end
end

#features_area_in_square_meters ⇒ Object 



237
238
239
240
241
242
 
# File 'lib/spatial_features/has_spatial_features.rb', line 237

def features_area_in_square_meters
  @features_area_in_square_meters ||= area if has_attribute?(:area) # Calculated area column
  @features_area_in_square_meters ||= features_area if has_attribute?(:features_area) # Cached area column
  @features_area_in_square_meters ||= aggregate_feature&.area if association(:aggregate_feature).loaded?
  @features_area_in_square_meters ||= aggregate_features.pluck(:area).first
end

#features_cache_key ⇒ Object 



188
189
190
 
# File 'lib/spatial_features/has_spatial_features.rb', line 188

def features_cache_key
  "#{self.class.name}/#{id}-#{has_spatial_features_hash? ? features_hash : (aggregate_feature || features).cache_key}"
end

#intersects?(other) ⇒ Boolean 



212
213
214
 
# File 'lib/spatial_features/has_spatial_features.rb', line 212

def intersects?(other)
  self.class.unscoped { self.class.intersecting(other).exists?(id) }
end

#lines? ⇒ Boolean 



196
197
198
 
# File 'lib/spatial_features/has_spatial_features.rb', line 196

def lines?
  !features.lines.empty?
end

#points? ⇒ Boolean 



200
201
202
 
# File 'lib/spatial_features/has_spatial_features.rb', line 200

def points?
  !features.points.empty?
end

#polygons? ⇒ Boolean 



192
193
194
 
# File 'lib/spatial_features/has_spatial_features.rb', line 192

def polygons?
  !features.polygons.empty?
end

#spatial_cache_for?(other, buffer_in_meters) ⇒ Boolean 



250
251
252
253
254
255
256
257
258
259
260
 
# File 'lib/spatial_features/has_spatial_features.rb', line 250

def spatial_cache_for?(other, buffer_in_meters)
  if cache = spatial_caches.between(self, Utils.class_of(other)).first
    return cache.intersection_cache_distance.nil? if buffer_in_meters.nil? # cache must be total if no buffer_in_meters
    return false if cache.stale? # cache must be for current features
    return true if cache.intersection_cache_distance.nil? # always good if cache is total

    return buffer_in_meters <= cache.intersection_cache_distance
  else
    return false
  end
end

#total_intersection_area_in_square_meters(other) ⇒ Object 



244
245
246
247
248
 
# File 'lib/spatial_features/has_spatial_features.rb', line 244

def total_intersection_area_in_square_meters(other)
  other = other.intersecting(self) unless other.is_a?(ActiveRecord::Base)
  return features.area if spatial_cache_for?(other, 0) && SpatialProximity.between(self, other).where('intersection_area_in_square_meters >= ?', features.area).exists?
  return features.total_intersection_area_in_square_meters(other.features)
end

#total_intersection_area_percentage(klass) ⇒ Object 



228
229
230
231
232
233
234
235
 
# File 'lib/spatial_features/has_spatial_features.rb', line 228

def total_intersection_area_percentage(klass)
  total_area = features_area_in_square_meters

  return if total_area.nil?
  return 0.0 if total_area.zero?

  ((total_intersection_area_in_square_meters(klass) / total_area) * 100).round(1)
end