uule_converter_light 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 4081fcbad84cf919eb5e0e46b13e115a993324fa78336d4c8b69bf27231bac4d
+  data.tar.gz: 1d882bb37982ed7f0da9d38e598604b06b04f32f0af5a690e79dfff8656e0700
+SHA512:
+  metadata.gz: bc5fa5c9220dc128181828328f07cb51ebc8ef1daf927386456f7e6736f836cb1d2fa140f0ae497af5e583ac54ff05d9b78cb1164025824b0b3b5fcb0f167c95
+  data.tar.gz: eefc38b34543f1b9d72570cac3c413eb25573809ae902504e8c39ef2ca87b0d33589535998488ba41c685795fa2490313624e66aba333fe5a234152e2474d149

data/lib/uule_converter_light.rb

@@ -0,0 +1,61 @@
+# lib/uule_converter.rb
+require 'base64'
+
+class UuleConverter
+  E7_FACTOR = 10_000_000
+
+  def self.encode(latitude, longitude, radius: -1, role: 1, producer: 12, provenance: 0, timestamp: nil)
+    timestamp ||= (Time.now.to_f * 1_000_000).to_i
+    lat_e7 = (latitude * E7_FACTOR).to_i
+    lon_e7 = (longitude * E7_FACTOR).to_i
+
+    uule_string = <<~UULE
+      role:#{role}
+      producer:#{producer}
+      provenance:#{provenance}
+      timestamp:#{timestamp}
+      latlng{
+      latitude_e7:#{lat_e7}
+      longitude_e7:#{lon_e7}
+      }
+      radius:#{radius}
+    UULE
+
+    'a+' + urlsafe_encode64(uule_string)
+  end
+
+  def self.decode(uule_encoded)
+    uule_string = urlsafe_decode64(uule_encoded[2..]) # Remove the 'a+' prefix before decoding
+    data = {}
+
+    uule_string.lines.each do |line|
+      key, value = line.strip.split(':')
+      data[key.to_sym] = value
+    end
+
+    data[:latitude] = data[:latitude_e7].to_i / E7_FACTOR.to_f
+    data[:longitude] = data[:longitude_e7].to_i / E7_FACTOR.to_f
+    data.delete(:latitude_e7)
+    data.delete(:longitude_e7)
+
+    data
+  end
+
+  private
+
+  def self.urlsafe_encode64(str)
+    Base64.strict_encode64(str).tr('+/', '-_').delete('=')
+  end
+
+  def self.urlsafe_decode64(str)
+    str = str.tr('-_', '+/').ljust((str.length + 3) & ~3, '=')
+    Base64.strict_decode64(str)
+  end
+end
+
+# No change has been observed by changing provenance and radius parameters
+# I still added them there in case they matter in the future.
+# Setting radius to `-1` and provenance to `0` works for now.
+# Setting user to `1` means `USER_SPECIFIED_FOR_REQUEST`.
+# Setting producer to `12`` means `LOGGED_IN_USER_SPECIFIED`.
+# Changing the value for the user and producer is shifting precision of the search.

metadata

@@ -0,0 +1,45 @@
+--- !ruby/object:Gem::Specification
+name: uule_converter_light
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Emirhan Akdeniz
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2024-02-12 00:00:00.000000000 Z
+dependencies: []
+description: A Ruby library for encoding and decoding UULE parameters in Google search
+  URLs using coordinates
+email:
+- kagermanovtalks@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/uule_converter_light.rb
+homepage: https://github.com/serpapi/uule_converter_light
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.5.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.4
+signing_key:
+specification_version: 4
+summary: Coordinates to UULE parameter converter for Google search
+test_files: []