FallerTrack Backend API Documentation

A comprehensive API for elderly fall detection and navigation system.

🌟 Core Features

Real-time fall detection and emergency notifications
GPS tracking and geofencing
Turn-by-turn navigation with voice guidance
Emergency services location finder
API activity logging

🧮 Algorithms & Technologies

Navigation System

Google Routes API: Turn-by-turn navigation with Bayesian algorithm for route optimization
Haversine Formula: Calculate distances between coordinates
Point-to-Line Distance: Track user position relative to route
Bearing Calculation: Determine direction of movement

Location Services

Google Geocoding API: Convert coordinates to readable addresses
Snap-to-Road: Keep users on valid walking paths
Places API: Find emergency services nearby

Speech Generation

Google Cloud Text-to-Speech API:
- Voice: en-US-Chirp3-HD-Achernar
- High-definition neural voice
- MP3 encoding format

Fall Detection

Distance Threshold Algorithm: Monitor sudden position changes
Geofence Monitoring: Track within home radius
Emergency Response System: Prioritize nearest services

🔌 Google API Integration

1. Routes API

Compute walking routes
Real-time navigation instructions
Distance & duration calculations
Walking-optimized paths

2. Maps Platform

Geocoding API: Location name lookup
Places API: Emergency services search
Distance Matrix API: Service proximity calculation
Snap-to-Roads: Path correction

3. Cloud Services

Text-to-Speech API: Voice navigation
Cloud Storage: Audio file hosting
Cloud Functions: Serverless operations
IAM & Security: API access control

4. Firebase Services

Firestore: Real-time data storage
Authentication: Service account access
Cloud Functions: Event triggers
Analytics: Usage tracking

📚 API Reference

Base URLs:

Development: https://fallertrack-backend-bj91ghkxw-reannn22s-projects.vercel.app
Production: https://fallertrack-be.my.id

Frontend-Available Endpoints

1. Home Management

# Initialize home location
curl -X POST https://fallertrack-be.my.id/api/home \
  -H "Content-Type: application/json" \
  -d '{
    "latitude": -5.364489256035376,
    "longitude": 105.30535841177186,
    "radius": 200
  }'

# Get current home location
curl -X GET https://fallertrack-be.my.id/api/home \
  -H "Content-Type: application/json"

# Delete home location
curl -X DELETE https://fallertrack-be.my.id/api/home \
  -H "Content-Type: application/json" \
  -d '{}'

2. Location & Navigation

# Update current location
curl -X POST https://fallertrack-be.my.id/api/current-distance \
  -H "Content-Type: application/json" \
  -d '{
    "latitude": -5.3388405,
    "longitude": 105.32688089999999
  }'

# Get latest location
curl -X GET https://fallertrack-be.my.id/api/current-distance \
  -H "Content-Type: application/json"

# Get voice navigation instruction
curl -X GET https://fallertrack-be.my.id/api/speech/text-to-speech \
  -H "Content-Type: application/json"

# Generate navigation route
curl -X POST https://fallertrack-be.my.id/api/navigation \
  -H "Content-Type: application/json" \
  -d '{}'

# Get navigation duration
curl -X GET https://fallertrack-be.my.id/api/time-length \
  -H "Content-Type: application/json"

3. Emergency Features

# Report fall detection
curl -X POST https://fallertrack-be.my.id/api/fall-detection \
  -H "Content-Type: application/json" \
  -d '{
    "accelero": [9.8, 0.1, 0.1],
    "gyro": [0.1, 0.2, 0.3]
  }'

# Get fall notification status
curl -X GET https://fallertrack-be.my.id/api/fall-notification \
  -H "Content-Type: application/json"

# Search emergency services
curl -X POST https://fallertrack-be.my.id/api/sos-location \
  -H "Content-Type: application/json" \
  -d '{
    "radius": 10000
  }'

# Send emergency alert
curl -X POST https://fallertrack-be.my.id/api/alert \
  -H "Content-Type: application/json" \
  -d '{
    "sos": true
  }'

Backend-Only Endpoints

The following endpoints are for internal system use only and should not be called directly from frontend applications:

POST /api/text-to-speech - Generate text-to-speech audio
GET /api/speech/:filename - Download speech file
GET /api/log-history - Get API activity logs
DELETE /api/log-history - Clear API logs
POST /api/summarize - Generate AI summary of logs

Authentication and Headers

