{"id":1801112,"date":"2023-01-26T10:30:39","date_gmt":"2023-01-26T18:30:39","guid":{"rendered":"https:\/\/www.esri.com\/arcgis-blog\/?post_type=blog&p=1801112"},"modified":"2023-01-27T03:25:57","modified_gmt":"2023-01-27T11:25:57","slug":"find-address-coordinates-using-node-js","status":"publish","type":"blog","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/developers\/developers\/find-address-coordinates-using-node-js","title":{"rendered":"Find address coordinates using Node.js"},"author":320172,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"_acf_changed":false,"_searchwp_excluded":""},"categories":[738191],"tags":[33301,768442],"industry":[],"product":[761642,36861,36601],"class_list":["post-1801112","blog","type-blog","status-publish","format-standard","hentry","category-developers","tag-arcgis-platform","tag-arcgis-rest-js","product-platform","product-api-rest","product-developers"],"acf":{"authors":[{"ID":320172,"user_firstname":"Courtney","user_lastname":"Yatteau","nickname":"Courtney Yatteau","user_nicename":"cyatteau","display_name":"Courtney Yatteau","user_email":"cyatteau@esri.com","user_url":"","user_registered":"2022-10-14 14:05:44","user_description":"Courtney Yatteau is a developer advocate on the Developer Experience team. She is responsible for outreach and awareness related to Esri's developer SDKs and APIs. Before Esri, Courtney worked in the secondary education field, teaching computer science and mathematics.","user_avatar":""}],"short_description":"Learn about a lightweight and open-source option to quickly find the latitude and longitude of an address.","flexible_content":[{"acf_fc_layout":"content","content":"

Do you want to learn how to build a simple Node.js application to find the location of an address? If so, keep reading to follow the step-by-step instructions below.<\/p>\n"},{"acf_fc_layout":"content","content":"

geocode({\r\n  address: \"1600 Pennsylvania Ave\"<\/span>,\r\n  countryCode: \"USA\"<\/span>\r\n}).then((res) => {\r\n  console<\/span>.log(res);\r\n});\r\n<\/code><\/pre>\n"},{"acf_fc_layout":"content","content":"
Prerequisites<\/strong><\/h2>\n
To start building this application, you\u2019ll need a few things:<\/p>\n
    \n
  1. Account: <\/strong>An ArcGIS Developer or ArcGIS Online account. If you don\u2019t have one, you can sign up for a free developer account<\/a>. This account will give you access to services such as the basemap layer service, geocoding service, and routing service.<\/li>\n
  2. Access token: <\/strong>Create an API key<\/a> that is scoped to access the geocoding service.<\/li>\n
  3. Node.js: <\/strong>An environment to run Node.js. We use Visual Studio Code below.<\/li>\n<\/ol>\n"},{"acf_fc_layout":"content","content":"
    Install ArcGIS REST JS packages<\/strong><\/h2>\n
    The easiest way to find the location of an address is to use ArcGIS REST JS<\/a> and the geocoding service. Use Visual Studio Code to set up a Node.js project. Next reference two ArcGIS REST packages. The first is the request package<\/a>. This contains the authentication helper to validate your requests. The second is the geocoding package<\/a>. This is a library you can use to access different geocoding operations such as findAddressCandidates<\/a>, geocode<\/a>, reverseGeocode<\/a>, suggest<\/a>, and geocodeAddresses<\/a> (batch geocoding). To install each of these packages, use npm with the following commands:<\/p>\n"},{"acf_fc_layout":"content","content":"
    npm install @esri\/arcgis-rest-request @esri\/arcgis-rest-geocoding\r\n<\/code><\/pre>\n"},{"acf_fc_layout":"content","content":"
    Create the script file<\/span><\/b><\/h2>\n
    1. In Visual Studio Code, reference the components you need by specifying the exports from the ES modules.<\/span><\/p>\n"},{"acf_fc_layout":"content","content":"
    import <\/span>{ ApiKeyManager } from<\/span> '@esri\/arcgis-rest-request'<\/span>; \r\nimport <\/span>{ geocode } from<\/span> '@esri\/arcgis-rest-geocoding'<\/span>;\r\n<\/code><\/pre>\n"},{"acf_fc_layout":"content","content":"
    3. In Visual Studio Code, define an authentication parameter for the request using the ApiKeyManager<\/a> import.<\/span><\/p>\n
    API keys should be kept secure and should not be committed to a repository. It is recommended that you use an environment variable or external config file (ignored in .gitignore) for the API key.<\/span><\/p>\n"},{"acf_fc_layout":"content","content":"
    const<\/span> apiKey = \"YOUR_API_KEY\"<\/span>;\r\nconst<\/span> authentication = ApiKeyManager.fromKey(apiKey);\r\n<\/code><\/pre>\n"},{"acf_fc_layout":"content","content":"
    4.\u00a0 <\/span>Access the geocoding service with the geocode <\/em>import.<\/span><\/p>\n
    Use the geocode method with the following parameters to get address candidates with a latitude, longitude, and correct address. To get the most accurate results, use the <\/span>address<\/span><\/code>,\u00a0<\/span>postal<\/span><\/code>,\u00a0<\/span>countryCode<\/span><\/code>, and\u00a0<\/span>authentication<\/span><\/code>\u00a0parameters, as shown below.<\/span><\/p>\n"},{"acf_fc_layout":"content","content":"
    geocode({\r\n  address: \"N Main st\"<\/span>,\r\n  postal: 38103,\r\n  countryCode: \"United States\"<\/span>,\r\n  authentication,\r\n});\r\n\r\n<\/code><\/pre>\n"},{"acf_fc_layout":"content","content":"
    5. Finally, before running the application, add code to log the results to the console. <\/span><\/p>\n
    The entire script file should look like this:<\/span><\/p>\n"},{"acf_fc_layout":"content","content":"
    import<\/span> { ApiKeyManager } from<\/span> \"@esri\/arcgis-rest-request\"<\/span>;\r\nimport<\/span> { geocode } from<\/span> \"@esri\/arcgis-rest-geocoding\"<\/span>;\r\nconst<\/span> apiKey = \"YOUR_API_KEY\"<\/span>;\r\nconst<\/span> authentication = ApiKeyManager.fromKey(apiKey);\r\ngeocode({\r\n  address: \"N Main st\"<\/span>,\r\n  postal: 38103<\/span>,\r\n  countryCode: \"USA\"<\/span>,\r\n  authentication,\r\n}).then((response) => {\r\n    response.candidates.forEach((res) => {\r\n      console<\/span>.log(res);\r\n    })\r\n});\r\n<\/code><\/pre>\n"},{"acf_fc_layout":"content","content":"
    Run the application<\/span><\/b><\/h2>\n
    Run the application<\/span>\u00a0in the terminal window. The results should resemble the example below:<\/span><\/p>\n"},{"acf_fc_layout":"image","image":{"ID":1819002,"id":1819002,"title":"OutputImage","filename":"OutputImage.png","filesize":50126,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/01\/OutputImage.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/developers\/developers\/find-address-coordinates-using-node-js\/outputimage","alt":"Output","author":"320172","description":"","caption":"","name":"outputimage","status":"inherit","uploaded_to":1801112,"date":"2023-01-18 14:08:16","modified":"2023-01-18 14:08:38","menu_order":0,"mime_type":"image\/png","type":"image","subtype":"png","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":675,"height":858,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/01\/OutputImage-213x200.png","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/01\/OutputImage.png","medium-width":205,"medium-height":261,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/01\/OutputImage.png","medium_large-width":675,"medium_large-height":858,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/01\/OutputImage.png","large-width":675,"large-height":858,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/01\/OutputImage.png","1536x1536-width":675,"1536x1536-height":858,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/01\/OutputImage.png","2048x2048-width":675,"2048x2048-height":858,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/01\/OutputImage-366x465.png","card_image-width":366,"card_image-height":465,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/01\/OutputImage.png","wide_image-width":675,"wide_image-height":858}},"image_position":"center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"
    The results include the address candidates that were found by the geocoding service. Each candidate contains the following:<\/p>\n
    2. Go to ArcGIS developer dashboard<\/a> to get an API key. Ensure it is scoped (Geocoding (not stored))<\/em> to access the geocoding service.<\/p>\n"},{"acf_fc_layout":"image","image":{"ID":1801182,"id":1801182,"title":"Image2","filename":"Image2.png","filesize":39800,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/12\/Image2.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/developers\/developers\/find-address-coordinates-using-node-js\/image2-23","alt":"API key in dashboard","author":"320172","description":"","caption":"","name":"image2-23","status":"inherit","uploaded_to":1801112,"date":"2022-12-20 14:03:57","modified":"2022-12-20 14:04:14","menu_order":0,"mime_type":"image\/png","type":"image","subtype":"png","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":624,"height":256,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/12\/Image2-213x200.png","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/12\/Image2.png","medium-width":464,"medium-height":190,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/12\/Image2.png","medium_large-width":624,"medium_large-height":256,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/12\/Image2.png","large-width":624,"large-height":256,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/12\/Image2.png","1536x1536-width":624,"1536x1536-height":256,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/12\/Image2.png","2048x2048-width":624,"2048x2048-height":256,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/12\/Image2.png","card_image-width":624,"card_image-height":256,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/12\/Image2.png","wide_image-width":624,"wide_image-height":256}},"image_position":"center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"