आपको उपयोगकर्ताओं को नजदीकी खोज करने देना होगा, मानचित्र पर एक पिन के लिए एक पता दिखाना होगा, और एक स्थान के लिए फ़ोटो और समीक्षाएँ खींचनी होंगी—इस सप्ताह। इस लेख के अंत तक, आप Zyla API Hub के Google Maps API पर स्थान अंत बिंदुओं को कॉल करने में सक्षम होंगे, एक स्थान की खोज करें, lat/lng द्वारा "यहाँ क्या है" को हल करें, और एक स्थान ID के लिए फ़ोटो और समीक्षाएँ प्राप्त करें।
यह API आपको क्या देती है
Zyla पर Google Maps API प्रदान करता है:
- खोज: पाठ क्वेरी के साथ स्थान खोजें जिसमें निर्देशांक, पता, फ़ोटो और place_id शामिल हैं।
- यहाँ क्या है: lat/lng के लिए पता और नजदीकी व्यवसाय संदर्भ को उलटें।
- स्थान फ़ोटो: अपने स्थान ID का उपयोग करके एक स्थान के लिए फ़ोटो प्राप्त करें।
- स्थान समीक्षाएँ: स्थान ID द्वारा एक स्थान के लिए उपयोगकर्ता समीक्षाएँ प्राप्त करें।
ये अंत बिंदु स्थान खोज, मानचित्र "मानचित्र पर टैप" अनुभव, और वेब और मोबाइल ऐप में स्थान विवरण दृश्य को शक्ति देते हैं।
Zyla API Hub पर शुरू करना
Zyla API Hub पर API पृष्ठ खोलें, उपलब्ध होने पर सब्सक्राइब या 7-दिन की परीक्षण अवधि शुरू करें, और अपना API कुंजी प्राप्त करें। Zyla एक सब्सक्रिप्शन और कोटा मॉडल पर चलता है (पे-पर-कॉल नहीं)। इस API के लिए, आप 7-दिन की परीक्षण अवधि या 50 अनुरोधों के साथ शुरू कर सकते हैं—वर्तमान पहुँच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जाँच करें।
हर अनुरोध को HTTP हेडर के साथ प्रमाणित करें:
- Authorization: Bearer YOUR_API_KEY
मार्केटप्लेस 10,000 से अधिक सार्वजनिक APIs को एकत्र करता है; एक खाता और एक API कुंजी सेवाओं में काम करते हैं, जिसमें लगातार बिलिंग होती है। एक मुफ्त खाता बनाएं और API पृष्ठ से सीधे एक कुंजी प्राप्त करें: Google Maps API पर 7-दिन की परीक्षण अवधि शुरू करें.
आप जिन अंत बिंदुओं का उपयोग करेंगे
1) खोज
पाठ द्वारा स्थान खोजें। नीचे दिया गया उदाहरण एक दिए गए ज़ूम स्तर पर "बर्लिन" की खोज करता है।
विधि: GET
URL: https://zylalabs.com/api/10107/google-maps-api/19301/search
क्वेरी पैरामीटर (नमूने से): query, zoom
curl -s -X GET "https://zylalabs.com/api/10107/google-maps-api/19301/search?query=Berlin&zoom=13" \
-H "Authorization: Bearer YOUR_API_KEY"
नमूना प्रतिक्रिया:
{
"status": "ok",
"data": [
{
"business_id": "0x47a84e373f035901:0x42120465b5e3b70",
"phone_number": null,
"name": "Berlin",
"full_address": "Berlin, Germany",
"full_address_array": [
"Germany"
],
"latitude": 52.520006599999995,
"longitude": 13.404954,
"review_count": null,
"rating": null,
"timezone": "Europe/Berlin",
"website": null,
"place_id": "ChIJAVkDPzdOqEcRcDteW0YgIQQ",
"place_link": "https://www.google.com/maps/place/data=!3m1!4b1!4m2!3m1!1s0x47a84e373f035901:0x42120465b5e3b70",
"types": null,
"price_level": null,
"working_hours": [],
"city": "Berlin, Germany",
"is_claimed": false,
"verified": true,
"is_permanently_closed": false,
"is_temporarily_closed": false,
"photos": [
{
"src": "https://lh3.googleusercontent.com/grass-cs/AABkmLffehkFWQeKJcoSb-1YW6L8asBOURQlYg7lDTzlg-TUUjHcP_iZA3YCo6lc1vSKHWpq9OwDIyiwB46OCe5IRwpsCCci5585tr4m6FnBlKPsaS3WVsEA1la8CVcIMhti5jyCmVBW=w203-h126-k-no",
"max_size": [
4963,
3102
],
"min_size": [
203,
100
]
},
{
"src": "https://lh3.googleusercontent.com/grass-cs/AABkmLcK-9P8aapCvGa0e5zeC2wBQm0Y01228VvLazWmPdE7yc_geBaO7DanSWf59BJSHospUgsiE7K6-VjWpB8b3c03ZfvnHzx3LwM50nvfCQ-DCaXA_fqLDhHnTrbcYAfCIzDumboTPQ=w203-h152-k-no",
"max_size": [
12000,
9000
],
"min_size": [
203,
100
]
},
{
"src": "https://lh3.googleusercontent.com/grass-cs/AABkmLfHzbwqyGh-qbjub4sgIBqFw1JqsU9wA-fOOAcEaQi24vqQnx47CebTSe9LxHMr6MfXW2M62qX94rtnpMeS9oFWfll0cW1avvFvgg1PWymyOTAen250DP6tK-Q_cVGIGL003WPOow=w203-h152-k-no",
"max_size": [
4032,
3024
],
"min_size": [
203,
100
]
},…
आप वास्तव में क्या उपयोग करेंगे:
- name, full_address, city: परिणाम शीर्षक और सारांश दिखाएं।
- latitude, longitude: मानचित्र को केंद्रित करें या निकटता की गणना करें।
- place_id, place_link: गहरे लिंक या विवरण प्राप्त करें (जैसे, फ़ोटो, समीक्षाएँ)।
- timezone: व्यावसायिक घंटों के लिए स्थानीय समय प्रदर्शित करें; मान IANA का पालन करते हैं (जैसे, Europe/Berlin)।
- photos[n].src: थंबनेल दिखाएं; max_size/min_size पिक्सेल आयाम हैं।
2) यहाँ क्या है
निर्देशांक के लिए पता और नजदीकी संदर्भ को उलटें। "मानचित्र पर लंबे प्रेस" प्रवाह या GPS को पढ़ने योग्य पते में परिवर्तित करने के लिए उपयोगी।
विधि: GET
URL: https://zylalabs.com/api/10107/google-maps-api/19306/what-is-here
आवश्यक क्वेरी पैरामीटर:
- lat (string): जैसे, 48.8719556
- lng (string): जैसे, 2.3415407
उदाहरण अनुरोध (स्पष्टता के लिए पैरामीटर दिखाए गए):
https://zylalabs.com/api/10107/google-maps-api/19306/what-is-here?lat=48.8719556&lng=2.3415407
उदाहरण प्रतिक्रिया (संक्षिप्त फ़ील्ड):
UI के लिए पता और समय क्षेत्र का उपयोग करें, डाउनस्ट्रीम कॉल के लिए place_id, और मानचित्र संरेखण के लिए निर्देशांक। मान मानक lat/lng डिग्री और IANA समय क्षेत्र नाम हैं।
3) स्थान फ़ोटो
अपने स्थान ID का उपयोग करके एक विशिष्ट स्थान के लिए फ़ोटो प्राप्त करें। स्थान विवरण पृष्ठ पर फ़ोटो गैलरी दिखाने के लिए आदर्श।
विधि: GET
URL: https://zylalabs.com/api/10107/google-maps-api/19307/place-photos
अनुरोध पैरामीटर: प्रमाणन के अलावा यहाँ कोई भी प्रलेखित नहीं है। इसका उपयोग एक स्थान से संबंधित फ़ोटो प्राप्त करने के लिए करें।
4) स्थान समीक्षाएँ
स्थान ID द्वारा एक स्थान के लिए उपयोगकर्ता समीक्षाएँ प्राप्त करें ताकि विवरण पृष्ठों को रेटिंग और टिप्पणियों के साथ समृद्ध किया जा सके।
विधि: GET
URL: https://zylalabs.com/api/10107/google-maps-api/19305/place-reviews
अनुरोध पैरामीटर: प्रमाणन के अलावा यहाँ कोई भी प्रलेखित नहीं है।
कोड कॉपी-पेस्ट करें: खोजें और परिणामों को पार्स करें
नीचे दिया गया स्निपेट खोज अंत बिंदु को कॉल करता है, निर्देशांक पढ़ता है, और एक सरल "नजदीकी खोज" UI के लिए आवश्यक फ़ील्ड निकालता है। Zyla से अपनी कुंजी के साथ YOUR_API_KEY को बदलें।
import requests
API_KEY = "YOUR_API_KEY"
url = "https://zylalabs.com/api/10107/google-maps-api/19301/search"
params = {
"query": "Berlin",
"zoom": "13"
}
headers = {
"Authorization": f"Bearer {API_KEY}"
}
resp = requests.get(url, headers=headers, params=params, timeout=20)
resp.raise_for_status()
payload = resp.json()
if payload.get("status") == "ok":
results = payload.get("data", [])
for item in results:
name = item.get("name")
address = item.get("full_address")
lat = item.get("latitude")
lng = item.get("longitude")
place_id = item.get("place_id")
timezone = item.get("timezone")
photos = item.get("photos", [])
# Print a compact line for your UI or logs
print(f"{name} | {address} | {lat},{lng} | place_id={place_id} | tz={timezone}")
# Use the first photo if available
if photos:
first_photo_url = photos[0].get("src")
print(f"Thumbnail: {first_photo_url}")
else:
raise RuntimeError(f"Search failed: {payload}")
डिज़ाइन नोट्स जो आपका समय बचाएंगे
- समय क्षेत्र: API IANA नाम लौटाता है (जैसे, Europe/Berlin)। अपने समय पुस्तकालयों के साथ स्थानीयकरण के लिए इन्हें सीधे उपयोग करें।
- निर्देशांक: अक्षांश और देशांतर दशमलव डिग्री हैं। निकटता क्रम के लिए, महान-वृत्त दूरी की गणना करें या उपयोगकर्ता के स्थान के चारों ओर बाउंडिंग बॉक्स का उपयोग करें।
- थंबनेल: खोज प्रतिक्रिया पहले से ही विभिन्न आकारों के साथ फ़ोटो शामिल करती है। बाद के लोड को कम करने के लिए अपनी तरफ फ़ोटो URLs को कैश करें।
- स्थान IDs: यदि आप बाद में फ़ोटो या समीक्षाएँ प्राप्त करने की योजना बनाते हैं तो खोज या यहाँ क्या है से place_id को स्टोर करें। यह स्थिर पहचानकर्ता है जो अंत बिंदुओं को जोड़ता है।
- कोटा: Zyla सब्सक्रिप्शन + कोटा का उपयोग करता है, पे-पर-कॉल नहीं। अपने डैशबोर्ड में उपयोग की निगरानी करें। Google Maps API लिस्टिंग 7-दिन की परीक्षण अवधि या 50 अनुरोधों की पेशकश करती है।
इसे एक साथ रखना: नजदीकी खोज प्रवाह
एक न्यूनतम "नजदीकी खोज" प्रवाह अक्सर तीन स्क्रीन की आवश्यकता होती है: एक खोज बॉक्स, एक मानचित्र सूची, और एक स्थान विवरण। यहाँ प्रत्येक चरण को ऊपर दिए गए अंत बिंदुओं से कैसे मैप किया जाए।
- उपयोगकर्ता एक शब्द टाइप करता है: निर्देशांक, समय क्षेत्र, फ़ोटो और place_id के साथ उम्मीदवार प्राप्त करने के लिए खोज को कॉल करें।
- उपयोगकर्ता मानचित्र पर टैप करता है: पढ़ने योग्य पता दिखाने के लिए lat/lng के साथ यहाँ क्या है को कॉल करें और गहरे विवरण के लिए place_id को कैप्चर करें।
- उपयोगकर्ता एक स्थान खोलता है: विवरण पृष्ठ को समृद्ध करने के लिए स्थान फ़ोटो और स्थान समीक्षाएँ लोड करने के लिए place_id का उपयोग करें।
प्रदर्शन के लिए, खोज प्रतिक्रियाओं को क्वेरी+ज़ूम द्वारा एक छोटे TTL (जैसे, कुछ मिनट) के लिए कैश करें। जब उपयोगकर्ता मानचित्र को खींचता है, तो केवल तब फिर से क्वेरी करें जब केंद्र आपके थ्रेशोल्ड से परे बदलता है।
अंत बिंदु संदर्भ उदाहरणों के साथ
खोज
GET https://zylalabs.com/api/10107/google-maps-api/19301/search
उदाहरण अनुरोध (आधिकारिक नमूने से):
https://zylalabs.com/api/10107/google-maps-api/19301/search?query=Berlin&zoom=13
यहाँ क्या है
GET https://zylalabs.com/api/10107/google-maps-api/19306/what-is-here
आवश्यक पैरामीटर: lat, lng
उदाहरण अनुरोध:
https://zylalabs.com/api/10107/google-maps-api/19306/what-is-here?lat=48.8719556&lng=2.3415407
स्थान फ़ोटो
GET https://zylalabs.com/api/10107/google-maps-api/19307/place-photos
यहाँ कोई अनुरोध पैरामीटर प्रमाणित नहीं हैं।
स्थान समीक्षाएँ
GET https://zylalabs.com/api/10107/google-maps-api/19305/place-reviews
यहाँ कोई अनुरोध पैरामीटर प्रमाणित नहीं हैं।
AI एजेंटों के माध्यम से API कॉल करें
Zyla पर हर API को MCP-संगत क्लाइंट (Claude Code, Cursor, Windsurf, और अन्य) से भी कॉल किया जा सकता है। अपने क्लाइंट को MCP अंत बिंदु पर इंगित करें और अपनी कुंजी प्रदान करें:
- अंत बिंदु: https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
वहाँ से, आपके एजेंट उपकरण ऊपर प्रलेखित समान Google Maps API अंत बिंदुओं को सक्रिय कर सकते हैं। अपने पसंदीदा संपादक या एजेंट रनटाइम में सेटअप के लिए MCP दस्तावेज़ देखें।
वास्तविक दुनिया के उपयोग के मामले जिन्हें आप इस सप्ताह भेज सकते हैं
- स्टोर लोकेटर: खोजें "Mitte के पास कॉफी" के साथ खोजें, फिर स्थान फ़ोटो और समय क्षेत्र-सचेत लेबल के साथ विवरण पृष्ठों पर घंटे और फ़ोटो दिखाएं।
- मानचित्र टैप-टू-पता: जब उपयोगकर्ता मानचित्र पर लंबे प्रेस करते हैं, तो यहाँ क्या है को कॉल करें ताकि एक पता कार्ड दिखा सकें और "इस स्थान को सहेजें" सक्षम कर सकें।
- शहर गाइड: लोकप्रिय क्वेरी के लिए खोज परिणामों को पूर्व-फेच करें; बेहतर निर्णय लेने के लिए स्थान समीक्षाओं के साथ विवरण पृष्ठों को हाइड्रेट करने के लिए place_id का उपयोग करें।
- बुकिंग या डिलीवरी रेडियस: उपयोगकर्ता की स्थिति से दूरी के आधार पर खोज परिणामों को फ़िल्टर करें और केवल उन वस्तुओं को प्रदर्शित करें जो आपकी सेवा रेडियस के भीतर हैं।
समस्या निवारण टिप्स
- प्रमाणन विफलताएँ: सुनिश्चित करें कि सटीक हेडर प्रारूप Authorization: Bearer YOUR_API_KEY है और कोई अतिरिक्तWhitespace नहीं है।
- Sparse परिणाम: अपने क्वेरी पाठ को समायोजित करें (जैसे, एक शहर का नाम जोड़ें) या खोज संदर्भ को चौड़ा/संकीर्ण करने के लिए ज़ूम बदलें।
- समय-संवेदनशील UI: स्थानीयकरण के लिए समय क्षेत्र फ़ील्ड का उपयोग करें।
- नेटवर्क विश्वसनीयता: अस्थायी त्रुटियों पर छोटे समय सीमाएँ और बुनियादी पुनः प्रयास लागू करें; स्थिर फ़ील्ड जैसे place_id और पता कैश करें।
अक्सर पूछे जाने वाले प्रश्न
मैं प्रमाणित कैसे करूँ?
हर अनुरोध पर Authorization: Bearer YOUR_API_KEY भेजें।
क्या कोई मुफ्त योजना है?
नहीं। यह API सब्सक्रिप्शन + कोटा पर चलती है। वर्तमान पहुँच विकल्पों के लिए API पृष्ठ की जाँच करें; आप 7-दिन की परीक्षण अवधि शुरू कर सकते हैं या मूल्यांकन के लिए 50 अनुरोधों का उपयोग कर सकते हैं।
मैं एक स्थान की फ़ोटो या समीक्षाएँ कैसे प्राप्त करूँ?
खोज या यहाँ क्या है से place_id का उपयोग करें, फिर क्रमशः स्थान फ़ोटो या स्थान समीक्षाएँ कॉल करें।
अक्षांश/देशांतर के लिए क्या इकाइयाँ हैं?
दशमलव डिग्री। समय क्षेत्र IANA स्ट्रिंग हैं जैसे Europe/Paris।
क्या मैं इसे AI एजेंट से कॉल कर सकता हूँ?
हाँ। MCP-संगत क्लाइंट में MCP अंत बिंदु (https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY) का उपयोग करें और समान अंत बिंदुओं को सक्रिय करें।
क्या आप अपने नजदीकी खोज को भेजने के लिए तैयार हैं? Zyla API Hub पर अपना खाता बनाएं और लिस्टिंग पर सीधे 7-दिन की परीक्षण अवधि शुरू करें: Google Maps API पर 7-दिन की परीक्षण अवधि शुरू करें.