google-maps-link-parser

Safe variants

Safe variants return the same envelope shape even on failure.

const result = parseGoogleMapsUrl("https://share.google/example");

if (result.status === "error") {
  console.error(result.error?.code, result.error?.message);
}

Throwing variants

Throwing variants are better when invalid input should halt a request immediately.

import { unfurlGoogleMapsUrlOrThrow } from "google-maps-link-parser";

const result = await unfurlGoogleMapsUrlOrThrow(url);

Provider denied responses

Denied provider responses are not treated like parser crashes. Instead, enriched mode records them as:

warning diagnostics
raw.providerErrors
preserved normalized data from the parse or unfurl stage

That means you can still use the URL-derived data even when a Google API key is restricted or a provider is disabled.

Raw artifacts Node usage

Getting Started

Concepts

Guides

Examples

API Reference

Project

Error handling

Safe variants

Throwing variants

Provider denied responses

​Safe variants

​Throwing variants

​Provider denied responses

Safe variants

Throwing variants

Provider denied responses