Specify the level of detail

The isoline polygon may contain a lot of points which might be a problem for clients processing the response.

The following is an example of the 10 km isoline calculated in the center of Berlin:

curl -X GET \
  'https://isoline.router.hereapi.com/v8/isolines?transportMode=car&origin=52.51578,13.37749&range[type]=distance&range[values]=10000&routingMode=short'

Response:

{
  "departure": {
    "place": {
      "type": "place",
      "location": {
        "lat": 52.5157611,
        "lng": 13.3774232
      },
      "originalLocation": {
        "lat": 52.51578,
        "lng": 13.37749
      }
    }
  },
  "isolines": [
    {
      "range": {
        "type": "distance",
        "value": 10000
      },
      "polygons": [
        {
          "outer": "BG696kkD0j4nZ-qBmgBuVsgCA61CwVsgC8qBA-qB9qB-qBA8qB-qB4gE-qBuVsgCA61CwVsgC61C61C-qBA8qB7qBsgCvV81CAsgCwV8qB8qBsgCwVsgCvVuVrgCA51CwVrgC8qB9qB-qB3gEsgCtVsgCuVuVsgCtVsgC9qB-qBA-qB4gE4gEwVsgCvVsgC7qB8qB9qB4gE3gE4gEtVsgCuVsgC4gE-qBuVsgCA61CtVsgC9qB8qBtVsgCA81CuVsgC-qB8qBuVsgCA81CwVsgC61C61C-qBAuVrgCAltNuVrgC81C51CsgCtVqgCuV-qB-qB-qBAuVrgCAp3KuVrgCsgCvVsgCwVwVsgCAktNuV61C-qB-qBuV9qBA51CuVrgCsgCtVsgCuV-qB4gE4gE4gEuVsgCtVsgC51C61C3gE-qBvVsgCA2rFwVqgC61C81CsgCuVsgCtV4gE3gEsgCtV61CAsgCuVuVsgCA61CtVsgC9qB-qBtVsgCA61CuVsgC4gE-qBwVsgCAuhIvVsgC7qB-qBA-qB8qB8qBwVsgCuV81CsgCsgCsgC8qBuVsgCAmtNtVsgC9qB8qBtVsgCuVsgC4gE-qBuVsgCA61CwVsgC8qB-qBwVsgCA61CuVsgCsgCuV2rFAsgCtV0rF1rFuVrgCA51CtVrgC7qB9qBvVrgCAp3KwVrgC61C51CsgCtVsgCuV61C61C-qB4gE8qBA-qB7qBsgCvVsgCwVuVsgCA61CwVsgC4gE-qBuVqgCA81CtVsgC9qB8qBtVsgCA81CuVsgC4gE4gEuVsgCAuhIuVsgC-qB-qBuVsgCA2rFtVsgC3gE8qB7qB4gE9qB-qBtVsgCA61CuVsgC4gE-qB61C61C-qB4gEsgCuVsgCtV8qB9qBsgCtVsgCuV-qB4gE-qB-qBuVsgCtVsgC9qB8qBA-qBsgCuV61CAsgCwVuVsgCA0rFtVsgC3gE-qBtVsgCA0rFuVsgC-qB-qB8qB4gE4gE4gEwVsgCvVsgC7qB8qBA-qB8qB-qBwVsgCAwhIuVsgC4gE2gEuVsgCAwhIwVsgC8qB-qBwVsgCA61CvVsgC3gE-qB7qB4gE3gE8qBvVsgCA81CtVsgC9qB8qB7qB4gE9qB-qBtVsgCA0rFtVsgC9qB-qB9qB4gE7qB-qBvVsgCwVsgC8qBA-qB9qB-qBA61C61CA-qB3gE4gEA8qB-qB-qBuVsgCA61CtVsgC3gE-qBA-qB8qB8qBwVsgCA61CvVsgC3gE-qB7qB4gErgCuVrgCtVvVrgCA51CtVrgC9qB9qB7qB3gE9qBA51C81CA8qB-qB-qBuVsgCA61CtVsgC3gE-qBA8qB61C81C-qBA8qB9qB-qBA61C61CuVsgCAwhIwVsgC8qB-qBwVsgCA0rFuVsgCy2Gy2GwVsgCvVsgC3gE4gE7qB4gE9qB-qB9qB4gE7qB8qBA-qB8qB-qBwVsgCA0rFvVsgC7qB-qB9qB4gErgCuVrgCtV7qB9qBrgCtVrgCuV9qB-qB3gE-qBA8qB-qB-qBuVsgCAq3KtVsgC3gE-qBvVsgCwVsgC4gE8qBuVsgCtVsgC9qB-qB9qB4gE7qB8qB9qB4gE3gE4gEtVsgCA61CvVsgCrgCwVpgCvV9qB7qB9qBAtVsgCA61CtVsgC9qB-qBtVsgCA61CvVsgCrgCuVrgCtV7qB3gErgCtVrgCuVvVsgCwVsgC8qB-qBwVqgCAs3KvVsgCrgCuVrgCtV7qB3gE9qB9qB7qB3gE9qBAtVsgCAwhIvVsgCrgCuV51CArgCwVtVsgCAq3KvVsgCrgCuVzrFArgCuV9qB-qBrgCuVrgCtV7qB3gE9qBA1rF2rFA8qB-qB-qBuVsgCA61CtVsgC9qB-qB7qB4gErgCuVrgCtV9qB3gE7qB9qB9qB3gE3gE7qB9qB3gE51C71C9qBA7qB-qB9qBA9qB9qBrgCtVthIArgCuVvVsgCA2rFtVsgC3gE8qB9qB4gErgCwVrgCvVtVrgCA51CtVrgC9qBAtVsgCAq3KtVsgC71C81C7qBA9qB3gE3gE3gEtVrgCA71CuVrgC-qB7qBA9qB3gE7qBvVrgCA71CwVrgC4gE7qB8qB3gE4gE3gEwVrgCA51CvVrgCrgCvVrgCwV7qB2gE3gE-qB9qB-qB3gE8qB3gE4gErgCwVrgCvVtVrgCA51CtVrgCrgCtV71CArgCvV7qB1gE9qBA9qB8qB7qBA51C51CvVrgCwVrgC8qB9qBuVrgCA51CwVrgC8qB9qB-qB1gEy2Gz2G-qB3gE-qB7qB8qB3gE4gE9qBwVrgCA51CvVrgC7qBA9qB4gE3gE8qB9qB-qB3gE-qBtVsgCA0rFtVsgC1rF2rFrgCuVrgCtVtVrgCtV51C9qB9qBtV-qBA0rFvVsgCrgCuVrgCtV7qB7qBrgCvV71CArgCwV7qB8qB9qBA3gE3gErgCtVp3KArgCtVtVrgCA71CuVrgC4gE3gEuVrgCA51CtVrgC9qBA7qB4gE3gE-qB9qB4gE51C61CrgCuV51CArgCwVvVsgCA61CtVsgCrgCuVrgCtVtVrgCAvhIvVrgC7qB9qBtVrgCuVrgC8qB7qBwVrgCA54SvV51C7qB9qB9qBuVrgCwVrgCvVtVrgCuVrgCy2Gx2GwVrgCvVrgC7qBAx2Gy2GrgCwV71CArgCvV7qB3gE9qBA9qB-qB7qBAvVrgCA51CwVrgC8qB9qBwVrgCA51CuVrgC-qB9qBuVrgCAvhItVrgC3gE1gEvVrgCA71CwVrgC4gE7qBuVrgCA54StVrgC3gE9qBvVrgCA51CwVrgC8qB9qBA7qB1gE3gEA9qB8qB9qBA7qB51C71C3gE7qB9qB3gE7qB9qB9qB3gE3gE7qB9qB9qB3gE9qB7qB3gE9qB7qBtVrgCA71CtVrgC9qBA9qB-qBrgCuVrgCtV7qB3gE9qB7qB9qB3gE3gE9qBtVrgCuVrgC02Gx2GuVrgCAltNtVrgC9qB7qBtVrgCuVrgC4gE9qB-qB3gE8qB7qB-qB3gE0rF1rF-qBA-qB-qBsgCuV0rFAsgCtVwVrgCA1rFvVrgC3gE3gEtVrgCAvhItVrgC9qBA3gE4gErgCwVrgCvVtVrgCAthIuVrgC-qB9qBA9qB9qB7qBtVrgCuVrgC-qB9qBuVrgCA_iQuVrgC81C51C4gE9qBA7qB9qB9qBtVrgCA51CuVrgC4gE3gEuVrgCA51CtVrgC9qB9qBtVrgCAzrFtVrgC3gE9qBvVrgCA51CwVrgC8qB9qBwVrgCA51CuVrgC-qB9qBuVrgCAzrFuV71C-qB51CuV51CwVrgC4gE3gEuVrgCA51CuVrgCsgCvVsgCwVuVsgCA61CwVsgCsgCuVsgCtV0rF1rF-qB3gE4gE7qB-qB3gEsgCvVqgCwV-qB4gE-qBA8qB3gE4gE9qBA9qB7qB7qBvVrgCAvhIwVrgCsgCtV61CAsgCvV61C51CA9qB7qB7qBvVrgCA51CwVrgC8qB9qBwVrgCA51CuVrgCsgCvVsgCwV8qB8qBsgCwV81CAsgCvV8qB3gE-qB7qB-qB3gE8qB9qB-qB3gE4gE7qBuVrgCA71CuVrgCsgCtV81CAsgCtVuVrgCA1rFuVrgCsgCtVsgCuV4gE4gE-qBA-qB9qB2gE7qB4gE3gEsgCtVsgCuVwVsgCuV61C-qB-qBuV9qBuVrgCsgCtVsgCuV-qB-qB8qBA81C51CA9qB3gE9qB9qB7qB3gE9qB7qB9qB3gE7qB71C71CtVrgCA51CuVrgCsgCtVsgCuV4gE4gE4gE-qB-qB8qBsgCwVsgCvVuVrgCAjtNtVrgC9qB9qBtVrgCuVrgC-qB7qB8qB3gE4gE9qB-qB7qB-qB3K8qBsgC"
        }
      ]
    }
  ]
}