Currently uses Firebase Admin SDK for backend authentication. All requests should include:

Content-Type: application/json

Endpoints Overview

Home Management

POST /api/home - Initialize home location
GET /api/home - Get current home location
DELETE /api/home - Delete home location

Navigation & Tracking

POST /api/current-distance - Update current location
GET /api/current-distance - Get latest location
POST /api/navigation - Generate navigation route
GET /api/text-to-speech - Get latest voice instruction
POST /api/text-to-speech - Generate text-to-speech audio
GET /api/speech/:filename - Download speech file

Emergency Features

POST /api/fall-detection - Report fall incident
GET /api/fall-notification - Get fall details
POST /api/sos-location - Search emergency locations by custom radius
POST /api/alert - Send emergency alert
GET /api/alert - Get latest alert status

Analytics & Logs

POST /api/time-length - Calculate navigation duration
GET /api/log-history - Get all API activity logs
DELETE /api/log-history - Clear all API logs
POST /api/summarize - Get AI summary of recent logs

API Commands Summary

Home Management APIs

✅ POST /api/home - Initialize home location ✅ GET /api/home - Get current home location ✅ DELETE /api/home - Delete home location

Navigation & Tracking APIs

✅ POST /api/current-distance - Update current location ✅ GET /api/current-distance - Get latest location ✅ POST /api/navigation - Generate navigation route ✅ GET /api/text-to-speech - Get latest voice instruction ✅ POST /api/text-to-speech - Generate text-to-speech audio ✅ GET /api/speech/:filename - Download speech file

Emergency APIs

✅ POST /api/fall-detection - Report fall incident ✅ GET /api/fall-notification - Get fall details ✅ POST /api/sos-location - Search emergency locations ✅ POST /api/alert - Send emergency alert ✅ GET /api/alert - Get latest alert status

Analytics APIs

✅ POST /api/time-length - Calculate navigation duration ✅ GET /api/log-history - Get all API activity logs ✅ DELETE /api/log-history - Clear all API logs ✅ POST /api/summarize - Get AI summary of recent logs

Detailed API Documentation

1. Home Location Management

Initialize Home Location (POST)

Request:

curl -X POST https://fallertrack-be.my.id/api/home \
  -H "Content-Type: application/json" \
  -d '{
    "latitude": -5.364489256035376,
    "longitude": 105.30535841177186,
    "radius": 200
  }'

Success Response (200):

{
  "latitude": -5.339191011843987,
  "longitude": 105.32698391811313,
  "radius": 200,
  "nama": "M86G+8QH Jatimulyo, South Lampung Regency, Lampung, Indonesia",
  "time": "2025-05-10T16:13:35.009Z"
}

Error Response (400):

{
  "error": "Home location already initialized. Only one initialization is allowed."
}

Get Home Location (GET)

Request:

curl -X GET https://fallertrack-be.my.id/api/home \
  -H "Content-Type: application/json"

Success Response (200):

{
  "latitude": -5.339191011843987,
  "longitude": 105.32698391811313,
  "radius": 200,
  "nama": "M86G+8QH Jatimulyo, South Lampung Regency, Lampung, Indonesia",
  "time": "2025-05-10T16:13:53.593Z"
}

Error Response (404):

{
  "error": "No home location found",
  "time": "2025-05-10T16:13:53.593Z"
}

Delete Home Location (DELETE)

Request:

curl -X DELETE https://fallertrack-be.my.id/api/home \
  -H "Content-Type: application/json" \
  -d '{}'

Success Response (200):

{
  "message": "Home location deleted successfully",
  "time": "2025-05-10T16:14:53.593Z"
}

Error Response (500):

{
  "error": "Error deleting home location: [error details]",
  "time": "2025-05-10T16:14:53.593Z"
}

2. Navigation System

Update Current Location

Request:

curl -X POST https://fallertrack-be.my.id/api/current-distance \
  -H "Content-Type: application/json" \
  -d '{
    "latitude": -5.3388405,
    "longitude": 105.32688089999999
  }'

Response:

{
  "isWithinRange": true,
  "distance": 41,
  "unit": "meters",
  "navigationStatus": {
    "onRoute": true,
    "distanceToEnd": 0,
    "currentStep": 2,
    "totalSteps": 4,
    "instruction": "Turn right\nDestination will be on the left"
  },
  "time": "2025-05-11T10:10:31.748Z"
}

