PHP Classes

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    
Ratings Unique User Downloads Download Rankings
Not yet rated by the usersTotal: 102 All time: 9,611 This week: 265Up
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
Picture of Ray Paseur
  Performance   Level  
Name: Ray Paseur is available for providing paid consulting. Contact Ray Paseur .
Classes: 8 packages by
Country: United States United States
Age: 72
All time rank: 2269312 in United States United States
Week rank: 485 Up56 in United States United States Up
Innovation award
Innovation award
Nominee: 5x

Winner: 1x

Class PlusCodeLocal

This static class extends the static class PlusCode, found here:

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  To 
use the web services, you _must_ get your own API key from GeoNames.
Register and login to GeoNames here:

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

Documentation References:
  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
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  
This week:0
All time:9,611
This week:265Up
For more information send a message to info at phpclasses dot org.