Package google.maps.geocode.v4alpha

इंडेक्स

DestinationService

यह सेवा, डेस्टिनेशन की जानकारी वापस पाने के लिए होती है.

डेस्टिनेशन से किसी जगह के बारे में क्रम के हिसाब से जानकारी मिलती है. इससे, उदाहरण के लिए, किसी बड़े अपार्टमेंट कॉम्प्लेक्स में अपार्टमेंट बिल्डिंग ढूंढने और इसके उलट काम करने में मदद मिलती है. यह नेविगेशन पॉइंट भी उपलब्ध कराता है, जो राइडशेयरिंग या डिलीवरी जैसे इस्तेमाल के मामलों के लिए सही होते हैं.

SearchDestinations

rpc SearchDestinations(SearchDestinationsRequest) returns (SearchDestinationsResponse)

यह तरीका, डेस्टिनेशन लुकअप करता है और डेस्टिनेशन की सूची दिखाता है.

अनुमति के स्कोप

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode

मंज़िल

कोई मंज़िल. इसमें मुख्य जगह, उससे जुड़ी जगहें, प्रवेश द्वार, और नेविगेशन पॉइंट शामिल हैं.

फ़ील्ड
primary

PlaceView

अनुरोध में primary_query के ज़रिए पहचानी गई मुख्य जगह.
containing_places[]

PlaceView

वे जगहें जो मुख्य जगह के मुकाबले कम सटीक हैं. उदाहरण के लिए, अपार्टमेंट कॉम्प्लेक्स, जिसमें यह बिल्डिंग मौजूद है.
sub_destinations[]

PlaceView

मुख्य जगह के ज़्यादा सटीक उप-डेस्टिनेशन. उदाहरण के लिए, किसी बिल्डिंग में मौजूद यूनिट.

ध्यान दें: Places API से मिले SubDestination की तुलना में, सब-डेस्टिनेशन की यह सूची ज़्यादा जानकारी वाली होती है. साथ ही, हर सब-डेस्टिनेशन में ज़्यादा जानकारी होती है.
landmarks[]

Landmark

लैंडमार्क, जिनका इस्तेमाल यह बताने के लिए किया जा सकता है कि डेस्टिनेशन कहां है या पहुंचने में मदद मिल सकती है.
entrances[]

Entrance

इस जगह के लिए प्रवेश द्वार.
navigation_points[]

NavigationPoint

इस डेस्टिनेशन के लिए नेविगेशन पॉइंट.

प्रवेश

प्रवेश द्वार, अक्षांश/देशांतर के निर्देशांक का एक ऐसा जोड़ा होता है जो किसी जगह के एंट्री और एक्ज़िट पॉइंट की जगह की जानकारी देता है.

फ़ील्ड
location

LatLng

प्रवेश द्वार की जगह.
tags[]

Entrance.Tag

प्रवेश द्वार की जानकारी देने वाले टैग की सूची.
place

string

दरवाज़े की जगह की जानकारी, places/{place_id} फ़ॉर्मैट में दी जा सकती है.

टैग

किसी दरवाज़े की जानकारी देने वाली विशेषताएं.

Enums
TAG_UNSPECIFIED इस्तेमाल नहीं किया गया.
PREFERRED

ऐसा हो सकता है कि मुख्य सड़क से अंदर जाने का रास्ता, खोज के नतीजों में दिखाए गए डेस्टिनेशन तक पहुंचने का मुख्य रास्ता हो. किसी जगह के लिए, एक से ज़्यादा पसंदीदा रास्ते हो सकते हैं. अगर किसी प्रवेश द्वार पर यह टैग नहीं है, तो इसका मतलब है कि वह प्रवेश द्वार, मुख्य जगह वाली बिल्डिंग में ही है. हालांकि, यह ज़रूरी नहीं है कि उससे उस जगह तक पहुंचा जा सके.

उदाहरण के लिए, अगर प्राइमरी जगह स्ट्रिप मॉल में मौजूद कोई रेस्टोरेंट है, तो "पसंदीदा" एंट्री वे वे होंगी जो सीधे रेस्टोरेंट में जाती हैं. वहीं, अन्य एंट्री वे, बिल्डिंग के अन्य एंट्री वे होंगे. जैसे, स्ट्रिप मॉल में मौजूद अन्य रेस्टोरेंट के एंट्री वे.

