require([
"esri/map",
"esri/dijit/Search",
"dojo/domReady!"
], function (Map, Search) {
// create a streets map
var map = new Map("map", {
basemap: "streets",
center: [-122.67, 45.52], // lon, lat
zoom: 14
});
// initialize search widget to reference the map
var search = new Search({
map: map
autoNavigate: false,
maxSuggestions: 20,
value: "Portland, OR coffee shops"
}, "search");
search.startup();
});Use the Esri Geocoding Service to convert an address or place name to latitude and longitude. For example, if you know the address of a business and want to put it on a map, you can use geocoding to find the coordinates.
ArcGIS API for Javascript
In ArcGIS API for Javascript you can perform geocoding and reverse geocoding with a prebuilt Search widget, or through the Locator task.
ArcGIS Runtime SDK for iOS
Find addressess and locations with the ArcGIS SDK for iOS using the Locator task. Geocoding can be done from an online service.
ArcGIS Runtime SDK for Android
Geocode addressess and places with the ArcGIS Runtime SDK for Android using the Locator class. Geocoding can be done from an online service.
More than Simple Geocoding
Geosearch
Search for individual addresses and place names.
Reverse Geocoding
Pass a geographic coordinate and get a place name or address.
Batch Geocoding
Geocode multiple places at the same time.
You can use the Esri Geocoding Service through all of Esri’s SDKs and APIs. You can also use the REST endpoint for the service.
- (void)findPlace:(NSString *)searchString
{
// Set up parameters and request places
AGSLocatorFindParameters *findParameters = [[AGSLocatorFindParameters alloc] init];
findParameters.outSpatialReference = self.mapView.spatialReference;
findParameters.text = searchString;
[self.locator findWithParameters:findParameters];
}
-(void)locator:(AGSLocator *)locator operation:(NSOperation *)op didFind:(NSArray *)results
{
// Show the best match on the map
AGSLocatorFindResult *topResult = results[0];
[self.resultsLayer removeAllGraphics];
[self.resultsLayer addGraphic:topResult.graphic];
[self.mapView zoomToEnvelope:topResult.extent animated:YES];
}// Initialize Geocoder
List geocodeResult;
LocatorFindParameters locatorFindParams = new LocatorFindParameters("380 New York Street, Redlands, CA, 92373");
Locator locator = new Locator();
geocodeResult = locator.find(locatorFindParams); What does the Geocoding Service Cost?
If you don't need to store the results of a Geocode request, you can make 1,000,000 (one million) requests per month included with your subscription. Storing the results of a Geocode request is a paid service that requires passing a token to the REST endpoint. Learn more about our service structure and credit model.
| Geocoding Pricing | Esri Credits | USD |
|---|---|---|
| Geosearch, Individual Address - Not Stored | n/a | n/a |
| Geocode, Batch or Stored | 0.04 credit | $.004 |
| Batch 1,000 Geocodes | 40 credits | $4.00 |
Get 50 credits a month for free with an introductory developer account
World-Wide Coverage
Get ready-to-use, address-level geocoding for 107 countries and place-level geocoding for the rest of the world.
Multilingual
Whether your addresses are in English or Japanese, the geocoding service can handle properties and data written in a variety of different languages.
Flexible Terms of Use
Take your Coordinates with you. Once you have the results of a Geocode operation, they're yours to take anywhere.
More than just Addresses
Find points of interest including millions of businesses. You can also search for placenames and postal codes.
Get Started Building with Geocoding
Geocoding Service FAQ
How can I store the results?
The best way to store your results is in a feature service.
Does using the geosearch consume credits?
No. Using geosearch in your apps to find a single address does not consume credits but you are limited to using 1 million geosearches per month.
Are there any limitations on geosearch transactions?
Yes. You are entitled to use 1 million geosearch transactions per month. If you think you'll need more, contact us.
What if I need more than 1 million searches per month?
Contact us at talktous@esri.com
How do you charge for the Geocoding Service?
The Geocoding Service uses a fraction of an ArcGIS Online credit for each geocode. For more information on pricing, view the ArcGIS Online developer plans and credit usage breakdown. If you’d like more info or enterprise pricing, contact us.
Are there discounts available for very high volume geocoding?
Esri supports many high-volume geocode users and can work with you to define the appropriate pricing model for your needs. Please contact us
Can I do geocoding on-premise?
Yes, Esri’s geocoding capabilities are pervasive across the platform. Users can geocode with a ready-to-use ArcGIS Online geocoding service or license ready-to-use locators as part of the StreetMap Premium data products. Users can use the StreetMap Premium locators or their own locators built using their reference data to geocode on-premises with ArcGIS Desktop.
To what level of accuracy does your geocoder work?
ArcGIS Online World Geocoding service supports very high location accuracy, up to address level for 107 countries across the globe, including the USA, Brazil, Russia, India, and China. Cascading capability is built-in to the Geocoding experience, meaning if users can’t find a match at the address level, the geocoding engine is capable of trying to find a match at the next best level automatically.
Does your geocoder return a confidence score?
Yes, the geocoder outputs not just the x, y coordinate, but also the accuracy level and the confidence score.
Can your geocoder return altitude?
No, altitude and z-value output is not currently supported, but you can combine the Esri World Geocoder Service with the Elevation Analysis Service.
Can your geocoder return parcel numbers?
No, Esri’s ready-to-use geocoding service and locators do not return parcel numbers, but matches to the rooftop centroids. However, users can build their own locators with parcel number information to support their own geocoding needs.