places_search
Find places in a city
Finds places of one kind in a city or area from OpenStreetMap: restaurants, cafes, bars, hotels, hostels, museums, attractions, pharmacies, hospitals, supermarkets, ATMs, parking, EV charging, parks… with address, coordinates, opening hours, website and phone when known.
Use when: someone asks for "restaurants in Rome", "museums in Amsterdam", "a pharmacy in Brussels".
Example: {"what":"restaurant","where":"Rome","limit":10}
輸入參數langwhat必填limitwhere必填
places_near
Find places near a point
Finds places of one kind around a latitude/longitude or an address (up to 5 km), nearest first, with distance in meters.
Use when: you need the closest pharmacy, ATM, restaurant, charging station… to the user's location or to an address.
Example: {"what":"pharmacy","lat":50.8467,"lon":4.3525,"radius_m":1000} or {"what":"pharmacy","where":"Grand-Place, Brussels"}
輸入參數latlonlangwhat必填limitwhereradius_m
geocode_address
Address or place name to coordinates
Turns an address, a place name or a city into coordinates (latitude, longitude) with its full address, type and country. Worldwide, any language.
Use when: you need coordinates for a map, a distance, weather or places_near.
Example: {"query":"Grand-Place, Brussels"}
輸入參數langlimitquery必填
reverse_geocode
Coordinates to address
Turns a latitude/longitude into the nearest address (street, postcode, city, country).
Use when: you have GPS coordinates and need a readable address.
Example: {"lat":48.8584,"lon":2.2945}
輸入參數lat必填lon必填lang
