Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/drylikov/perch_fieldtype_geocode
A Perch CMS field type for geocoding addresses.
https://github.com/drylikov/perch_fieldtype_geocode
google-maps perch php
Last synced: about 2 months ago
JSON representation
A Perch CMS field type for geocoding addresses.
- Host: GitHub
- URL: https://github.com/drylikov/perch_fieldtype_geocode
- Owner: drylikov
- License: mit
- Created: 2024-11-16T10:30:05.000Z (2 months ago)
- Default Branch: drylikov
- Last Pushed: 2024-11-16T10:34:12.000Z (2 months ago)
- Last Synced: 2024-11-16T11:25:06.174Z (2 months ago)
- Topics: google-maps, perch, php
- Language: PHP
- Homepage:
- Size: 0 Bytes
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Perch Geocode Field Type.
========================
A Perch CMS field type for geocoding addresses.
# Requirements
* PHP 5.3+
* Perch CMS v2.3.2
# Installation
1. Copy `perch/addons/fieldtypes/geocode` into your project `$PERCH/addons/fieldtypes` directory.
2. Download [PHP Geocoder](https://github.com/geocoder-php) into `$PERCH/addons/fieldtypes/geocode/php-geocoder`.
# Usage
To use the fieldtype, add into your template as follows:
```html
```
Once an address has been successfully geocoded, you'll see a Google Map preview:
## Adapters
The `adapter` attributes determines which HTTP adapter to use when geocoding. The choices are `curl` or `socket`.
The **default** adapter is `curl`.
## Providers
The `providers` attributes determines which service(s) to use for geocoding. They should be seperated by a single space, and will be executed in the order specified, stopping once a provider returns a result.
The available options are `google_maps`, `google_maps_business`, `bing_maps`, `openstreetmaps`, `map_quest`, `nominatim`, `geocoder_ca`, `geocoder_us`, `ign_openls`, `data_science_toolkit`, `yandex`, `baidu` and `tomtom`.
The **default** providers are `google_maps`, `openstreetmaps` and `map_quest`.
### Provider Configuration
Providers are configured using constants. For example, the Google Maps provider accepts a region, locale and a useSSL parameter upon construction. The constant names are determined by the name of the provider (e.g., `google_maps`) and the name of the parameter (e.g., `region`), capitalised and underscored separated.
You should specify constants in your `$PERCH/config/config.php` file:
```php
```
Check out the [PHP Geocoder](https://github.com/geocoder-php) documentation for more information providers and what parameters their constructors accept.
Note: The specified HTTP adapter is automatically passed to the provider constructor, you only need to configure the remaining parameters.
# Accessing Latitude/Longitude Data
The latitude and longitude values, as well as the address entered by the user and any error messages, are stored in the item's JSON:
```js
{
address":
{
"address": "1218 2nd Avenue South\nLethbridge\nAlberta\nT1J 0E3",
"addr1": "1218 2nd Avenue South",
"addr2": "",
"city": "Lethbridge",
"state": "Alberta",
"postcode": "T1J 0E3",
"error": "",
"latitude": 49.6974029,
"longitude": -112.8277358
}
}
```
You can access this information using Perch's `perch_content_custom()` method:
```php
true,
));
print_r($addresses);
/*
[0] => Array
(
[_id] => 95
[name] => Media 32
[_title] => Media 32
[address] => Array
(
[address] => 1218 2nd Avenue South
Lethbridge
Alberta
T1J 0E3
[addr1] => 1218 2nd Avenue South
[addr2] =>
[city] => Lethbridge
[state] => Alberta
[postcode] => T1J 0E3
[error] =>
[latitude] => 49.6974029
[longitude] => -112.8277358
)
[_page] => *
)
*/
?>
```