راهنمای API مدیریت نقشه و مثالها، راهنمای API مدیریت نقشه و مثالها

Map Management API به شما امکان می دهد منابع طراحی نقشه های مبتنی بر ابر خود را با استفاده از API های RESTful مدیریت کنید.

خلاصه مراحل

1. از کنسول Cloud برای ایجاد شناسه نقشه (محدود به نقشه های مبتنی بر برداری جاوا اسکریپت) استفاده کنید.
2. از کنسول Cloud برای ایجاد یک سبک نقشه استفاده کنید. سبک نقشه به عنوان پیوند بین شناسه نقشه و مجموعه داده استفاده می شود.
3. از کنسول Cloud یا Maps Datasets API برای ایجاد یک مجموعه داده استفاده کنید.
4. از Map Management API برای مرتبط کردن مجموعه داده با شناسه سبک استفاده کنید.
5. از شناسه نقشه در یک برنامه (JS، iOS، یا Android) استفاده کنید و از API سبک مبتنی بر داده برای استایل دادن به ویژگی‌های مجموعه داده استفاده کنید.

انواع

DatasetStyleAssociation

نوع: Object/Proto

رابطه بین یک مجموعه داده موجود و یک Client Style موجود را در بر می گیرد.

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>

نمونه Call to List Endpoint

<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: این خطاها همیشه به جزئیات دسترسی به منابعی رد شده است. به عنوان مثال، زمانی که API برای پروژه ارائه شده فعال نیست.

• ALREADY_EXISTS: زمانی که DatasetStyleAssociation از قبل وجود داشته باشد، توسط یک فراخوانی ایجاد می شود.

• NOT_FOUND: هنگامی که تلاش برای دسترسی به منبعی که وجود ندارد، مانند یک سبک، مجموعه داده یا پروژه، توسط هر یک از روش‌های بالا فعال می‌شود.

• INVALID_ARGUMENT: درخواست نادرست است.