serpapi-uule-converter-light 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 518adb1455cfca249af3911fa9b396c4d9660e78319d02bc2247cdf1bec7cab4
+  data.tar.gz: 43872e6da6ad0a1220b7dca1bcc021fa5d75035914965a36c89659d7a4dc7d10
+SHA512:
+  metadata.gz: 4f9b29008a146344f2f07cf73ce7fff55f988c76cb933366c0460a6b79978307dc1eeeecb4dfacc74acff094e7022b7f231e2b62ed6ec484ff99c38b607c063c
+  data.tar.gz: 59c6cf7c936f1a1efd3412c17990147f93f8a76156663f2e14f7d85e5cb1a60d4dce4add389a3afde38f851850c01b37bb4e396f5263af3fd56df725c33fb5a7

data/lib/serpapi-uule-converter-light.rb

@@ -0,0 +1,61 @@
+# lib/serpapi-uule-converter-light.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: serpapi-uule-converter-light
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Emirhan Akdeniz
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2024-03-04 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/serpapi-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: []