{
  "markdown": "# TomTom Maps SDK for JavaScript — Examples\n\n[🎮 **Examples**](https://docs.tomtom.com/maps-sdk-js/examples/) |\n[📖 **Documentation**](https://docs.tomtom.com/maps-sdk-js/introduction/overview) |\n[📋 **API Reference**](https://docs.tomtom.com/maps-sdk-js/api-reference/index.html) |\n[📦 **npm**](https://www.npmjs.com/package/@tomtom-org/maps-sdk)\n\n![SDK Examples Collage](https://raw.githubusercontent.com/tomtom-international/maps-sdk-js/main/sdk-examples-collage.png)\n\nThe runnable examples of the [TomTom Maps SDK for JavaScript](https://docs.tomtom.com/maps-sdk-js/introduction/overview)\n(`@tomtom-org/maps-sdk`) and its plugins: over 110 browser apps and Node.js scripts, the best code to copy from.\nThe SDK itself installs from npm; its sources are not published in this repository.\n\nEach example installs the SDK and plugins at the versions they were last synced against, pinned in the `catalog`\nof [`pnpm-workspace.yaml`](./pnpm-workspace.yaml).\n<br/><br/>\n\n## 🚀 Running an example\n\n**Requirements**: Node.js 24+, pnpm 11+ (`corepack enable`), and a [TomTom API key](https://my.tomtom.com/).\n\n```bash\npnpm install\ncp examples/.env.example examples/.env   # then set API_KEY_EXAMPLES\n\ncd examples/default-map\npnpm develop                             # a Vite dev server, on http://localhost:5173\n```\n\nA Node.js example reads the key from the environment:\n\n```bash\ncd examples/nodejs-geocode\nAPI_KEY_EXAMPLES=<your key> pnpm develop\n```\n\nA few examples need more than the one key; [`examples/.env.example`](./examples/.env.example) lists each extra.\n\nEvery example only imports `@tomtom-org/maps-sdk/*` and `@tomtom-org/maps-sdk-plugin-*`, as your own app would:\ncopy its `src/` into a project that installs those packages.\n<br/><br/>\n\n## 🤖 AI Coding Agent Skill\n\nInstall the SDK skill for AI coding agents (Claude Code, Cursor, GitHub Copilot, Windsurf, and [many more](https://www.npmjs.com/package/skills#available-agents)) to get SDK-specific assistance in your coding agent:\n\n```bash\nnpx skills add tomtom-international/maps-sdk-js --skill tomtom-maps-sdk-js\n```\n\n[AI coding with the SDK](https://docs.tomtom.com/maps-sdk-js/guides/ai-coding) lists the topics it covers and how to invoke them.\n<br/><br/>\n\n## 📋 Changelogs\n\n- [`CHANGELOG.md`](./CHANGELOG.md) — the SDK (`@tomtom-org/maps-sdk`)\n- `plugins/<name>/CHANGELOG.md` — each plugin, next to its `README.md`\n\nThe [Release Notes](https://docs.tomtom.com/maps-sdk-js/introduction/release-notes) cover what's new and the breaking changes.\n<br/><br/>\n\n## 💬 Feedback\n\nThis repository is a read-only mirror of an internal one, so it does not accept pull requests.\n[Open an issue](https://github.com/tomtom-international/maps-sdk-js/issues) to report a bug, or\n[start a discussion](https://github.com/tomtom-international/maps-sdk-js/discussions) for questions and feature requests.\n<br/><br/>\n\n## 📄 License\n\n- **Examples** — all code in `examples/` is open-source under the Apache V2.0 License: 📜 [examples/LICENSE](./examples/LICENSE).\n  Copy, modify and use it freely in your projects.\n- **SDK packages and plugins** — `@tomtom-org/maps-sdk` and `@tomtom-org/maps-sdk-plugin-*`, which the examples install,\n  are distributed under a proprietary license: 📜 [LICENSE.txt](./LICENSE.txt), copied as each plugin's\n  `plugins/<name>/LICENSE.txt`. They require a TomTom API key and\n  agreement to our terms of service. Their third-party notices are in [THIRD_PARTY.txt](./THIRD_PARTY.txt).\n",
  "bytes": 3455,
  "sha": "bfbbd23cd02901c42904af5b051c136a57c6856ae963edb763d601e45554eca9",
  "repo_slug": "tomtom-international/maps-sdk-js",
  "fonte": "repo",
  "truncated": false,
  "api": "https://api.agentalog.com/api/listings/skl_tomtom_international_maps_sdk_js_tomtom__ed57cd52/readme"
}