Get Voice Navigation

Request:

curl -X GET https://fallertrack-be.my.id/api/text-to-speech \
  -H "Content-Type: application/json"

Response:

{
  "text": "Turn right",
  "downloadUrl": "/api/speech/speech_1746904498149.mp3",
  "time": "2025-05-10T19:14:58.139Z",
  "meters": 36,
  "status": "on_route"
}

Generate Text to Speech

Request:

curl -X POST https://fallertrack-be.my.id/api/text-to-speech \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Turn right at the next intersection"
  }'

Response:

{
  "message": "Speech generated successfully",
  "downloadUrl": "/api/speech/speech_1747020523618.mp3",
  "publicUrl": "https://storage.googleapis.com/lansiasuara/speech_1747020523618.mp3",
  "text": "Turn right at the next intersection",
  "timestamp": "2025-05-12T03:28:48.365Z"
}

Get Speech File

Request:

curl -X GET https://fallertrack-be.my.id/api/speech/speech_1747020523618.mp3 \
  -H "Content-Type: application/json"

Response:

Binary audio file (MP3)
Content-Type: audio/mpeg
Content-Disposition: attachment; filename="speech_1747020523618.mp3"

Navigation Route Management

Generate Navigation Route (POST)

Request:

curl -X POST https://fallertrack-be.my.id/api/navigation \
  -H "Content-Type: application/json" \
  -d '{}'

Success Response (200):

{
  "routes": [
    {
      "legs": [
        {
          "steps": [
            {
              "navigationInstruction": {
                "instructions": "Head south",
                "maneuver": "TURN_SOUTH"
              },
              "startLocation": {
                "latLng": {
                  "latitude": -5.3388405,
                  "longitude": 105.32688089999999
                }
              },
              "endLocation": {
                "latLng": {
                  "latitude": -5.339191011843987,
                  "longitude": 105.32698391811313
                }
              }
            }
          ],
          "travelAdvisory": {
            "speedReadingIntervals": []
          },
          "duration": "2m",
          "distance": {
            "meters": 150
          }
        }
      ]
    }
  ],
  "geocodingResults": [],
  "time": "2025-05-11T10:10:31.748Z"
}

Error Response (404):

{
  "error": "No current location found. Please submit location first.",
  "time": "2025-05-11T10:10:31.748Z"
}

Error Response (500):

{
  "error": "Error computing navigation: HTTP error! status: 400",
  "time": "2025-05-11T10:10:31.748Z"
}

Navigation Test Cases for "Head south" Instruction

At Start Point (Case 1: TRIGGER_DISTANCE ≤ 10m):

curl -X POST https://fallertrack-be.my.id/api/current-distance \
  -H "Content-Type: application/json" \
  -d '{
    "latitude": -5.3388405,
    "longitude": 105.32688089999999
  }'

Response:

{
  "isWithinRange": true,
  "distance": 41,
  "unit": "meters",
  "navigationStatus": {
    "onRoute": true,
    "distanceToEnd": 36,
    "currentStep": 0,
    "totalSteps": 1,
    "instruction": "Head south"
  },
  "time": "2025-05-12T06:22:20.239Z",
  "instruction": "Head south"
}

On Route (Case 2: ON_ROUTE_MARGIN ≤ 20m):

curl -X POST https://fallertrack-be.my.id/api/current-distance \
  -H "Content-Type: application/json" \
  -d '{
    "latitude": -5.338997,
    "longitude": 105.326847
  }'

Response:

{
  "isWithinRange": true,
  "distance": 41,
  "unit": "meters",
  "navigationStatus": {
    "onRoute": true,
    "distanceToEnd": 18,
    "currentStep": 0,
    "totalSteps": 1,
    "instruction": "Move forward 18 meters"
  },
  "time": "2025-05-12T06:22:25.239Z",
  "instruction": "Move forward 18 meters"
}

Off Route (Distance > 20m):

curl -X POST https://fallertrack-be.my.id/api/current-distance \
  -H "Content-Type: application/json" \
  -d '{
    "latitude": -5.338997,
    "longitude": 105.327100
  }'

Response:

{
  "isWithinRange": true,
  "distance": 41,
  "unit": "meters",
  "navigationStatus": null,
  "time": "2025-05-12T06:22:30.239Z",
  "instruction": "You are not on the navigation route"
}

These test cases cover:

