Geocoder

Geocoder क्लास

क्लास google.maps.Geocoder
लाइब्रेरी "geocoding"

किसी पते और LatLng के बीच कन्वर्ज़न करने की सेवा.

const {Geocoder} = await google.maps.importLibrary("geocoding");
Geocoder
Geocoder()
पैरामीटर: कोई नहीं
Geocoder का एक नया इंस्टेंस बनाता है, जो Google के सर्वर को जियोकोड के अनुरोध भेजता है.
geocode
geocode(request[, callback])
पैरामीटर:
रिटर्न वैल्यू: Promise<GeocoderResponse>
किसी अनुरोध को जियोकोड करना.

GeocoderRequest इंटरफ़ेस

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

Geocoder को भेजे जाने वाले जियोकोडिंग अनुरोध की जानकारी.
address
ज़रूरी नहीं
टाइप: string optional
जियोकोड करने के लिए पता. address, location, और placeId में से सिर्फ़ एक वैल्यू दी जानी चाहिए.
bounds
ज़रूरी नहीं
टाइप: LatLngBounds|LatLngBoundsLiteral optional
वह LatLngBounds जिसमें खोजना है. ज़रूरी नहीं.
componentRestrictions
ज़रूरी नहीं
टाइप: GeocoderComponentRestrictions optional
कॉम्पोनेंट का इस्तेमाल, नतीजों को किसी खास इलाके तक सीमित करने के लिए किया जाता है. फ़िल्टर में इनमें से एक या उससे ज़्यादा चीज़ें शामिल होती हैं: route, locality, administrativeArea, postalCode, country. सिर्फ़ वे नतीजे दिखेंगे जो सभी फ़िल्टर से मैच करते हैं. फ़िल्टर वैल्यू, स्पेलिंग को सही करने और कुछ हद तक मैच करने के लिए, अन्य जियोकोडिंग अनुरोधों की तरह ही काम करती हैं. ज़रूरी नहीं.
BetaextraComputations
ज़रूरी नहीं
टाइप: Array<ExtraGeocodeComputation> optional
अतिरिक्त कंप्यूटेशन की सूची, जिसका इस्तेमाल अनुरोध को पूरा करने के लिए किया जा सकता है. ध्यान दें: इन अतिरिक्त कंप्यूटेशन की वजह से, रिस्पॉन्स में अतिरिक्त फ़ील्ड दिख सकते हैं.
fulfillOnZeroResults
ज़रूरी नहीं
टाइप: boolean optional
जवाब में ZERO_RESULT स्टेटस मिलने पर, प्रॉमिस को पूरा करें. ऐसा इसलिए हो सकता है, क्योंकि जियोकोडिंग के शून्य नतीजे मिलने पर भी, रिस्पॉन्स लेवल के अन्य फ़ील्ड दिख सकते हैं.
language
ज़रूरी नहीं
टाइप: string optional
भाषा का आइडेंटिफ़ायर, जिससे यह तय होता है कि नतीजे किस भाषा में दिखाए जाएं. हालांकि, ऐसा तब ही होता है, जब उस भाषा में नतीजे दिखाना मुमकिन हो. उपलब्ध भाषाओं की सूची देखें.
location
ज़रूरी नहीं
टाइप: LatLng|LatLngLiteral optional
LatLng (या LatLngLiteral) जिसे खोजना है. जियोकोडर, रिवर्स जियोकोड करता है. ज़्यादा जानकारी के लिए, रिवर्स जियोकोडिंग देखें. address, location, और placeId में से सिर्फ़ एक वैल्यू दी जानी चाहिए.
placeId
ज़रूरी नहीं
टाइप: string optional
जगह से जुड़ा प्लेस आईडी. जगह के आईडी, Google के जगहों के डेटाबेस और Google Maps में किसी जगह की अलग पहचान के लिए इस्तेमाल होते हैं. Places API की डेवलपर गाइड में, जगह के आईडी के बारे में ज़्यादा जानें. जियोकोडर, रिवर्स जियोकोड करता है. ज़्यादा जानकारी के लिए, रिवर्स जियोकोडिंग देखें. address, location, और placeId में से सिर्फ़ एक वैल्यू दी जानी चाहिए.
region
ज़रूरी नहीं
टाइप: string optional
खोज के नतीजों को बेहतर बनाने के लिए इस्तेमाल किया जाने वाला देश का कोड. इसे दो वर्णों (बिना अंक वाले) के यूनिकोड क्षेत्र के सबटैग / CLDR आइडेंटिफ़ायर के तौर पर बताया जाता है. ज़रूरी नहीं. Google Maps Platform की उपलब्धता वाले देशों या इलाकों के बारे में जानने के लिए, Google Maps Platform की कवरेज की जानकारी देखें.

