{"id":16920278,"url":"https://github.com/ctlong/address_geocoder","last_synced_at":"2025-04-12T23:42:28.100Z","repository":{"id":45633314,"uuid":"49310346","full_name":"ctlong/address_geocoder","owner":"ctlong","description":"Calls and parses Google Geocoding API for address validation and geocoding","archived":false,"fork":false,"pushed_at":"2016-08-03T23:51:57.000Z","size":133,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-12T23:42:23.211Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://rubygems.org/gems/address_geocoder","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ctlong.png","metadata":{"files":{"readme":"README.rdoc","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-01-09T04:13:37.000Z","updated_at":"2025-02-10T08:23:35.000Z","dependencies_parsed_at":"2022-09-13T11:00:34.033Z","dependency_job_id":null,"html_url":"https://github.com/ctlong/address_geocoder","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ctlong%2Faddress_geocoder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ctlong%2Faddress_geocoder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ctlong%2Faddress_geocoder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ctlong%2Faddress_geocoder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ctlong","download_url":"https://codeload.github.com/ctlong/address_geocoder/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248647257,"owners_count":21139081,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-13T19:47:37.608Z","updated_at":"2025-04-12T23:42:28.081Z","avatar_url":"https://github.com/ctlong.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"= AddressGeocoder\n\n{\u003cimg src=\"https://codeclimate.com/github/ctlong/address_geocoder/badges/gpa.svg\" /\u003e}[https://codeclimate.com/github/ctlong/address_geocoder]\n{\u003cimg src=\"https://travis-ci.org/ctlong/address_geocoder.svg?branch=master\" /\u003e}[https://travis-ci.org/ctlong/address_geocoder.svg?branch=master]\n{\u003cimg src=\"https://badge.fury.io/rb/address_geocoder.svg\" alt=\"Gem Version\" /\u003e}[https://badge.fury.io/rb/address_geocoder]\n\n\u003cb\u003eAddressGeocoder\u003c/b\u003e is a Ruby interface to certain Maps APIs that allow you to validate and geocode addresses.\n\nSome APIs may require certain credentials to access.\n\n== Getting started\n\nAddressGeocoder was written and tested on Rails \u003e= 4.2.5. You can install it by adding in to your Gemfile with:\n\n  gem 'address_geocoder'\n\nRun the bundle command to install it.\n\n== Basic usage\n\nRequire the library:\n\n  require 'address_geocoder'\n\nCreate a client:\n\n  client = MapsApi::Google::Client.new\n\nYou can set some or all of the address information when or after creating the client (country names are {ISO 3166-1 Alpha-2}[https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2] codes):\n\n  client = MapsApi::Google::Client.new(\n    country: 'Your country',\n    state: 'Your state',\n    city: 'Your city',\n    postal_code: 'Your postal code',\n    street: 'Your street',\n    language: 'The language to return your response in',\n    api_key: 'Your api key for an API'\n  )\n\n  client.street = 'A different street'\n\nValidating an address:\n\n  client.valid_address? # returns true or false\n\nFinding suggested addresses:\n\n  client.suggested_addresses # returns a list of addresses that most closely match your inputted addresss\n\nAdditional methods:\n\n  client.response       # returns the marketplace's actual response\n  client.address        # returns the current user inputted address\n  client.former_address # returns the last address that was used in a call, nil if no call has been made.\n\n== The APIs\n\n=== Google\n\nCurrently the only API we have integrated. All validations are done using {Google's Geocoding API}[https://developers.google.com/maps/documentation/geocoding/intro]. Although an {API key}[https://developers.google.com/maps/documentation/geocoding/get-api-key] is not required, it is recommended to track usage and upgrade your call limit if required. Google provides a maximum of 2,000 free calls per day to either your IP address or API key.\n\n== How it works\n\n\u003cb\u003eAddressGeocoder\u003c/b\u003e sends addresses in varying formats to the Maps API of your choice. A positive response indicates that the address is valid. After a positive response the gem can parse returned elements to suggest a formatted address.\n\n== Development and tests\n\nWe are open to suggestions and improvements. Just don't forget to write tests before the pull request.\n\n== Bug reporting\n\nIf you discover a problem with our gem, please let us know about it: {ctlong/address_geocoder/issues}[https://github.com/ctlong/address_geocoder/issues]\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fctlong%2Faddress_geocoder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fctlong%2Faddress_geocoder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fctlong%2Faddress_geocoder/lists"}