PHP Classes
elePHPant
Icontem

PHP PlusCode Local: Get the location information from PlusCode

Recommend this page to a friend!
  Info   View files Example   View files View files (3)   DownloadInstall with Composer Download .zip   Reputation   Support forum   Blog    
Last Updated Ratings Unique User Downloads Download Rankings
2019-01-13 (7 months ago) RSS 2.0 feedNot yet rated by the usersTotal: 96 All time: 9,250 This week: 243Up
Version License PHP version Categories
pluscodelocal 1.0.0Public Domain5PHP 5, Geography
Description Author

This class can get the location information from PlusCode.

It takes a string in the PlusCode format and extracts the geographic coordinates of the respective location using the base PlusCode.

The class uses the GeoNames API to get details about the given location and returns a PlusCode local string.

Innovation Award
PHP Programming Innovation award nominee
February 2019
Number 10
PlusCode is a form to represent a location in the planet.

This class can take a location string defined in the PlusCode format and returns a string with the administrative city, state and country.

Manuel Lemos
  Performance   Level  
Name: Ray Paseur is available for providing paid consulting. Contact Ray Paseur .
Classes: 8 packages by
Country: United States United States
Age: 68
All time rank: 2510309 in United States United States
Week rank: 377 Up33 in United States United States Up
Innovation award
Innovation award
Nominee: 5x

Winner: 1x

 

Details
Class PlusCodeLocal

This static class extends the static class PlusCode, found here:
https://www.phpclasses.org/package/11016

The class provides a single method, get() which takes as input a 
full Open Location Code and returns a string with a localized code.

The philosophy of the Google PlusCode address is that it "looks like 
a regular address, but with a short code where the street name and 
number would be."  This class tries to provide the "regular address"
part in a manner that looks similar to the PlusCode that Google might
produce.  It gives names of the nearby locations such that a full 
Open Location Code of "48Q39JW9+G9" would be returned in the form of
a local code like "9JW9+G9 Buenos Aires Argentina."  

This class has a dependency on web services from GeoNames.org.  To 
use the web services, you _must_ get your own API key from GeoNames.
Register and login to GeoNames here:
https://www.geonames.org/login

When you have your API key, insert it into the public static $apikey 
variable at the top of this class file.

The GeoNames API fails sometimes.  When this happens the Class
returns the original input Open Location Code.  The full OLC may
still be usable in many applications.  A PHP Notice will be issued 
saying something like this:
    "ERROR: canceling statement due to statement timeout"

The demonstration script for this class will call the GeoNames API 
repeatedly and in practice that might not be a good idea.  You may
want to consider downloading and hosting your own version of their
database.

Documentation References:
   https://plus.codes/
   https://www.geonames.org/about.html
   https://www.geonames.org/export/ws-overview.html
   https://www.geonames.org/export/web-services.html#findNearby
   https://www.geonames.org/export/codes.html
  Files folder image Files  
File Role Description
Plain text file class_PlusCodeLocal.php Class PlusCode Localization
Accessible without login Plain text file demo_PlusCodeLocal.php Example Demonstration Script
Accessible without login Plain text file readme_PlusCodeLocal.txt Doc. readme text file

Downloadpluscodelocal-2019-01-13.zip 3KB
Downloadpluscodelocal-2019-01-13.tar.gz 3KB
Install with ComposerInstall with Composer
Needed packages  
Class DownloadWhy it is needed Dependency
PHP PlusCode Download .zip .tar.gz This Class extends PlusCode Required
 Version Control Unique User Downloads Download Rankings  
 0%
Total:96
This week:0
All time:9,250
This week:243Up