Level of Detail

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

Below 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"
        }
      ]
    }
  ]
}
Example of isoline with many points
Figure 1. Example of isoline with many points

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.

Note : Quality and correctness of isoline degrades as maxPoints value is decreased. Hence we have limited the value to be not less than 30 max points. It is recommended to use maxPoints value greater than 100 for optimal quality isolines.

Below 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"
        }
      ]
    }
  ]
}
Example of isoline with max points applied
Figure 2. Example of isoline with max points applied

results matching ""

    No results matching ""