Load Data Source Dataflow
Load Data Source Dataflow API to create a data source that contains entity data for a user-specified entity type. For example, a data source could contain location and hours of operation information for a set of restaurants. With the Load Data Source Dataflow API you can:
Create a data source.
Update, add and delete data source entities.
Overwrite an existing data source.
Make your data source public.
You can also use the Bing Maps Account Center to create or update a data source. The Bing Maps Account Center also offers the option to geocode address data on upload. For more information, see Creating and Managing Data Sources.
Before using this API, review the Geocode and Data Source Limits.
The Load Data Source Dataflow API creates and updates data sources by creating load data source jobs. The Create a Load Data Source Job and Input Entity Data URL is used to create the load data source job and requires a data schema and a set of entity data. The data schema and entity data can be provided in XML format or as values separated by commas, tabs or pipe (|) values. KML, KMZ and shapefile formats are also supported. Shapefile data must be uploaded as a zipped set of .shp, .shx, and .dbf files. For more information about the data schema and input data, see Load Data Source Data Schema and Sample Input.
After you have created a job, you can use the Get Load Data Source Status URL to get job status. A job can have one of three statuses: “Pending”, “Completed” or “Aborted”. A job has a “Pending” status when it is created and keeps that status until the job is “Completed” or Aborted”. When a job completes, the response returns a unique base URL that you can use to query the data source with the Query API.
You can delete a data source by using the Delete a Data Source API.
Describes how to create a data source and upload entity data by using a load data source job. You can also use this API to stage or update a data source.
Describes how to request status for a load data source job.
Describes how to publish a staged data source.
Describes the responses returned when you create and get status for a load data source job.
Describes how to define a data schema and input data for an entity type. Examples are provided for XML format and for input data that is provided by using sets of values separated by pipe (|), comma, or tab characters.
Describes the variety of geography types available that represent a geographic area. These types can be used as an entity property and to query for entities in a custom geographical area.
Provides helpful tips to guide you when you create a data schema and entity data to upload to a data source.
Provides C# code that shows how to upload entity data to a data source by using the Load Data Source Dataflow API.
Provides VB code that shows how to upload entity data to a data source by using the Load Data Source Dataflow API.