https://github.com/fkanout/gps-to-address-microservice

This is a simple microservices developed with Seneca microservices toolkit. Its aim is to get the user full address from his GPS coordinates. It can be used under service-to-service or user-to-service patterns.
https://github.com/fkanout/gps-to-address-microservice

api http microservice seneca-service

Last synced: about 1 month ago
JSON representation

This is a simple microservices developed with Seneca microservices toolkit. Its aim is to get the user full address from his GPS coordinates. It can be used under service-to-service or user-to-service patterns.

• Host: GitHub
• URL: https://github.com/fkanout/gps-to-address-microservice
• Owner: fkanout
• License: mit
• Created: 2017-08-30T13:33:37.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2019-01-03T17:00:56.000Z (about 6 years ago)
• Last Synced: 2024-11-18T05:21:05.471Z (3 months ago)
• Topics: api, http, microservice, seneca-service
• Language: JavaScript
• Size: 3.1 MB
• Stars: 3
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: readme.md
  • License: LICENSE

Awesome Lists containing this project

README

        

# Obtain full address from GPS coordinates, Micro-Service.

*Part of NotifyDriver project's back-end*

This is a simple microservice developed with [Seneca](http://senecajs.org/) microservices toolkit.

Its aim is to get the user full address from his GPS coordinates.

It can be used under *service-to-service*  or *user-to-service* patterns. To communicate with it, I used HTTP as transport (pipeline).

![alt text](https://raw.githubusercontent.com/fkanout/GPS-to-address-MicroService/master/demo/demo.gif)

# How to use

`git clone https://github.com/fkanout/GPS-to-address-MicroService`

`cd GPS-to-address-MicroService`

`npm install`

*for developement*

`node bin/app.js` 

*for production*:

use the `IIFE (Immediately Invoked Function Expression)`directly from `lib/index.js`

*By default the service is available on:*

`http://localhost:8888/geolocation`

# Example

`curl -d '{"task": "geolocation", "gps": {"lat":48.8529806, "log":2.3273854 }}' http://localhost:8888/geolocation`

- HTTP method: `POST`

- body: `{"task": "geolocation", "gps": {"lat":` **LAT_VALUE**`, "log": `**LOG_VALUE**` }}`

# ENV variables

`SERVICE_PORT` *service listing port*

`SERVICE_PATH` *service's route*

`ADDRESS_API` *The URL of the external API to resolve address, e.g: Google API*

*Keyless access to Google Maps Platform is deprecated. Please use an API key with all your API calls to avoid service interruption. For further details please refer to http://g.co/dev/maps-no-account"*

# Who am I

[Website](https://www.kanout.com)

[Linkedin](https://www.linkedin.com/in/faisalkanout/)