Skip to main content

Documentation Index

Fetch the complete documentation index at: https://gmlp.kdco.dev/llms.txt

Use this file to discover all available pages before exploring further.

minimal

minimal never performs network requests. Use it when:
  • you already have a full Google Maps URL
  • you only need coordinates or typed URL metadata
  • you want deterministic, cheap parsing in hot code paths

unfurl

unfurl allows public redirect resolution and optional HTML fallback. Use it when:
  • users paste maps.app.goo.gl or goo.gl/maps links
  • you need the final browser-resolved URL
  • you want redirect-chain artifacts for debugging or analytics

enriched

enriched starts from the parsed or unfurled result, then optionally calls Google APIs. Use it when:
  • you need a formatted address from coordinates
  • a text query should become coordinates
  • directions URLs should return distance or duration
  • you want a provider place_id

Cost policy

enriched mode accepts a policy:
  • when-needed: only call provider APIs when normalized data is still missing
  • always: keep enrichment enabled even when the URL already provides useful data
Use when-needed unless you have a business requirement to standardize provider-backed fields across every result.