מדריך ומקרים לדוגמה של Map Management API

‫Map Management API מאפשר לכם לנהל את משאבי העיצוב של המפות מבוססות-הענן באמצעות ממשקי API מסוג RESTful.

סיכום השלבים

1. משתמשים ב-Cloud Console כדי ליצור מזהה מפה (מוגבל למפות וקטוריות מבוססות JavaScript).
2. משתמשים במסוף Cloud כדי ליצור סגנון מפה. סגנון מפה משמש כקישור בין מזהה מפה לבין מערך נתונים.
3. משתמשים ב-Cloud Console או ב-Maps Datasets API כדי ליצור מערך נתונים.
4. משתמשים ב-Map Management API כדי לשייך את מערך הנתונים למזהה הסגנון.
5. משתמשים במזהה המפה באפליקציה (JS,‏ iOS או Android) ומשתמשים ב-API של סגנון מבוסס-נתונים כדי להגדיר סגנון לתכונות של קבוצת הנתונים.

סוגים

DatasetStyleAssociation

טיפוס: Object/Proto

התג הזה כולל את הקשר בין מערך נתונים קיים לבין סגנון לקוח קיים.

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;

Methods

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 : השגיאות האלה תמיד מפרטות את הגישה למשאב שנחסמה. לדוגמה, אם ה-API לא מופעל בפרויקט שצוין.

• ALREADY_EXISTS: מופעל על ידי קריאת Create אם DatasetStyleAssociation כבר קיים.

• NOT_FOUND: מופעל על ידי כל אחת מהשיטות שלמעלה כשמנסים לגשת למשאב שלא קיים, כמו סגנון, מערך נתונים או פרויקט.

• INVALID_ARGUMENT: Request is malformed.