अगर मुख्य जगह कोई बिल्डिंग है, तो PREFERRED प्रवेश द्वार वे होंगे जो बिल्डिंग के "मुख्य" हिस्से में जाते हैं. उदाहरण के लिए, शॉपिंग सेंटर में PREFERRED प्रवेश द्वार वे होंगे जिनसे मुख्य फ़ोयर एरिया में जाया जा सकता है. हालांकि, अगर कोई प्रवेश द्वार सिर्फ़ इमारत के किनारे मौजूद किसी स्टोर में जाने की अनुमति देता है, तो वह PREFERRED प्रवेश द्वार नहीं होगा.

ध्यान दें: ऐसा हो सकता है कि PREFERRED वाले दरवाज़े से मुख्य जगह का ऐक्सेस न मिले और PREFERRED के बिना वाले दरवाज़े से मुख्य जगह का ऐक्सेस मिल जाए.

लैंडमार्क

लैंडमार्क का इस्तेमाल, यह बताने के लिए किया जाता है कि डेस्टिनेशन कहां है या डेस्टिनेशन पर पहुंचने में मदद करने के लिए किया जाता है.

फ़ील्ड
tags[]

Landmark.Tag

ऐसे टैग जिनसे पता चलता है कि मंज़िल के हिसाब से लैंडमार्क का इस्तेमाल कैसे किया जा सकता है.
यूनियन फ़ील्ड landmark. लैंडमार्क. landmark इनमें से सिर्फ़ एक हो सकता है:
place

PlaceView

वह जगह जो इस लैंडमार्क को दिखाती है.

टैग

उन सभी टैग की सूची जो यह बताते हैं कि किसी जगह के संदर्भ में लैंडमार्क का इस्तेमाल कैसे किया जा सकता है.

अगर किसी पते में ADDRESS और ARRIVAL दोनों टैग मौजूद हैं, तो इसका मतलब है कि लैंडमार्क, स्थानीय तौर पर लोकप्रिय है और डेस्टिनेशन के पास है.

Enums
TAG_UNSPECIFIED इस्तेमाल नहीं किया गया.
ADDRESS स्थानीय तौर पर मशहूर कोई जगह. इसका इस्तेमाल, मंज़िल की सामान्य जगह की जानकारी का पता लगाने के लिए किया जा सकता है. आम तौर पर, यह जगह मंज़िल से कुछ सौ मीटर के दायरे में होती है. ये, Geocoding API की Address Descriptors सुविधा से मिले लैंडमार्क की तरह होते हैं: https://developers.google.com/maps/documentation/geocoding/address-descriptors/requests-address-descriptors.
ARRIVAL ऐसी जगह जिसका इस्तेमाल, मंज़िल तक पहुंचने में मदद करने के लिए किया जा सकता है. मंज़िल के आस-पास पहुंचने पर, नेविगेशन के लिए यह कुकी काम की होती है. उदाहरण के लिए, यह लैंडमार्क ऐसी जगह हो सकती है जो मंज़िल के ठीक सामने सड़क के दूसरी ओर हो. इस टैग वाली जगह, आम तौर पर ADDRESS टैग वाली जगहों की तुलना में डेस्टिनेशन के ज़्यादा करीब होती है.

नेविगेशन पॉइंट, सड़क के किनारे मौजूद ऐसी जगह होती है जहां नेविगेशन खत्म हो सकता है.

फ़ील्ड
display_name

LocalizedText

इस नेविगेशन पॉइंट का डिसप्ले नेम. उदाहरण के लिए, "5th Ave" या "Gate B".
location

LatLng

सड़क के उस हिस्से के बगल में मौजूद पॉइंट जहां नेविगेशन खत्म होना चाहिए. इस पॉइंट को सड़क के बीच से थोड़ा अलग रखा गया है, ताकि सड़क के उस हिस्से को साफ़ तौर पर मार्क किया जा सके जहां यह जगह मौजूद है.
travel_modes[]

NavigationPoint.TravelMode

यात्रा के ऐसे मोड जो इस नेविगेशन पॉइंट के लिए सही हैं.
usages[]

NavigationPoint.Usage

इस नेविगेशन पॉइंट के साथ काम करने वाले इस्तेमाल के उदाहरण.

TravelMode

यात्रा के ऐसे मोड जो इस नेविगेशन पॉइंट के लिए सही हैं.

