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

Download Sample File

Single File Post a CSV File and get CSV File response

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.

  1. string url = "http://geocoder.maplarge.com/geocoder/PostCSV?key=YOUR-KEY";
  2. string filePath = @"C:\Maplarge\Geocode.csv";
  3. WebClient wc = new WebClient();
  4. byte[] responseArray = wc.UploadFile(url, filePath);
  5. System.IO.File.WriteAllBytes(@"c:\Maplarge\result.csv",
  6. responseArray);
Multiple Files Post One of more CSV files as a zip package, and get a zip package back
  1. //Zipped package one ore more files string
  2. url = "http://geocoder.maplarge.com/geocoder/PostCSV?key=YOUR-KEY";
  3. string filePath = @"C:\Maplarge\Geocode.zip";
  4. byte[] responseArray = wc.UploadFile(url, filePath);
  5. 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
  1. string url = "http://geocoder.maplarge.com/geocoder/PostReverseCSV?key=YOUR-KEY";
  2. string filePath = @"C:\Maplarge\Geocode.csv";
  3. WebClient wc = new WebClient();
  4. byte[] responseArray = wc.UploadFile(url,filePath);
  5. 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
  1. //Zipped package one or more files
  2. string url = "http://geocoder.maplarge.com/geocoder/PostReverseCSV?key=YOUR-KEY";
  3. string filePath = @"C:\Maplarge\Geocode.zip";
  4. byte[] responseArray = wc.UploadFile(url, filePath);
  5. 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