Geocoder

Geocoder class

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 से मिला जियोकोडर रिस्पॉन्स, जिसमें GeocoderResult की सूची शामिल है.

प्रॉपर्टी
results	टाइप:  Array<GeocoderResult> GeocoderResult की सूची.
address_descriptor optional	ध्यान दें: यह सुविधा सिर्फ़ v=beta चैनल में उपलब्ध है. टाइप:  AddressDescriptor optional किसी जगह की जानकारी. इसमें आस-पास के लैंडमार्क और टारगेट की गई जगह के आस-पास के इलाकों की रैंकिंग शामिल होती है. यह सिर्फ़ रिवर्स जियोकोडिंग के अनुरोधों के लिए भरी जाती है. ऐसा सिर्फ़ तब होता है, जब ExtraGeocodeComputation.ADDRESS_DESCRIPTORS चालू हो.
plus_code optional	टाइप:  PlacePlusCode optional जगह से जुड़ा प्लस कोड.

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 जगह से जुड़ा प्लस कोड.
postcode_localities optional	टाइप:  Array<string> optional स्ट्रिंग का एक कलेक्शन, जिसमें पिन कोड में शामिल सभी इलाकों की जानकारी होती है. यह सिर्फ़ तब दिखता है, जब खोज के नतीजे में एक ऐसा पिन कोड दिखता है जिसमें एक से ज़्यादा जगहें शामिल हों.

AddressDescriptor इंटरफ़ेस

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 टारगेट की गई जगह और लैंडमार्क के बीच, सड़क के नेटवर्क के हिसाब से यात्रा की दूरी. अगर लैंडमार्क, सड़क के उस नेटवर्क से अलग है जिससे टारगेट सबसे नज़दीक है या टारगेट की जगह को सड़क के नेटवर्क पर नहीं माना गया है, तो यह फ़ील्ड खाली हो सकता है.

एरिया के इंटरफ़ेस

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	लैंडमार्क में स्पेस की ज्यामिति होती है और टारगेट उसकी सीमाओं में होता है.