Starting point of navigation
Mid-route point within margin
Off-route point

3. Emergency System

Report Fall Detection (POST)

Request:

curl -X POST https://fallertrack-be.my.id/api/fall-detection \
  -H "Content-Type: application/json" \
  -d '{
    "accelero": [90.8, 0.1, 0.1],
    "gyro": [100.1, 0.2, 0.3]
  }'

Response (Fall Detected due to high acceleration and gyroscope values):

{
  "accelero": [90.8, 0.1, 0.1],
  "gyro": [100.1, 0.2, 0.3],
  "status": true,
  "message": "Elderly person has fallen",
  "timestamp": "2024-01-20T06:22:30.239Z"
}

Notes:

Fall is detected when either:
- Total acceleration exceeds 20 m/s²
- OR absolute gyroscope value exceeds 100 rad/s
accelero: Array of [x, y, z] acceleration values in m/s²
gyro: Array of [x, y, z] angular velocity values in rad/s

Get Fall Notification Status (GET)

Request:

curl -X GET https://fallertrack-be.my.id/api/fall-notification \
  -H "Content-Type: application/json"

Response:

{
  "fallStatus": {
    "detected": true,
    "timestamp": "2024-01-20T06:22:30.239Z",
    "location": {
      "latitude": -5.3388405,
      "longitude": 105.32688089999999,
      "address": "M86G+8QH Jatimulyo"
    }
  },
  "elderlyInfo": {
    "name": "Mrs. Edith Thompson",
    "age": 75,
    "medicalConditions": ["Hypertension", "Diabetes"],
    "emergencyContact": {
      "name": "John Thompson",
      "phone": "+1234567890",
      "relationship": "Son",
      "notificationStatus": {
        "call": true,
        "message": true,
        "timestamp": "2024-01-20T06:22:35.123Z"
      }
    }
  },
  "emergencyResponse": {
    "status": "active",
    "servicesNotified": [
      {
        "name": "Posko Damkar Kec. Jatiagung",
        "responding": true,
        "eta": "5 mins"
      }
    ],
    "lastUpdate": "2024-01-20T06:22:40.567Z"
  }
}

Find Emergency Services

Request:

curl -X POST https://fallertrack-be.my.id/api/sos-location \
  -H "Content-Type: application/json" \
  -d '{
    "radius": 5000
  }'

Response:

{
  "results": [
    {
      "name": "Posko Damkar Kec. Jatiagung",
      "vicinity": "M75V+W9P, Jalan P. Senopati, Jatimulyo",
      "rating": 5
    }
  ],
  "status": "OK"
}

Send Emergency Alert (POST)

Request:

curl -X POST https://fallertrack-be.my.id/api/alert \
  -H "Content-Type: application/json" \
  -d '{
    "sos": true
  }'

Success Response:

{
  "sos": true,
  "time": "2025-05-14T09:04:37.859Z"
}

Error Response (400):

{
  "error": "SOS must be boolean (true/false)",
  "time": "2025-05-14T09:04:37.859Z"
}

Get Latest Alert Status (GET)

Request:

curl -X GET https://fallertrack-be.my.id/api/alert \
  -H "Content-Type: application/json"

Success Response:

{
  "sos": true,
  "time": "2025-05-14T09:04:37.859Z"
}

Error Response (404):

{
  "error": "No alerts found",
  "time": "2025-05-14T09:04:37.859Z"
}

4. Analytics & Logging

Get Navigation Duration

Request:

curl -X POST https://fallertrack-be.my.id/api/time-length \
  -H "Content-Type: application/json" \
  -d '{}'

Response:

{
  "time_arrival": "2025-05-11T09:44:04.720Z",
  "time_end": "2025-05-11T10:10:32.108Z",
  "hour": "26 minutes 27 seconds",
  "time": "2025-05-11T10:27:07.969Z"
}

Get API Activity Logs

Request:

curl -X GET https://fallertrack-be.my.id/api/log-history \
  -H "Content-Type: application/json"

Response:

{
  "logs": [
    {
      "id": "log123",
      "endpoint": "/api/current-distance",
      "requestData": {
        "latitude": -5.3388405,
        "longitude": 105.32688089999999
      },
      "responseData": {
        "isWithinRange": true,
        "distance": 41
      },
      "timestamp": "2025-05-11T10:27:07.969Z"
    }
  ],
  "count": 1,
  "time": "2025-05-11T10:27:09.969Z"
}

