कैसे निर्देशांक द्वारा खोजें

आपके पास एक मानचित्र क्लिक या मोबाइल GPS रीडिंग से एक lat/long है, और आपको अभी पास की संपत्तियों को प्राप्त करने की आवश्यकता है। इस गाइड के अंत तक आप एक वास्तविक भू-स्थानांतरण एंडपॉइंट को एक केंद्र निर्देशांक और व्यास के साथ क्वेरी करेंगे, प्रतिक्रिया को पार्स करेंगे, और इसे Zyla API Hub से एकल API कुंजी का उपयोग करके भेजेंगे।

आप निर्देशांक-आधारित खोज के साथ क्या बना सकते हैं

Zyla API Hub पर रियल-टाइम ज़िलो डेटा API लाइव संपत्ति डेटा लौटाता है जिसे आप भूगोल द्वारा फ़िल्टर कर सकते हैं। इसके साथ आप:

• एक मानचित्र टैप या GPS पिंग के बाद एक उपयोगकर्ता के सटीक स्थान के चारों ओर लिस्टिंग दिखाएं।
• अपने रियल एस्टेट ऐप में स्थान-जानकारी वाले फीचर्स को एक साफ API के पीछे गेट करें।
• जब आवश्यक हो, पड़ोस की सीमाओं या कस्टम आकारों के लिए बहुभुज पर खोजें।

यह API डेटा लौटाता है जैसे zpid, पता, अक्षांश/देशांतर, घर का प्रकार, कीमत, अनुमान, और अधिक—जैसे भू-स्थानांतरण उपयोग के मामलों के लिए “यहां क्या बिक्री पर है?”

Zyla API Hub पर शुरू करना

API पृष्ठ खोलें, सदस्यता लें, और अपनी कुंजी प्राप्त करें। Zyla एक खाते, एक API कुंजी, और 10,000 से अधिक सार्वजनिक APIs के बीच एक सदस्यता + कोटा मॉडल का उपयोग करता है। इस API के लिए, आप 7-दिन की परीक्षण अवधि शुरू कर सकते हैं या अपने एकीकरण को मान्य करने के लिए 50 अनुरोध कर सकते हैं।

रियल-टाइम ज़िलो डेटा API पर 7-दिन की परीक्षण अवधि शुरू करें

आप एंडपॉइंट्स को Authorization: Bearer YOUR_API_KEY के साथ कॉल करेंगे और प्रति-कॉल मूल्य निर्धारण आश्चर्य नहीं होगा—बस अपनी सदस्यता कोटा का उपयोग करें। आप कभी भी Zyla API Hub पर अधिक श्रेणियों को ब्राउज़ कर सकते हैं।

भू-स्थानांतरण के लिए आप जिन एंडपॉइंट्स का उपयोग करेंगे

नीचे सभी अनुरोध Zyla Hub URLs और Authorization हेडर में एक Bearer टोकन का उपयोग करते हैं।

निर्देशांक द्वारा खोजें

एक केंद्र lat/long के चारों ओर संपत्तियों के लिए खोजें, वैकल्पिक रूप से व्यास द्वारा संकीर्ण करें।

• विधि: GET
• URL: https://zylalabs.com/api/7341/real-time-zillow-data-api/11668/search-by-coordinates
• आवश्यक पैरामीटर:
  • long (string): देशांतर (जैसे, -118.504744)
  • lat (string): अक्षांश (जैसे, 34.01822)
• वैकल्पिक पैरामीटर:
  • व्यास (string): जैसे, 2

curl -s -X GET "https://zylalabs.com/api/7341/real-time-zillow-data-api/11667/search?location=Los+Angeles%2C+CA&page=2&home_status=FOR_SALE" \
-H "Authorization: Bearer YOUR_API_KEY"

उदाहरण प्रतिक्रिया:

{
"status": "OK",
"request_id": "81fc95df-86f3-44b7-a3dc-1d81abcd7a97",
"parameters": {
"page": 2,
"home_status": "FOR_SALE",
"sort": "DEFAULT",
"listing_type": "BY_AGENT",
"location": "Los Angeles, CA"
},
"data": [
{
"zpid": "136702358",
"homeStatus": "FOR_SALE",
"detailUrl": "https://www.zillow.com/homedetails/24425-Woolsey-Canyon-Rd-SPC-39-Canoga-Park-CA-91304/136702358_zpid/",
"address": "24425 Woolsey Canyon Rd Spc 39, Canoga Park, CA 91304",
"streetAddress": "24425 Woolsey Canyon Rd Spc 39",
"city": "Canoga Park",
"state": "CA",
"country": "USA",
"zipcode": "91304",
"latitude": 34.235462,
"longitude": -118.661224,
"homeType": "MANUFACTURED",
"price": 99500,
"currency": "USD",
"zestimate": 178100,
"rentZestimate": 3439,
"taxAssessedValue": 21901,
"bathrooms": 2,
"bedrooms": 4,
"livingArea": 1818,
"daysOnZillow": 5,
"isFeatured": false,
"isPreforeclosureAuction": false,
"timeOnZillow": 498172000,
"isNonOwnerOccupied": true,
"isPremierBuilder": false,
"isZillowOwned": false,
"unit": "Spc 39",
"isShowcaseListing": false,
"listingSubType": {
"is_FSBA": true
},
"palsId": "3007_SR26162189",
"id": "136702358",
"rawHomeStatusCd": "ForSale",
"marketingStatusSimplifiedCd": "For Sale by Agent",
"imgSrc": "https://photos.zillowstatic.com/fp/1d8602169bd359c27caa6d6e25cdf662-p_e.jpg",
"hasImage": true,
"statusType": "FOR_SALE",
"statusText": "Home for sale",
"countryCurrency": "$",
"unformattedPrice": 99500,
"addressStreet": "24425 Woolsey Canyon Rd Spc 39",
"addressCity": "Canoga Park",
"addressState": "CA",
"addressZipcode": "91304",
"isUndisclosedAddress": false,
"shouldShowRequestOnPrice": false,
"beds": 4,
"baths": 2,
"area": 1818,
"latLong": {
"latitude": 34.235462,
"longitude": -118.661224
},
"flexFieldText": "5 days on…

आप वास्तव में प्रतिक्रिया से क्या उपयोग करेंगे:

• data[].zpid: स्थिर संपत्ति पहचानकर्ता
• data[].latitude, data[].longitude: मानचित्र पर प्लॉट करने के लिए
• data[].price और currency: पिन के साथ प्रदर्शित करने के लिए मूल्य निर्धारण
• data[].address, city, state, zipcode: लेबल और संदर्भ
• data[].homeStatus/homeType: UI में त्वरित फ़िल्टर
• parameters.long/lat/diameter: पुष्टि करता है कि क्वेरी को कैसे व्याख्यायित किया गया था

खोजें

स्थान लेबल (काउंटी, पड़ोस, शहर, या ज़िप कोड) द्वारा खोजें। यह तब सहायक होता है जब एक उपयोगकर्ता “लॉस एंजेलेस, सीए” टाइप करता है या ऑटोकम्प्लीट से एक शहर चुनता है।

• विधि: GET
• URL: https://zylalabs.com/api/7341/real-time-zillow-data-api/11667/search
• आवश्यक पैरामीटर:
  • location (string): जैसे, लॉस एंजेलेस, सीए
• वैकल्पिक पैरामीटर:
  • page (string)
  • home_status (string): जैसे, FOR_SALE

आधिकारिक उदाहरण:

जब आपका UX एक स्थान टेक्स्ट इनपुट से शुरू होता है, तो इसका उपयोग करें न कि मानचित्र क्लिक से। आपको अभी भी मानचित्र पर प्लॉट करने के लिए वही भू-स्थानांतरण फ़ील्ड (अक्षांश/देशांतर) मिलते हैं।

बहुभुज द्वारा खोजें

कस्टम सीमाएँ खींचें—कैम्पस, जल निकाय, ऐतिहासिक जिले—और उनके भीतर खोजें। जब रेडियल दूरी पर्याप्त नहीं होती है, तो यह आदर्श है।

• विधि: GET
• URL: https://zylalabs.com/api/7341/real-time-zillow-data-api/11669/search-by-polygon
• आवश्यक पैरामीटर:
  • polygon (string): “lon lat” जोड़ों का एक अनुक्रम जो अल्पविराम द्वारा अलग किए गए हैं

परिणामों को आपके टीम या उपयोगकर्ताओं के लिए महत्वपूर्ण सटीक सीमाओं पर लंगर डालने के लिए बहुभुज का उपयोग करें।

न्यूनतम पायथन उदाहरण: निर्देशांक द्वारा खोजें

यह उदाहरण निर्देशांक एंडपॉइंट को कॉल करता है, प्रतिक्रिया की जांच करता है, और पास की संपत्तियों को प्रिंट करता है जिन्हें आप मानचित्र पर रख सकते हैं। URL और पैरामीटर को ठीक उसी तरह रखें जैसा दिखाया गया है।

import os
import requests

API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
url = "https://zylalabs.com/api/7341/real-time-zillow-data-api/11668/search-by-coordinates"
params = {
"long": "-118.504744",
"lat": "34.01822",
"diameter": "2"
}
headers = {
"Authorization": f"Bearer {API_KEY}"
}

resp = requests.get(url, params=params, headers=headers, timeout=30)
resp.raise_for_status()
payload = resp.json()

# Basic sanity checks
if payload.get("status") != "OK":
raise RuntimeError(f"Unexpected status: {payload}")

properties = payload.get("data", [])
for p in properties:
print({
"zpid": p.get("zpid"),
"status": p.get("homeStatus"),
"type": p.get("homeType"),
"price": p.get("price"),
"currency": p.get("currency"),
"lat": p.get("latitude"),
"lon": p.get("longitude"),
"address": p.get("address"),
"url": p.get("detailUrl")
})

# Example: center map on the first listing if available
if properties:
first = properties[0]
center = (first.get("latitude"), first.get("longitude"))
print("Center suggestion:", center)

आपका समय बचाने के लिए कार्यान्वयन नोट्स

• प्रमाणीकरण हेडर: Authorization: Bearer YOUR_API_KEY
• भू-इनपुट: long, lat को स्ट्रिंग के रूप में पास करें; व्यास वैकल्पिक है।
• मुद्रा और इकाइयाँ: प्रतिक्रिया में मुद्रा (जैसे, USD) और क्षेत्र इकाइयाँ (जैसे, sqft) शामिल हैं जहाँ लागू हो। प्रदर्शित करने के लिए लौटाए गए फ़ील्ड का उपयोग करें न कि हार्डकोडिंग।
• पैजिनेशन: प्रतिक्रियाएँ एक parameters.page फ़ील्ड शामिल करती हैं जो सर्वर-चयनित पृष्ठ दिखाती हैं। जब आपको अतिरिक्त पृष्ठों या फ़िल्टरिंग की आवश्यकता होती है, तो वर्तमान विकल्पों के लिए API पृष्ठ पर परामर्श करें।
• कैशिंग: यदि आप परिणामों को कैश करते हैं, तो विभिन्न क्षेत्रों को मिलाने से बचने के लिए क्वेरी ट्यूपल (long, lat, diameter) द्वारा कुंजी बनाएं।
• त्रुटि हैंडलिंग: स्थिति == "OK" की जांच करें और खाली डेटा एरे को सुचारू रूप से संभालें; समर्थन को तेज़ी से बढ़ाने के लिए लॉग में request_id को सतह पर लाएं।
• कोटा: यह API सदस्यता + कोटा का उपयोग करता है (प्रति-कॉल नहीं)। आप 7-दिन की परीक्षण अवधि या 50 अनुरोधों के साथ शुरू कर सकते हैं ताकि आप जल्दी से पुनरावृत्ति कर सकें। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए, API पृष्ठ की जांच करें।

कब प्रत्येक भू-स्थानांतरण मोड का उपयोग करें

• निर्देशांक द्वारा खोजें: "मानचित्र पर टैप करें और जो पास में है उसे दिखाएं" के लिए सबसे अच्छा। त्वरित, केंद्रित खोजें जो उपयोगकर्ता के पैन करते समय चलते हैं।
• खोजें: "94110" या "लॉस एंजेलेस, सीए" जैसे टाइप की गई स्थानों के लिए आदर्श। इसका उपयोग करें जब आपके पास अभी तक सटीक निर्देशांक न हों।
• बहुभुज द्वारा खोजें: पड़ोस-ग्रेड सटीकता के लिए। परिणामों को कस्टम क्षेत्रों तक सीमित करें जो आपका उत्पाद परिभाषित करता है।

AI एजेंटों द्वारा MCP के माध्यम से API को कॉल करना

आप इन एंडपॉइंट्स को MCP-संगत उपकरणों (जैसे, क्लॉड कोड, कर्सर, विंडसर्फ) में भी वायर कर सकते हैं। अपने क्लाइंट को Zyla MCP गेटवे पर इंगित करें और अपनी API कुंजी प्रदान करें; आपका एजेंट फिर ऊपर उपयोग किए गए समान हब लिस्टिंग एंडपॉइंट्स को सक्रिय कर सकता है।

दस्तावेज़ और एंडपॉइंट: MCP

जहां लागू हो, अपने एजेंट के उपकरण कॉन्फ़िगरेशन में समान Authorization: Bearer YOUR_API_KEY हेडर अर्थशास्त्र का उपयोग करें। लाभ यह है कि आप Zyla API Hub पर हजारों APIs के बीच एकल कुंजी बनाए रखते हैं जबकि AI-संचालित कार्यप्रवाह में विकास करते हैं।

अब लागू करने के लिए एंड-टू-एंड प्रवाह

1. API पृष्ठ पर अपनी परीक्षण अवधि शुरू करें और अपनी कुंजी प्राप्त करें।
2. निर्देशांक द्वारा खोजें को long, lat, और वैकल्पिक रूप से व्यास के साथ कॉल करें।
3. अपने मानचित्र पर data[].latitude/data[].longitude को रेंडर करें; मूल्य, पता, और detailUrl को एक कार्ड में दिखाएं।
4. एक फॉलबैक जोड़ें: यदि उपयोगकर्ता एक स्थान टाइप करता है, तो खोजें को कॉल करें।
5. कस्टम सीमाओं के लिए, एक ड्रॉ बहुभुज मोड जोड़ें जो बहुभुज द्वारा खोजें को कॉल करता है।

अक्सर पूछे जाने वाले प्रश्न

मैं अनुरोधों को कैसे प्रमाणित करूं?
Hub URL को कॉल करते समय हर बार Authorization: Bearer YOUR_API_KEY भेजें।

व्यास के लिए पैरामीटर इकाइयाँ क्या हैं?
एंडपॉइंट एक व्यास पैरामीटर को स्ट्रिंग के रूप में स्वीकार करता है। विशिष्ट इकाई अर्थशास्त्र के लिए, वर्तमान दस्तावेज़ीकरण के लिए API पृष्ठ की जांच करें।

क्या मैं निर्देशांक खोजों को पेजिनेट कर सकता हूं?
प्रतिक्रियाएँ एक parameters.page फ़ील्ड शामिल करती हैं। प्रोग्रामेटिक पेजिनेशन समर्थन और उपलब्ध क्वेरी पैरामीटर के लिए, Zyla पर API के पृष्ठ पर संदर्भित करें।

क्या कोई मुफ्त योजना है?
एक्सेस सदस्यता + कोटा का उपयोग करता है, प्रति-कॉल नहीं। आप 7-दिन की परीक्षण अवधि शुरू कर सकते हैं या मूल्यांकन के लिए 50 अनुरोध कर सकते हैं; वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।

क्या मैं घर की स्थिति द्वारा फ़िल्टर कर सकता हूं?
खोजें एंडपॉइंट home_status को एक वैकल्पिक पैरामीटर के रूप में स्वीकार करता है। भू-स्थानांतरण एंडपॉइंट्स के लिए, ऊपर दिखाए गए दस्तावेज़ीकृत पैरामीटर का उपयोग करें।

निर्देशांक-आधारित संपत्ति खोज को शिप करने के लिए तैयार हैं? यहां अपनी परीक्षण अवधि शुरू करें और अपनी API कुंजी प्राप्त करें: रियल-टाइम ज़िलो डेटा API पर 7-दिन की परीक्षण अवधि शुरू करें. एक बार एकल कुंजी के साथ बनाएं और Zyla मार्केटप्लेस में स्केल करें।