GeocoderComponentRestrictions इंटरफ़ेस

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

GeocoderComponentRestrictions, फ़िल्टर के एक सेट को दिखाता है जो किसी खास इलाके के लिए काम करता है. यह कैसे काम करता है, इस बारे में जानने के लिए जियोकोडिंग कॉम्पोनेंट फ़िल्टर करना लेख पढ़ें.
administrativeArea
ज़रूरी नहीं
टाइप: string optional
सभी administrative_area levels से मेल खाता है. ज़रूरी नहीं.
country
ज़रूरी नहीं
टाइप: string optional
यह किसी देश के नाम या दो अक्षरों वाले ISO 3166-1 देश के कोड से मैच करता है. ज़रूरी नहीं.
locality
ज़रूरी नहीं
टाइप: string optional
locality और sublocality, दोनों टाइप से मैच करता है. ज़रूरी नहीं.
postalCode
ज़रूरी नहीं
टाइप: string optional
postal_code और postal_code_prefix से मेल खाता है. ज़रूरी नहीं.
route
ज़रूरी नहीं
टाइप: string optional
route के लंबे या छोटे नाम से मेल खाता है. ज़रूरी नहीं.

ExtraGeocodeComputation कॉन्सटेंट

कॉन्सटैंट google.maps.ExtraGeocodeComputation
लाइब्रेरी "geocoding"

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

इन कॉन्सटैंट को स्ट्रिंग के तौर पर भी इस्तेमाल किया जा सकता है. TypeScript में, स्ट्रिंग लिटरल को ExtraGeocodeComputationString टाइप से तय किया जाता है.

const {ExtraGeocodeComputation} = await google.maps.importLibrary("geocoding");
ADDRESS_DESCRIPTORS पते की जानकारी देने वाला कोई लैंडमार्क जनरेट करें.

GeocoderStatus कॉन्सटैंट

कॉन्सटैंट google.maps.GeocoderStatus
लाइब्रेरी "geocoding"

geocode() को किए गए कॉल के पूरा होने पर, Geocoder से मिला स्टेटस. इन्हें वैल्यू या कॉन्सटेंट के नाम का इस्तेमाल करके तय करें. उदाहरण के लिए, 'OK' या google.maps.GeocoderStatus.OK.

इन कॉन्सटैंट को स्ट्रिंग के तौर पर भी इस्तेमाल किया जा सकता है. TypeScript में, स्ट्रिंग लिटरल को GeocoderStatusString टाइप से तय किया जाता है.

const {GeocoderStatus} = await google.maps.importLibrary("geocoding");
ERROR Google के सर्वर से संपर्क करने में कोई समस्या हुई.
INVALID_REQUEST यह GeocoderRequest अमान्य था.
OK जवाब में एक मान्य GeocoderResponse शामिल है.
OVER_QUERY_LIMIT वेबपेज पर बहुत कम समय में, अनुरोधों की तय सीमा से ज़्यादा अनुरोध किए गए हैं.
REQUEST_DENIED वेबपेज को जियोकोडर इस्तेमाल करने की अनुमति नहीं है.
UNKNOWN_ERROR सर्वर की गड़बड़ी की वजह से, जियोकोडिंग का अनुरोध प्रोसेस नहीं किया जा सका. फिर से कोशिश करने पर, अनुरोध पूरा हो सकता है.
ZERO_RESULTS इस GeocoderRequest के लिए कोई नतीजा नहीं मिला.

GeocoderResponse इंटरफ़ेस

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

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

GeocoderResult इंटरफ़ेस

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