Enums
TRAVEL_MODE_UNSPECIFIED इस्तेमाल नहीं किया गया.
DRIVE ड्राइविंग के लिए सही है.
WALK पैदल चलने के लिए सही है.

इस्तेमाल

इस नेविगेशन पॉइंट के साथ काम करने वाले इस्तेमाल के उदाहरण.

Enums
USAGE_UNSPECIFIED इस्तेमाल नहीं किया गया.
UNKNOWN इस्तेमाल के टाइप के बारे में जानकारी नहीं है. ज़्यादातर नेविगेशन पॉइंट UNKNOWN होंगे. इसका मतलब यह ज़रूरी नहीं है कि उनके इस्तेमाल पर किसी तरह की पाबंदी हो. यह नेविगेशन, पिकअप और/या ड्रॉपऑफ़ के लिए अब भी सही हो सकता है.
DROPOFF यात्री को उतारने के लिए सही जगह. उदाहरण के लिए, राइडशेयर करने वाली किसी कंपनी की गाड़ी से उतरने की जगह.
PICKUP किसी यात्री को पिक अप करने के लिए सही जगह. उदाहरण के लिए, राइड शेयर करने के लिए पिक अप करने की जगह.

PlaceView

Places API में, जगह के व्यू को दिखाता है. यह डेस्टिनेशन के बारे में ज़्यादा जानकारी भी देता है. जैसे, स्ट्रक्चर का टाइप और डिसप्ले पॉलीगॉन.

कुछ मामलों में, एक ही जगह के आईडी वाले PlaceView की वैल्यू, types और display_name फ़ील्ड के लिए Places API से मिली वैल्यू से अलग हो सकती है.

फ़ील्ड
place

string

इस जगह का संसाधन नाम, places/{placeId} फ़ॉर्मैट में.
display_name

LocalizedText

जगह के बारे में ऐसी जानकारी जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है. उदाहरण के लिए, "गेट बी", "मैकडॉनल्ड्स"
primary_type

string

इस जगह का मुख्य टाइप. संभावित वैल्यू की सूची देखने के लिए, https://developers.google.com/maps/documentation/places/web-service/place-types पर जाएं.

ध्यान दें: इस फ़ील्ड में हमेशा जानकारी नहीं भरी जाती. ऐसी स्थितियों में, types फ़ील्ड का इस्तेमाल करने के लिए तैयार रहें.
types[]

string

इस जगह से जुड़ी सभी तरह की जगहें. संभावित वैल्यू की सूची देखने के लिए, https://developers.google.com/maps/documentation/places/web-service/place-types पर जाएं.
formatted_address

string

एक लाइन में पता.
postal_address

PostalAddress

स्ट्रक्चर्ड पता.
structure_type

PlaceView.StructureType

इस जगह से जुड़ा स्ट्रक्चर किस तरह का है.
location

LatLng

इस जगह की लोकेशन. जिन जगहों के लिए डिसप्ले पॉलीगॉन मौजूद हैं उनके लिए, यह मैप पर मार्कर लगाने की अच्छी जगह हो सकती है.
display_polygon

Struct

जगह की पॉलीगॉन आउटलाइन, GeoJSON फ़ॉर्मैट में. इसके लिए, RFC 7946 फ़ॉर्मैट का इस्तेमाल किया जाता है: https://datatracker.ietf.org/doc/html/rfc7946#section-3.1.6.

ध्यान दें: RFC 7946 फ़ॉर्मैट में MultiPolygons काम करते हैं. इसलिए, एक display_polygon ऑब्जेक्ट कई पॉलीगॉन को दिखा सकता है.

StructureType

यह जगह किस तरह की है.

Enums
STRUCTURE_TYPE_UNSPECIFIED इस्तेमाल नहीं किया गया.
POINT पॉइंट लोकेशन.
SECTION किसी बिल्डिंग का सब-सेक्शन.
BUILDING एक बिल्डिंग.
GROUNDS यह एक बड़ा इलाका होता है, जिसमें आम तौर पर कई इमारतें होती हैं. जैसे, यूनिवर्सिटी कैंपस, अपार्टमेंट कॉम्प्लेक्स या शॉपिंग मॉल.

SearchDestinationsRequest

DestinationService.SearchDestinations के लिए अनुरोध मैसेज.

फ़ील्ड
travel_modes[]

NavigationPoint.TravelMode

