This browser is no longer supported.
Upgrade to Microsoft Edge to take advantage of the latest features, security updates, and technical support.
Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Note
Bing Maps Spatial Data Service Data Source Management API retirement
Bing Maps Spatial Data Service Data Source Management API is deprecated and will be retired. Free (Basic) account customers can continue to use Bing Maps Data Source Management API until June 30th, 2025. Enterprise account customers can continue to use Bing Maps Data Source Management API until June 30th, 2028. To avoid service disruptions, all implementations using Bing Maps Spatial Data Service Data Source Management API will need to be updated to use an alternative, such as an Azure-based solution, by the retirement date that applies to your Bing Maps for Enterprise account type. For detailed migration guidance, see Migrate Bing Maps Data Source Management and Query API.
Azure Maps is Microsoft's next-generation maps and geospatial services for developers. Azure Maps has many of the same features as Bing Maps for Enterprise, and more. To get started with Azure Maps, create a free Azure subscription and an Azure Maps account. For more information about azure Maps, see Azure Maps Documentation. For migration guidance, see Bing Maps Migration Overview.
Use the following URL to delete a data source. To delete a data source, a delete data source job is created.
You can also use the Bing Maps Account Center to delete a data source. For more information, see Creating and Managing Data Sources.
A job is created when you delete a data source. Before using this API, review the job limits in Geocode and Data Source Limits.
To get a list of all the data source and geocode jobs submitted in the last 15 days, see Get Job List.
DELETE
Delete a data source.
The key parameter in this URL must be set to the data source master key.
You can get the data source base component (http://spatial.virtualearth.net/REST/v1/data/*accessId*/*dataSourceName*), by using the Get Data Source Information API and requesting information about all the data sources associated with the Bing Maps Account that manages the data source.
The URL uses the HTTP DELETE method so you cannot delete a datasource by typing the URL directly in the address bar of a browser. See the Example section for more information.
http://spatial.virtualearth.net/REST/v1/data/accessId/dataSourceName?key=masterKey
After you initiate a job to delete a data source, you must wait until the delete job is completed before creating a new data source with the same name.
Note
Parameter names and values are not case sensitive except for the key parameter value.
| Parameter | Description | Values |
|---|---|---|
| accessId | Required. A unique ID for the data source. | A string containing and ID that is part of the URL structure that identifies the data source. You can retrieve the accessId and dataSourceName values when you get information about all datasources. For more information, see Get Data Source Information. Example: a92dcfac8a0894bc4921ad5c74022623. |
| dataSourceName | Required The name of the data source that you want to search. | A string that identifies the data source. The name is part of the URL structure that identifies the data source. You can retrieve the accessId and dataSourceName values when you get information about all datasources. For more information, see Get Data Source Information. Example: FourthCoffeeSample |
| isStaging | Optional. Specifies to delete the staged version of the data source. | A Boolean value. - 0 or false**[default]** - 1 or true Example: isStaging=1 |
| key | Required. The master key for the data source. | The Bing Maps Key that was specified as the master key when the data source was created. Example: key=abc123def456ghi789abc123def456ghi789 |
If the data source is successfully deleted, the HTTP 202 status code is returned. The response does not contain any content.
EXAMPLE: Delete a data source.
The following request deletes a data source. The key parameter must be set to the data source master key. You cannot submit this URL directly from the Address bar in a browser because the URL uses the HTTP DELETE method. You may want to use a tool such as Fiddler or cURL to submit this URL request.
DELETE http://spatial.virtualearth.net/REST/v1/data/12ccc26d9e9412345f94922212345/ADataSourceName?key=masterKey HTTP/1.1
Note
For more details about these HTTP status codes, see Status Codes and Error Handling.
When the request is successful, the following HTTP status code is returned.
When the request is not successful, the response returns one of the following errors.
400
401
This error code can occur in any of the following conditions:
The key parameter is not specified.
The specified key value is not a valid Bing Maps Key.
The specified key is not the master key for the data source.
404
500
503
Training
Module
Develop a data API for Azure SQL Database - Training
Learn how to create modern REST data API for Azure SQL Database. We'll delve into Data API Builder, a powerful cross-platform that simplifies the creation of endpoints for your Azure SQL Database. With features like automatic query generation, granular security controls, and seamless integration with other Azure services, the Data API Builder can effortlessly transform your database into a versatile API.