Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/gsans/amplify-london-cycles

LondonCycles. Find available rental Santander Cycles in London using open data via GraphQL with AWS Amplify and Angular
https://github.com/gsans/amplify-london-cycles

amazon-elasticsearch aws-amplify aws-appsync geolocation graphql mapbox mapbox-gl-js open-data

Last synced: 4 months ago
JSON representation

LondonCycles. Find available rental Santander Cycles in London using open data via GraphQL with AWS Amplify and Angular

Host: GitHub
URL: https://github.com/gsans/amplify-london-cycles
Owner: gsans
Created: 2019-12-05T10:59:02.000Z (about 5 years ago)
Default Branch: master
Last Pushed: 2023-05-07T11:18:19.000Z (almost 2 years ago)
Last Synced: 2023-08-15T07:10:50.896Z (over 1 year ago)
Topics: amazon-elasticsearch, aws-amplify, aws-appsync, geolocation, graphql, mapbox, mapbox-gl-js, open-data
Language: TypeScript
Homepage:
Size: 1.51 MB
Stars: 11
Watchers: 3
Forks: 5
Open Issues: 7
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

# LondonCycles. Find available rental Santander Cycles in London using open data via GraphQL with AWS Amplify and Angular

This app shows how to integrate **Amazon Elasticsearch** with **AWS Amplify**, **AWS AppSync** to query Santander Cycles open data via **GraphQL** and create a client using **Mapbox** and **Angular** to run GraphQL distance-aware searches.

Features included:
- Display bike stations and allow querying a single bike station to see how many free bikes it has available at the moment using Santander Cycles open data via GraphQL.
- Find the nearest bike stations around a given location and how many bikes are available for each at that time through a single GraphQL API.
- Query using users current location (Geolocation Web API) or map coordinates.
- Allow users to locate points of interest, addresses or places using a text based search integrating the Mapbox Geocoding API.
- Relocate map to a default location, at Piccadilly Circus, for demo purposes.

Distance-aware searches usage example:
```
query NearbyBikes {
nearbyBikeStations(location: {
lat: 51.510239,
lon: -0.134167
}, m: 500, limit: 10) {
total
nextToken
items {
id
name
location {
lat
lon
}
bikes
}
}
}
```

## Deploy with the AWS Amplify Console

The AWS Amplify Console provides hosting for fullstack serverless web apps. [Learn more](https://console.amplify.aws). Deploy this app to your AWS account with a single click:

[![amplifybutton](https://oneclick.amplifyapp.com/button.svg)](https://console.aws.amazon.com/amplify/home#/deploy?repo=https://github.com/gsans/amplify-london-cycles)

>**Important**: enabling searches in your application will incur in costs. As part of the AWS Free Tier you are able to use searches for at least 30 days and up to 1GB data transfer with no cost.

The Amplify Console will fork this repo in your GitHub account, and then build and deploy your backend and frontend in a single workflow. Your app will be available at `https://master.APPID.amplifyapp.com`.

## Run locally with the Amplify CLI

1. Install and configure the Amplify CLI

```
npm install -g @aws-amplify/cli
amplify configure
```

2. Install and configure the Amplify CLI

```
amplify init --app https://github.com/gsans/amplify-london-cycles
```

>The init command clones the GitHub repo, initializes the CLI, creates a ‘sampledev’ environment in CLI, detects and adds categories, provisions the backend, pushes the changes to the cloud, and starts the app.

3. Provisioning the frontend and backend

Once the process is complete, the CLI will automatically open the app in your default browser.

# Elastic Search Setup
```
# Create the index if it does not exist
PUT /bikepoint
```
Result
```
{
"acknowledged": true,
"shards_acknowledged": true,
"index": "bikepoint"
}
```

```
# Tell Elasticsearch that the location field is a geo_point
PUT /bikepoint/_mapping/doc
{
"properties": {
"location": {
"type": "geo_point"
}
}
}
```
Result
```
{
"acknowledged": true
}
```

Create BikePoint
```
mutation addBikePoint {
m0: createBikePoint(input: { id: "BikePoints_1" name: "River Street , Clerkenwell" location: { lat: 51.529163 lon: -0.10997 } }) { id }
}
```

Query
```
query nearByBikes {
nearbyBikeStations(location:{
lon: -0.134167
lat: 51.510239
} km: 3) {
items {
id name location { lon lat }
}
}
}
```

Searches
```
GET /bikepoint/_search
{
"query": { "match_all": {} }
}

GET /bikepoint/doc/_search
{
"query": { "match_all": {} }
}
```

Search Radius around location
```
GET /bikepoint/doc/_search
{
"from" : 0,
"size" : 20,
"query": {
"bool" : {
"must" : {
"match_all" : {}
},
"filter" : {
"geo_distance" : {
"distance" : "1km",
"location" : {
"lon": -0.134167,
"lat": 51.510239
}
}
}
}
}
}
```