Tags

Tags are categorical labels that help organize and classify geographic sets. They provide a flexible way to group related geographic areas together for efficient querying and filtering.

What are Tags?

A tag is a simple string identifier attached to a set that categorizes it. Tags act as buckets that can contain many sets, making it easy to query for all geographic areas of a certain type.

json

"uuid": "80a25c7e-f0de-4be0-be9d-6826ac63c792"

"name": "Zion National Park"

Common Tags

Deliberate API comes pre-loaded with thousands of geographic sets organized by tags. Here are some commonly used tags:

United States

us_state - U.S. states
us_county - U.S. counties
us_national_park - U.S. national parks
us_national_scenic_trail - National scenic trails

Global

world_country - Countries around the world
ocean - Oceans
sea - Seas
timezone - Time zones

Maritime

port - Ports
terminal - Ocean terminals

Querying by Tags

Use the tags filter in your queries to find sets by their tags. The contains operator checks if a set has a specific tag:

json

Multiple Tags

Sets can have multiple tags. Use contains_all to find sets that have all specified tags:

json

Custom Tags

When you create your own geographic sets, you can assign custom tags to organize them according to your application's needs. Tags can be anything that makes sense for your use case—from simple categories like warehouse or delivery_zone to more specific identifiers.