The shape[maxPoints] option can be used if the client is limited on the number of points it is able to process.

If this parameter is used, the service will automatically adjust the level of detail and perform shape simplification in order to fit within the limit.

The following is an example of the same request with fewer points in the response:

curl -X GET \
  'https://isoline.router.hereapi.com/v8/isolines?transportMode=car&origin=52.51578,13.37749&range[type]=distance&range[values]=10000&routingMode=short&shape[maxPoints]=50'

Response:

{
  "departure": {
    "place": {
      "type": "place",
      "location": {
        "lat": 52.5157611,
        "lng": 13.3774232
      },
      "originalLocation": {
        "lat": 52.51578,
        "lng": 13.37749
      }
    }
  },
  "isolines": [
    {
      "range": {
        "type": "distance",
        "value": 10000
      },
      "polygons": [
        {
          "outer": "BGkw9nkDkq7oZq3Kq6a0uV2uV2uV-rgC0uV0uVq3K-lgBAm1rFp3K-lgBzuV2uV1uV-rgCn9qBo9qB9rgC2uV1uV0uVzuVAx61Cx61Cr3K_lgBAn9qBp3K_lgBzuVzuVp3K_lgBAj1rFq3K_lgB83gE73gE-lgBp3Kq9qBAgmgB2rFq3K-iQAq6a"
        }
      ]
    }
  ]
}