Map Feedback API Developer's Guide

Tracking Feedback Status

The user wants to track the feedback status for a single feedback ID and multiple feedback IDs:

HTTP Header Fields

Map Feedback API GET requests require the following HTTP header fields:

Group-Id: FGx1AWaAzKOo0imNkLmf
Auth-Service-Id: here_app
Auth-Identifier: {YOUR_APP_ID}
Auth-Secret: {YOUR_APP_CODE}
Accept: application/json
Accept-Charset: charset=UTF-8

Request

The GET requests specify:

  • A single feedback ID:
    https://maphub.cit.api.here.com/feedback/-19746
  • Multiple feedback IDs:
    https://maphub.cit.api.here.com/feedback/-19746;-19752;-19753

Response

The responses to the request contain:

  • copy of the feedback submitted
  • layerID and timestamp for the feedback
  • feedback status information for a single ID or multiple IDs
Single ID:
[
  {
    "previousGuid": "97725e2b44d4eb761e87eede76e787b451a3b6e7",
    "layerId": "grp|wiki|WIKI_MAP_FEEDBACK",
    "lastUpdateTS": 1418199095358,
    "coordinates": [
      -122.4462810410399,
      37.77017601747043,
      0
    ],
    "guid": "cd6e81fc277c66c124a289e39b645c478694a768",
    "id": -19746,
    "type": "Point",
    "createdTS": 1418199095141,
    "properties": {
      "zoomLevel": 20,
      "jobStatus": "OPEN",
      "city": "San Francisco",
      "referenceIds": [
        "948902673"
      ],
      "error": 21,
      "number": "1476",
      "jobSolution": "NONE",
      "v": "2.7",
      "appId": "{YOUR_APP_ID}",
      "isocc": "USA",
      "details": "This address is incorrect",
      "pageURL": "https://www.here.com/?x=ep&map=37.77017,-122.44667,20,normal",
      "roadname": "Haight Street"
  }
]
Multiple IDs:
[
  {
    "previousGuid": "354516c9e571332eaa13ae1b3fc344a825dc1d56",
    "layerId": "grp|wiki|WIKI_MAP_FEEDBACK",
    "lastUpdateTS": 1418201945825,
    "coordinates": [
      8.656664011955286,
      49.86079425922911,
      0
    ],
    "guid": "1cc05d1e87ece77c00f69f8d0632d2ca584774ec",
    "id": -19753,
    "type": "Point",
    "createdTS": 1418201944918,
    "properties": {
      "zoomLevel": 18,
      "jobStatus": "INPROGRESS",
      "referenceIds": [
        "52391246"
      ],
      "dir": "0",
      "error": 10,
      "languageCode": "deu",
      "type": "5",
      "jobId": -2102,
      "jobSolution": "NONE",
      "v": "2.7",
      "appId": "{YOUR_APP_ID}",
      "speedCat": "8",
      "isocc": "DEU",
      "details": "There is a foot path missing.",
      "pageURL": "https://here.com/?map=8.656025,49.861,18,0,normal",
      "roadname": "Bruchwiesenstraße"
    }
  },
  {
    "previousGuid": "039b3a2bcf036607b43b569dd34a584a993543cb",
    "layerId": "grp|wiki|WIKI_MAP_FEEDBACK",
    "lastUpdateTS": 1418201039927,
    "coordinates": [
      -87.63245,
      41.88425,
      0
    ],
    "guid": "0f412f8ae2d017b7ca5804820b5e836d68a2c017",
    "id": -19752,
    "type": "Point",
    "createdTS": 1418201039323,
    "properties": {
      "zoomLevel": 20,
      "jobStatus": "OPEN",
      "feedbackSystem": "core",
      "city": "Chicago",
      "referenceIds": [
        "776397653"
      ],
      "error": 31,
      "languageCode": "eng",
      "type": "5800",
      "URL": "www.MyPlace.com",
      "zipcode": "60605",
      "jobId": -2101,
      "number": "114",
      "jobSolution": "NONE",
      "phone": "+1 111 2 333",
      "v": "2.7",
      "appId": "{YOUR_APP_ID}",
      "isocc": "USA",
      "name": "MyPlace",
      "details": "Place MyPlace has inaccurate information. It is a restaurant",
      "pageURL": "https://here.com/?map=-87.62075959200841,41.876032263224666,20,0,normal",
      "roadname": "East Congress Parkway"
    }
  },
  {
    "previousGuid": "97725e2b44d4eb761e87eede76e787b451a3b6e7",
    "layerId": "grp|wiki|WIKI_MAP_FEEDBACK",
    "lastUpdateTS": 1418199095358,
    "coordinates": [
      -122.4462810410399,
      37.77017601747043,
      0
    ],
    "guid": "cd6e81fc277c66c124a289e39b645c478694a768",
    "id": -19746,
    "type": "Point",
    "createdTS": 1418199095141,
    "properties": {
      "zoomLevel": 20,
      "jobStatus": "OPEN",
      "city": "San Francisco",
      "referenceIds": [
        "948902673"
      ],
      "error": 21,
      "number": "1476",
      "jobSolution": "NONE",
      "v": "2.7",
      "appId": "{YOUR_APP_ID}",
      "isocc": "USA",
      "details": "This address is incorrect",
      "pageURL": "https://www.here.com/?x=ep&map=-122.44667,37.77017,20,normal",
      "roadname": "Haight Street"
    }
  }
]

For more options when tracking the feedback status, see Table 1.