robertdavis1 / amplify-london-cycles

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

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. Deploy this app to your AWS account with a single click:

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
          }
        }
      }
    }
  }
}