https://github.com/jeroendesloovere/geolocation-php-api
This Geolocation PHP class connects to Google Geocoding API to find latitude/longitude or the address.
https://github.com/jeroendesloovere/geolocation-php-api
geocoding geolocation latitude longitude php php7
Last synced: 10 months ago
JSON representation
This Geolocation PHP class connects to Google Geocoding API to find latitude/longitude or the address.
- Host: GitHub
- URL: https://github.com/jeroendesloovere/geolocation-php-api
- Owner: jeroendesloovere
- License: mit
- Created: 2013-10-03T06:30:23.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2023-07-16T04:55:54.000Z (over 2 years ago)
- Last Synced: 2023-12-19T17:07:42.834Z (about 2 years ago)
- Topics: geocoding, geolocation, latitude, longitude, php, php7
- Language: PHP
- Homepage:
- Size: 54.7 KB
- Stars: 73
- Watchers: 9
- Forks: 35
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Geolocation PHP class connects to Google MAPS API
[](https://packagist.org/packages/jeroendesloovere/geolocation-php-api)
[](https://github.com/jeroendesloovere/geolocation-php-api/blob/master/LICENSE)
[](https://scrutinizer-ci.com/g/jeroendesloovere/geolocation-php-api/build-status/master)
[](https://scrutinizer-ci.com/g/jeroendesloovere/geolocation-php-api/?branch=master)
> This Geolocation PHP class connects to Google Maps API to find latitude/longitude or address.
## Installing
### Using Composer
When using [Composer](https://getcomposer.org) you can always load in the latest version.
``` json
composer require jeroendesloovere/geolocation-php-api
```
Check [in Packagist](https://packagist.org/packages/jeroendesloovere/geolocation-php-api).
### Usage example
**getCoordinates**
> Get latitude/longitude coordinates from address.
``` php
$street = 'Koningin Maria Hendrikaplein';
$streetNumber = '1';
$city = 'Gent';
$zip = '1';
$country = 'belgium';
$result = Geolocation::getCoordinates(
$street,
$streetNumber,
$city,
$zip,
$country
);
```
**getAddress**
> Get address from latitude/longitude coordinates.
``` php
$latitude = 51.0363935;
$longitude = 3.7121008;
$result = Geolocation::getAddress(
$latitude,
$longitude
);
```
Check [the Geolocation class source](./src/Geolocation.php).
## Symfony bundle
I've also created a Symfony bundle.
View the [Geolocation bundle](https://github.com/jeroendesloovere/geolocation-bundle).
## Tests
We have tests to make sure everything works as expected.
First execute `composer install`.
Then execute `vendor/bin/phpunit tests`.
### Coding Syntax
We use [squizlabs/php_codesniffer](https://packagist.org/packages/squizlabs/php_codesniffer) to maintain the code standards.
Type the following to execute them:
```bash
# To view the code errors
vendor/bin/phpcs --standard=psr2 --extensions=php --warning-severity=0 --report=full "src"
# OR to fix the code errors
vendor/bin/phpcbf --standard=psr2 --extensions=php --warning-severity=0 --report=full "src"
```
> [Read documentation about the code standards](https://github.com/squizlabs/PHP_CodeSniffer/wiki)
## Documentation
The class is well documented inline. If you use a decent IDE you'll see that each method is documented with PHPDoc.
## Contributing
It would be great if you could help us improve this class. GitHub does a great job in managing collaboration by providing different tools, the only thing you need is a [GitHub](http://github.com) login.
* Use **Pull requests** to add or update code
* **Issues** for bug reporting or code discussions
* Or regarding documentation and how-to's, check out **Wiki**
More info on how to work with GitHub on help.github.com.
## License
The module is licensed under [MIT](./LICENSE). In short, this license allows you to do everything as long as the copyright statement stays present.