serpapi-uule-converter 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 930e7fbfa964f3cbbd90372017da0be2b2c29f5f3d8252db91f1cd88194d0497
+  data.tar.gz: dacf03af6c226a8e694c29dcb1fd3182c3db207b31cb4240c5933804ea92e4c8
+SHA512:
+  metadata.gz: fbf77711f737acdcd47bb198b0213fee63312f2228986da018811128bf04155a476f3b4d55d710de2f7b6b8ce2a52639f0ee0523577abd5dfc3bd03bcce14122
+  data.tar.gz: b6b0e7288c4a8b68cc3e18684aaa7404e7ef4e5e7fb755ed6fdcfdbd750682511b8a29c3819dc0ff69b3866d5c5befa2d8d9d838dd0dc2b1bd6aee0afd588c0d

data/lib/serpapi-uule-converter.rb

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