{"id":27874173,"url":"https://github.com/sergeysolovev/ymaps","last_synced_at":"2025-10-07T20:28:08.667Z","repository":{"id":23933392,"uuid":"100179180","full_name":"sergeysolovev/ymaps","owner":"sergeysolovev","description":":round_pushpin:Yandex Maps on-demand promise-based widget loader","archived":false,"fork":false,"pushed_at":"2023-01-03T18:28:26.000Z","size":1157,"stargazers_count":27,"open_issues_count":13,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-25T16:21:51.084Z","etag":null,"topics":["es6","javascript","promise","yandex-api","yandex-maps"],"latest_commit_sha":null,"homepage":"","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/sergeysolovev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-08-13T13:39:58.000Z","updated_at":"2024-01-08T10:50:42.000Z","dependencies_parsed_at":"2023-01-14T07:00:34.674Z","dependency_job_id":null,"html_url":"https://github.com/sergeysolovev/ymaps","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sergeysolovev%2Fymaps","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sergeysolovev%2Fymaps/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sergeysolovev%2Fymaps/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sergeysolovev%2Fymaps/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sergeysolovev","download_url":"https://codeload.github.com/sergeysolovev/ymaps/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252423165,"owners_count":21745553,"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","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":["es6","javascript","promise","yandex-api","yandex-maps"],"created_at":"2025-05-05T01:31:25.911Z","updated_at":"2025-10-07T20:28:03.598Z","avatar_url":"https://github.com/sergeysolovev.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ymaps\n\n[![npm version](https://img.shields.io/npm/v/ymaps.svg?style=flat)](https://npmjs.org/package/ymaps)\n[![CircleCI](https://circleci.com/gh/sergeysolovev/ymaps.svg?style=shield)](https://circleci.com/gh/sergeysolovev/ymaps)\n\nYandex Maps on-demand promise-based widget loader.\n\n- Appends [Yandex Maps API](https://tech.yandex.com/maps/jsapi/) script to the\n  document body.\n- Returns a promise which resolves as soon as the script has loaded and the\n  [API is ready](https://tech.yandex.com/maps/doc/jsapi/2.1/dg/concepts/load-docpage/#api-ready).\n\nThis way the widget doesn’t load until it’s needed to decrease page load time.\n\n[View on CodeSandbox →](https://codesandbox.io/s/ymaps-v1cb6)\n\n## Quickstart\n\nInstall from the command line:\n\n```shell\nnpm install ymaps\n```\n\nUse in your code to load the widget:\n\n```javascript\nimport ymaps from 'ymaps';\n\nymaps\n  .load()\n  .then(maps =\u003e {\n    const map = new maps.Map('your-map-container', {\n      center: [-8.369326, 115.166023],\n      zoom: 7\n    });\n  })\n  .catch(error =\u003e console.log('Failed to load Yandex Maps', error));\n```\n\nTo use another language simply pass a valid `src` to `ymaps.load`\n\n```javascript\nymaps.load('https://api-maps.yandex.ru/2.1/?lang=en_US').then(maps =\u003e {\n  /* ... */\n});\n```\n\nThe information about other options is available in the\n[API docs](https://tech.yandex.com/maps/doc/jsapi/2.1/dg/concepts/load-docpage/).\nPlease check out [known issues](#known-issues) to see not supported options.\n\n## Running the tests\n\n```shell\nnpm test\n```\n\n## Known issues\n\n- `load` parameter, except when it's set to `package.full` is causing an error\n  \"TypeError: s is not a constructor\". To reproduce, try to pass\n  `\"//api-maps.yandex.ru/2.1/?lang=en_US\u0026load=Map\"` to `ymaps.load` in the\n  [example above](#usage). PR is welcome!\n\n## Contributing\n\nPlease read [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of\nconduct, and the process for submitting pull requests to us.\n\n## Versioning\n\n[SemVer](http://semver.org/) is used for versioning. For the versions available,\nsee the [tags on this repository](https://github.com/sergeysolovev/ymaps/tags).\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file\nfor details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsergeysolovev%2Fymaps","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsergeysolovev%2Fymaps","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsergeysolovev%2Fymaps/lists"}