{"id":29289413,"url":"https://github.com/zyferlink/bite-map-android-app","last_synced_at":"2025-09-11T02:37:49.910Z","repository":{"id":277126413,"uuid":"930997384","full_name":"zyferlink/bite-map-android-app","owner":"zyferlink","description":"Experimental, learning-focused project. BiteMap is an Android app that helps you find nearby restaurants and navigate to them easily. Tap to see nearby options, get directions via Google Maps, or search for specific places. 🛠️📚🗺️","archived":false,"fork":false,"pushed_at":"2025-02-19T20:34:39.000Z","size":2356,"stargazers_count":22,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-06T04:51:34.188Z","etag":null,"topics":["android","maps-api","places-api"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zyferlink.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-02-11T14:58:58.000Z","updated_at":"2025-04-25T00:25:52.000Z","dependencies_parsed_at":"2025-02-12T09:48:09.791Z","dependency_job_id":"8511b328-2f01-44be-a7ad-fe00fabb2925","html_url":"https://github.com/zyferlink/bite-map-android-app","commit_stats":null,"previous_names":["novalogics/ride-ease-android-app","zyferlink/bite-map-android-app","novalogics/bite-map-android-app"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/zyferlink/bite-map-android-app","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zyferlink%2Fbite-map-android-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zyferlink%2Fbite-map-android-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zyferlink%2Fbite-map-android-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zyferlink%2Fbite-map-android-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zyferlink","download_url":"https://codeload.github.com/zyferlink/bite-map-android-app/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zyferlink%2Fbite-map-android-app/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274568473,"owners_count":25309281,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-11T02:00:13.660Z","response_time":74,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","maps-api","places-api"],"created_at":"2025-07-06T04:36:28.626Z","updated_at":"2025-09-11T02:37:49.905Z","avatar_url":"https://github.com/zyferlink.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\" \u003e  \nBiteMap  \u003cbr\u003e ♨ [ ᴀɴᴅʀᴏɪᴅ  ᴘʀᴏᴊᴇᴄᴛ ] ♨\n\u003c/h1\u003e\n\n\u003cbr/\u003e\n\n\u003cp align=\"center\"\u003e\n🛠️📚 \u003cstrong\u003eThis is a learning focused project to explore Kotlin's functionality and modular architecture in app development\u003c/strong\u003e 🛠️📚\n\u003c/p\u003e\n\n\u003cbr/\u003e\n\n## ɪ  ⁃  ᴘʀᴏᴊᴇᴄᴛ ɪɴꜰᴏ\n\nBiteMap is an Android app designed to simplify your dining experience by helping you discover nearby restaurants and navigate to them effortlessly. With just a tap, the app displays a list of nearby eateries, and selecting one opens Google Maps to guide you directly to your chosen destination. The app also includes a powerful search feature to find specific places with ease.\n\n\u003e [!Note]\n\u003e **This app is intended for educational purposes, showcasing the capabilities of the Kotlin programming language. It provides insights into how large-scale, complex applications are structured, particularly through modular architecture. In this project, separate packages are used to represent modules, offering a clear example of how to organize and categorize components in a scalable application.**\n#\n\n\u003cdiv align=\"center\"\u003e\n\n[![Platform](https://img.shields.io/badge/-Android%20|%20Platform-2E8B57?logo=android\u0026logoColor=white\u0026style=for-the-badge)](#)\n[![Language](https://img.shields.io/badge/-Kotlin%20|%20Language-%2307405e?logo=kotlin\u0026logoColor=white\u0026style=for-the-badge)](#)\n\n[![MIN API LEVEL](https://img.shields.io/badge/-MIN%20SDK%20|%2024-1C1E24?logo=planetscale\u0026logoColor=00C7B7\u0026style=for-the-badge)](#)\n[![Target Version](https://img.shields.io/badge/-Target%20SDK%20|%2034-1C1E24?logo=planetscale\u0026logoColor=00C7B7\u0026style=for-the-badge)](#)\n[![Architecture](https://img.shields.io/badge/-Architecture%20|%20MVI-1C1E24?logo=planetscale\u0026logoColor=00C7B7\u0026style=for-the-badge)](#)\n[![UI](https://img.shields.io/badge/-UI%20|%20Jetpack%20Compose-1C1E24?logo=planetscale\u0026logoColor=00C7B7\u0026style=for-the-badge)](#)\n[![License: MIT](https://img.shields.io/badge/-LICENSE%20|%20MIT-1C1E24?logo=maas\u0026logoColor=00C7B7\u0026style=for-the-badge)](./LICENSE)\n\n\u003c/div\u003e\n\n\u003cbr/\u003e\n\u003cbr/\u003e\n\n\u003cp align=\"center\"\u003e\n\u003cimg \n  src=\"./_archive/screenshot/screenshot-loading.png\" \n   width=\"210\" height=\"460\" \n  /\u003e\n\u003cimg \n  src=\"./_archive/screenshot/screenshot-home.png\" \n  width=\"210\" height=\"460\" \n  /\u003e\n\u003cimg\n    src=\"./_archive/screenshot/screenshot-search-blank.png\"\n    width=\"210\" height=\"460\"\n  /\u003e\n\u003cimg\n    src=\"./_archive/screenshot/screenshot-search-places.png\"\n    width=\"210\" height=\"460\"\n  /\u003e\n\u003cimg\n    src=\"./_archive/screenshot/screenshot-location-directions.jpg\"\n    width=\"210\" height=\"460\"\n  /\u003e\n\u003c/p\u003e\n\n---\n\n### ⭓ Features\n\n- **Nearby Restaurants**: Instantly discover all nearby restaurants with just a tap.\n- **Google Maps Integration**: Get directions to your chosen restaurant directly through Google Maps.\n- **Search Feature**: Easily search for specific restaurants or cuisines.\n- **User-Friendly Design**: Simple and intuitive interface for seamless navigation.\n\n##\n### ⭓ Requirements\n- Android 7.0 and Above\n- Min SDK version 24\n\n##\n### ⭓ Permissions\n- Location\n- Internet\n\n\u003cbr\u003e  \n\n---\n\n\n## ⭓ Important Note ⭓\n\nTo run this project, you need a **Google Maps API key**.\nFollow the steps below to retrieve your API key and add it to your `local.properties` file. Without this, the app will not function properly.\n\n\n---\n\n### ⭓ Steps to Retrieve Google Maps API Key\n\n1. **Go to Google Cloud Console**:\n    - Visit Google Cloud Console :  \n    ```https://console.cloud.google.com/```\n   \n    - Sign in with your Google account.\n\n2. **Create a New Project (if needed)**:\n    - Click on the project dropdown at the top of the page.\n    - Select \"New Project\" and follow the prompts to create a new project.\n\n3. **Enable Required APIs**:\n    - In the left sidebar, go to **APIs \u0026 Services \u003e Library**.\n    - Search for and enable the following APIs:\n        - **Maps SDK for Android**\n        - **Places API** (for restaurant search functionality)\n\n4. **Create API Key**:\n    - In the left sidebar, go to **APIs \u0026 Services \u003e Credentials**.\n    - Click **Create Credentials** and select **API Key**.\n    - Copy the generated API key.\n\n5. **Restrict API Key (Optional but Recommended)**:\n    - Click on the API key you just created.\n    - Under **Application restrictions**, select **Android apps**.\n    - Add your app’s package name and SHA-1 fingerprint (found in your app’s `build.gradle` or via the `keytool` command).\n    - Under **API restrictions**, restrict the key to **Maps SDK for Android** and **Places API**.\n\n---\n\n### ⭓ Steps to Add API Key to `local.properties`\n\n1. **Open Your Project**:\n    - Open your Android project in Android Studio.\n\n2. **Locate `local.properties`**:\n    - In the project view, find the `local.properties` file (usually in the root directory).\n\n3. **Add the API Key**:\n    - Add the following line to the file:\n      ```properties  \n      PLACES_API_KEY=YOUR_API_KEY_HERE  \n      ```  \n    - Replace `YOUR_API_KEY_HERE` with the API key you copied earlier.\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"./_archive/screenshot/screenshot-local-properties.png\" width=\"720\"/\u003e\n\u003c/div\u003e\n\n\u003cbr/\u003e\n\nThat's all, \nonce the API key is added, the app will work as expected.\n\n\u003cbr/\u003e\n\n#\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzyferlink%2Fbite-map-android-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzyferlink%2Fbite-map-android-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzyferlink%2Fbite-map-android-app/lists"}