जियोकोड सर्वर से मिला एक जियोकोडर नतीजा. जियोकोड के अनुरोध से, कई नतीजे मिल सकते हैं. ध्यान दें कि भले ही यह नतीजा "JSON जैसा" है, लेकिन यह पूरी तरह से JSON नहीं है. इसकी वजह यह है कि इसमें LatLng ऑब्जेक्ट शामिल है.
address_components
GeocoderAddressComponent की कैटगरी
formatted_address
टाइप: string
इस स्ट्रिंग में, इस जगह का पता होता है. इसे कोई भी व्यक्ति आसानी से पढ़ सकता है.
geometry
टाइप: GeocoderGeometry
एक GeocoderGeometry ऑब्जेक्ट
place_id
टाइप: string
जगह से जुड़ा प्लेस आईडी. जगह के आईडी, Google के जगहों के डेटाबेस और Google Maps में किसी जगह की अलग पहचान के लिए इस्तेमाल होते हैं. Places API की डेवलपर गाइड में, जगह के आईडी के बारे में ज़्यादा जानें.
types
टाइप: Array<string>
स्ट्रिंग का एक कलेक्शन, जो जियोकोड किए गए एलिमेंट के टाइप को दिखाता है. संभावित स्ट्रिंग की सूची के लिए, डेवलपर गाइड का पते के कॉम्पोनेंट के टाइप सेक्शन देखें.
Betaaddress_descriptor
ज़रूरी नहीं
टाइप: AddressDescriptor optional
इस जियोकोड से जुड़ी जगह की जानकारी. इसमें आस-पास के लैंडमार्क और विज्ञापन दिखाने के लिए जगह वाले इलाकों का रैंक किया गया सेट शामिल होता है. यह फ़ील्ड सिर्फ़ फ़ॉरवर्ड जियोकोडिंग और जगह के आईडी की खोज के अनुरोधों के लिए भरा जाएगा. ऐसा सिर्फ़ तब होगा, जब ExtraGeocodeComputation.ADDRESS_DESCRIPTORS चालू हो और सिर्फ़ स्थानीय जगहों के लिए हो.
partial_match
ज़रूरी नहीं
टाइप: boolean optional
क्या जियोकोडर, मूल अनुरोध के लिए एग्ज़ैक्ट मैच नहीं दिखा पाया, भले ही वह अनुरोध किए गए पते के कुछ हिस्से से मैच कर पाया हो. अगर एग्ज़ैक्ट मैच है, तो वैल्यू undefined होगी.
plus_code
ज़रूरी नहीं
टाइप: PlacePlusCode optional
जगह से जुड़ा Plus Code.
postcode_localities
ज़रूरी नहीं
टाइप: Array<string> optional
स्ट्रिंग का एक कलेक्शन, जो किसी पिन कोड में शामिल सभी इलाकों को दिखाता है. यह सिर्फ़ तब मौजूद होता है, जब नतीजे में ऐसा पिन कोड हो जिसमें कई इलाके शामिल हों.

AddressDescriptor इंटरफ़ेस

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

किसी जगह की जानकारी, जो किसी दूसरी जगह के संदर्भ में दी गई हो. इसमें आस-पास के लैंडमार्क और विज्ञापन दिखाने के लिए जगह वाले इलाकों का रैंक किया गया सेट शामिल होता है.
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
ज़रूरी नहीं
टाइप: LatLngBounds optional
इस GeocoderResult की सटीक सीमाएं, अगर लागू हो

GeocoderLocationType कॉन्सटैंट

कॉन्सटैंट google.maps.GeocoderLocationType
लाइब्रेरी "geocoding"

यह जियोकोड से मिली जगह के टाइप के बारे में बताता है. इन्हें वैल्यू या कॉन्सटेंट के नाम का इस्तेमाल करके तय करें. उदाहरण के लिए, 'ROOFTOP' या google.maps.GeocoderLocationType.ROOFTOP.

इन कॉन्सटैंट को स्ट्रिंग के तौर पर भी इस्तेमाल किया जा सकता है. TypeScript में, स्ट्रिंग लिटरल को GeocoderLocationTypeString टाइप से तय किया जाता है.

const {GeocoderLocationType} = await google.maps.importLibrary("geocoding");
APPROXIMATE नतीजा अनुमानित है.
GEOMETRIC_CENTER नतीजे में, किसी लाइन (जैसे, सड़क) या पॉलीगॉन (इलाका) का ज्यामितीय केंद्र दिखाया जाता है.
RANGE_INTERPOLATED जवाब में मिला नतीजा, दो सटीक पॉइंट (जैसे, चौराहे) के बीच इंटरपोलेट किए गए अनुमान (आम तौर पर, सड़क पर) को दिखाता है. इंटरपोलेट किए गए नतीजे आम तौर पर तब दिखाए जाते हैं, जब किसी मोहल्ले के पते के लिए रूफ़टॉप जियोकोड उपलब्ध नहीं होते.
ROOFTOP नतीजे में सटीक जियोकोड दिखता है.

