Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/serpapi/uule_converter
A Ruby library for encoding and decoding UULE parameters in Google search URLs using coordinates
https://github.com/serpapi/uule_converter
google-local-business google-maps google-maps-api local-seo local-serp open-source opensource ruby ruby-gem ruby-gems ruby-on-rails rubygem rubygems rubyonrails seo seo-friendly seo-optimization seo-tools seotools serp
Last synced: about 1 month ago
JSON representation
A Ruby library for encoding and decoding UULE parameters in Google search URLs using coordinates
- Host: GitHub
- URL: https://github.com/serpapi/uule_converter
- Owner: serpapi
- License: mit
- Created: 2023-04-07T14:13:55.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2024-03-04T14:02:39.000Z (9 months ago)
- Last Synced: 2024-09-27T16:20:57.362Z (about 2 months ago)
- Topics: google-local-business, google-maps, google-maps-api, local-seo, local-serp, open-source, opensource, ruby, ruby-gem, ruby-gems, ruby-on-rails, rubygem, rubygems, rubyonrails, seo, seo-friendly, seo-optimization, seo-tools, seotools, serp
- Language: Ruby
- Homepage:
- Size: 22.5 KB
- Stars: 10
- Watchers: 6
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# SerpApi UULE Converter
#### A Ruby library for encoding and decoding UULE parameters in Google search URLs using coordinates
---
[![Gem Version][gem-shield]][gem-url]
[![Contributors][contributors-shield]][contributors-url]
[![Forks][forks-shield]][forks-url]
[![Stargazers][stars-shield]][stars-url]
[![Issues][issues-shield]][issues-url]
[![Issues][issuesclosed-shield]][issuesclosed-url]
[![MIT License][license-shield]][license-url]
---
A Blog Post with example usecase: [Real World Example of GPS Targeted Local SERP](https://serpapi.com/blog/gps-targeted-local-serp)
This gem is served under two names:
- `uule_converter`(legacy): [RubyGems Link](https://rubygems.org/gems/serpapi-uule-converter)
- `serpapi-uule-converter`(recent): [RubyGems Link](https://rubygems.org/gems/uule_converter)
You can also find a light version at [SerpApi UULE Converter Light](github.com/serpapi/uule_converter_light).
---
### Installation
```bash
gem install serpapi-uule-converter
```
---
### Example
```rb
require 'serpapi-uule-converter'
latitude = 30.266666
longitude = -97.733330
# Get GL parameter from coordinates (Optional, For more precise results)
gl_parameter = UuleConverter.get_gl(latitude, longitude)
puts "GL Parameter: #{gl_parameter}"
# Encode coordinates to UULE
uule_encoded = UuleConverter.encode(latitude, longitude)
puts "Encoded UULE: #{uule_encoded}"
# Decode UULE to coordinates
uule_decoded = UuleConverter.decode(uule_encoded)
puts "Decoded UULE: #{uule_decoded}"
puts "Example Google Link: https://www.google.com/search?q=Cafe&tbm=lcl&gl=#{gl_parameter}&uule=#{uule_encoded}"
```
---
### Output
```bash
GL Parameter: us
Encoded UULE: a+cm9sZToxCnByb2R1Y2VyOjEyCnByb3ZlbmFuY2U6MAp0aW1lc3RhbXA6MTY4MDg3NzkwNjIzNjczNgpsYXRsbmd7CmxhdGl0dWRlX2U3OjMwMjY2NjY2MApsb25naXR1ZGVfZTc6LTk3NzMzMzMwMAp9CnJhZGl1czotMQo
Decoded UULE: {:role=>"1", :producer=>"12", :provenance=>"0", :timestamp=>"1680877906236736", :"latlng{"=>nil, :"}"=>nil, :radius=>"-1", :latitude=>30.266666, :longitude=>-97.73333}
Example Google Link: https://www.google.com/search?q=Cafe&tbm=lcl&gl=us&uule=a+cm9sZToxCnByb2R1Y2VyOjEyCnByb3ZlbmFuY2U6MAp0aW1lc3RhbXA6MTY4MDg3NzkwNjIzNjczNgpsYXRsbmd7CmxhdGl0dWRlX2U3OjMwMjY2NjY2MApsb25naXR1ZGVfZTc6LTk3NzMzMzMwMAp9CnJhZGl1czotMQo
```
---
### Result
[gem-shield]: https://img.shields.io/gem/v/serpapi-uule-converter.svg
[gem-url]: https://rubygems.org/gems/serpapi-uule-converter
[contributors-shield]: https://img.shields.io/github/contributors/serpapi/uule_converter.svg
[contributors-url]: https://github.com/serpapi/uule_converter/graphs/contributors
[forks-shield]: https://img.shields.io/github/forks/serpapi/uule_converter.svg
[forks-url]: https://github.com/serpapi/uule_converter/network/members
[stars-shield]: https://img.shields.io/github/stars/serpapi/uule_converter.svg
[stars-url]: https://github.com/serpapi/uule_converter/stargazers
[issues-shield]: https://img.shields.io/github/issues/serpapi/uule_converter.svg
[issues-url]: https://github.com/serpapi/uule_converter/issues
[issuesclosed-shield]: https://img.shields.io/github/issues-closed/serpapi/uule_converter.svg
[issuesclosed-url]: https://github.com/serpapi/uule_converter/issues?q=is%3Aissue+is%3Aclosed
[license-shield]: https://img.shields.io/github/license/serpapi/uule_converter.svg
[license-url]: https://github.com/serpapi/uule_converter/blob/master/LICENSE