Geolocation Services attempts to retrieve a visitor's physical location, allowing for geographically relevant content to be delivered.
Global Configuration is available from the WordPress settings->Ochre Geolocation page:
Per-page and per-post configurations include:
The following actions for do_action() are fired when a Geolocation update is received:
The following AJAX actions are implemented:
containing information from the Geolocation Service plugin.
Properties of this object are:
res.la; // latitude res.ll; // longitude res.ev; // elevation (not always available - do not rely on) res.ac // accuracy (not always available - do not rely on) If reverse geo coding is enabled, the object may also contain: res.country // country res.countryc // country code res.state // state res.statec // state code res.city // city
// This is the Ochre Geo object instantiated by the plugin. $ochre_geo = new OCHRELABS_WP_Geolocation(); // Get status of the current geolocation request. $ochre_geo::STATUS_UPDATED means you have "valid" coordinate data. // Constants are: $ochre_geo::STATUS_QUERY; // waiting for update from client $ochre_geo::STATUS_UPDATED; // received coordinate update from client $ochre_geo::STATUS_NOTSUPPORTED; // client does not support geo location $ochre_geo::STATUS_ERROR; // an error was returned from the client $ochre_geo::STATUS_UNKNOWNPOS; // location was unknown $ochre_geo::STATUS_DISABLED; // module has been told not to present geolocation query $ochre_geo->get_status(); // Set the location information manually (not normally needed) $ochre_geo->set_coordinates($latitude,$longitude,$elevation=0,$accuracy=0); // get the current resolved location information - check get_status() first before relying on this data! // the returned array will be something like: array("latitude"=>49.1234, "longitude"=>"-123.1234","elevation"=>0,"accuracy"=>0); $ochre_geo->get_coordinates(); // geocodes the current resolved location information and returns it as an array like array("city"=>"Vancouver","country"=>"Canada","state"=>"British Columbia","statec"=>"BC","country"=>"Canada","countryc"=>"CA") $ochre_geo->geocode();
We've thrown in Yahoo! place finder Geocoding support. The geocoder() returns an array consisting of something like:
array( "city"=>"Vancouver"," "country"=>"Canada", "state"=>"British Columbia", "statec"=>"BC", "country"=>"Canada", "countryc"=>"CA" )