Get Log Summary

Request:

curl -X POST https://fallertrack-be.my.id/api/summarize \
  -H "Content-Type: application/json" \
  -d '{
    "limit": 50,
    "startDate": "2025-05-11T00:00:00Z",
    "endDate": "2025-05-12T00:00:00Z"
  }'

Response:

{
  "text": "Log Analysis Summary:\n\n1. Activity Overview: Multiple requests to /api/current-distance endpoint showing user tracking over time.\n\n2. Navigation Status: User appears to be within range (109 meters) of target location but consistently off the navigation route.\n\n3. Pattern: 8 logged entries, with 7 showing off-route status and 1 showing successful on-route navigation with 'Head south' instruction.\n\n4. Time Range: Activities logged between May 11-12, 2025, with most recent activity at 03:43:53 UTC."
}

Get Log History with Filters

Request:

curl -X GET "https://fallertrack-be.my.id/api/log-history?endpoint=/api/current-distance&limit=2&startDate=2025-05-11T00:00:00Z&endDate=2025-05-12T00:00:00Z" \
  -H "Content-Type: application/json"

Response:

{
  "logs": [
    {
      "id": "log123",
      "endpoint": "/api/current-distance",
      "requestData": {
        "latitude": -5.3388405,
        "longitude": 105.32688089999999
      },
      "responseData": {
        "isWithinRange": true,
        "distance": 41
      },
      "timestamp": "2025-05-11T10:27:07.969Z"
    },
    {
      "id": "log124",
      "endpoint": "/api/current-distance",
      "requestData": {
        "latitude": -5.340154,
        "longitude": 105.326813
      },
      "responseData": {
        "isWithinRange": true,
        "distance": 109
      },
      "timestamp": "2025-05-11T09:27:08.969Z"
    }
  ],
  "count": 2,
  "time": "2025-05-11T10:27:09.969Z"
}

Query Parameters:

endpoint: Filter logs by specific API endpoint
limit: Maximum number of logs to return (default: 50)
startDate: Filter logs from this date (ISO format)
endDate: Filter logs until this date (ISO format)

Clear API Logs

Request:

curl -X DELETE https://fallertrack-be.my.id/api/log-history \
  -H "Content-Type: application/json" \
  -d '{}'

Response:

{
  "message": "Successfully deleted 14 log entries",
  "time": "2025-05-11T12:49:29.680Z"
}

Calculate Navigation Duration (POST/GET)

Both POST and GET methods available with same response format.

Request:

# Using POST
curl -X POST https://fallertrack-be.my.id/api/time-length

# Using GET
curl -X GET https://fallertrack-be.my.id/api/time-length \
  -H "Content-Type: application/json"

Success Response:

{
  "time_arrival": "2025-05-14T03:30:24.974Z",
  "time_end": "2025-05-14T03:30:31.631Z",
  "hour": "6 seconds",
  "time": "2025-05-14T03:30:38.147Z"
}

Error Response (404 - No Home):

{
  "error": "No home location found",
  "time": "2025-05-14T03:30:38.147Z"
}

Error Response (404 - No Navigation):

{
  "error": "Navigation not yet completed",
  "time": "2025-05-14T03:30:38.147Z"
}

Note: Time calculation starts when home location is set and ends when destination is reached.

Example Usage Flow:

Set Home Location:

curl -X POST https://fallertrack-be.my.id/api/home \
  -H "Content-Type: application/json" \
  -d '{
    "latitude": -5.364489256035376,
    "longitude": 105.30535841177186,
    "radius": 200
  }'

Response:

{
  "latitude": -5.364489256035376,
  "longitude": 105.30535841177186,
  "radius": 200,
  "nama": "J8P4+645 Harapan Jaya, Bandar Lampung City, Lampung, Indonesia",
  "time": "2025-05-14T03:30:24.974Z"
}

Update Location (Reaching Destination):

curl -X POST https://fallertrack-be.my.id/api/current-distance \
  -H "Content-Type: application/json" \
  -d '{
    "latitude": -5.36453602,
    "longitude": 105.30535929999999
}'

Response:

