{"id":24225698,"url":"https://github.com/deliprofesor/joblocationmapper","last_synced_at":"2026-05-14T07:35:25.704Z","repository":{"id":269750644,"uuid":"908354782","full_name":"deliprofesor/JobLocationMapper","owner":"deliprofesor","description":"JobLocationMapper is a Python tool that visualizes job listings on an interactive map. It uses city and state data to place job markers accurately and color-codes them by occupation (Software, Marketing, Design). The map clusters markers for better organization, and users can click on them to view job details.","archived":false,"fork":false,"pushed_at":"2024-12-25T21:40:45.000Z","size":460,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-04T04:13:14.418Z","etag":null,"topics":["clustrered-markers","data-analysis","data-visualization","folium","geocoding","geographical-visualization","interactive-map","job-listings","map-visualization","pandas","python"],"latest_commit_sha":null,"homepage":"","language":"HTML","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/deliprofesor.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}},"created_at":"2024-12-25T20:56:51.000Z","updated_at":"2024-12-29T21:40:11.000Z","dependencies_parsed_at":"2024-12-25T21:24:11.713Z","dependency_job_id":"706bde4e-f11e-4753-aac0-a32c42318c15","html_url":"https://github.com/deliprofesor/JobLocationMapper","commit_stats":null,"previous_names":["deliprofesor/joblocationmapper"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/deliprofesor/JobLocationMapper","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deliprofesor%2FJobLocationMapper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deliprofesor%2FJobLocationMapper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deliprofesor%2FJobLocationMapper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deliprofesor%2FJobLocationMapper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/deliprofesor","download_url":"https://codeload.github.com/deliprofesor/JobLocationMapper/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deliprofesor%2FJobLocationMapper/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33015535,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-13T13:14:54.681Z","status":"online","status_checked_at":"2026-05-14T02:00:06.663Z","response_time":57,"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":["clustrered-markers","data-analysis","data-visualization","folium","geocoding","geographical-visualization","interactive-map","job-listings","map-visualization","pandas","python"],"created_at":"2025-01-14T08:15:34.467Z","updated_at":"2026-05-14T07:35:25.690Z","avatar_url":"https://github.com/deliprofesor.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# JobLocationMapper\n\n![india2](https://github.com/user-attachments/assets/38c99525-f288-457b-9c5c-2c50f70fd3bb)\n\n**JobLocationMapper** is a Python project that visualizes the geographical locations of job listings on a map. This tool visualizes job opportunities by mapping city and state information on an interactive map, making it more accessible and visually appealing. Additionally, each job listing is color-coded based on its occupation category, allowing users to easily distinguish between different fields of job opportunities.\n\n## Features\n\n- **Geographical Location Visualization**  \n  Job listings are visualized on the map based on their city and state information. Each job listing is placed on the map at the correct geographical location.\n\n- **Color-Coded Markers by Job Category**  \n  Job listings are color-coded according to their occupation category:\n  - **Software** jobs are marked with `blue`\n  - **Marketing** jobs are marked with `green`\n  - **Design** jobs are marked with `red`\n  \n- **Geocoding**  \n  City and state information is converted into geographical coordinates (latitude, longitude) using a geocoding service, and placed on the map at the correct location.\n\n- **Clustered Markers**  \n  Job listings that appear in the same location are grouped together on the map, offering a more organized and cleaner appearance.\n\n- **Interactive Map**  \n  Users can click on markers on the map to view details such as job titles and location information.\n\n## Requirements\n\nTo run this project, you'll need the following Python libraries:\n\n- `pandas` : For data manipulation and processing\n- `folium` : For map visualization\n- `geopy` : For geocoding (location resolution)\n\n### Install Dependencies\n\nTo install all the required Python libraries, run the following command:\n\npip install -r requirements.txt\n\n## Running the Project\n\nClone the repository from GitHub:\n\n- **git clone https://github.com/deliprofesor/JobLocationMapper.git**\n\nAfter cloning, install the necessary dependencies:\n\n- **pip install -r requirements.txt**\n\nPrepare your job_dataset.csv file:\n\nThis file should contain necessary information about job listings, such as city, state, job titles, and other relevant data.\n\nRun the job_locator.py script to generate the map:\n\n- **python job_locator.py**\n\nThe map will be saved as india_job_location_map_with_categories.html. Open this file in a web browser to start exploring the job listings on the map.\n\n## Usage\nThe project visualizes job listings on the map and categorizes them by profession:\n\nOccupation Categories\nJob listings are color-coded based on their occupation categories such as Software, Marketing, and Design. These colors help users easily identify different types of job opportunities:\n\nSoftware (Developer) jobs are marked in blue\nMarketing jobs are marked in green\nDesign jobs are marked in red\nJob Listing Information\nClicking on a job listing on the map will display the job title and location information. Users can learn more about each job opportunity as they explore the map.\n\n## Map Visualization\nThe map is designed to visualize job listings in India, but it can easily be adapted to display listings from other geographical regions.\n\n## Contribution\nIf you'd like to contribute to this project, follow these steps:\n\nFork this repository on GitHub.\nAdd a new feature or fix a bug.\nSubmit a pull request with your changes.\nIf you have any questions, please feel free to reach out via the Issues section.\n\n## License\nThis project is licensed under the MIT License. See the LICENSE file for more details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeliprofesor%2Fjoblocationmapper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdeliprofesor%2Fjoblocationmapper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeliprofesor%2Fjoblocationmapper/lists"}