लैंडमार्क इंटरफ़ेस

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

कोई ऐसी जगह जो पते के लिए रेफ़रंस पॉइंट के तौर पर काम करती हो.
display_name
टाइप: string
लैंडमार्क का नाम.
display_name_language_code
टाइप: string
लैंडमार्क के नाम की भाषा.
place_id
टाइप: string
लैंडमार्क के तौर पर इस्तेमाल की जा रही जगह का आईडी. इसका इस्तेमाल, Place Details या जगह के आईडी लुकअप की मदद से लैंडमार्क के बारे में ज़्यादा जानकारी पाने के लिए किया जा सकता है.
spatial_relationship
टाइप: SpatialRelationship
इससे टारगेट की गई जगह और लैंडमार्क के बीच की दूरी का पता चलता है.
straight_line_distance_meters
टाइप: number
टारगेट की गई जगह और लैंडमार्क के बीच की सीधी दूरी.
types
टाइप: Array<string>
नतीजे के टाइप के बारे में बताने वाली एक या उससे ज़्यादा वैल्यू. ज़्यादा जानकारी के लिए, कृपया टाइप देखें.
travel_distance_meters
ज़रूरी नहीं
टाइप: number optional
टारगेट की गई जगह और लैंडमार्क के बीच, सड़क नेटवर्क के हिसाब से यात्रा की दूरी. यह फ़ील्ड खाली हो सकता है, अगर लैंडमार्क, सड़क नेटवर्क के उस हिस्से से डिसकनेक्ट हो गया हो जो टारगेट के सबसे नज़दीक है या अगर टारगेट की गई जगह को असल में सड़क नेटवर्क पर नहीं माना गया था.

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

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

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

Containment कॉन्सटेंट

कॉन्सटैंट google.maps.Containment
लाइब्रेरी "geocoding"

यह एक enum है, जो इलाके और विज्ञापन दिखाने के लिए जगह के बीच के संबंध को दिखाता है.

इन कॉन्सटैंट को स्ट्रिंग के तौर पर भी इस्तेमाल किया जा सकता है. TypeScript में, स्ट्रिंग लिटरल को ContainmentString टाइप से तय किया जाता है.

const {Containment} = await google.maps.importLibrary("geocoding");
NEAR विज्ञापन दिखाने के लिए चुनी गई जगह, इलाके से बाहर है, लेकिन उसके आस-पास है.
OUTSKIRTS विज्ञापन दिखाने के लिए चुनी गई जगह, इलाके के अंदर और किनारे के पास है.
WITHIN टारगेट की गई जगह, इलाके के बीच में मौजूद है.

SpatialRelationship कॉन्सटेंट

कॉन्सटैंट google.maps.SpatialRelationship
लाइब्रेरी "geocoding"

एक enum, जो लैंडमार्क और टारगेट के बीच स्पेस में संबंध दिखाता है.

इन कॉन्सटैंट को स्ट्रिंग के तौर पर भी इस्तेमाल किया जा सकता है. TypeScript में, स्ट्रिंग लिटरल को SpatialRelationshipString टाइप से तय किया जाता है.

const {SpatialRelationship} = await google.maps.importLibrary("geocoding");
ACROSS_THE_ROAD टारगेट, सड़क के दूसरी ओर मौजूद लैंडमार्क के ठीक सामने है.
AROUND_THE_CORNER यह लैंडमार्क के रास्ते पर नहीं है, लेकिन एक मोड़ दूर है.
BEHIND लैंडमार्क के स्ट्रक्चर के पास, लेकिन उसके ऐक्सेस पॉइंट से दूर.
BESIDE टारगेट, लैंडमार्क के ठीक बगल में है.
DOWN_THE_ROAD लैंडमार्क वाले रास्ते पर है, लेकिन उसके बगल में या सामने नहीं है.
NEAR अगर नीचे दी गई कोई भी शर्त लागू नहीं होती है, तो यह डिफ़ॉल्ट संबंध होता है.
WITHIN लैंडमार्क में स्पेशल ज्यामिति है और टारगेट इसकी सीमाओं के अंदर है.