Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jumpinjackie/mapguide-rest
REST Extension for MapGuide Open Source
https://github.com/jumpinjackie/mapguide-rest
mapguide php rest-api
Last synced: 4 days ago
JSON representation
REST Extension for MapGuide Open Source
- Host: GitHub
- URL: https://github.com/jumpinjackie/mapguide-rest
- Owner: jumpinjackie
- License: lgpl-2.1
- Created: 2013-12-17T10:33:28.000Z (about 11 years ago)
- Default Branch: master
- Last Pushed: 2025-01-22T16:36:16.000Z (12 days ago)
- Last Synced: 2025-01-22T17:30:47.978Z (12 days ago)
- Topics: mapguide, php, rest-api
- Language: JavaScript
- Homepage:
- Size: 42.3 MB
- Stars: 26
- Watchers: 10
- Forks: 14
- Open Issues: 39
-
Metadata Files:
- Readme: README.md
- Changelog: changelog.txt
- License: LICENSE
Awesome Lists containing this project
README
mapguide-rest
=============[![Build Status](https://travis-ci.org/jumpinjackie/mapguide-rest.svg)](https://travis-ci.org/jumpinjackie/mapguide-rest)
[![Windows Build Status](https://ci.appveyor.com/api/projects/status/trt32l1n4p20uwvp/branch/master?svg=true)](https://ci.appveyor.com/project/jumpinjackie/mapguide-rest)mapguide-rest is a RESTful web extension for [MapGuide Open Source](http://mapguide.osgeo.org) that continues the ideas explored in [mapguide4j](https://github.com/jumpinjackie/mapguide4j) and [GeoREST](https://code.google.com/p/georest/) projects
mapguide-rest provides the following services:
- A REST-ful http interface modeled on original discussions on a [RESTful web service for MapGuide](http://trac.osgeo.org/mapguide/wiki/Future/RESTfulWebServices)
- A re-imagining of GeoREST and its data publishing capabilitiesmapguide-rest is written in PHP and uses the following libraries:
- [Slim Framework](http://www.slimframework.com/)
- [Smarty Template Engine](http://www.smarty.net)This project is not affiliated with Autodesk or OSGeo.
Requirements
============mapguide-rest requires an installation of MapGuide Open Source and its bundled copy of PHP. As PHP is required by Fusion and other installed MapGuide web applications, this requirement will almost always be satisifed.
mapguide-rest has been tested on MapGuide Open Source 2.6. It should theoretically work on any installation of MapGuide Open Source or AIMS that includes PHP 5.3 or newer.
Setup
=====**NOTE: For convenience, you should use one of the pre-packaged [release distributions](https://github.com/jumpinjackie/mapguide-rest/releases)**
1. Ensure you have a git and svn client installed and this is accessible from the command-line.
2. Clone this repository into the www directory of your MapGuide Open Source installation. Rename the clone directory to "rest" (eg. C:\Program Files\OSGeo\MapGuide\Web\www\rest on windows or /usr/local/mapguideopensource-2.6.0/webserverextensions/www/rest on linux)
3. Install [PHP Composer](https://getcomposer.org/) if you have no done so already
4. Run the following composer command from the root of your clone to pull down required vendor libraries
> composer install
or
> php composer.phar installSome of the external libraries that composer pulls down may require a svn checkout or git clone, so ensure you have these clients installed in step 1.
5. [OPTIONAL] Install and enable the [Application Request Routing module for IIS](http://www.iis.net/downloads/microsoft/application-request-routing). This allows for "cleaner" URLs. If you have installed the ARR module, you can rename the web.config.iis file to web.config to activate ARR for the REST extension. For Apache, you can use the provided .htaccess file for clean URLs and skip this step.
You may also need to install the [URL Rewrite module for IIS](https://www.iis.net/downloads/microsoft/url-rewrite) as well.
6. [OPTIONAL] On Linux, you may need to create a "templates_c" folder under the "cache" directory and give it sufficient permissions for the Smarty template engine to save compiled templates to. See [Example 2.7 of the Smarty installation guide](http://www.smarty.net/docsv2/en/installing.smarty.basic.tpl) for more information. Additionally, Smarty may also complain about a default timezone not being set (this is raised as an exception). To avoid this exception, [set a default timezone in php.ini and restart Apache](http://au2.php.net/manual/en/datetime.configuration.php#ini.date.timezone)
7. You can now access the REST endpoint at:
- http://yourservername:port/mapguide/rest
- http://yourservername:port/mapguide/rest/index.php (if you don't have ARR installed for IIS or mod_rewrite enabled for Apache)Documentation
=============Check out the [wiki](https://github.com/jumpinjackie/mapguide-rest/wiki) for additional information and documentation.
License
=======mapguide-rest is licensed under the GNU Lesser General Public License (LGPL) v2.1 (see LICENSE for more information)