Make a Data Source Public

Use the following URLs to make your data source publicly accessible or to make it private. A public data source can be queried by anyone with a Bing Maps Key. A private data source can only queried using the data source query key only.

You can also use the Bing Maps Account Center to change the public status of a data source. For more information, see Making a Data Source Public or Private.

A job is created when you change the public status of 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.

Supported HTTP Methods

GET

URL templates

Set a data source to publicly accessible by setting the setPublic parameter..

http://spatial.virtualearth.net/REST/v1/data/accessID/dataSourceName/$updateDataSource?setPublic=setPublic&key=masterKey  

The base part of the following URL with accessID and dataSourceName is returned when you create the data source. It is also returned when you request information for all data sources that belong to a Bing Maps Account.

Template Parameters

Response

This URL supports the following response formats.

• JSON: application/json

• XML: application/xml

For information about the response, see Response Data.

Examples

EXAMPLE: Make a data source publicly available. .

The following request makes the specified data source public.

http://spatial.virtualearth.net/REST/v1/data/d2accd5bf52e486f8261c4889d5940d6/FourthCoffeeSample/$updatedatasource?setPublic=1&o=xml&key=MasterKey  

The status of Created in the response indicates that the job to make the data source public has been created. This operation is expected to take only a few minutes. You can confirm that the data source is public by requesting data source information with the Get Data Source Information API. Depending on the request and response format, one of the following parameters should be set to true: bsi:isPublic="true","IsPublic":"true", or IsPublic="true".

URL with XML Response

<Response xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"   
          xmlns:xsd="http://www.w3.org/2001/XMLSchema"   
          xmlns="http://schemas.microsoft.com/search/local/ws/rest/v1">  
  <Copyright>  
    Copyright © 2012 Microsoft and its suppliers. All rights reserved. This API cannot be accessed and the content and any results may not be used, reproduced or transmitted in any manner without express written permission from Microsoft Corporation.  
  </Copyright>  
  <BrandLogoUri>  
    http://spatial.virtualearth.net/Branding/logo_powered_by.png  
  </BrandLogoUri>  
  <StatusCode>201</StatusCode>  
  <StatusDescription>Created</StatusDescription>  
  <AuthenticationResultCode>ValidCredentials</AuthenticationResultCode>  
  <TraceId>  
    47fbdfa7eb2d4bc8ba06fb9f37aeb2fd  
  </TraceId>  
  <ResourceSets>  
    <ResourceSet>  
      <EstimatedTotal>1</EstimatedTotal>  
      <Resources>  
        <Resource xsi:type="DataServiceJob">  
          <Id>a7edd54c39704e638603a62ff42d4d39</Id>  
          <Description>Data source "FourthCoffeeSample" set public</Description>  
          <Status>Created</Status>  
          <CreatedDate>2012-10-16T15:45:24.7616166-07:00</CreatedDate>  
          <CompletedDate xsi:nil="true"/>  
        </Resource>  
      </Resources>  
    </ResourceSet>  
  </ResourceSets>  
</Response>  
  

URL with JSON Response

If o=xml was not specified in the response, a JSON response similar to the following example is returned.

{  
   "authenticationResultCode":"ValidCredentials",  
   "brandLogoUri":"http:\/\/spatial.virtualearth.net\/Branding\/logo_powered_by.png",  
   "copyright":"Copyright © 2012 Microsoft and its suppliers. All rights reserved. This API cannot be accessed and the content and any results may not be used, reproduced or transmitted in any manner without express written permission from Microsoft Corporation.",  
   "resourceSets":[  
      {  
         "estimatedTotal":1,  
         "resources":[  
            {  
               "__type":"DataServiceJob:http:\/\/schemas.microsoft.com\/search\/local\/ws\/rest\/v1",  
               "id":"38545e58f0204310afb9a39998ffe13b",  
               "createdDate":"Tue, 16 Oct 2012 22:47:15 GMT",  
               "description":"Data source \"FourthCoffeeSample\" set public",  
               "status":"Created"  
            }  
         ]  
      }  
   ],  
   "statusCode":201,  
   "statusDescription":"Created",  
   "traceId":"4799eeda80e445b4a1f0de6591b296b1"  
}  

HTTP Status Codes

When the request is successful, the following HTTP status code is returned.

• 202

When the request is not successful, the response returns one of the following errors.

• 400

• 401

• 500

• 503