uule_converter 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 75eaafd69f3039c4d252588a267e6993c3b4ad4b72bd4123fa074610b541ce31
+  data.tar.gz: 5cb5b49e32735669c34fa87dafb27a32954a91f826a15065f0928bbd4054f86f
+SHA512:
+  metadata.gz: 5a91938175c7a75329f506b4316ddaca9ca5337154fe4cc91b1fca7b4bb4e3cacf2d6a7250d92d52679a0e33662ab79bce527147dc4c352567d7ed1ec7584e11
+  data.tar.gz: cf10f1bd3eb6d870a801dbfd641e65c45612c388fc410b041ad38d7b385587d0d7509a4c4d741cd39ed837b421205a239821eae9aca152f9ed6d746780d8d799

data/lib/uule_converter.rb

@@ -0,0 +1,69 @@
+# lib/uule_converter.rb
+require 'base64'
+require 'geocoder'
+
+class UuleConverter
+  E7_FACTOR = 10_000_000
+
+  def self.get_gl(latitude, longitude)
+    results = Geocoder.search([latitude, longitude])
+
+    # If a result is found, return the country code (gl parameter)
+    results.first&.country_code&.downcase
+  end
+
+  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,59 @@
+--- !ruby/object:Gem::Specification
+name: uule_converter
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Emirhan Akdeniz
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2023-04-07 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: geocoder
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+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.rb
+homepage: https://github.com/serpapi/uule_converter
+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: []