{"_id":"@bradrichardson/overture-geocoder","_rev":"5-a531492cd07bc301135b831d0f0cb4f3","name":"@bradrichardson/overture-geocoder","dist-tags":{"latest":"0.2.2"},"versions":{"0.1.0":{"name":"@bradrichardson/overture-geocoder","version":"0.1.0","keywords":["geocoding","overture","maps","nominatim","places","addresses"],"author":{"name":"Brad Richardson"},"license":"MIT","_id":"@bradrichardson/overture-geocoder@0.1.0","maintainers":[{"name":"bradrichardson","email":"bradrichardsonmail@gmail.com"}],"homepage":"https://github.com/bradrichardson/overture-geocoder#readme","bugs":{"url":"https://github.com/bradrichardson/overture-geocoder/issues"},"dist":{"shasum":"9121abd0ad246ea158c479612a97cb8d214f82b7","tarball":"https://registry.npmjs.org/@bradrichardson/overture-geocoder/-/overture-geocoder-0.1.0.tgz","fileCount":9,"integrity":"sha512-noGIBVCGXfeEhx6xSqzMxA8O6YTs4nrQDWJAf/uA/AtnOVCtFL8xJ5Xc2zHYpDZoe8Q2t6cGrkXFKnEcHHpGaw==","signatures":[{"sig":"MEUCIB6nAsrQZyWcAL+SFO3ptVau5ZvldRPJV14SEOcfUXdcAiEAwSWTjvok+98FFVsjC28rv6lc5VKWiRvTxXSAWendi6k=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":88002},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"207f3da2af4897f84c5e2586739edf4be97e3bcf","scripts":{"test":"vitest","build":"tsc","test:ci":"vitest run","typecheck":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"bradrichardson","email":"bradrichardsonmail@gmail.com"},"repository":{"url":"git+https://github.com/bradrichardson/overture-geocoder.git","type":"git","directory":"clients/js"},"_npmVersion":"11.6.0","description":"Forward geocoder using Overture Maps data with Nominatim-compatible API","directories":{},"_nodeVersion":"24.10.0","dependencies":{"@bradrichardson/overturemaps":"^0.3.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^1.0.0","typescript":"^5.3.3","@types/node":"^20.10.0"},"_npmOperationalInternal":{"tmp":"tmp/overture-geocoder_0.1.0_1767375908373_0.6838938430934947","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@bradrichardson/overture-geocoder","version":"0.1.2","keywords":["geocoding","overture","maps","nominatim","places","addresses"],"author":{"name":"Brad Richardson"},"license":"MIT","_id":"@bradrichardson/overture-geocoder@0.1.2","maintainers":[{"name":"bradrichardson","email":"bradrichardsonmail@gmail.com"}],"homepage":"https://github.com/brad-richardson/overture-geocoder#readme","bugs":{"url":"https://github.com/brad-richardson/overture-geocoder/issues"},"dist":{"shasum":"989a5878c1ebc7d9a3049b09866f3cb4f2ef3783","tarball":"https://registry.npmjs.org/@bradrichardson/overture-geocoder/-/overture-geocoder-0.1.2.tgz","fileCount":7,"integrity":"sha512-xW6g7pE5fYLhoWVuUIMBfJmTmY+K9U/7m4U8v2YQYdvFV2dNxY6zOQ5BZ4q5Tk60Sb6OF+hjKsSg7eFPMmBcWA==","signatures":[{"sig":"MEQCIAz1Qms+mjpDeewJMMNjd3sfRMKBLL90BvPbbKs3A6k/AiA1i89bvleBUyjGSUhjWlx/iusPKs3fyhNx4jzovZqdiQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@bradrichardson%2foverture-geocoder@0.1.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":60552},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"80ff1ce03dd37c450a49da4f9d64af73f337618b","scripts":{"test":"vitest","build":"tsc","test:ci":"vitest run","typecheck":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:adbef816-53d7-4c7a-bcbe-996492610a22"}},"repository":{"url":"git+https://github.com/brad-richardson/overture-geocoder.git","type":"git","directory":"clients/js"},"_npmVersion":"11.6.2","description":"Forward geocoder using Overture Maps data with Nominatim-compatible API","directories":{},"_nodeVersion":"24.12.0","dependencies":{"@bradrichardson/overturemaps":"^0.3.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^1.0.0","typescript":"^5.3.3","@types/node":"^20.10.0"},"_npmOperationalInternal":{"tmp":"tmp/overture-geocoder_0.1.2_1767381315939_0.9412047762603002","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@bradrichardson/overture-geocoder","version":"0.2.0","keywords":["geocoding","overture","maps","nominatim","places","addresses"],"author":{"name":"Brad Richardson"},"license":"MIT","_id":"@bradrichardson/overture-geocoder@0.2.0","maintainers":[{"name":"bradrichardson","email":"bradrichardsonmail@gmail.com"}],"homepage":"https://github.com/brad-richardson/overture-geocoder#readme","bugs":{"url":"https://github.com/brad-richardson/overture-geocoder/issues"},"dist":{"shasum":"045d3497a215020d51c5a48e6b16040f2e3f514e","tarball":"https://registry.npmjs.org/@bradrichardson/overture-geocoder/-/overture-geocoder-0.2.0.tgz","fileCount":7,"integrity":"sha512-g1stT46OSLwTpmpW9Ne0EIWEqfem8Y/DBzI7Z1Vgc39DVpQk6RHK50jACZ1CJ56nkb/ZSsMv/+ID9o0eyYUhPw==","signatures":[{"sig":"MEUCIQCmt+jyiXBtCc7kwrJshFb0eGPCFw7zrF3UeEtgewiRlgIgdfz0pnw8o5A4v8y6eznPjtK+hxCfLcbUNvYQvcA29G4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@bradrichardson%2foverture-geocoder@0.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":60501},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"cb045ffaf7d1351e65864732b90edaf35967bb69","scripts":{"test":"vitest","build":"tsc","test:ci":"vitest run","typecheck":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:adbef816-53d7-4c7a-bcbe-996492610a22"}},"repository":{"url":"git+https://github.com/brad-richardson/overture-geocoder.git","type":"git","directory":"clients/js"},"_npmVersion":"11.6.2","description":"Forward geocoder using Overture Maps data with Nominatim-compatible API","directories":{},"_nodeVersion":"24.12.0","dependencies":{"@bradrichardson/overturemaps":"^0.3.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^1.0.0","typescript":"^5.3.3","@types/node":"^20.10.0"},"_npmOperationalInternal":{"tmp":"tmp/overture-geocoder_0.2.0_1767415612910_0.6929053529443681","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@bradrichardson/overture-geocoder","version":"0.2.1","keywords":["geocoding","overture","maps","nominatim","places","addresses"],"author":{"name":"Brad Richardson"},"license":"MIT","_id":"@bradrichardson/overture-geocoder@0.2.1","maintainers":[{"name":"bradrichardson","email":"bradrichardsonmail@gmail.com"}],"homepage":"https://github.com/brad-richardson/overture-geocoder#readme","bugs":{"url":"https://github.com/brad-richardson/overture-geocoder/issues"},"dist":{"shasum":"1d184bd5acf18710ac496cee67121119130766f8","tarball":"https://registry.npmjs.org/@bradrichardson/overture-geocoder/-/overture-geocoder-0.2.1.tgz","fileCount":7,"integrity":"sha512-LvJA3yqoJqDcgROGqIreTAGeMYg1P/ICZMEFovMj5Qs1UxitcMdLbnDRpin7/v2LzVtRiUmNdKyKhhtn5kicqg==","signatures":[{"sig":"MEQCIFPmZczoRWwS5IlRT40r8p9bwDze+yx0MRaAky8QIpcYAiAbbR6I9rL9p9ykbOpyDIs6Eius9tgN6hWqTJtwARzNhw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@bradrichardson%2foverture-geocoder@0.2.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":63411},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"}},"gitHead":"ceaad5ed3d76a00244de761384b504510fe12cbc","scripts":{"test":"vitest","build":"tsup src/index.ts --format cjs,esm --dts --clean","test:ci":"vitest run","typecheck":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:adbef816-53d7-4c7a-bcbe-996492610a22"}},"repository":{"url":"git+https://github.com/brad-richardson/overture-geocoder.git","type":"git","directory":"clients/js"},"_npmVersion":"11.6.2","description":"Forward geocoder using Overture Maps data with Nominatim-compatible API","directories":{},"_nodeVersion":"24.12.0","dependencies":{"@bradrichardson/overturemaps":"^0.3.3"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.1","vitest":"^1.0.0","typescript":"^5.3.3","@types/node":"^20.10.0"},"_npmOperationalInternal":{"tmp":"tmp/overture-geocoder_0.2.1_1767416383853_0.16845064199036175","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@bradrichardson/overture-geocoder","version":"0.2.2","description":"Forward geocoder using Overture Maps data with Nominatim-compatible API","type":"module","main":"./dist/index.cjs","module":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"}},"scripts":{"build":"tsup src/index.ts --format cjs,esm --dts --clean","prepublishOnly":"npm run build","test":"vitest","test:ci":"vitest run","typecheck":"tsc --noEmit"},"keywords":["geocoding","overture","maps","nominatim","places","addresses"],"author":{"name":"Brad Richardson"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/brad-richardson/overture-geocoder.git","directory":"clients/js"},"homepage":"https://github.com/brad-richardson/overture-geocoder#readme","bugs":{"url":"https://github.com/brad-richardson/overture-geocoder/issues"},"engines":{"node":">=18.0.0"},"publishConfig":{"access":"public"},"dependencies":{"@bradrichardson/overturemaps":"^0.3.3"},"devDependencies":{"@types/node":"^20.10.0","tsup":"^8.5.1","typescript":"^5.3.3","vitest":"^1.0.0"},"gitHead":"afc5fb7ed14dd80b3285531dc9a97dfc4762c960","_id":"@bradrichardson/overture-geocoder@0.2.2","_nodeVersion":"24.12.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-tAzGBTjlGIMpKipJ9n3U0uuz1vcLviIO5FA7q1uTXsrBdQusuGPwa2sxJvKiY9+TJlY22NXNmGE+nK4Cjyu0kw==","shasum":"4207475bbf535842fdd57e2079c44f824082f8ec","tarball":"https://registry.npmjs.org/@bradrichardson/overture-geocoder/-/overture-geocoder-0.2.2.tgz","fileCount":7,"unpackedSize":63891,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@bradrichardson%2foverture-geocoder@0.2.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQC+y0oB/9euv1H1cfoQfZ4zaVNC5LX+uDCIukY2eVqq4gIgLTRF5Yd6AVrO0fXn7bzGcNTJHiQyF9f73/1YFlQKGiM="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:adbef816-53d7-4c7a-bcbe-996492610a22"}},"directories":{},"maintainers":[{"name":"bradrichardson","email":"bradrichardsonmail@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/overture-geocoder_0.2.2_1767451303690_0.28669551861693354"},"_hasShrinkwrap":false}},"time":{"created":"2026-01-02T17:45:08.267Z","modified":"2026-01-03T14:41:44.231Z","0.1.0":"2026-01-02T17:45:08.510Z","0.1.2":"2026-01-02T19:15:16.101Z","0.2.0":"2026-01-03T04:46:53.050Z","0.2.1":"2026-01-03T04:59:43.996Z","0.2.2":"2026-01-03T14:41:43.824Z"},"bugs":{"url":"https://github.com/brad-richardson/overture-geocoder/issues"},"author":{"name":"Brad Richardson"},"license":"MIT","homepage":"https://github.com/brad-richardson/overture-geocoder#readme","keywords":["geocoding","overture","maps","nominatim","places","addresses"],"repository":{"type":"git","url":"git+https://github.com/brad-richardson/overture-geocoder.git","directory":"clients/js"},"description":"Forward geocoder using Overture Maps data with Nominatim-compatible API","maintainers":[{"name":"bradrichardson","email":"bradrichardsonmail@gmail.com"}],"readme":"# Overture Geocoder - JavaScript/TypeScript Client\n\nForward geocoder using Overture Maps data with Nominatim-compatible API.\n\n## Installation\n\n```bash\nnpm install @bradrichardson/overture-geocoder\n```\n\n## Usage\n\n### Basic Search\n\n```typescript\nimport { OvertureGeocoder } from '@bradrichardson/overture-geocoder';\n\nconst geocoder = new OvertureGeocoder();\n\n// Search for a place\nconst results = await geocoder.search('Boston, MA');\nconsole.log(results[0].primary_name); // \"Boston\"\nconsole.log(results[0].lat, results[0].lon); // 42.3588336, -71.0578303\n```\n\n### Reverse Geocoding\n\n```typescript\n// Reverse geocode coordinates\nconst results = await geocoder.reverse(42.3588336, -71.0578303);\nconsole.log(results[0].primary_name);\n```\n\n### Convenience Functions\n\n```typescript\nimport { geocode, reverseGeocode } from '@bradrichardson/overture-geocoder';\n\n// Quick one-off search\nconst results = await geocode('Cambridge, MA', { limit: 5 });\n\n// Quick reverse geocode\nconst reverse = await reverseGeocode(42.3588336, -71.0578303);\n```\n\n### GeoJSON Output\n\n```typescript\nconst geojson = await geocoder.searchGeoJSON('Boston');\n// Returns FeatureCollection with Point geometries\n\nconst reverseGeojson = await geocoder.reverseGeoJSON(42.3588336, -71.0578303);\n```\n\n### Full Geometry Fetching\n\nFetch full geometries from Overture S3 data:\n\n```typescript\nconst geometry = await geocoder.getFullGeometry('gers-id');\n// Returns full polygon/multipolygon geometry from Overture\n\n// Release resources when done\nawait geocoder.close();\n```\n\n### Nearby Search\n\n```typescript\n// Find nearby places\nconst places = await geocoder.getNearbyPlaces(42.3588336, -71.0578303, {\n  radiusKm: 1,\n  limit: 10,\n});\n\n// Find nearby addresses\nconst addresses = await geocoder.getNearbyAddresses(42.3588336, -71.0578303, {\n  radiusKm: 0.5,\n});\n```\n\n## Configuration\n\n```typescript\nconst geocoder = new OvertureGeocoder({\n  baseUrl: 'https://geocoder.bradr.dev', // default\n  timeout: 30000, // ms\n  retries: 3,\n  retryDelay: 1000, // ms\n});\n```\n\n## Types\n\nAll types are exported for TypeScript users:\n\n```typescript\nimport type {\n  GeocoderResult,\n  SearchOptions,\n  ReverseOptions,\n  OvertureGeocoderConfig,\n  GeoJSONFeature,\n  GeoJSONFeatureCollection,\n  OverturePlace,\n  OvertureAddress,\n  NearbySearchOptions,\n  // STAC types for advanced usage\n  StacCatalog,\n  BoundingBox,\n} from '@bradrichardson/overture-geocoder';\n```\n\n## API Reference\n\n### `OvertureGeocoder`\n\n- `search(query: string, options?: SearchOptions): Promise<GeocoderResult[]>`\n- `searchGeoJSON(query: string, options?: SearchOptions): Promise<GeoJSONFeatureCollection>`\n- `reverse(lat: number, lon: number, options?: ReverseOptions): Promise<ReverseGeocoderResult[]>`\n- `reverseGeoJSON(lat: number, lon: number): Promise<GeoJSONFeatureCollection>`\n- `verifyContainsPoint(gersId: string, lat: number, lon: number): Promise<boolean>`\n- `getFullGeometry(gersId: string): Promise<GeoJSONFeature | null>`\n- `getNearbyPlaces(lat: number, lon: number, options?: NearbySearchOptions): Promise<OverturePlace[]>`\n- `getNearbyAddresses(lat: number, lon: number, options?: NearbySearchOptions): Promise<OvertureAddress[]>`\n- `reverseAndRefine(lat: number, lon: number, options?: ReverseAndRefineOptions): Promise<RefinedReverseResult>`\n- `close(): Promise<void>` - Release resources when done with geometry fetching\n\n### `SearchOptions`\n\n```typescript\ninterface SearchOptions {\n  limit?: number;        // 1-40, default: 10\n  countrycodes?: string; // e.g., \"us,ca\"\n  viewbox?: [number, number, number, number]; // [lon1, lat1, lon2, lat2]\n  bounded?: boolean;     // Restrict to viewbox\n  format?: 'json' | 'jsonv2' | 'geojson';\n}\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}