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

GeocodeService

जियोकोडिंग करने के लिए सेवा.

GeocodeAddress

rpc GeocodeAddress(GeocodeAddressRequest) returns (GeocodeAddressResponse)

यह तरीका, पते को जियोकोड करता है. इससे पते को LatLng में मैप किया जाता है. इससे पते के बारे में स्ट्रक्चर्ड जानकारी भी मिलती है.

अनुमति पाने के लिंक

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

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

rpc GeocodeLocation(GeocodeLocationRequest) returns (GeocodeLocationResponse)

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

अनुमति पाने के लिंक

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

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

rpc GeocodePlace(GeocodePlaceRequest) returns (GeocodeResult)

यह तरीका, जगह के आईडी का इस्तेमाल करके जियोकोड लुकअप करता है.

अनुमति पाने के लिंक

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

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

मंज़िल

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

फ़ील्ड
primary

PlaceView

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

PlaceView

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

PlaceView

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

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

Landmark

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

Entrance

इस डेस्टिनेशन के लिए एंट्री पॉइंट.
navigation_points[]

NavigationPoint

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

Destination.ArrivalSummary

मंज़िल पर पहुंचने के बाद के अनुभव के बारे में, एआई से जनरेट की गई खास जानकारी.

ArrivalSummary

मंज़िल पर पहुंचने के बाद के अनुभव के बारे में, एआई से जनरेट की गई खास जानकारी.

फ़ील्ड
text

LocalizedText

डेस्टिनेशन पर पहुंचने के बाद मिलने वाले अनुभव के बारे में खास जानकारी.
flag_content_url

string

एक लिंक, जहां उपयोगकर्ता जवाब में मौजूद किसी समस्या के बारे में शिकायत कर सकते हैं.
disclosure_text

LocalizedText

सिर्फ़ आउटपुट के लिए. इसमें यात्रा के बारे में जानकारी देने वाले टेक्स्ट की जानकारी होती है.

प्रवेश

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

फ़ील्ड
location

LatLng

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

Entrance.Tag

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

string

दरवाज़े पर लगाई गई पिन, जिस इमारत पर मौजूद है उसकी जानकारी places/{place_id} फ़ॉर्मैट में.

टैग

किसी एंट्री के बारे में बताने वाली विशेषताएं.

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

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

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

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

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

GeocodeAddressRequest

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

फ़ील्ड
location_bias

GeocodeAddressRequest.LocationBias

ज़रूरी नहीं. वह क्षेत्र जिसमें खोजना है. इस जगह की जानकारी का इस्तेमाल, नतीजों को पक्षपातपूर्ण बनाने के लिए किया जाता है. इसका मतलब है कि दी गई जगह के आस-पास के नतीजे दिखाए जा सकते हैं.
language_code

string

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

string

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

string

जियोकोड करने के लिए, बिना स्ट्रक्चर वाला पता.
address

PostalAddress

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

LocationBias

वह क्षेत्र जिसमें खोजना है. इस जगह की जानकारी का इस्तेमाल, नतीजों को पक्षपातपूर्ण बनाने के लिए किया जाता है. इसका मतलब है कि दी गई जगह के आस-पास के नतीजे दिखाए जा सकते हैं.

फ़ील्ड
यूनियन फ़ील्ड type. जगह के हिसाब से खोज के नतीजों में अंतर आने की वजहें. type इनमें से सिर्फ़ एक हो सकता है:
rectangle

Viewport

उत्तर-पूर्व और दक्षिण-पश्चिम कोने से तय किया गया आयताकार बॉक्स. rectangle.high(), आयताकार व्यूपोर्ट का उत्तर-पूर्वी बिंदु होना चाहिए. rectangle.low(), आयताकार व्यूपोर्ट का दक्षिण-पश्चिम बिंदु होना चाहिए. rectangle.low().latitude(), rectangle.high().latitude() से ज़्यादा नहीं हो सकता. इससे अक्षांश की रेंज खाली हो जाएगी. रेक्टैंगल व्यूपोर्ट की चौड़ाई 180 डिग्री से ज़्यादा नहीं हो सकती.

GeocodeAddressResponse

GeocodeService.GeocodeAddress के लिए जवाब का मैसेज.

फ़ील्ड
results[]

GeocodeResult

जियोकोडिंग का नतीजा.

GeocodeLocationRequest

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

फ़ील्ड
language_code

string

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

string

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

string

ज़रूरी नहीं. नतीजों को सीमित करने के लिए, टाइप टैग का सेट. जिन नतीजों में बताए गए टाइप में से कोई भी टाइप नहीं है उन्हें हटा दिया जाता है.

