Skip to content

Ms-Irungu/Pata-Places

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

27 Commits
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Pata-Places

πŸš€ Pata Places is a Single Page Application (SPA) that helps users find Points of Interest (POIs) near them in Kenya. πŸ—ΊοΈ Using the OpenStreetMap Overpass API, users can search for locations πŸ”, use GPS πŸ“ to find nearby places, and view results on an interactive map πŸ—ΊοΈ.

πŸš€ Overview

Pata Places is a Single Page Application (SPA) designed to help users find Points of Interest (POIs) near them in Kenya. Using the OpenStreetMap Overpass API, users can search for locations, use GPS to find nearby places, and view results on an interactive map.

✨ Features

  • πŸ” Search for Places – Users can enter a location or use GPS to find nearby POIs.
  • πŸ“Œ POI Categories – Select categories like hospitals, schools, restaurants, etc.
  • πŸ—ΊοΈ Interactive Map – Displays POIs on a Leaflet.js-powered map.
  • πŸŒ— Light/Dark Mode – Toggle between themes for a personalized experience.
  • ℹ️ POI Details – View information about each POI in a card format.

πŸ”— API Used

We will use the OpenStreetMap Overpass API, which allows querying geographic data based on specific locations and categories. It is free and provides detailed, real-time geographic data.

πŸ—οΈ Project Structure

/src
 β”œβ”€β”€ /components
 β”‚   β”œβ”€β”€ Navbar.jsx
 β”‚   β”œβ”€β”€ SearchBar.jsx
 β”‚   β”œβ”€β”€ POICategories.jsx
 β”‚   β”œβ”€β”€ MapDisplay.jsx
 β”‚   β”œβ”€β”€ POIList.jsx
 β”‚
 β”œβ”€β”€ /pages
 β”‚   β”œβ”€β”€ Home.jsx
 β”‚
 β”œβ”€β”€ /utils
 β”‚   β”œβ”€β”€ fetchPOIs.js
 β”‚
 β”œβ”€β”€ App.jsx
 β”œβ”€β”€ main.jsx

πŸ“‚ Explanation of Key Files

  • Home.jsx – The main page where all components are rendered.
  • fetchPOIs.js – A utility function to fetch POIs from the Overpass API.
  • App.jsx – The main component that sets up routing and global state.
  • main.jsx – The entry point of the React application.

πŸ› οΈ Tech Stack

  • Frontend: React.js, Tailwind CSS, Leaflet.js
  • State Management: useState & useEffect
  • API: OpenStreetMap Overpass API
  • Deployment: Vercel or Netlify

Made with ❀️ by Valentine Irungu

About

πŸš€ Pata Places is a Single Page Application (SPA) that helps users find Points of Interest (POIs) near them in Kenya. πŸ—ΊοΈ Using the OpenStreetMap Overpass API, users can search for locations πŸ”, use GPS πŸ“ to find nearby places, and view results on an interactive map πŸ—ΊοΈ.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors