Geocoder

Geocoder क्लास

google.maps.Geocoder क्लास

यह पता और LatLng के बीच कन्वर्ज़न करने वाली सेवा है.

const {Geocoder} = await google.maps.importLibrary("geocoding") पर कॉल करके ऐक्सेस करें.
Maps JavaScript API में मौजूद लाइब्रेरी देखें.

निर्माता
Geocoder	Geocoder() पैरामीटर:  कोई नहीं यह Geocoder का नया इंस्टेंस बनाता है, जो Google के सर्वर को जियोकोड के अनुरोध भेजता है.

तरीके
geocode	geocode(request[, callback]) पैरामीटर:  request:  GeocoderRequest callback:  function(Array<GeocoderResult> optional, GeocoderStatus): void optional लौटाई गई वैल्यू:  Promise<GeocoderResponse> अनुरोध को जियोकोड करें.

GeocoderRequest इंटरफ़ेस

google.maps.GeocoderRequest इंटरफ़ेस

Geocoder को भेजे जाने वाले जियोकोडिंग अनुरोध की जानकारी.

प्रॉपर्टी
address optional	टाइप:  string optional जियोकोड करने के लिए पता. address, location, और placeId में से सिर्फ़ एक वैल्यू दी जानी चाहिए.
bounds optional	टाइप:  LatLngBounds|LatLngBoundsLiteral optional LatLngBounds में खोजना है. ज़रूरी नहीं.
componentRestrictions optional	टाइप:  GeocoderComponentRestrictions optional कॉम्पोनेंट का इस्तेमाल, नतीजों को किसी खास इलाके तक सीमित करने के लिए किया जाता है. फ़िल्टर में इनमें से एक या इससे ज़्यादा शामिल होते हैं: route, locality, administrativeArea, postalCode, country. सिर्फ़ वे नतीजे दिखाए जाएंगे जो सभी फ़िल्टर से मेल खाते हों. फ़िल्टर की वैल्यू में, स्पेलिंग ठीक करने और कुछ हद तक मैच करने के लिए, वही तरीके इस्तेमाल किए जाते हैं जो जियोकोडिंग के अन्य अनुरोधों के लिए इस्तेमाल किए जाते हैं. ज़रूरी नहीं.
extraComputations optional	ध्यान दें: यह सुविधा सिर्फ़ v=beta चैनल में उपलब्ध है. टाइप:  Array<ExtraGeocodeComputation> optional अतिरिक्त कैलकुलेशन की सूची, जिसका इस्तेमाल अनुरोध को पूरा करने के लिए किया जा सकता है. ध्यान दें: इन अतिरिक्त कैलकुलेशन से, जवाब में अतिरिक्त फ़ील्ड दिख सकते हैं.
fulfillOnZeroResults optional	टाइप:  boolean optional जवाब में ZERO_RESULT स्टेटस के बारे में जानकारी दें. ऐसा इसलिए किया जा सकता है, क्योंकि भले ही जियोकोडिंग के नतीजे न मिले हों, लेकिन जवाब के लेवल पर अब भी अन्य फ़ील्ड दिख सकते हैं.
language optional	टाइप:  string optional यह एक भाषा आइडेंटिफ़ायर है. इससे यह पता चलता है कि नतीजे किस भाषा में दिखाए जाने चाहिए. हालांकि, ऐसा सिर्फ़ तब किया जाता है, जब यह सुविधा उपलब्ध हो. इस्तेमाल की जा सकने वाली भाषाओं की सूची देखें.
location optional	टाइप:  LatLng|LatLngLiteral optional LatLng (या 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 optional administrative_area levels से मेल खाता है. ज़रूरी नहीं.
country optional	टाइप:  string optional यह देश के नाम या दो अक्षरों वाले ISO 3166-1 देश कोड से मेल खाता है. ज़रूरी नहीं.
locality optional	टाइप:  string optional यह locality और sublocality, दोनों तरह के अनुरोधों से मेल खाता है. ज़रूरी नहीं.
postalCode optional	टाइप:  string optional postal_code और postal_code_prefix से मेल खाता है. ज़रूरी नहीं.
route optional	टाइप:  string optional यह route के लंबे या छोटे नाम से मेल खाता है. ज़रूरी नहीं.

ExtraGeocodeComputation कॉन्स्टेंट

google.maps.ExtraGeocodeComputation कॉन्स्टेंट

ध्यान दें: यह सुविधा सिर्फ़ v=beta चैनल में उपलब्ध है.

जियोकोडिंग का अनुरोध पूरा करते समय, अतिरिक्त गणनाएं की जाती हैं.

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 की सूची.
address_descriptor optional	ध्यान दें: यह सुविधा सिर्फ़ v=beta चैनल में उपलब्ध है. टाइप:  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	टाइप:  GeocoderGeometry GeocoderGeometry ऑब्जेक्ट
place_id	टाइप:  string जगह से जुड़ा प्लेस आईडी. जगह के आईडी, Google Places के डेटाबेस और Google Maps में किसी जगह की अलग पहचान के लिए इस्तेमाल होते हैं. Places API डेवलपर गाइड में, जगह के आईडी के बारे में ज़्यादा जानें.
types	टाइप:  Array<string> यह एक स्ट्रिंग का कलेक्शन होता है. इसमें, जियोकोड किए गए एलिमेंट के टाइप की जानकारी होती है. संभावित स्ट्रिंग की सूची के लिए, डेवलपर की गाइड में पते के कॉम्पोनेंट टाइप सेक्शन देखें.
address_descriptor optional	ध्यान दें: यह सुविधा सिर्फ़ v=beta चैनल में उपलब्ध है. टाइप:  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 इंटरफ़ेस

ध्यान दें: यह सुविधा सिर्फ़ v=beta चैनल में उपलब्ध है.

किसी जगह के बारे में जानकारी देने वाला टेक्स्ट. इसमें आस-पास के लैंडमार्क और टारगेट की गई जगह की जानकारी देने वाले इलाकों का रैंक किया गया सेट शामिल होता है.

प्रॉपर्टी
areas	टाइप:  Array<Area> इसमें, किसी जगह के आस-पास की जगहों की रैंक के हिसाब से सूची होती है. सबसे ज़्यादा काम के (पहचानने लायक और सटीक) इलाकों को सबसे पहले रैंक किया जाता है.
landmarks	टाइप:  Array<Landmark> आस-पास के लैंडमार्क की रैंक की गई सूची. सबसे ज़्यादा मददगार (पहचान में आने वाले और आस-पास के) लैंडमार्क को सबसे ऊपर रैंक किया जाता है.

GeocoderAddressComponent इंटरफ़ेस

google.maps.GeocoderAddressComponent इंटरफ़ेस

GeocoderResult में मौजूद पता कॉम्पोनेंट. पूरे पते में पते के कई कॉम्पोनेंट शामिल हो सकते हैं.

प्रॉपर्टी
long_name	टाइप:  string पते के कॉम्पोनेंट का पूरा टेक्स्ट
short_name	टाइप:  string पते के कॉम्पोनेंट का छोटा किया गया टेक्स्ट
types	टाइप:  Array<string> स्ट्रिंग की एक कैटगरी, जो इस पते के कॉम्पोनेंट के टाइप को दिखाती है. मान्य टाइप की सूची यहां देखी जा सकती है

GeocoderGeometry इंटरफ़ेस

google.maps.GeocoderGeometry इंटरफ़ेस

इस GeocoderResult के बारे में जियॉमेट्री की जानकारी

प्रॉपर्टी
location	टाइप:  LatLng इस नतीजे के अक्षांश/देशांतर के कोऑर्डिनेट
location_type	टाइप:  GeocoderLocationType location में दिखाई गई जगह का टाइप
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 इंटरफ़ेस

ध्यान दें: यह सुविधा सिर्फ़ v=beta चैनल में उपलब्ध है.

ऐसी जगह जो पते के लिए रेफ़रंस पॉइंट के तौर पर काम करती है.

प्रॉपर्टी
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 इंटरफ़ेस

ध्यान दें: यह सुविधा सिर्फ़ v=beta चैनल में उपलब्ध है.

कोई ऐसी जगह जो एक छोटा इलाका हो, जैसे कि आस-पड़ोस, उप-इलाका या बड़ा कॉम्प्लेक्स, जिसमें टारगेट की गई जगह शामिल हो.

प्रॉपर्टी
containment	टाइप:  Containment इससे टारगेट की गई जगह और इलाके के बीच के स्थानिक संबंध के बारे में पता चलता है.
display_name	टाइप:  string जगह का नाम.
display_name_language_code	टाइप:  string इलाके के नाम की भाषा.
place_id	टाइप:  string जगह का आईडी. इस कुकी का इस्तेमाल, जगह की जानकारी या जगह के आईडी की खोज के ज़रिए, इलाके के बारे में ज़्यादा जानकारी पाने के लिए किया जा सकता है.

कंटेनमेंट कॉन्सटेंट

google.maps.Containment कॉन्स्टेंट

ध्यान दें: यह सुविधा सिर्फ़ v=beta चैनल में उपलब्ध है.

यह एक इनम है, जो इलाके और टारगेट की गई जगह के बीच के संबंध को दिखाता है.

const {Containment} = await google.maps.importLibrary("geocoding") पर कॉल करके ऐक्सेस करें.
Maps JavaScript API में मौजूद लाइब्रेरी देखें.

कॉन्स्टेंट
NEAR	टारगेट की गई जगह, क्षेत्र से बाहर है, लेकिन उसके आस-पास है.
OUTSKIRTS	टारगेट की गई जगह, क्षेत्र के अंदर है और किनारे के पास है.
WITHIN	टारगेट की गई जगह, क्षेत्र के बीच में है.

SpatialRelationship कॉन्स्टेंट

google.maps.SpatialRelationship कॉन्स्टेंट

ध्यान दें: यह सुविधा सिर्फ़ v=beta चैनल में उपलब्ध है.

यह एक इनम है. यह लैंडमार्क और टारगेट के बीच की दूरी को दिखाता है.

const {SpatialRelationship} = await google.maps.importLibrary("geocoding") पर कॉल करके ऐक्सेस करें.
Maps JavaScript API में मौजूद लाइब्रेरी देखें.

कॉन्स्टेंट
ACROSS_THE_ROAD	टारगेट, सड़क के दूसरी ओर मौजूद लैंडमार्क के ठीक सामने है.
AROUND_THE_CORNER	लैंडमार्क के रास्ते पर नहीं है, लेकिन एक मोड़ दूर है.
BEHIND	लैंडमार्क की बनावट के करीब, लेकिन उसके ऐक्सेस पॉइंट से दूर.
BESIDE	टारगेट, लैंडमार्क के ठीक बगल में है.
DOWN_THE_ROAD	लैंडमार्क के रास्ते पर, लेकिन उसके बगल में या सामने नहीं.
NEAR	अगर नीचे दी गई जानकारी में से कोई भी जानकारी लागू नहीं होती है, तो यह डिफ़ॉल्ट रिलेशनशिप होता है.
WITHIN	लैंडमार्क में स्पेशल ज्योमेट्री है और टारगेट उसकी सीमाओं के अंदर है.