The MapLarge bulk geocoding API allows you to POST a file and the response is a file with geocoded data appended. The API expects a key parameter in the query string and the post body contains the file data.
Bulk Geocoding C# Example
Input Column Headers
- Address
- City
- State
- Zip or Post Code
- Country
Note: City or State columns are required for domestic zip codes. Country column is required for international addresses.
string url = "//geocoder.maplarge.com/geocoder/PostCSV?key=YOUR-KEY"; string filePath = @"C:\Maplarge\Geocode.csv"; byte[] responseArray = wc.UploadFile(url, filePath); System.IO.File.WriteAllBytes(@"c:\Maplarge\result.csv", responseArray);
Multiple Files | Post One of more CSV files as a zip package, and get a zip package back |
//Zipped package one ore more files string url = "//geocoder.maplarge.com/geocoder/PostCSV?key=YOUR-KEY"; string filePath = @"C:\Maplarge\Geocode.zip"; byte[] responseArray = wc.UploadFile(url, filePath); System.IO.File.WriteAllBytes(@"c:\Maplarge\result.csv.zip", responseArray);
For POST examples in other languages click here.
Download Sample File
Single File | Post a CSV File and get CSV File response |
Required Column Headers
- Latitude
- Longitude
string url = "//geocoder.maplarge.com/geocoder/PostReverseCSV?key=YOUR-KEY"; string filePath = @"C:\Maplarge\Geocode.csv"; byte[] responseArray = wc.UploadFile(url,filePath); System.IO.File.WriteAllBytes(@"c:\Maplarge\result.csv", responseArray);
Multiple Files | Post One of more CSV files as a zip package, and get a zip package back |
//Zipped package one or more files string url = "//geocoder.maplarge.com/geocoder/PostReverseCSV?key=YOUR-KEY"; string filePath = @"C:\Maplarge\Geocode.zip"; byte[] responseArray = wc.UploadFile(url, filePath); System.IO.File.WriteAllBytes(@"c:\Maplarge\result.csv.zip", responseArray);
Response Columns
The Geocoder returns a new .csv file with 4 columns appended to the input data. The new columns are LATITUDE, LONGITUDE, MatchType, and NumMatch. Possible output values are listed below.
- LATITUDE: Latitude
- LONGITUDE: Longitude
- NumMatch: streetNumber quality
- Exact: Exact street number location found
- Approx: Interpolated street number location found
- NoMatch: No match to street number
- MatchType: Geocode match quality
- ExactMatch: Exact street found
- KnownAlternateName: Street name found with minimal clean up
- DirectionSuffixRemoved: Street name found with direction suffix removed
- DirectionPrefixRemoved: Street name found with direction prefix removed
- WeakName: A street name was found that does not match exactly, but close enough it could still be correct
- MatchToZip: Address matched to zip level
- MatchToCity: Address matched to city level
- MatchToState: Address matched to state level
- MatchToCountry: Address matched to country level
- IntersectionExactMatch: Exact intersection found
- IntersectionClosestPoint: Exact intersection was not detected, but we found a point where the two streets are very close to each other
- IntersectionOneStreetFound: Only one street of the intersection was found
- RegionNotFound: No match