Skip to content

Geographic web services for directions and POIs in private spaces

License

Notifications You must be signed in to change notification settings

dan-zx/zekke-api

Repository files navigation

ZeKKe REST API v0.1

Coverage Build Status License

ZeKKe provides geographic web services for directions and POIs (Points of interest) in private spaces. where no roads exist in systems like Google Maps or Bing Maps. Also, provides additional information about the POIs like events, adds, etc.

Getting started

  1. Install MongoDB and initialize it.

    a. Create the collections sequences, users and waypoints

    b. Create the stored procedure functions located at fuctions directory in your MongoDB with the command.

    db.system.js.save( { _id: "<functionName>", value: <function> } );

    c. Create indexes for the ZeKKe collections.

  2. Set the active profile as dev or staging on the property spring.profiles.active in application.properties file or as environment variable.

  3. Set your Mongo DB connection settings depending on the active profile:

    • For dev profile: Set in application.properties file the connection values for your Mongo DB instance:

      • dev.mongodb.host
      • dev.mongodb.port
      • dev.mongodb.db
      • dev.mongodb.db.user
      • dev.mongodb.db.password
    • For staging profile: Set the MONGODB_URI environment variable with the connection URI of your Mongo DB instance:

      • mongodb:[//[user[:password]@]host[:port]][/database]
  4. Start ZeKKe services with the following command

$ ./gradlew bootRun

Look at Mongo collections for sample data sets.

REST API

Endpoint documentation, requests and responses here

License

Copyright 2017 Daniel Pedraza-Arcega

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.