{"id":19824766,"url":"https://github.com/stephangeorg/geocoder-arcgis","last_synced_at":"2025-05-01T13:31:41.507Z","repository":{"id":57249778,"uuid":"51693769","full_name":"StephanGeorg/geocoder-arcgis","owner":"StephanGeorg","description":"Promises based JavaScript wrapper for the ESRI ArcGIS geocoder service.","archived":false,"fork":false,"pushed_at":"2019-05-11T11:52:56.000Z","size":116,"stargazers_count":8,"open_issues_count":0,"forks_count":4,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-20T18:01:53.729Z","etag":null,"topics":["arcgis","arcgis-geocoder","geocode","geocoder"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/StephanGeorg.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-02-14T12:29:20.000Z","updated_at":"2019-05-11T11:52:57.000Z","dependencies_parsed_at":"2022-08-24T16:31:17.119Z","dependency_job_id":null,"html_url":"https://github.com/StephanGeorg/geocoder-arcgis","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/StephanGeorg%2Fgeocoder-arcgis","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/StephanGeorg%2Fgeocoder-arcgis/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/StephanGeorg%2Fgeocoder-arcgis/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/StephanGeorg%2Fgeocoder-arcgis/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/StephanGeorg","download_url":"https://codeload.github.com/StephanGeorg/geocoder-arcgis/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251881711,"owners_count":21659146,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["arcgis","arcgis-geocoder","geocode","geocoder"],"created_at":"2024-11-12T11:05:51.055Z","updated_at":"2025-05-01T13:31:41.233Z","avatar_url":"https://github.com/StephanGeorg.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# GeocoderArcGIS [![npm version](https://badge.fury.io/js/geocoder-arcgis.svg)](https://badge.fury.io/js/geocoder-arcgis)\n\nA promises based JavaScript wrapper for the [ArcGIS](https://developers.arcgis.com/features/geocoding/) Geocoder API.\nIt uses fetch-everywhere to use in\n\n- Node\n- Browser\n- React-native\n\n## Installation\n\nInstalling using npm:\n\n    npm i geocoder-arcgis -S\n\n## Usage\n\n### Initialization\n```javascript\nconst GeocoderArcGIS = require('geocoder-arcgis');\n\nconst geocoder = new GeocoderArcGIS({\n  client_id: 'YOUR CLIENT ID',         // optional, see below\n  client_secret: 'YOUR CLIENT SECRET'  // optional, see below\n});\n```\n\nThe constructor function also takes an optional configuration object:\n\n* client_id: id for OAuth to use with \"geocodeAddresses\" or \"forStorage\" option. See [reference](https://developers.arcgis.com/rest/geocode/api-reference/geocoding-free-vs-paid.htm)\n* client_secret: secret for OAuth to use with \"geocodeAddresses\" or \"forStorage\" option. See [reference](https://developers.arcgis.com/rest/geocode/api-reference/geocoding-free-vs-paid.htm)\n* endpoint: custom ArcGIS endpoint\n\n### Geocode (findAddressCandidates)\n\n```javascript\ngeocoder.findAddressCandidates('380 New York Street, Redlands, CA 92373',{})\n    .then((result) =\u003e{\n      console.log(result);\n    })\n    .catch(console.log);\n```\n\nYou can pass a [SingleLine string or an object](https://developers.arcgis.com/rest/geocode/api-reference/geocoding-find-address-candidates.htm#ESRI_SECTION1_699C8961EDD845CAB84A46409D9E9105) to the geocoder.\n\nOptional parameters:\n* you can pass all [request parameters](https://developers.arcgis.com/rest/geocode/api-reference/geocoding-find-address-candidates.htm#ESRI_SECTION1_699C8961EDD845CAB84A46409D9E9105)\n\n### Reverse geocode (reverseGeocode)\n```javascript\ngeocoder.reverse('51.484463,-0.195405',{ // longitude,latitude\n  maxLocations: 10,\n  distance: 100\n}).then((result) =\u003e {\n  console.log(result);\n});\n```\n\nOptional parameters:\n* you can pass all [request parameters](https://developers.arcgis.com/rest/geocode/api-reference/geocoding-reverse-geocode.htm#ESRI_SECTION1_ABD1AD449DF54FFEB9527A606341714C)\n\n### Suggest (suggest)\n```javascript\ngeocoder.suggest('Glogauer Straße, Berlin',{})\n.then((result) =\u003e {\n  console.log(result);\n})\n.catch(console.log);\n```\n\nOptional parameters:\n* you can pass all [request parameters](https://developers.arcgis.com/rest/geocode/api-reference/geocoding-suggest.htm#ESRI_SECTION1_606D93C721874B16844B9AB9CA8083FF)\n\n### geocodeAddresses\n```javascript\ngeocoder.geocodeAddresses([\n  \"380 New York St., Redlands, CA, 92373\",\n  {\n    \"Address\": \"1 World Way\",\n    \"Neighborhood\": \"\",\n    \"City\": \"Los Angeles\",\n    \"Subregion\": \"\",\n    \"Region\": \"CA\"\n  }\n  ],{})\n    .then((result){\n      console.log(result);\n    })\n    .catch(console.log);\n```\n\nYou can pass an array of attributes to the geocoder. All required fields will be added/formatted automatically.  If you don't pass in OBJECTIDs for each address, this library will create them for you. You can pass a [SingleLine string or an object](https://developers.arcgis.com/rest/geocode/api-reference/geocoding-find-address-candidates.htm#ESRI_SECTION1_699C8961EDD845CAB84A46409D9E9105) to the geocoder.\n\nOptional parameters:\n* you can pass all [request parameters](https://developers.arcgis.com/rest/geocode/api-reference/geocoding-geocode-addresses.htm#ESRI_SECTION1_2F67482E18324994B54C9E93A81AA99D)\n\n### Geocode (find) - [deprecated](https://developers.arcgis.com/rest/geocode/api-reference/geocoding-find-address-candidates.htm)\n```javascript\ngeocoder.geocode('Berlin',{})\n    .then((response) =\u003e {\n        console.log(response);\n    })\n    .catch(console.log);\n```\n\n### Response\n\nAll methods return a promise.\n\n## See Also\n* [geoservices-js](https://github.com/Esri/geoservices-js/blob/master/docs/Geocoding.md) provides another client for the ArcGIS geocoder, using a callback interface instead of promises.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstephangeorg%2Fgeocoder-arcgis","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstephangeorg%2Fgeocoder-arcgis","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstephangeorg%2Fgeocoder-arcgis/lists"}