संभावित वैल्यू की पूरी सूची के लिए, https://developers.google.com/maps/documentation/places/web-service/place-types पर मौजूद टेबल A और टेबल B देखें.
granularity[]

GeocodeResult.Granularity

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

string

जगह की जानकारी, "lat,lng" स्ट्रिंग के फ़ॉर्मैट में. उदाहरण के लिए, "64.7611872,-18.4705364".
location

LatLng

स्ट्रक्चर्ड फ़ॉर्मैट में जगह की जानकारी.

GeocodeLocationResponse

GeocodeService.GeocodeLocation के लिए जवाब का मैसेज.

फ़ील्ड
results[]

GeocodeResult

जियोकोडिंग का नतीजा.
plus_code

PlusCode

अनुरोध में दी गई जगह का Plus Code.

GeocodePlaceRequest

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

फ़ील्ड
place

string

ज़रूरी है. जगह की पहचान करने वाला ऐसा आईडी जिसे जगह के हिसाब से कोड में बदला जा सकता है. इसका फ़ॉर्मैट places/{place} होता है.
language_code

string

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

string

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

GeocodeResult

जियोकोड के नतीजे में, किसी जगह की भौगोलिक जानकारी होती है.

फ़ील्ड
place

string

इस नतीजे के लिए, जगह का पूरी तरह से क्वालिफ़ाइड आइडेंटिफ़ायर. यह "//places.googleapis.com/places/{placeID}" फ़ॉर्मैट में होता है. ज़्यादा जानकारी के लिए, https://developers.google.com/maps/documentation/places/web-service/place-id पर जाएं.
place_id

string

इस नतीजे के लिए जगह का आईडी.
location

LatLng

इस पते का अक्षांश/देशांतर.
granularity

GeocodeResult.Granularity

जगह की जानकारी का लेवल.
viewport

Viewport

जियोकोड के नतीजे दिखाने के लिए सही व्यूपोर्ट.
bounds

Viewport

पते के लिए बाउंडिंग बॉक्स.
formatted_address

string

एक लाइन में फ़ॉर्मैट किया गया पता.
postal_address

PostalAddress

डाक पते के फ़ॉर्मैट में पता.
address_components[]

GeocodeResult.AddressComponent

हर इलाके के लेवल के लिए दोहराए गए कॉम्पोनेंट.
postal_code_localities[]

LocalizedText

पिन कोड में शामिल सभी इलाकों की पूरी सूची.

यह सिर्फ़ तब भरा जाता है, जब नतीजा "postal_code" टाइप का हो.
types[]

string

इस नतीजे के लिए टाइप टैग का सेट. उदाहरण के लिए, "political" और "administrative_area".

संभावित वैल्यू की पूरी सूची के लिए, https://developers.google.com/maps/documentation/places/web-service/place-types पर मौजूद टेबल A और टेबल B देखें.
plus_code

PlusCode

इस जियोकोड में मौजूद जगह का Plus Code.

AddressComponent

अगर यह जानकारी उपलब्ध है, तो फ़ॉर्मैट किए गए पते के स्ट्रक्चर्ड कॉम्पोनेंट.

फ़ील्ड
long_text

string

पते के कॉम्पोनेंट का पूरा नाम या ब्यौरा. उदाहरण के लिए, ऑस्ट्रेलिया के लिए पते के कॉम्पोनेंट का पूरा नाम "ऑस्ट्रेलिया" हो सकता है.
short_text

string

अगर पता कॉम्पोनेंट के लिए छोटा किया गया नाम उपलब्ध है, तो उसे टेक्स्ट के तौर पर दिखाया जाता है. उदाहरण के लिए, ऑस्ट्रेलिया के लिए पते के कॉम्पोनेंट का छोटा नाम "AU" हो सकता है.
types[]

string

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

ज़्यादा जानकारी के लिए, https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types पर जाएं.
language_code

string

इस कॉम्पोनेंट को फ़ॉर्मैट करने के लिए इस्तेमाल की गई भाषा. यह CLDR नोटेशन में होती है.

जानकारी का स्तर

जगह की जानकारी का लेवल.

Enums
GRANULARITY_UNSPECIFIED इस्तेमाल न करें.
ROOFTOP यह उस प्लॉट की जगह की जानकारी देता है जिसका पता, मैच किए गए पते से मेल खाता है.
RANGE_INTERPOLATED इसे सड़क के अलग-अलग नंबरों के हिसाब से इंटरपोलेट किया जाता है. उदाहरण के लिए, अगर हमें पता है कि Amphitheatre Pkwy के एक सेगमेंट में 1600 से 1699 तक की संख्याएं शामिल हैं, तो 1650 को इसके एंडपॉइंट के बीच में रखा जा सकता है.
GEOMETRIC_CENTER यह उस फ़ीचर का जियोमेट्रिक सेंटर होता है जिसके लिए हमारे पास पॉलीगोनल डेटा होता है.
APPROXIMATE अन्य सभी.

