{"id":21368076,"url":"https://github.com/microapps/store-locator","last_synced_at":"2026-02-25T20:32:33.994Z","repository":{"id":39495960,"uuid":"111677894","full_name":"microapps/store-locator","owner":"microapps","description":"A simple module for displaying a google map with list of stores on it","archived":false,"fork":false,"pushed_at":"2022-07-20T19:52:24.000Z","size":3870,"stargazers_count":32,"open_issues_count":21,"forks_count":15,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-07-13T05:39:29.566Z","etag":null,"topics":["google-maps-api","location"],"latest_commit_sha":null,"homepage":"https://microapps.github.io/store-locator/","language":"JavaScript","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/microapps.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}},"created_at":"2017-11-22T11:50:51.000Z","updated_at":"2025-02-26T18:55:08.000Z","dependencies_parsed_at":"2022-08-09T15:01:32.610Z","dependency_job_id":null,"html_url":"https://github.com/microapps/store-locator","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/microapps/store-locator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microapps%2Fstore-locator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microapps%2Fstore-locator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microapps%2Fstore-locator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microapps%2Fstore-locator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/microapps","download_url":"https://codeload.github.com/microapps/store-locator/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microapps%2Fstore-locator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29838087,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-25T19:08:47.527Z","status":"ssl_error","status_checked_at":"2026-02-25T18:59:04.705Z","response_time":61,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["google-maps-api","location"],"created_at":"2024-11-22T07:22:35.803Z","updated_at":"2026-02-25T20:32:33.974Z","avatar_url":"https://github.com/microapps.png","language":"JavaScript","readme":"# Store Locator\n\nA drop-in module for a website that shows a google map with list of stores in the sidebar. \n\n![Gif](/demo.gif?raw=true)\n\n[Live Demo](https://microapps.github.io/store-locator/)\n\n## Features\n- draws all stores on a map\n- shows a list of stores in the side bar providing map navigation\n- determines user location and sorts the stores, showing nearest first\n- shows a distance to each store form a given location (walking or driving)\n- allows to search for nearest store to a given location\n- provides a direction link to each store\n- allows to set custom markers\n\n## CDN\n\n```html\n\u003clink rel=\"stylesheet\" href=\"https://cdn.jsdelivr.net/gh/microapps/store-locator@latest/dist/store-locator.css\"\u003e\n\u003cscript src=\"https://cdn.jsdelivr.net/gh/microapps/store-locator@latest/dist/store-locator.js\"\u003e\u003c/script\u003e\n```\n\n## Usage\n\n- Include [store-locator.js](/dist/store-locator.js?raw=true) and [store-locator.css](/dist/store-locator.css?raw=true) on your page\n- Add a container where you want the map to be rendered\n- Initialize the script\n\n\n```html\n\u003cdiv id=\"my-store-locator\"\u003e\n      \u003c!-- map will be rendered here--\u003e\n\u003c/div\u003e\n\u003cscript src=\"store-locator.js\"\u003e\u003c/script\u003e\n\u003cscript\u003e\n  storeLocator({\n    container: 'store-locator',\n    apiKey: 'GOOGLE_MAPS_API_KEY',\n    center: {lat: 42.382387, lng: -71.116648},\n    travelMode: 'WALKING',\n    unitSystem: 'METRIC',\n    storeMarkerIcon: './storeIcon.png',\n    homeMarkerIcon: './homeIcon.png',\n    markerIconSize: [40, 62],\n    limit: 1,\n    searchHint: \"Not all stores sell our whole range so if you're looking for a specific product we recommend you call ahead.\",\n    loadStores: function(location) {\n      // location: {lat, lng}\n      // you can load your stores based on location dynamically\n      return Promise.resolve([\n        {\n          name: 'PAEZ FLAGSHIP STORE EL BORN',\n          address: 'Carrer de les Caputxes, 2, 08003 Barcelona, Spain',\n          location: {lat: 41.3833695, lng: 2.1814855999999736},\n          website: 'http://microapps.com'\n        },\n        {\n          name: 'PAEZ STORE CC. Maremagnum',\n          address: \"Moll d'Espanya, 5, 08039 Barcelona, Spain\",\n          location: {lat: 41.3752, lng: 2.18286999999998}\n        }\n      ])\n    }\n  })\n\u003c/script\u003e\n```\n\n## Configuration options\n\n| Option | Description | Default |\n| --- | --- | --- |\n| `container` | id of the element where the map will be rendered\n| `stores` | an array of stores to render on a map `[{name, address, location: {lat, lng}, website}]`\n| `loadStores` | a function that returns an array of stores directly or a Promise. It accepts a location `{lat, lng}` param and is called every time location autocomplete is triggered\n| `zoom` | initial map zoom | 6\n| `center` | initial map center | `{lat: 39.6433995, lng: -6.4396778}`\n| `storeMarkerIcon` | custom store marker icon\n| `homeMarkerIcon` | custom current location marker icon\n| `markerIconSize` | an array of [x, y] to scale marker icon\n| `searchHint` | text rendered after a search input\n| `travelMode` | the mode used to calculate distance `WALKING` or `DRIVING` | `DRIVING`\n| `unitSystem` | used to show distance `METRIC` or `IMPERIAL` | `METRIC`\n| `limit` | shows only first n closest results to the location | 10\n| `homeLocationHint` |  text that appears in an info window of home location marker | Current location\n| `farAwayMarkerOpacity` | an opacity of a marker that is too far away (determined by `limit`) | 0.6\n| `fullWidthMap` | changes the appearance to make the map full width and store list as an overlay on top of it\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicroapps%2Fstore-locator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmicroapps%2Fstore-locator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicroapps%2Fstore-locator/lists"}