Map Management API की गाइड और उदाहरण

Map Management API की मदद से, RESTful API का इस्तेमाल करके, क्लाउड पर मैप की स्टाइलिंग से जुड़े संसाधनों को मैनेज किया जा सकता है.

चरणों से जुड़ी खास जानकारी

1. Cloud Console का इस्तेमाल करके, मैप आईडी बनाएं. यह सुविधा, JavaScript वेक्टर-आधारित मैप के लिए उपलब्ध है.
2. Cloud Console का इस्तेमाल करके, मैप की स्टाइल बनाएं. मैप स्टाइल का इस्तेमाल, मैप आईडी और डेटासेट के बीच लिंक के तौर पर किया जाता है.
3. डेटासेट बनाने के लिए, Cloud Console या Maps Datasets API का इस्तेमाल करें.
4. डेटासेट को स्टाइल आईडी से जोड़ने के लिए, Map Management API का इस्तेमाल करें.
5. किसी ऐप्लिकेशन (JS, iOS या Android) में मैप आईडी का इस्तेमाल करें. साथ ही, डेटासेट की सुविधाओं को स्टाइल करने के लिए, डेटा पर आधारित स्टाइलिंग एपीआई का इस्तेमाल करें.

टाइप

DatasetStyleAssociation

टाइप: ऑब्जेक्ट/प्रोटो

यह मौजूदा डेटासेट और मौजूदा ClientStyle के बीच के संबंध को कैप्सूल करता है.

message DatasetStyleAssociation {
  option (google.api.resource) = {
    type: "mapstyling.googleapis.com/DatasetStyleAssociation"
    pattern: "projects/{project}/datasets/{dataset}/clientStyles/{client_style}"
    plural: "datasetStyleAssociations",
    singular: "datasetStyleAssociation"
  };

  // Resource name.
  // projects/{project}/datasets/{dataset}/clientStyles/{client_style}
  string name = 1;

  // The resource name of the style.
  // projects/{project}/clientStyles/{client_style}
  string client_style = 2;

तरीके

CreateDatasetStyleAssociation

  rpc CreateDatasetStyleAssociation(CreateDatasetStyleAssociationRequest)
      returns (DatasetStyleAssociation) {
    option (google.api.http) = {
      post: "/v1/{parent=projects/*/datasets/*}"
      body: "dataset_style_association"
    };
    option (google.api.method_signature) =  parent,dataset_style_association";
  }

ListDatasetStyleAssociations

  rpc ListDatasetStyleAssociations(ListDatasetStyleAssociationsRequest)
      returns (ListDatasetStyleAssociationsResponse) {
    option (google.api.http) = {
      get: "/v1/{parent=projects/*/datasets/*}"
    };
    option (google.api.method_signature) = "parent";
  }

DeleteDatasetStyleAssociation

   rpc DeleteDatasetStyleAssociation(DeleteDatasetStyleAssociationRequest)
      returns (google.protobuf.Empty) {
    option (google.api.http) = {
      post: "/v1/{name=projects/*/datasets/*/clientStyles/*}:delete"
      body: "*"
    };
    option (google.api.method_signature) = "name";
  }

C++ कॉल के उदाहरण

एंडपॉइंट बनाने के लिए सैंपल कॉल

<pre>curl --http2 -X POST -H 'Content-Type: application/json' -H 'Authorization: Bearer <Token>' https://mapmanagement.googleapis.com/v1/projects/<Project_Number>/datasets/{dataset_id} -d '{name: "projects/{project_number}/datasets/{dataset_id}/clientStyles/{style_id}", client_style: "projects/{project_number}/clientStyles/{style_id}" }'</pre>

सूची वाले एंडपॉइंट को कॉल करने का सैंपल

<pre>curl --http2 -X GET -H 'Content-Type: application/json' -H 'Authorization: Bearer <Token>'   https://mapmanagement.googleapis.com/v1/projects/<Project_Number>/datasets/-</pre>

'एसोसिएटेड मैप की सूची बनाएं' फ़ंक्शन का सैंपल

<pre>curl --http2 -X GET -H 'Content-Type: application/json' -H 'Authorization: Bearer  <Token>' https://mapmanagement.googleapis.com/v1/projects/<Project_Number>/datasets/<dataset-id>/clientStyles/<style_id>:listAssociatedMaps</pre>

एंडपॉइंट मिटाने के लिए कॉल का सैंपल

<pre>curl --http2 -X POST -H 'Content-Type: application/json' -H 'Authorization: Bearer <Token>' https://mapmanagement.googleapis.com/v1/projects/<Project_Number>/datasets/<dataset_id>/clientStyles/<style_id>:delete -d '{"map_ids": ["map-id-1", "map-id-2"]}'</pre>

गड़बड़ियां

• PERMISSION_DENIED : इन गड़बड़ियों में हमेशा यह बताया जाता है कि किस संसाधन का ऐक्सेस नहीं दिया गया है. उदाहरण के लिए, जब दिए गए प्रोजेक्ट के लिए एपीआई चालू न हो.

• ALREADY_EXISTS: यह तब ट्रिगर होता है, जब Create कॉल के दौरान DatasetStyleAssociation पहले से मौजूद हो.

• NOT_FOUND: यह गड़बड़ी ऊपर दिए गए किसी भी तरीके से तब ट्रिगर होती है, जब किसी ऐसी संसाधन को ऐक्सेस करने की कोशिश की जाती है जो मौजूद नहीं है. जैसे, स्टाइल, डेटासेट या प्रोजेक्ट.

• INVALID_ARGUMENT: Request is malformed.