# google-maps-link-parser

## Docs

- [Errors](https://gmlp.kdco.dev/api-reference/errors.md): Typed error classes and when to use them.
- [API overview](https://gmlp.kdco.dev/api-reference/overview.md): The main public functions and how they fit together.
- [Types](https://gmlp.kdco.dev/api-reference/types.md): Key public types exposed by the package.
- [Parse vs unfurl vs enrich](https://gmlp.kdco.dev/concepts/parse-vs-unfurl-vs-enrich.md): Choose the right mode for your cost, latency, and accuracy needs.
- [Parsing model](https://gmlp.kdco.dev/concepts/parsing-model.md): Understand the stable normalized envelope and extraction precedence.
- [Security model](https://gmlp.kdco.dev/concepts/security-model.md): Hostname restrictions, redirect validation, and SSRF defenses.
- [Browser usage](https://gmlp.kdco.dev/examples/browser-usage.md): Use pure parsing helpers in browser code without provider calls.
- [Node usage](https://gmlp.kdco.dev/examples/node-usage.md): Use the library in Bun or Node server code.
- [Installation](https://gmlp.kdco.dev/getting-started/installation.md): Install the package and set up the local development workflow.
- [Quick start](https://gmlp.kdco.dev/getting-started/quick-start.md): Parse a direct URL, unfurl a short link, and understand when to enrich.
- [Error handling](https://gmlp.kdco.dev/guides/error-handling.md): Use safe envelopes or throwing variants depending on the integration boundary.
- [Handle short links](https://gmlp.kdco.dev/guides/handle-short-links.md): Resolve `maps.app.goo.gl` and `goo.gl/maps` links safely, including dead links.
- [Parse coordinates](https://gmlp.kdco.dev/guides/parse-coordinates.md): Extract coordinates, zoom, and map-view data from common Google Maps URL forms.
- [Raw artifacts](https://gmlp.kdco.dev/guides/raw-artifacts.md): Capture raw parsing, redirect, HTML, and provider artifacts without polluting normalized output.
- [Introduction](https://gmlp.kdco.dev/index.md): Parse, normalize, unfurl, and optionally enrich public Google Maps URLs with one stable typed result envelope.
- [Releases](https://gmlp.kdco.dev/releases.md): Versioning, changelog generation, and npm publishing.