ज़रूरी नहीं. नेविगेशन पॉइंट को फ़िल्टर करने के लिए यात्रा के मोड. इससे, जवाब में दिखाए गए navigation_points फ़ील्ड पर असर पड़ता है. अगर यह खाली है, तो यात्रा के सभी मोड के नेविगेशन पॉइंट दिखाए जा सकते हैं.
language_code

string

ज़रूरी नहीं. वह भाषा जिसमें नतीजे दिखाए जाने चाहिए.
region_code

string

ज़रूरी नहीं. क्षेत्र का कोड. क्षेत्र का कोड, जिसे ccTLD ("टॉप-लेवल डोमेन") के तौर पर दो वर्णों वाली वैल्यू के तौर पर तय किया जाता है. यह पैरामीटर, लागू कानून के आधार पर नतीजों पर असर डालता है. यह पैरामीटर, सेवा से मिले नतीजों पर भी असर डालता है. हालांकि, इससे नतीजों को पूरी तरह से सीमित नहीं किया जाता.

यूनियन फ़ील्ड primary_query. प्राइमरी डेस्टिनेशन के लिए क्वेरी करें. यह कोई जगह, पूरा पता या LatLng जगह की जानकारी हो सकती है. कम जानकारी वाले कुछ पतों और जगहों को डेस्टिनेशन में नहीं बदला जा सकेगा.

डेस्टिनेशन, दी गई मुख्य क्वेरी के आधार पर बनाए जाते हैं.

ध्यान दें: सिर्फ़ उन जगहों और पतों के लिए नेविगेशन की सुविधा काम करती है जहां पहुंचा जा सकता है. उदाहरण के लिए, किसी घर या अपार्टमेंट कॉम्प्लेक्स को दिखाने वाली जगह को मुख्य क्वेरी के तौर पर इस्तेमाल किया जा सकता है. हालांकि, किसी इलाके या प्रशासनिक क्षेत्र को दिखाने वाली जगहों को मुख्य क्वेरी के तौर पर इस्तेमाल नहीं किया जा सकता. primary_query इनमें से सिर्फ़ एक हो सकता है:
place

string

जगह का संसाधन नाम, places/{place_id} फ़ॉर्मैट में.
address_query

SearchDestinationsRequest.AddressQuery

मोहल्ले का पता.
location_query

SearchDestinationsRequest.LocationQuery

जगह की सटीक जानकारी.

AddressQuery

वह पता जिसे आपको खोजना है. पते, उस देश की राष्ट्रीय डाक सेवा के इस्तेमाल किए गए फ़ॉर्मैट के मुताबिक होने चाहिए.

फ़ील्ड
यूनियन फ़ील्ड kind. पते के बारे में क्वेरी. kind इनमें से सिर्फ़ एक हो सकता है:
address

PostalAddress

डाक पते के फ़ॉर्मैट में मोहल्ले का पता.
address_query

string

मोहल्ले का पता, जिसे एक लाइन में फ़ॉर्मैट किया गया हो.

LocationQuery

आस-पास की मुख्य जगह की पहचान करने के लिए, जगह की जानकारी से जुड़ी क्वेरी.

ध्यान दें: अगर जगह की जानकारी के लिए की गई क्वेरी, किसी ऐसी बिल्डिंग के अंदर की गई है जिसमें सबप्रीमाइसेस शामिल हैं, तो हो सकता है कि जवाब में मिली मुख्य जगह, सबप्रीमाइसेस हो. ऐसे मामलों में, containing_places फ़ील्ड में इमारत की जानकारी शामिल होगी.

फ़ील्ड
यूनियन फ़ील्ड kind. जगह की जानकारी के लिए क्वेरी. kind इनमें से सिर्फ़ एक हो सकता है:
location

LatLng

जगह की सटीक LatLng जानकारी.

SearchDestinationsResponse

DestinationService.SearchDestinations के लिए जवाब का मैसेज.

फ़ील्ड
destinations[]

Destination

डेस्टिनेशन की सूची.

अगर मुख्य क्वेरी से मुख्य डेस्टिनेशन की पहचान साफ़ तौर पर की जा सकती है, तो सेवा एक नतीजा दिखाती है. ऐसा न करने पर, सेवा एक से ज़्यादा नतीजे दिखा सकती है या कोई भी नतीजा नहीं दिखा सकती है.