Return place suggestions while a user types, grouped into a billable search session.

Sends this request to the live API and shows the real response.

Parameters

qrequiredstringmin length 1

langoptionalstring17 options

session_tokenoptionalstring

bboxoptionalstring

proximityoptionalstring

typesoptionalstring

curl \
  -H "X-MapScale-Key: $MAPSCALE_API_KEY" \
  "https://api.mapscale.io/v1/autocomplete?q=Siam+Paragon&lang=th"

Default response

{
  "predictions": [
    {
      "place_id": "place_bangkok_123",
      "description": "Siam Paragon, Pathum Wan, Bangkok",
      "structured_formatting": {
        "main_text": "Siam Paragon",
        "secondary_text": "Pathum Wan, Bangkok"
      }
    }
  ]
}

Responses

200Autocomplete predictionsapplication/json

400Invalid requestapplication/json

401mapscale/effect-api/UnauthorizedFailureapplication/json

403mapscale/effect-api/ForbiddenFailureapplication/json

404Not foundapplication/json

429mapscale/effect-api/RateLimitedFailureapplication/json

500mapscale/effect-api/MiddlewareInternalFailureapplication/json

502Upstream geocoding engine failureapplication/json

503Upstream geocoding engine unavailable | mapscale/effect-api/UpstreamUnavailableFailureapplication/json

Autocomplete a place or address query

Parameters

Responses

On this page