Geocode Dataflow API

Before using this API, make sure you are aware of the Geocode and Data Source Limits.

About data schema versions: There are two versions of the input and output data schema for this API. The latest data schema (version 2.0) provides additional geocoding information in the response, such as different points for routing and display and a rectangular area that bounds the location. If you are a new user, version 2.0 is recommended because it provides the greatest flexibility. Version 1.0 users can upgrade to version 2.0, but must be aware of the changes in the data schema including some name changes that were made to match the REST Services Locations API.

The Geocode Dataflow API uses REST URLS to geocode and reverse-geocode large sets of spatial data. To use this API, you must:

  1. Format your location data using the Data Schema v2.0 or Data Schema v1.0 (for existing users). The spatial data you upload can be in XML format, or it can be provided as sets of values that use commas, tabs, or pipe (|) characters to separate the values.

  2. Create Job

  3. Get Job Status and watch for the job to complete.

  4. Download Results

    For an overview of this process, see Walkthrough.

    To get a list of all geocode dataflow jobs and data source jobs submitted in the last 15 days, see Get Job List.

In this Section

Create Job Describes how to create a job to geocode and reverse-geocode the data.
Get Job Status Describes how to get the status of a geocode job.
Download Results Describes how to download geocoded results.
Response Data Describes the information returned in the HTTP responses.
Walkthrough Provides a detailed overview of how to use the Geocode Dataflow using version 2.0 of the data schema.
Sample Code Provides complete sample code that uses the Geocode Dataflow and version 1.0 of the data schema to geocode data.
Data Schema v1.0 Describes the original (version 1.0) data schema for the input data and the geocoded results.
Data Schema v2.0 Describes version 2.0 of the data schema for the input data and the geocoded results.
Sample Input and Output v1.0 Shows examples of all types of accepted input formats for the original (version 1.0) of the data schema. This includes XML examples and examples of sets of values separated by pipe (|), comma, or tab characters
Sample Input and Output v2.0 Shows examples of all types of accepted input formats for version 2.0 of the data schema. This includes XML examples and examples of sets of values separated by pipe (|), comma, or tab characters