{"info":{"_postman_id":"a4a09b46-3cec-4fa6-7ac1-dc0721b3a845","name":"Batch Geocoder API","description":"The **HERE Batch Geocoder API** is a web service that allows users to geocode large data sets (hundreds of thousands). Users upload a single input file, the service processes the data asynchronously and returns a single file with the results.\n\nThis example set works with version **6.2.34** or higher\n\nAdditional information can be found on [developer.here.com](https://developer.here.com/rest-apis/documentation/batch-geocoder)","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json"},"item":[{"name":"Download Geocoded Data","id":"057d3534-07b4-dc2a-ba92-f1c2d7d7b544","request":{"method":"GET","header":[{"key":"Content-Type","value":"application/octet-stream"}],"body":{"mode":"formdata","formdata":[{"key":"app_id","type":"text","value":"{{YOUR_APP_ID}}"},{"key":"app_code","type":"text","value":"{{YOUR_APP_CODE}}"}]},"url":{"raw":"https://batch.geocoder.cit.api.here.com/6.2/jobs/puwWrv32YOU24y8MNoUr793chFAI36aC/result?app_id={{YOUR_APP_ID}}&app_code={{YOUR_APP_CODE}}","protocol":"https","host":["batch","geocoder","cit","api","here","com"],"path":["6.2","jobs","puwWrv32YOU24y8MNoUr793chFAI36aC","result"],"query":[{"key":"app_id","value":"{{YOUR_APP_ID}}"},{"key":"app_code","value":"{{YOUR_APP_CODE}}"}]},"description":"*Download a zipped geocoded dataset from a completed job*\n\nTo download the results, make a request to the `jobs/requestId/result `endpoint and unzip the file.\n\n\n\n* **app_id**  `text`\n \\- A 20 byte Base64 URL-safe encoded string used for the authentication of the client application.    You must include an `app_id` with every request.  \n\n* **app_code**  `text`\n \\- A 20 byte Base64 URL-safe encoded string used for the authentication of the client application.    You must include an `app_code` with every request.  \n\n* **Content-Type**  `header`\n\n  Specifies the media type of the body in the GET request.  "},"response":[],"_postman_id":"057d3534-07b4-dc2a-ba92-f1c2d7d7b544"},{"name":"Batch Geocode Job Status","id":"7c523a24-2c3b-ebf4-8574-0346e052c5c3","request":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[{"key":"action","type":"text","value":"status"},{"key":"app_code","type":"text","value":"{{YOUR_APP_CODE}}"},{"key":"app_id","type":"text","value":"{{YOUR_APP_ID}}"}]},"url":{"raw":"https://batch.geocoder.cit.api.here.com/6.2/jobs/puwWrv32YOU24y8MNoUr793chFAI36aC?action=status&app_code={{YOUR_APP_CODE}}&app_id={{YOUR_APP_ID}}","protocol":"https","host":["batch","geocoder","cit","api","here","com"],"path":["6.2","jobs","puwWrv32YOU24y8MNoUr793chFAI36aC"],"query":[{"key":"action","value":"status"},{"key":"app_code","value":"{{YOUR_APP_CODE}}"},{"key":"app_id","value":"{{YOUR_APP_ID}}"}]},"description":"*Request the status of a batch geocoder job*\n\nTo check the status, make a request to the `jobs` endpoint  appending the `requestId` and using the parameter `action=status `\n  \n\n\n\n* **action**  `enum`\n \\- Type of request  \n\n Valid values are : `cancel`, `runs`, `status`\n\n* **app_code**  `text`\n \\- A 20 byte Base64 URL-safe encoded string used for the authentication of the client application.    You must include an `app_code` with every request.  \n\n* **app_id**  `text`\n \\- A 20 byte Base64 URL-safe encoded string used for the authentication of the client application.    You must include an `app_id` with every request.  "},"response":[],"_postman_id":"7c523a24-2c3b-ebf4-8574-0346e052c5c3"},{"name":"Batch Geocode Addresses","id":"e89acae0-b0ad-5cf1-1907-fdc49e0f6a1c","request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"recId|searchText|country\n0001|Invalidenstraße 116 10115 Berlin|DEU\n0002|Am Kronberger Hang 8 65824 Schwalbach|DEU\n0003|425 W Randolph St Chicago IL 60606|USA\n0004|One Main Street Cambridge MA 02142|USA\n0005|200 S Mathilda Ave Sunnyvale CA 94086|USA"},"url":{"raw":"https://batch.geocoder.cit.api.here.com/6.2/jobs?gen=8&app_id={{YOUR_APP_ID}}&app_code={{YOUR_APP_CODE}}&action=run&mailto=<my_email>&header=true&indelim=|&outdelim=|&outcols=displayLatitude,displayLongitude,locationLabel,houseNumber,street,district,city,postalCode,county,state,country&outputCombined=false","protocol":"https","host":["batch","geocoder","cit","api","here","com"],"path":["6.2","jobs"],"query":[{"key":"gen","value":"8"},{"key":"app_id","value":"{{YOUR_APP_ID}}"},{"key":"app_code","value":"{{YOUR_APP_CODE}}"},{"key":"action","value":"run"},{"key":"mailto","value":"<my_email>"},{"key":"header","value":"true"},{"key":"indelim","value":"|"},{"key":"outdelim","value":"|"},{"key":"outcols","value":"displayLatitude,displayLongitude,locationLabel,houseNumber,street,district,city,postalCode,county,state,country"},{"key":"outputCombined","value":"false"}]},"description":"* Start asynchronously geocoding a large set of addresses in one batch*\n\nSubmit an HTTP POST request with `action=run` and attach the input data to the body. \n  \n\n\n\n* **gen**  `number`\n \\- Enables/disables backward incompatible behavior in the API\n\n* **app_id**  `text`\n \\- A 20 byte Base64 URL-safe encoded string used for the authentication of the client application.    You must include an `app_id` with every request.\n\n* **app_code**  `text`\n \\- A 20 byte Base64 URL-safe encoded string used for the authentication of the client application.    You must include an `app_code` with every request.\n\n* **action**  `enum`\n \\- Type of request\n\n Valid values are : `cancel`, `run`, `status`\n\n* **mailto**  `text`\n \\- Email address where completion notification is sent.\n\n* **header**  `enum`\n \\- If `true`, a header row is included before the results in the output.  \n\n Valid values are : `false`, `true`\n\n* **indelim**  `text`\n \\- \n\n* **outdelim**  `text`\n \\- \n\n* **outcols**  `text`\n \\- \n\n* **outputCombined**  `enum`\n \\- \n\n Valid values are : `true`, `false`"},"response":[],"_postman_id":"e89acae0-b0ad-5cf1-1907-fdc49e0f6a1c"},{"name":"Batch Reverse Geocode Locations","id":"be3dff0a-01d1-886a-c9fb-8563d3fdc239","request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"recId|prox\n0001|52.505308,13.327739,250\n0002|49.917257,8.486488,250\n0003|51.119593,7.399356,250\n0004|49.20012,8.12326,250\n0005|51.116845,7.397318,250\n0006|52.265938,7.976922,250\n0007|48.143131,10.829233,250\n0008|51.770237,7.442682,250\n0009|51.511877,7.461382,250\n0010|52.53,13.391389,250"},"url":{"raw":"http://batch.geocoder.cit.api.here.com/6.2/jobs?gen=8&app_id={{YOUR_APP_ID}}&app_code={{YOUR_APP_CODE}}&action=run&mailto=<my_email>&header=true&indelim=|&outdelim=|&outcols=displayLatitude,displayLongitude,locationLabel,houseNumber,street,district,city,postalCode,county,state,country&outputCombined=false&mode=retrieveAddresses","protocol":"http","host":["batch","geocoder","cit","api","here","com"],"path":["6.2","jobs"],"query":[{"key":"gen","value":"8"},{"key":"app_id","value":"{{YOUR_APP_ID}}"},{"key":"app_code","value":"{{YOUR_APP_CODE}}"},{"key":"action","value":"run"},{"key":"mailto","value":"<my_email>"},{"key":"header","value":"true"},{"key":"indelim","value":"|"},{"key":"outdelim","value":"|"},{"key":"outcols","value":"displayLatitude,displayLongitude,locationLabel,houseNumber,street,district,city,postalCode,county,state,country"},{"key":"outputCombined","value":"false"},{"key":"mode","value":"retrieveAddresses"}]},"description":"*Start asynchronously reverse-geocoding a large set of locations in one batch*\n\nSubmit an HTTP POST request with `action=run` and attach the input data to the body. \n  \n\n\n\n* **gen**  `number`\n \\- Enables/disables backward incompatible behavior in the API\n\n* **app_id**  `text`\n \\- A 20 byte Base64 URL-safe encoded string used for the authentication of the client application.    You must include an `app_id` with every request.\n\n* **app_code**  `text`\n \\- A 20 byte Base64 URL-safe encoded string used for the authentication of the client application.    You must include an `app_code` with every request.\n\n* **action**  `enum`\n \\- \n\n Valid values are : `cancel`, `run`, `status`\n\n* **mailto**  `text`\n \\- \n\n* **header**  `enum`\n \\- \n\n Valid values are : `false`, `true`\n\n* **indelim**  `text`\n \\- \n\n* **outdelim**  `text`\n \\- \n\n* **outcols**  `text`\n \\- \n\n* **outputCombined**  `enum`\n \\- \n\n Valid values are : `true`, `false`\n\n* **mode**  `text`\n \\- "},"response":[],"_postman_id":"be3dff0a-01d1-886a-c9fb-8563d3fdc239"}]}