google-api-customization 0.0.1 → 0.0.3

checksums.yaml

@@ -1,15 +1,7 @@
 ---
-!binary "U0hBMQ==":
-  metadata.gz: !binary |-
-    ODkxM2MzMjkzMzBlODg1MTg0OTVkMjRlNDY3Yjg1ZWI1YmFhMDhkZg==
-  data.tar.gz: !binary |-
-    NGNmMjAxMWJjYzE0NzU4MTc0MmMyYzYxMDVjZmQzNDMwZTFhNjNjZA==
+SHA256:
+  metadata.gz: 24f33be4fcc3ad7f0079e5222be998de22d7decc2f8c2f358622d709738e32e4
+  data.tar.gz: 2ac49d69075a9a3394f6ce49ee7fe3afa35c0e880ad8c7b87b27d6b2007fbbb5
 SHA512:
-  metadata.gz: !binary |-
-    NjgwYjI0YTUzYjRmYTFjZTRlOTViYzk0OTgzNWUwN2RhMGUyYjkzY2Y1ZWRj
-    OTRlM2NkMmY5MWFhZGJkYTE1OTM0N2U0MjRkMDc5ODM4ZWUxMjk2MTc1NjBj
-    NjExODAxZmUzOTIzNjk5ZDMyODU2MTc2M2NlZTNmODg2MzI2MGQ=
-  data.tar.gz: !binary |-
-    ZjljOGYwODRlNDhkYzQzMTE5NGU5MWU5M2NiOWVlNGI1ZjYwOGVjYjUxOTQy
-    MmI1YjQyMjI2Y2Q5OWIyOWVhY2M1MTU3ZDkwY2Q1NTRiNWM2NTI4ODZiZTIy
-    YTBkYWMwODMzYmM3ZGEyMzk2NWM2YTM0YTM5OGJlN2ZiYWRhMDk=
+  metadata.gz: 459886cba07f4db6b1d019f23f4deeaaaa396f68d39fc828174b7e0bd1b760a270f7f1aaa566e9014176a9c7818dfa1c8852a07a1243f0d7c71ca8ca096d8400
+  data.tar.gz: 20d85b64028dcda04a0d55e13cc1375a14ec766b097ad0454266eb69835a65d462215b31d1e75920202df92a4f5267211ece7ba8c64ce86da5174cf7f34fb204

data/README.md