{
  "latitude": -5.36453602,
  "longitude": 105.30535929999999,
  "isWithinRange": true,
  "distance": 5,
  "unit": "meters",
  "navigationStatus": {
    "onRoute": true,
    "distanceToEnd": 1,
    "currentStep": 2,
    "totalSteps": 3,
    "instruction": "Turn left onto Jl. Nangka III\nDestination will be on the right"
  },
  "time": "2025-05-14T03:30:31.631Z",
  "instruction": "Turn left onto Jl. Nangka III\nDestination will be on the right"
}

Get Time Length:

curl -X GET https://fallertrack-be.my.id/api/time-length \
  -H "Content-Type: application/json"

Response:

{
  "time_arrival": "2025-05-14T03:30:24.974Z",
  "time_end": "2025-05-14T03:30:31.631Z",
  "hour": "6 seconds",
  "time": "2025-05-14T03:30:38.147Z"
}

Current Location Management

Update Current Location (POST)

Request:

curl -X POST https://fallertrack-be.my.id/api/current-distance \
  -H "Content-Type: application/json" \
  -d '{
    "latitude": -5.3388405,
    "longitude": 105.32688089999999
  }'

Success Response (200):

{
  "isWithinRange": true,
  "distance": 41,
  "unit": "meters",
  "navigationStatus": {
    "onRoute": true,
    "distanceToEnd": 150,
    "currentStep": 1,
    "totalSteps": 4,
    "instruction": "Move forward 150 meters"
  },
  "time": "2025-05-11T10:10:31.748Z",
  "instruction": "Move forward 150 meters"
}

Error Response (400):

{
  "error": "Latitude and longitude are required",
  "time": "2025-05-11T10:10:31.748Z"
}

Get Latest Location (GET)

Request:

curl -X GET https://fallertrack-be.my.id/api/current-distance \
  -H "Content-Type: application/json"

Success Response (200):

{
  "isWithinRange": true,
  "distance": 41,
  "unit": "meters",
  "time": "2025-05-11T10:10:31.748Z"
}

Error Response (404):

{
  "error": "No current location found",
  "time": "2025-05-11T10:10:31.748Z"
}

🔧 Error Handling

All errors return this format:

{
  "error": "Error description",
  "time": "ISO timestamp"
}

Common status codes:

200: Success
400: Bad Request (invalid input)
404: Resource Not Found
500: Server Error

🚀 Rate Limiting

Currently no rate limiting implemented.

📦 Dependencies

Express.js
Firebase Admin SDK
Google Cloud Text-to-Speech
Google Routes API
Google Places API
Google Cloud Storage
- Bucket: fallertrack-navigation-sound
- Type: Multi-region (US)
- Access: Public
- Used for storing navigation audio files

📦 Project Structure

🚀 Deployment

Production Environment (Cloud Run)

URL: https://fallertrack-be-755271153581.europe-west1.run.app
Region: europe-west1
Container: gcr.io/gesp-459003/fallertrack-be

Configuration:

CPU: 8 cores
Memory: 16GB
Concurrency: 100 requests
Timeout: 300 seconds
Autoscaling: Enabled (Min: 0, Max: 1)
Startup CPU boost: Enabled
Environment: Default
Port: 8080

CI/CD Pipeline:

Triggers on push to main branch
Builds Docker container
Pushes to Google Container Registry
Deploys to Cloud Run
Routes traffic automatically
Health checks enabled

Development Environment (Vercel)

URL: https://fallertrack-backend-bj91ghkxw-reannn22s-projects.vercel.app
Auto-deployment on push to development branch
Preview deployments for pull requests
Edge Network CDN enabled

Google Cloud Platform Setup

Prerequisites
- Google Cloud account
- gcloud CLI installed
- Docker installed

Build & Deploy

# Build container
docker build -t fallertrack-backend .

# Tag for Google Container Registry
docker tag fallertrack-backend gcr.io/fallertrack/fallertrack-backend

# Push to Container Registry
docker push gcr.io/fallertrack/fallertrack-backend

# Deploy to Cloud Run
gcloud run deploy fallertrack-backend \
  --image gcr.io/fallertrack/fallertrack-backend \
  --platform managed \
  --region us-west2 \
  --allow-unauthenticated

Environment Variables

Set in Cloud Run service

Required variables:

NODE_ENV=production
GOOGLE_CLOUD_PROJECT=fallertrack
GOOGLE_APPLICATION_CREDENTIALS=/credentials/service-account.json

Monitoring
- Cloud Monitoring dashboard
- Cloud Logging for application logs
- Error Reporting for exception tracking
- Cloud Trace for latency analysis