लैंडमार्क

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

फ़ील्ड
relational_description

LocalizedText

इस स्ट्रिंग में, डेस्टिनेशन और लैंडमार्क के बीच के संबंध के बारे में ऐसी जानकारी होती है जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है. उदाहरण के लिए: "एम्पायर स्टेट बिल्डिंग के पास" या "संसद भवन के सामने".
tags[]

Landmark.Tag

ऐसे टैग जिनसे पता चलता है कि मंज़िल के हिसाब से लैंडमार्क का इस्तेमाल कैसे किया जा सकता है.
straight_line_distance_meters

double

सिर्फ़ आउटपुट के लिए. इस लैंडमार्क से डेस्टिनेशन तक की सीधी दूरी, मीटर में.
travel_distance_meters

double

सिर्फ़ आउटपुट के लिए. इस लैंडमार्क से डेस्टिनेशन तक सड़क के नेटवर्क की दूरी, मीटर में.
यूनियन फ़ील्ड landmark. लैंडमार्क. landmark इनमें से सिर्फ़ एक हो सकता है:
place

PlaceView

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

टैग

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

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

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

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

फ़ील्ड
navigation_point_token

string

सिर्फ़ आउटपुट के लिए. यह एक ऐसा टोकन है जिसका इस्तेमाल इस नेविगेशन पॉइंट की पहचान करने के लिए किया जा सकता है.
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

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

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

StructureType

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

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

PlusCode

प्लस कोड (http://plus.codes) एक लोकेशन रेफ़रंस होता है. यह दो फ़ॉर्मैट में होता है: ग्लोबल कोड, जो 14 मीटर x 14 मीटर (डिग्री का 1/8000वां हिस्सा) या इससे छोटे रेक्टैंगल को तय करता है. दूसरा, कंपाउंड कोड, जो प्रीफ़िक्स को रेफ़रंस लोकेशन से बदलता है.

फ़ील्ड
global_code

string

जगह का ग्लोबल (पूरा) कोड, जैसे कि "9FWM33GV+HQ". यह 1/8000 डिग्री गुणा 1/8000 डिग्री (~14 मीटर गुणा 14 मीटर) के क्षेत्र को दिखाता है.
compound_code

string

जगह का कंपाउंड कोड, जैसे कि "33GV+HQ, रामबर्ग, नॉर्वे". इसमें ग्लोबल कोड का सफ़िक्स होता है. साथ ही, प्रीफ़िक्स को फ़ॉर्मैट किए गए रेफ़रंस इकाई के नाम से बदल दिया जाता है.

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 फ़ील्ड में इमारत की जानकारी शामिल होगी.

फ़ील्ड
place_filter

SearchDestinationsRequest.LocationQuery.PlaceFilter

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

LatLng

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

PlaceFilter

डेस्टिनेशन कैंडिडेट पर लागू किए जाने वाले फ़िल्टर.

फ़ील्ड
structure_type

PlaceView.StructureType

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

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

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

SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability

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

विज्ञापन दिखाने के लिए सही ऑडियंस को टारगेट करने की सुविधा

यह कुकी, टारगेटिंग के लिए उपलब्ध ऑडियंस को फ़िल्टर करने के विकल्पों के बारे में बताती है. आने वाले समय में, नई वैल्यू जोड़ी जा सकती हैं.

Enums
ADDRESSABILITY_UNSPECIFIED अगर कोई वैल्यू नहीं दी जाती है, तो सेवा डिफ़ॉल्ट वैल्यू चुन लेगी.
ANY विज्ञापन दिखाने के लिए सही ऑडियंस को टारगेट करना, फ़िल्टर करने की शर्त नहीं है. डेस्टिनेशन, उनकी पहुंच के हिसाब से दिखाए जाते हैं.
PRIMARY खोज के नतीजों में दिखाई गई सभी जगहों में, सड़क के लेवल का पता या नाम शामिल होगा.
WEAK खोज के नतीजों में दिखाए गए सभी डेस्टिनेशन में, सड़क के लेवल का पता या नाम होगा. ऐसा इसलिए, क्योंकि उनमें या तो कोई मुख्य जगह होगी या कोई सबडेस्टिनेशन होगा.

SearchDestinationsResponse

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

फ़ील्ड
destinations[]

Destination

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

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