You can use a tag to restrict your results on the Nearby API. We support two types of tags, a single-word format for common use-cases and key-value pairs for advanced use-cases.
For most use-cases, the list of tags below should suffice. Multiple tags can be specified as a comma-separated list.
| Tag | Description |
|---|
| all | Return a list of all PoIs |
| airport | List of airports |
| restaurant | List of restaurants |
| bank | List of banks |
| atm | List of ATMs |
| hotel | List of hotels |
| pub | List of pubs |
| bus_station | List of bus stations |
| railway_station | List of railway stations |
| cinema | List of cinema theatres |
| hospital | List of hospitals |
| college | List of colleges |
| school | List of schools |
| pharmacy | List of pharmacies |
| supermarket | List of supermarket |
| fuel | List of fuel stations |
| gym | List of gyms |
| place_of_worship | List of places of worship |
| toilet | List of toilets |
| park | List of parks |
| stadium | List of stadiums |
| parking | List of parking |
| cardealer | List of car dealers |
For advanced use-cases that need additional tags not present in the table above, we also support tags based on OpenStreetMap''s (OSM) exhaustive list of tags. These tags are represented as key-value pairs of class and type values. Multiple class and type values can be specified as a comma-separated list.
Examples:
- To return a list of all PoIs: tag=all
- To return records with amenity class (e.g., restaurants, hospitals, banks): tag=amenity:*
- To return records with the amenity class and school as type (i.e., a list of schools): tag=amenity:school
- To return all records except those with amenity as class: tag=all,!amenity:*
- To return all records in the amenity class except gym: tag=amenity:*,!amenity:gym
- To return all records except elements with amenity as class and gym as type: tag=!amenity:gym
- To return a list of airports, hotels, and parking spaces nearby: tag=aeroway:aerodrome,tourism:hotel,amenity:parking
