Geocoder क्लास
google.maps.Geocoder
क्लास
यह पता और LatLng के बीच कन्वर्ज़न करने वाली सेवा है.
const {Geocoder} = await google.maps.importLibrary("geocoding") पर कॉल करके ऐक्सेस करें.
Maps JavaScript API में मौजूद लाइब्रेरी देखें.
निर्माता | |
|---|---|
Geocoder |
Geocoder()पैरामीटर: कोई नहीं
यह Geocoder का नया इंस्टेंस बनाता है, जो Google के सर्वर को जियोकोड के अनुरोध भेजता है. |
तरीके | |
|---|---|
geocode |
geocode(request[, callback])पैरामीटर:
लौटाई गई वैल्यू:
Promise<GeocoderResponse>अनुरोध को जियोकोड करें. |
GeocoderRequest इंटरफ़ेस
google.maps.GeocoderRequest
इंटरफ़ेस
Geocoder को भेजे जाने वाले जियोकोडिंग अनुरोध की जानकारी.
प्रॉपर्टी | |
|---|---|
address optional |
टाइप:
string optionalजियोकोड करने के लिए पता. address, location, और placeId में से सिर्फ़ एक वैल्यू दी जानी चाहिए. |
bounds optional |
टाइप:
LatLngBounds|LatLngBoundsLiteral optionalLatLngBounds में खोजना है. ज़रूरी नहीं. |
componentRestrictions optional |
टाइप:
GeocoderComponentRestrictions optionalकॉम्पोनेंट का इस्तेमाल, नतीजों को किसी खास इलाके तक सीमित करने के लिए किया जाता है. फ़िल्टर में इनमें से एक या इससे ज़्यादा शामिल होते हैं: route, locality, administrativeArea, postalCode, country. सिर्फ़ वे नतीजे दिखाए जाएंगे जो सभी फ़िल्टर से मेल खाते हों. फ़िल्टर की वैल्यू में, स्पेलिंग ठीक करने और कुछ हद तक मैच करने के लिए, वही तरीके इस्तेमाल किए जाते हैं जो जियोकोडिंग के अन्य अनुरोधों के लिए इस्तेमाल किए जाते हैं. ज़रूरी नहीं. |
|
टाइप:
Array<ExtraGeocodeComputation> optionalअतिरिक्त कैलकुलेशन की सूची, जिसका इस्तेमाल अनुरोध को पूरा करने के लिए किया जा सकता है. ध्यान दें: इन अतिरिक्त कैलकुलेशन से, जवाब में अतिरिक्त फ़ील्ड दिख सकते हैं. |
fulfillOnZeroResults optional |
टाइप:
boolean optionalजवाब में ZERO_RESULT स्टेटस के बारे में जानकारी दें. ऐसा इसलिए किया जा सकता है, क्योंकि भले ही जियोकोडिंग के नतीजे न मिले हों, लेकिन जवाब के लेवल पर अब भी अन्य फ़ील्ड दिख सकते हैं. |
language optional |
टाइप:
string optionalयह एक भाषा आइडेंटिफ़ायर है. इससे यह पता चलता है कि नतीजे किस भाषा में दिखाए जाने चाहिए. हालांकि, ऐसा सिर्फ़ तब किया जाता है, जब यह सुविधा उपलब्ध हो. इस्तेमाल की जा सकने वाली भाषाओं की सूची देखें. |
location optional |
टाइप:
LatLng|LatLngLiteral optionalLatLng (या LatLngLiteral) को खोजना है. जियोकोडर, रिवर्स जियोकोड करता है. ज़्यादा जानकारी के लिए, रिवर्स जियोकोडिंग देखें. address, location, और placeId में से सिर्फ़ एक वैल्यू दी जानी चाहिए. |
placeId optional |
टाइप:
string optionalजगह से जुड़ा प्लेस आईडी. जगह के आईडी, Google Places के डेटाबेस और Google Maps में किसी जगह की अलग पहचान के लिए इस्तेमाल होते हैं. Places API डेवलपर गाइड में, जगह के आईडी के बारे में ज़्यादा जानें. जियोकोडर, रिवर्स जियोकोड करता है. ज़्यादा जानकारी के लिए, रिवर्स जियोकोडिंग देखें. address, location, और placeId में से सिर्फ़ एक वैल्यू दी जानी चाहिए. |
region optional |
टाइप:
string optionalखोज के नतीजों को किसी देश के हिसाब से दिखाने के लिए इस्तेमाल किया जाने वाला देश का कोड. इसे दो वर्णों (गैर-संख्यात्मक) वाले यूनिकोड क्षेत्र के सबटैग / CLDR आइडेंटिफ़ायर के तौर पर तय किया जाता है. ज़रूरी नहीं. जिन देशों/इलाकों में यह सुविधा काम करती है उनके बारे में जानने के लिए, Google Maps Platform की कवरेज की जानकारी देखें. |
GeocoderComponentRestrictions इंटरफ़ेस
google.maps.GeocoderComponentRestrictions
इंटरफ़ेस
GeocoderComponentRestrictions, फ़िल्टर का एक ऐसा सेट दिखाता है जो किसी खास इलाके के लिए काम करता है. यह सुविधा कैसे काम करती है, इस बारे में जानने के लिए जियोकोडिंग कॉम्पोनेंट फ़िल्टर करना लेख पढ़ें.
प्रॉपर्टी | |
|---|---|
administrativeArea optional |
टाइप:
string optionaladministrative_area levels से मेल खाता है. ज़रूरी नहीं. |
country optional |
टाइप:
string optionalयह देश के नाम या दो अक्षरों वाले ISO 3166-1 देश कोड से मेल खाता है. ज़रूरी नहीं. |
locality optional |
टाइप:
string optionalयह locality और sublocality, दोनों तरह के अनुरोधों से मेल खाता है. ज़रूरी नहीं. |
postalCode optional |
टाइप:
string optionalpostal_code और postal_code_prefix से मेल खाता है. ज़रूरी नहीं. |
route optional |
टाइप:
string optionalयह route के लंबे या छोटे नाम से मेल खाता है. ज़रूरी नहीं. |
ExtraGeocodeComputation कॉन्स्टेंट
google.maps.ExtraGeocodeComputation
कॉन्स्टेंट
जियोकोडिंग का अनुरोध पूरा करते समय, अतिरिक्त गणनाएं की जाती हैं.
const {ExtraGeocodeComputation} = await google.maps.importLibrary("geocoding") पर कॉल करके ऐक्सेस करें.
Maps JavaScript API में मौजूद लाइब्रेरी देखें.
कॉन्स्टेंट | |
|---|---|
ADDRESS_DESCRIPTORS |
पते का डेस्क्रिप्टर जनरेट करें. |
GeocoderStatus कॉन्स्टेंट
google.maps.GeocoderStatus
कॉन्स्टेंट
geocode() को कॉल पूरा होने पर, Geocoder से मिला स्टेटस. इन्हें वैल्यू के हिसाब से या कॉन्स्टेंट के नाम का इस्तेमाल करके तय करें. उदाहरण के लिए, 'OK' या google.maps.GeocoderStatus.OK.
const {GeocoderStatus} = await google.maps.importLibrary("geocoding") पर कॉल करके ऐक्सेस करें.
Maps JavaScript API में मौजूद लाइब्रेरी देखें.
कॉन्स्टेंट | |
|---|---|
ERROR |
Google के सर्वर से संपर्क करने में कोई समस्या हुई. |
INVALID_REQUEST |
यह GeocoderRequest अमान्य था. |
OK |
जवाब में एक मान्य GeocoderResponse शामिल है. |
OVER_QUERY_LIMIT |
वेब पेज पर, तय समयसीमा में अनुरोधों की संख्या तय सीमा से ज़्यादा हो गई है. |
REQUEST_DENIED |
वेबपेज को जियोकोडर इस्तेमाल करने की अनुमति नहीं है. |
UNKNOWN_ERROR |
सर्वर की गड़बड़ी की वजह से, जियोकोडिंग का अनुरोध प्रोसेस नहीं किया जा सका. फिर से कोशिश करने पर, अनुरोध पूरा हो सकता है. |
ZERO_RESULTS |
इस GeocoderRequest के लिए कोई नतीजा नहीं मिला. |
GeocoderResponse इंटरफ़ेस
google.maps.GeocoderResponse
इंटरफ़ेस
यह Geocoder से मिला Geocoder रिस्पॉन्स है. इसमें Geocoder की सूची शामिल होती है.GeocoderResult
प्रॉपर्टी | |
|---|---|
results |
टाइप:
Array<GeocoderResult>GeocoderResult की सूची. |
|
टाइप:
AddressDescriptor optionalकिसी जगह के बारे में जानकारी देने वाला टेक्स्ट. इसमें आस-पास के लैंडमार्क और टारगेट की गई जगह की जानकारी देने वाले इलाकों का रैंक किया गया सेट शामिल होता है. यह सिर्फ़ रिवर्स जियोकोडिंग के अनुरोधों के लिए भरा जाता है. साथ ही, यह सिर्फ़ तब भरा जाता है, जब ExtraGeocodeComputation.ADDRESS_DESCRIPTORS चालू हो. |
plus_code optional |
टाइप:
PlacePlusCode optionalजगह से जुड़ा Plus Code. |
GeocoderResult इंटरफ़ेस
google.maps.GeocoderResult
इंटरफ़ेस
जियोकोडर का एक नतीजा, जिसे जियोकोड सर्वर से वापस पाया गया है. जियोकोड के अनुरोध पर, नतीजे के तौर पर कई ऑब्जेक्ट मिल सकते हैं. ध्यान दें कि यह नतीजा "JSON जैसा" है, लेकिन यह पूरी तरह से JSON नहीं है. ऐसा इसलिए है, क्योंकि इसमें LatLng ऑब्जेक्ट को परोक्ष रूप से शामिल किया गया है.
प्रॉपर्टी | |
|---|---|
address_components |
टाइप:
Array<GeocoderAddressComponent>GeocoderAddressComponent की कैटगरी |
formatted_address |
टाइप:
stringइस स्ट्रिंग में, इस जगह का पता होता है, ताकि लोग इसे आसानी से पढ़ सकें. |
geometry |
टाइप:
GeocoderGeometryGeocoderGeometry ऑब्जेक्ट |
place_id |
टाइप:
stringजगह से जुड़ा प्लेस आईडी. जगह के आईडी, Google Places के डेटाबेस और Google Maps में किसी जगह की अलग पहचान के लिए इस्तेमाल होते हैं. Places API डेवलपर गाइड में, जगह के आईडी के बारे में ज़्यादा जानें. |
types |
टाइप:
Array<string>यह एक स्ट्रिंग का कलेक्शन होता है. इसमें, जियोकोड किए गए एलिमेंट के टाइप की जानकारी होती है. संभावित स्ट्रिंग की सूची के लिए, डेवलपर की गाइड में पते के कॉम्पोनेंट टाइप सेक्शन देखें. |
|
टाइप:
AddressDescriptor optionalइस जियोकोड से जुड़ी जगह की जानकारी. इसमें आस-पास के लैंडमार्क और टारगेट की गई जगह की जानकारी देने वाले इलाकों का रैंक किया गया सेट शामिल होता है. यह फ़ील्ड, सिर्फ़ फ़ॉरवर्ड जियोकोडिंग और जगह के आईडी की जानकारी पाने के अनुरोधों के लिए भरा जाएगा. ऐसा सिर्फ़ तब होगा, जब ExtraGeocodeComputation.ADDRESS_DESCRIPTORS चालू हो. साथ ही, यह सिर्फ़ स्थानीय जगहों के लिए होगा. |
partial_match optional |
टाइप:
boolean optionalक्या जियोकोडर ने मूल अनुरोध के लिए कोई सटीक मैच नहीं दिया, हालांकि वह अनुरोध किए गए पते के कुछ हिस्से से मेल खाने में कामयाब रहा. अगर कोई एग्ज़ैक्ट मैच मिलता है, तो वैल्यू undefined होगी. |
plus_code optional |
टाइप:
PlacePlusCode optionalजगह से जुड़ा Plus Code. |
postcode_localities optional |
टाइप:
Array<string> optionalस्ट्रिंग का एक ऐसा कलेक्शन जो किसी पिन कोड में मौजूद सभी इलाकों को दिखाता है. यह जानकारी सिर्फ़ तब दिखती है, जब खोज के नतीजे में ऐसा पिन कोड शामिल होता है जिसमें कई इलाके शामिल होते हैं. |
AddressDescriptor interface
google.maps.AddressDescriptor
इंटरफ़ेस
किसी जगह के बारे में जानकारी देने वाला टेक्स्ट. इसमें आस-पास के लैंडमार्क और टारगेट की गई जगह की जानकारी देने वाले इलाकों का रैंक किया गया सेट शामिल होता है.
प्रॉपर्टी | |
|---|---|
areas |
इसमें, किसी जगह के आस-पास की जगहों की रैंक के हिसाब से सूची होती है. सबसे ज़्यादा काम के (पहचानने लायक और सटीक) इलाकों को सबसे पहले रैंक किया जाता है. |
landmarks |
आस-पास के लैंडमार्क की रैंक की गई सूची. सबसे ज़्यादा मददगार (पहचान में आने वाले और आस-पास के) लैंडमार्क को सबसे ऊपर रैंक किया जाता है. |
GeocoderAddressComponent इंटरफ़ेस
google.maps.GeocoderAddressComponent
इंटरफ़ेस
GeocoderResult में मौजूद पता कॉम्पोनेंट. पूरे पते में पते के कई कॉम्पोनेंट शामिल हो सकते हैं.
प्रॉपर्टी | |
|---|---|
long_name |
टाइप:
stringपते के कॉम्पोनेंट का पूरा टेक्स्ट |
short_name |
टाइप:
stringपते के कॉम्पोनेंट का छोटा किया गया टेक्स्ट |
types |
टाइप:
Array<string>स्ट्रिंग की एक कैटगरी, जो इस पते के कॉम्पोनेंट के टाइप को दिखाती है. मान्य टाइप की सूची यहां देखी जा सकती है |
GeocoderGeometry इंटरफ़ेस
google.maps.GeocoderGeometry
इंटरफ़ेस
इस GeocoderResult के बारे में जियॉमेट्री की जानकारी
प्रॉपर्टी | |
|---|---|
location |
टाइप:
LatLngइस नतीजे के अक्षांश/देशांतर के कोऑर्डिनेट |
location_type |
टाइप:
GeocoderLocationTypelocation में दिखाई गई जगह का टाइप |
viewport |
टाइप:
LatLngBoundsइस GeocoderResult को दिखाने के लिए, सुझाए गए व्यूपोर्ट की सीमाएं |
bounds optional |
टाइप:
LatLngBounds optionalअगर लागू हो, तो इस GeocoderResult की सटीक सीमाएं |
GeocoderLocationType कॉन्स्टेंट
google.maps.GeocoderLocationType
कॉन्स्टेंट
जियोकोड से मिली जगह की जानकारी के टाइप के बारे में बताता है. इन्हें वैल्यू के हिसाब से या कॉन्स्टेंट के नाम का इस्तेमाल करके तय करें. उदाहरण के लिए, 'ROOFTOP' या google.maps.GeocoderLocationType.ROOFTOP.
const {GeocoderLocationType} = await google.maps.importLibrary("geocoding") पर कॉल करके ऐक्सेस करें.
Maps JavaScript API में मौजूद लाइब्रेरी देखें.
कॉन्स्टेंट | |
|---|---|
APPROXIMATE |
जवाब में दी गई जानकारी अनुमानित है. |
GEOMETRIC_CENTER |
जवाब के तौर पर मिली जानकारी, किसी लाइन (जैसे कि सड़क) या पॉलीगॉन (क्षेत्र) का जियोमेट्रिक सेंटर होती है. |
RANGE_INTERPOLATED |
जवाब में दिखाई गई दूरी, दो सटीक पॉइंट (जैसे, चौराहे) के बीच की अनुमानित दूरी होती है. यह दूरी आम तौर पर सड़क के हिसाब से होती है. आम तौर पर, इंटरपोलेट किए गए नतीजे तब दिखाए जाते हैं, जब किसी सड़क के पते के लिए, रूफ़टॉप जियोकोड उपलब्ध नहीं होते हैं. |
ROOFTOP |
जवाब में सटीक जियोकोड दिखता है. |
लैंडमार्क इंटरफ़ेस
google.maps.Landmark
इंटरफ़ेस
ऐसी जगह जो पते के लिए रेफ़रंस पॉइंट के तौर पर काम करती है.
प्रॉपर्टी | |
|---|---|
display_name |
टाइप:
stringलैंडमार्क का नाम. |
display_name_language_code |
टाइप:
stringलैंडमार्क के नाम की भाषा. |
place_id |
टाइप:
stringलैंडमार्क के तौर पर काम करने वाली जगह का प्लेस आईडी. इस कुकी का इस्तेमाल, जगह की जानकारी या जगह के आईडी की मदद से लैंडमार्क के बारे में ज़्यादा जानकारी पाने के लिए किया जा सकता है. |
spatial_relationship |
टाइप:
SpatialRelationshipइससे टारगेट की गई जगह और लैंडमार्क के बीच की दूरी के बारे में पता चलता है. |
straight_line_distance_meters |
टाइप:
numberटारगेट की गई जगह और लैंडमार्क के बीच की सीधी दूरी. |
types |
टाइप:
Array<string>एक या उससे ज़्यादा वैल्यू, जो दिखाए गए नतीजे के टाइप के बारे में बताती हैं. ज़्यादा जानकारी के लिए, कृपया टाइप देखें. |
travel_distance_meters optional |
टाइप:
number optionalटारगेट की गई जगह और लैंडमार्क के बीच सड़क नेटवर्क से यात्रा करने की दूरी. अगर लैंडमार्क, सड़क नेटवर्क के उस हिस्से से जुड़ा नहीं है जिसके सबसे करीब टारगेट है या अगर टारगेट की जगह को सड़क नेटवर्क पर नहीं माना गया था, तो इस फ़ील्ड में कोई वैल्यू नहीं होगी. |
Area इंटरफ़ेस
google.maps.Area
इंटरफ़ेस
कोई ऐसी जगह जो एक छोटा इलाका हो, जैसे कि आस-पड़ोस, उप-इलाका या बड़ा कॉम्प्लेक्स, जिसमें टारगेट की गई जगह शामिल हो.
प्रॉपर्टी | |
|---|---|
containment |
टाइप:
Containmentइससे टारगेट की गई जगह और इलाके के बीच के स्थानिक संबंध के बारे में पता चलता है. |
display_name |
टाइप:
stringजगह का नाम. |
display_name_language_code |
टाइप:
stringइलाके के नाम की भाषा. |
place_id |
टाइप:
stringजगह का आईडी. इस कुकी का इस्तेमाल, जगह की जानकारी या जगह के आईडी की खोज के ज़रिए, इलाके के बारे में ज़्यादा जानकारी पाने के लिए किया जा सकता है. |
कंटेनमेंट कॉन्सटेंट
google.maps.Containment
कॉन्स्टेंट
यह एक इनम है, जो इलाके और टारगेट की गई जगह के बीच के संबंध को दिखाता है.
const {Containment} = await google.maps.importLibrary("geocoding") पर कॉल करके ऐक्सेस करें.
Maps JavaScript API में मौजूद लाइब्रेरी देखें.
कॉन्स्टेंट | |
|---|---|
NEAR |
टारगेट की गई जगह, क्षेत्र से बाहर है, लेकिन उसके आस-पास है. |
OUTSKIRTS |
टारगेट की गई जगह, क्षेत्र के अंदर है और किनारे के पास है. |
WITHIN |
टारगेट की गई जगह, क्षेत्र के बीच में है. |
SpatialRelationship कॉन्स्टेंट
google.maps.SpatialRelationship
कॉन्स्टेंट
यह एक इनम है. यह लैंडमार्क और टारगेट के बीच की दूरी को दिखाता है.
const {SpatialRelationship} = await google.maps.importLibrary("geocoding") पर कॉल करके ऐक्सेस करें.
Maps JavaScript API में मौजूद लाइब्रेरी देखें.
कॉन्स्टेंट | |
|---|---|
ACROSS_THE_ROAD |
टारगेट, सड़क के दूसरी ओर मौजूद लैंडमार्क के ठीक सामने है. |
AROUND_THE_CORNER |
लैंडमार्क के रास्ते पर नहीं है, लेकिन एक मोड़ दूर है. |
BEHIND |
लैंडमार्क की बनावट के करीब, लेकिन उसके ऐक्सेस पॉइंट से दूर. |
BESIDE |
टारगेट, लैंडमार्क के ठीक बगल में है. |
DOWN_THE_ROAD |
लैंडमार्क के रास्ते पर, लेकिन उसके बगल में या सामने नहीं. |
NEAR |
अगर नीचे दी गई जानकारी में से कोई भी जानकारी लागू नहीं होती है, तो यह डिफ़ॉल्ट रिलेशनशिप होता है. |
WITHIN |
लैंडमार्क में स्पेशल ज्योमेट्री है और टारगेट उसकी सीमाओं के अंदर है. |