Download the PHP package stanley/geocodio-php without Composer
On this page you can find all versions of the php package stanley/geocodio-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package geocodio-php
DEPRECATED
This library has been replaced by https://github.com/Geocodio/geocodio-library-php
geocod.io PHP
Thin PHP wrapper for geocod.io geocoding API that includes a service provider for Laravel.
Features
- Geocode an individual address
- Batch geocode up to 10,000 addresses at a time
- Parse an address into its identifiable components
Read the complete geocod.io geocoding API for service documentation.
Installing via Composer
The recommended way to install geocod.io PHP is through Composer.
After installing, you need to require Composer's autoloader:
Using
Using the geocod.io PHP library is super simple.
Note: Create an API key by signing up at https://dash.geocod.io/auth/register
Geocode single address
To encode a single address, simply pass a string to the geocode function.
Geocode multiple addresses
For multiple addresses, you can pass an array of addresses to the same geocode function.
Up to 10,000 addresses can be geocoded in a single batch request
Reverse geocoding a single coordinate
geocod.io also supports reverse geocoding. To convert a single lat/long pair into an address, call the 'reverse' method.
The lat/long pairs should be separateed by a comma.
Reverse geocoding multiple coordinates
To do a batch conversion, pass your lat/long pairs in an array.
Fields
Geocoding and reverse geocoding requests accepts an optional second parameter for fields.
Return Values
The geocod.io PHP client will return an instance of the Stanley\Geocodio\Data class. The raw response body can be accessed from the response property. This property had the response data stored as an object.
Laravel Service Provider and Facade
A service provder and facade are available if you are using Laravel. Once you've added the package to your composer.json file, run php composer.phar update. Add 'Stanley\Geocodio\ServiceProviders\LaravelServiceProvider'to the providers key. Then, edit the aliases key and add 'Geocodio' => 'Stanley\Geocodio\Geocodio' to the array.
You are now ready to use the Facade. If you are using Laravel, you will need to pass your API Key as the third parameter.
Exceptions
Periodically, the geocod.io service will return errors.
To handle these:
- An HTTP 403 error raises a
GeocodioAuthError - An HTTP 422 error raises a
GeocodioDataErrorand the error message will be reported through the exception - An HTTP 5xx error raises a
GeocodioServerError - An unmatched non-200 response will simply raise
Exception
Credits
The original library was written by David Stanley. Much of this readme and the structure of this library was inspired by the Py-Geocodio Library by Ben Lopatin.
