The Places API lets you search for places.
You can search for places either by proximity or a text string.
A FindPlaceByText request takes a text parameter and returns a place.
Required parameters:
text - Text input that identifies the search target, such as a name or address.Optional parameters:
language - The two-letter language code in which to return results (ISO 639-1).bounds - Prefer results in a specified rectangular area. Format: south,west,north,east. Coordinates: decimal degrees.A FindPlacesNearby lets you search for places around location within a specified radius.
Required parameters:
location - The latitude/longitude around which to retrieve places.Optional parameters:
radius - The distance (in meters) within which to return results. Maximum: 10000 m.type - The type of places that are returned (see the list of allowed types below.).language - The two-letter language code in which to return results (ISO 639-1).The service returns a list of places along with details information about each place.
A Place contains the following fields:
Search for places by text string
FindPlaceByText - Endpoint Features
| Object | Description |
|---|---|
text |
[Required] A text string on which to search |
language |
Optional The two-letter language code in which to return results (ISO 639-1) |
bounds |
Optional Bounding rectangle. Format: south,west,north,east. Coordinates: decimal degrees. |
{
"results": [
{
"id": "578A19E791A33F37C5189F95D428ED1E",
"name": "Children's Creativity Museum",
"address": "221 4th St, San Francisco, CA 94103, United States",
"phone_number": "+14158203320",
"website": "http://www.creativity.org/",
"location": {
"lat": 37.783366,
"lng": -122.402325
},
"types": [
"museum",
"tourist_attraction"
]
}
]
}
curl --location --request GET 'https://zylalabs.com/api/3898/trueway+places+api/4605/findplacebytext?text=Children's Creativity Museum&language=en' --header 'Authorization: Bearer YOUR_API_KEY'
Search for nearby places
FindPlacesNearby - Endpoint Features
| Object | Description |
|---|---|
location |
[Required] The latitude/longitude around which to retrieve places |
type |
Optional The type of places that are returned |
radius |
Optional The distance (in meters) within which to return results |
language |
Optional The two-letter language code in which to return results (ISO 639-1) |
{
"results": [
{
"id": "1DE9131FF814DC997C6EEAF351D618EF",
"name": "Funny Library Coffee Shop",
"address": "250 4th St, San Francisco, CA 94103, USA",
"phone_number": "+14155346500",
"website": "https://virginhotels.com/san-francisco/dine-and-drink/funny-library/",
"location": {
"lat": 37.782442,
"lng": -122.402157
},
"types": [
"cafe",
"food",
"store"
],
"distance": 104
},
{
"id": "0BF71988AE26A020BCD7E06E8E42ED22",
"name": "Joyride Pizza - Yerba Buena Gardens",
"address": "730 Howard St, San Francisco, CA 94103, USA",
"phone_number": "+14152952914",
"website": "http://www.joyridepizza.com/",
"location": {
"lat": 37.784506,
"lng": -122.401944
},
"types": [
"bar",
"cafe",
"food",
"restaurant"
],
"distance": 131
}
]
}
curl --location --request GET 'https://zylalabs.com/api/3898/trueway+places+api/4606/findplacesnearby?location=37.783366,-122.402325&radius=1000&language=en' --header 'Authorization: Bearer YOUR_API_KEY'
| Header | Description |
|---|---|
Authorization
|
[Required] Should be Bearer access_key. See "Your API Access Key" above when you are subscribed. |
No long-term commitment. Upgrade, downgrade, or cancel anytime. Free Trial includes up to 50 requests.
The FindPlaceByText endpoint accepts parameters like text, language, and bounds. The FindPlacesNearby endpoint uses location, radius, type, and language. These parameters allow users to customize their searches effectively.
The response data is structured as a JSON object containing a "results" array. Each element in the array represents a place with its associated fields, making it easy to parse and utilize the information programmatically.
Both endpoints provide information about various places, including restaurants, museums, parks, and more. Users can search for specific types of places or explore nearby options based on their location.
Data accuracy is maintained through regular updates and quality checks from multiple sources. The API aggregates information from trusted databases, ensuring users receive reliable and up-to-date place details.
Typical use cases include finding nearby restaurants, locating tourist attractions, or searching for specific services like hospitals or banks. Developers can integrate this data into apps for navigation, travel planning, or local discovery.
Users can utilize the returned data by displaying place information in applications, filtering results based on types or distance, and linking to external websites for more details. This enhances user experience in location-based services.
Please have a look at our Refund Policy: https://zylalabs.com/terms#refund
To obtain your API key, you first need to sign in to your account and subscribe to the API you want to use. Once subscribed, go to your Profile, open the Subscription section, and select the specific API. Your API key will be available there and can be used to authenticate your requests.
You can’t switch APIs during the free trial. If you subscribe to a different API, your trial will end and the new subscription will start as a paid plan.
If you don’t cancel before the 7th day, your free trial will end automatically and your subscription will switch to a paid plan under the same plan you originally subscribed to, meaning you will be charged and gain access to the API calls included in that plan.
The free trial ends when you reach 50 API requests or after 7 days, whichever comes first.
No, the free trial is available only once, so we recommend using it on the API that interests you the most. Most of our APIs offer a free trial, but some may not include this option.
Yes, we offer a 7-day free trial that allows you to make up to 50 API calls at no cost, so you can test our APIs without any commitment.
Zyla API Hub is like a big store for APIs, where you can find thousands of them all in one place. We also offer dedicated support and real-time monitoring of all APIs. Once you sign up, you can pick and choose which APIs you want to use. Just remember, each API needs its own subscription. But if you subscribe to multiple ones, you'll use the same key for all of them, making things easier for you.
Service Level:
100%
Response Time:
342ms
Service Level:
100%
Response Time:
756ms
Service Level:
100%
Response Time:
712ms
Service Level:
100%
Response Time:
732ms
Service Level:
100%
Response Time:
605ms
Service Level:
100%
Response Time:
1,026ms
Service Level:
100%
Response Time:
664ms
Service Level:
100%
Response Time:
813ms
Service Level:
100%
Response Time:
921ms
Service Level:
100%
Response Time:
2,429ms
Service Level:
100%
Response Time:
742ms
Service Level:
100%
Response Time:
279ms
Service Level:
100%
Response Time:
246ms
Service Level:
100%
Response Time:
419ms
Service Level:
100%
Response Time:
695ms
Service Level:
100%
Response Time:
2,204ms
Service Level:
100%
Response Time:
849ms
Service Level:
100%
Response Time:
180ms
Service Level:
100%
Response Time:
973ms
Service Level:
100%
Response Time:
151ms