Panduan dan Contoh Map Management API

Map Management API memungkinkan Anda mengelola resource gaya visual peta berbasis cloud menggunakan API RESTful.

Ringkasan langkah

  1. Gunakan konsol Cloud untuk membuat ID peta (terbatas untuk peta berbasis vektor JavaScript).
  2. Gunakan Konsol Cloud untuk membuat gaya peta. Gaya peta digunakan sebagai link antara ID peta dan set data.
  3. Gunakan Konsol Cloud atau Maps Datasets API untuk membuat set data.
  4. Gunakan Map Management API untuk mengaitkan set data dengan ID gaya.
  5. Gunakan ID peta dalam aplikasi (JS, iOS, atau Android) dan gunakan API gaya visual berbasis data untuk menata gaya fitur set data.

Jenis

DatasetStyleAssociation

Jenis: Object/Proto

Mencakup hubungan antara set data yang ada dan Gaya Klien yang ada.

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;

Metode

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";
  }

Contoh panggilan C++

Contoh Panggilan untuk Membuat Endpoint

<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>

Contoh Panggilan ke Endpoint Daftar

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

Contoh Panggilan untuk Mencantumkan Peta Terkait

<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>

Contoh Panggilan untuk Menghapus Endpoint

<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>

Error

  • PERMISSION_DENIED : Error ini selalu menjelaskan akses resource mana yang ditolak. Misalnya, saat API tidak diaktifkan untuk project yang diberikan.

  • ALREADY_EXISTS: Dipicu oleh panggilan Create saat DatasetStyleAssociation sudah ada.

  • NOT_FOUND: Dipicu oleh salah satu metode di atas saat upaya dilakukan untuk mengakses resource yang tidak ada, seperti Gaya, Set Data, atau Project.

  • INVALID_ARGUMENT: Permintaan salah format.