## Street Attributes Overview

### Introduction

Street Attributes is a method in the Street Attributes API service that turns real traffic signs into structured data. Send a GPS coordinate, and it returns the nearest road's name and shape, its speed limit, and every traffic-sign rule attached to it — including which lane, which vehicle type, and which day or hour each rule applies to.

### Why use Street Attributes

Real streets carry rules a plain map can't show — speed limits, vehicle-specific bans, time-of-day restrictions. Street Attributes gives you this data on demand, so your app can:

- Apply the correct speed limit at any point.
- Keep vehicles off streets, lanes, or turns they aren't allowed to use, by vehicle type.
- Respect restrictions that only apply on certain days or hours.


Useful for navigation, ride-hailing, delivery, and fleet-management apps that need road-rule context without building their own traffic-sign database.

### What's available today

With the Street Attributes API, you can:

- **Find the nearest road** to any GPS coordinate, along with its name and shape.
- **Get the road's overall speed limit.**
- **Get restrictions down to the lane level** — for each lane, which vehicle types it applies to, minimum/maximum speed, allowed lane changes and turns, and weight limits.
- **Know exactly when a rule is active** — many restrictions only apply on specific days or hours, and the API returns the exact schedule.
- **Identify the sign behind each rule** — its name, location, and category (prohibition, warning, mandatory, and more), covering over 50 official traffic-sign types.


This method shipped as part of the first Digime Map API release and is available for production use today.

> Street Attributes reports the rules for the nearest road segment only — it doesn't plan a route. Pair it with a routing API to apply these rules across an entire trip.


### How Street Attributes works

The Street Attributes API accepts an HTTP GET request with query parameters that contains the request details.

> Example:


```bash
curl --request GET \
  --url "https://dplace-api.themap.world/street-attributes/v2/ways/way-attributes" \
  --get \
  --data-urlencode "latitude=10.8008266" \
  --data-urlencode "longitude=106.7528268" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  --header "Accept: application/json"
```

The service then finds the nearest road segment to the given coordinate and returns its street name, ordered coordinates, maximum speed, and traffic-sign attributes.