@@ -0,0 +1,78 @@
+# google-api-customization
+
+A Ruby gem that wraps the Google Places API for use in Rails applications. Supports place details, text search, nearby search, radar search, photos, reviews, and autocomplete.
+
+## Installation
+
+Add this line to your `Gemfile`:
+
+```ruby
+gem 'google-api-customization'
+```
+
+Then run:
+
+```bash
+bundle install
+```
+
+## Configuration
+
+```ruby
+GoogleApiCustomization.configuration do |config|
+  config.api_key = "YOUR_GOOGLE_API_KEY"
+end
+```
+
+## Usage
+
+### Look up a place by ID
+
+```ruby
+place = GoogleApiCustomization::Place.find(place_id, api_key, sensor)
+
+place.name               # => "Eiffel Tower"
+place.formatted_address  # => "Champ de Mars, Paris, France"
+place.lat                # => 48.8584
+place.lng                # => 2.2945
+place.rating             # => 4.7
+place.website            # => "https://www.toureiffel.paris"
+place.opening_hours      # => { ... }
+```
+
+### Text search
+
+```ruby
+places = GoogleApiCustomization::Place.list_by_query(
+  "coffee shops",
+  api_key,
+  sensor,
+  lat: 48.8584,
+  lng: 2.2945,
+  radius: 1000
+)
+```
+
+### Photos
+
+```ruby
+place.photos.each do |photo|
+  url = photo.fetch_url(400)  # maxwidth in pixels
+end
+```
+
+### Reviews
+
+```ruby
+place.reviews.each do |review|
+  puts "#{review.author_name}: #{review.text} (#{review.rating}/5)"
+end
+```
+
+## Available Place Attributes
+
+`name`, `place_id`, `lat`, `lng`, `formatted_address`, `formatted_phone_number`, `international_phone_number`, `website`, `rating`, `price_level`, `opening_hours`, `types`, `photos`, `reviews`, `url`, `vicinity`, `address_components`, `utc_offset`
+
+## Dependencies
+
+- [httparty](https://github.com/jnunemaker/httparty)

data/google-api-customization.gemspec

@@ -0,0 +1,21 @@
+require_relative "lib/google_api_customization/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "google-api-customization"
+  spec.version       = GoogleApiCustomization::VERSION
+  spec.authors       = ["Abhishek Sharma"]
+  spec.email         = ["abhsss96@gmail.com"]
+  spec.summary       = "Ruby gem to expand usage of Google API with Rails"
+  spec.description   = "A wrapper around the Google Places API supporting place lookup, text search, nearby search, photos, reviews, and autocomplete."
+  spec.homepage      = "https://github.com/abhsss96/google-api-customization"
+  spec.license       = "MIT"
+  spec.required_ruby_version = ">= 2.7"
+
+  spec.files         = Dir["lib/**/*", "README.md", "*.gemspec"]
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "httparty", ">= 0.14"
+
+  spec.add_development_dependency "rspec", "~> 3.12"
+  spec.add_development_dependency "webmock", "~> 3.0"
+end

data/lib/google_api_customization/api_key.rb

@@ -0,0 +1,21 @@
+module GoogleApiCustomization
+  
+  class ApiKey
+    
+    attr_reader :api_key
+
+    attr_reader :options
+    attr_reader :sensor
+    
+    def initialize(api_key = @api_key, sensor = false, options = {})
+      api_key ? @api_key = api_key : @api_key = GoogleApiCustomization.api_key
+      @sensor = sensor
+      @options = options
+    end
+    
+    def place_detail(place_id, options = {})
+      Place.find(place_id, @api_key, @sensor, @options.merge(options))
+    end
+  end   
+ 
+end

data/lib/google_api_customization/errors.rb

@@ -0,0 +1,17 @@
+module GoogleApiCustomization
+  class Error < StandardError
+    attr_reader :response
+    def initialize(response)
+      @response = response
+      super(response.parsed_response.to_s)
+    end
+  end
+
+  class OverQueryLimitError  < Error; end
+  class RequestDeniedError   < Error; end
+  class InvalidRequestError  < Error; end
+  class UnknownError         < Error; end
+  class NotFoundError        < Error; end
+  class RetryError           < Error; end
+  class RetryTimeoutError    < Error; end
+end

data/lib/google_api_customization/photo.rb

@@ -0,0 +1,44 @@
+module GoogleApiCustomization
+  class Photo
+    attr_accessor :width, :height, :photo_reference, :html_attributions
+
+    def initialize(width, height, photo_reference, html_attributions, api_key, sensor)
+      @width             = width
+      @height            = height
+      @photo_reference   = photo_reference
+      @html_attributions = html_attributions
+      @api_key           = api_key
+      @sensor            = sensor
+    end
+
+    # Search for a Photo's url with its reference key
+    #
+    # @return [URL]
+    # @param [String] api_key the provided api key
+    # @param [Boolean] sensor
+    #   Indicates whether or not the Place request came from a device using a location sensor (e.g. a GPS)
+    #   to determine the location sent in this request.
+    #   <b>Note that this is a mandatory parameter</b>
+    # @param [Hash] options
+    # @option options [Hash] :retry_options ({})
+    #   A Hash containing parameters for search retries
+    # @option options [Object] :retry_options[:status] ([])
+    # @option options [Integer] :retry_options[:max] (0) the maximum retries
+    # @option options [Integer] :retry_options[:delay] (5) the delay between each retry in seconds
+    def fetch_url(maxwidth, options = {})
+      language  = options.delete(:language)
+      retry_options = options.delete(:retry_options) || {}
+
+      unless @fetched_url
+        @fetched_url = Request.photo_url(
+          :maxwidth => maxwidth,
+          :photoreference => @photo_reference,
+          :sensor => @sensor,
+          :key => @api_key,
+          :retry_options => retry_options
+        )
+      end
+      @fetched_url
+    end
+  end
+end

data/lib/google_api_customization/review.rb

@@ -0,0 +1,14 @@
+module GoogleApiCustomization
+  class Review
+    attr_accessor :rating, :type, :author_name, :author_url, :text, :time
+
+    def initialize(rating, type, author_name, author_url, text, time)
+      @rating       = rating
+      @type         = type
+      @author_name  = author_name
+      @author_url   = author_url
+      @text         = text
+      @time         = time
+    end
+  end
+end

data/lib/google_api_customization/version.rb

@@ -0,0 +1,3 @@
+module GoogleApiCustomization
+  VERSION = "0.0.3"
+end

data/lib/google_api_customization.rb

@@ -1,24 +1,19 @@
-require 'debugger'
-require 'rubygems'
-require 'httparty'
-
-%w(request place api_key photo review).each do |file|
-  require File.join(File.dirname(__FILE__), 'google_api_customization', file)
-end
-
+require "httparty"
+require_relative "google_api_customization/version"
+require_relative "google_api_customization/errors"
+require_relative "google_api_customization/request"
+require_relative "google_api_customization/place"
+require_relative "google_api_customization/api_key"
+require_relative "google_api_customization/photo"
+require_relative "google_api_customization/review"
 
 module GoogleApiCustomization
-  
   class << self
-
     attr_accessor :api_key
 
     def configuration
-      
       yield self
-      
     end
-
   end
+end
 
-end

metadata

@@ -1,46 +1,96 @@
 --- !ruby/object:Gem::Specification
 name: google-api-customization
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.3
 platform: ruby
 authors:
 - Abhishek Sharma
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2014-09-01 00:00:00.000000000 Z
-dependencies: []
-description: Gem to expand usage of google api with rails
-email: abhishek.sharma@medma.in
+date: 2026-05-31 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.14'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.14'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: A wrapper around the Google Places API supporting place lookup, text
+  search, nearby search, photos, reviews, and autocomplete.
+email:
+- abhsss96@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- README.md
+- google-api-customization.gemspec
 - lib/google_api_customization.rb
+- lib/google_api_customization/api_key.rb
+- lib/google_api_customization/errors.rb
+- lib/google_api_customization/photo.rb
 - lib/google_api_customization/place.rb
 - lib/google_api_customization/request.rb
-homepage: http://rubygems.org/gems/google_api_customization
+- lib/google_api_customization/review.rb
+- lib/google_api_customization/version.rb
+homepage: https://github.com/abhsss96/google-api-customization
 licenses:
-- NONE
+- MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '2.7'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.2.2
-signing_key: 
+rubygems_version: 3.5.22
+signing_key:
 specification_version: 4
-summary: Hello! This is start up for google API customization for Rails
+summary: Ruby gem to expand usage of Google API with Rails
 test_files: []