📊 Google Technologies & APIs Usage Analysis

Core Google APIs (7)

Google Routes API
- Used in: /routes/navigation-and-tracking/navigation.js
- Purpose: Computing walking routes and navigation paths
Google Maps Geocoding API
- Used in: /routes/home-management/home.js
- Purpose: Converting coordinates to human-readable addresses
Google Places API
- Used in: /routes/emergency-features/sos-location.js
- Purpose: Finding nearby emergency services
Google Cloud Text-to-Speech API
- Used in: /routes/navigation-and-tracking/text-to-speech.js
- Purpose: Converting navigation instructions to voice
Google Cloud Storage API
- Used in: /routes/navigation-and-tracking/text-to-speech.js
- Purpose: Storing and serving audio files
- Bucket: 'fallertrack-navigation-sound'
Google Cloud IAM API
- Used in: /config/getAccessToken.js
- Purpose: Managing service account authentication
Google AI Gemini API
- Used in: /routes/analytics-and-logs/summarize.js
- Purpose: Generating AI summaries of API logs

Firebase Services (4)

Firebase Admin SDK
- Used in: /config/firebase.js
- Purpose: Main Firebase initialization and management
Firestore Database
- Used across multiple files
- Collections used:
  - homes
  - current_locations
  - navigation_data
  - speech_files
  - latest_tts
  - fall_notifications
  - api_logs
  - log_summaries
Firebase Authentication
- Used for service account authentication
- Credentials in: /credentials/ folder
Firebase Cloud Storage
- Used for backup audio file storage

Total Google Technologies Used: 11

7 Core Google APIs
4 Firebase Services

Authentication Methods

Service Account Authentication
- Used for: Google Cloud & Firebase services
- Location: /credentials/
- Files:
  - gesp-459003-aabf1ee34b71.json (Google Cloud)
  - fallertrack-database-firebase-adminsdk-fbsvc-5ed10a17ab.json (Firebase)

API Keys Used

Google Maps Platform API Key
- Used for: Routes, Geocoding, Places APIs
- Key: AIzaSyCXqDSiV34e_jSIURIbxavQ2sf6ESSG7xc
Google AI API Key
- Used for: Gemini API
- Key: AIzaSyA1A9io37eems1avvVRUC6RhD2w91CQ

Note: All service accounts and API keys shown in this documentation should be treated as sensitive information and should be properly secured in production environments.

Name		Name	Last commit message	Last commit date
Latest commit History 9 Commits
.vercel		.vercel
.vscode		.vscode
config		config
credentials		credentials
node_modules		node_modules
src		src
tests		tests
Dockerfile		Dockerfile
README.md		README.md
REQUIREMENT.md		REQUIREMENT.md
cloudbuild.yaml		cloudbuild.yaml
index.js		index.js
package-lock.json		package-lock.json
package.json		package.json
vercel.json		vercel.json

Reannn22/fallertrack-be

Folders and files

Latest commit

History

Repository files navigation

FallerTrack Backend API Documentation

🌟 Core Features

🧮 Algorithms & Technologies

Navigation System

Location Services

Speech Generation

Fall Detection

🔌 Google API Integration

1. Routes API

2. Maps Platform

3. Cloud Services

4. Firebase Services

📚 API Reference

Frontend-Available Endpoints

1. Home Management

2. Location & Navigation

3. Emergency Features

Backend-Only Endpoints

Authentication and Headers

Endpoints Overview

Home Management

Navigation & Tracking

Emergency Features

Analytics & Logs

API Commands Summary

Home Management APIs

Navigation & Tracking APIs

Emergency APIs

Analytics APIs

Detailed API Documentation

1. Home Location Management

2. Navigation System

Navigation Route Management

3. Emergency System

4. Analytics & Logging

Current Location Management

🔧 Error Handling

🚀 Rate Limiting

📦 Dependencies

📦 Project Structure

🚀 Deployment

Production Environment (Cloud Run)

Development Environment (Vercel)

Google Cloud Platform Setup

📊 Google Technologies & APIs Usage Analysis

Core Google APIs (7)

Firebase Services (4)

Total Google Technologies Used: 11

Authentication Methods

API Keys Used

About

Topics

Resources

Uh oh!

Stars

Watchers

Forks

Releases 1

Packages 0

Languages

Packages