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
  • https://www.googleapis.com/auth/maps-platform.destinations

GeocodeService

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

GeocodeAddress

rpc GeocodeAddress(GeocodeAddressRequest) returns (GeocodeAddressResponse)

यह तरीका, पते का जियोकोड करता है. इससे पते को अक्षांश और देशांतर से मैप किया जाता है. इससे पते के बारे में व्यवस्थित जानकारी भी मिलती है.

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

इनमें से किसी एक 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

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

Destination.ParkingOptions

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

Destination.ArrivalSummary

एआई से बनाया गया कॉन्टेंट, जिसमें मंज़िल पर पहुंचने के अनुभव के बारे में बताया गया है.

ArrivalSummary

एआई से बनाया गया कॉन्टेंट, जिसमें मंज़िल पर पहुंचने के अनुभव के बारे में बताया गया है.

फ़ील्ड
text

LocalizedText

मंज़िल पर पहुंचने के अनुभव की खास जानकारी.
flag_content_url

string

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

LocalizedText

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

ParkingOptions

मंज़िल पर पार्किंग के विकल्पों की जानकारी.

फ़ील्ड
availability

Destination.ParkingOptions.Availability

इस मंज़िल पर पार्किंग की उपलब्धता.
parking_facilities[]

Destination.ParkingOptions.ParkingFacility

इस डेस्टिनेशन पर पार्किंग की सुविधाएं.
onsite_parking

bool

मंज़िल पर, ऑनसाइट पार्किंग की सुविधा मौजूद है.
free_parking_lot

bool

मुफ़्त पार्किंग की सुविधा देता है.
paid_parking_lot

bool

यहां पैसे चुकाकर पार्किंग करने की सुविधा उपलब्ध है.
free_street_parking

bool

सड़क के किनारे मुफ़्त पार्किंग की सुविधा है.
paid_street_parking

bool

सड़क के किनारे पार्किंग की सुविधा के लिए पैसे देने होंगे.
valet_parking

bool

वैले पार्किंग की सुविधा है.
free_garage_parking

bool

गराज में मुफ़्त पार्किंग की सुविधा है.
paid_garage_parking

bool

यहां पैसे चुकाकर गराज में पार्किंग करने की सुविधा उपलब्ध है.

उपलब्धता

इस जगह पर जाने पर, पार्किंग ढूंढना कितना मुश्किल है, इसका कुल आकलन.

आने वाले समय में, नई वैल्यू जोड़ी जा सकती हैं.

Enums
AVAILABILITY_UNSPECIFIED पार्किंग की सुविधा उपलब्ध नहीं है.
PLENTY पार्किंग के लिए काफ़ी जगह है.
SOMEWHAT_DIFFICULT पार्किंग मिलना थोड़ा मुश्किल है.
DIFFICULT पार्किंग मिलना बहुत मुश्किल है.

ParkingFacility

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

फ़ील्ड
place

PlaceView

पार्किंग की इस खास सुविधा की जगह की जानकारी.
onsite

bool

क्या पार्किंग की यह सुविधा, मुख्य मंज़िल पर मौजूद है. अगर यह फ़ील्ड सेट नहीं है, तो ऑन-साइट स्टेटस के बारे में जानकारी नहीं मिलती.
popular

bool

क्या यह पार्किंग सुविधा, मुख्य डेस्टिनेशन पर जाने वाले लोगों के लिए एक लोकप्रिय विकल्प है. अगर यह फ़ील्ड सेट नहीं किया गया है, तो लोकप्रियता की स्थिति के बारे में जानकारी नहीं मिलती.
straight_line_distance_meters

double

मुख्य डेस्टिनेशन से इस पार्किंग की सुविधा तक की सीधी दूरी, मीटर में.

प्रवेश

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

फ़ील्ड
display_name

LocalizedText

ऐसा नाम जिसे कोई व्यक्ति आसानी से पढ़ सके. जैसे, "गेट बी", "साउथ एंट्रेंस", "फ़िफ़्थ एवेन्यू एंट्रेंस".
location

LatLng

एंट्री पॉइंट की जगह.
tags[]

Entrance.Tag

एंट्री के बारे में बताने वाले टैग की सूची.
place

string

वह स्ट्रक्चर जिस पर यह एंट्री मौजूद है. इसे places/{place_id} फ़ॉर्मैट में लिखें.
street_view_thumbnail

StreetViewThumbnail

Street View की थंबनेल इमेज, जिसमें एंट्री पॉइंट दिख रहा है. Street View Static API से इमेज का अनुरोध किया जा सकता है. https://developers.google.com/maps/documentation/streetview/request-streetview देखें.
street_view_annotation

ImageAnnotation

ऊपर दिए गए street_view_thumbnail पर मौजूद एंट्री पॉइंट का एनोटेशन.

टैग

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

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/{placeId} फ़ॉर्मैट में. इसका इस्तेमाल, जगह की जानकारी देखने के लिए किया जा सकता है.
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

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

ये वैल्यू, Places API के इस्तेमाल किए जाने वाले पते के टाइप और पते के कॉम्पोनेंट टाइप की टेबल से ली जाती हैं: https://developers.google.com/maps/documentation/places/web-service/place-types#address-types
language_code

string

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

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

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

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

ImageAnnotation

इमेज के थंबनेल पर मौजूद एनोटेशन, जैसे कि किसी एंट्री पॉइंट को आउटलाइन करने वाला पॉलीगॉन.

फ़ील्ड
coordinates[]

ImageAnnotation.Coordinate

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

कोऑर्डिनेट

इमेज पर मौजूद किसी पॉइंट का पिक्सल कोऑर्डिनेट. मूल बिंदु (0,0) इमेज के सबसे ऊपर बाएं पिक्सल का सबसे ऊपर बायां कोना होता है. इसमें x-ऐक्सिस दाईं ओर और y-ऐक्सिस नीचे की ओर होता है.

फ़ील्ड
x_px

float

X कोऑर्डिनेट.
y_px

float

Y कोऑर्डिनेट.

लैंडमार्क

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

फ़ील्ड
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 की Address Descriptors सुविधा से मिलने वाले लैंडमार्क जैसे होते हैं: https://developers.google.com/maps/documentation/geocoding/address-descriptors/requests-address-descriptors.
ARRIVAL ऐसी जगह जिसका इस्तेमाल, मंज़िल तक पहुंचने में मदद के लिए किया जा सकता है. मंज़िल के करीब पहुंचने पर, नेविगेशन के लिए मददगार. उदाहरण के लिए, यह लैंडमार्क मंज़िल के सामने वाली सड़क पर मौजूद कोई जगह हो सकती है. इस टैग वाली लैंडमार्क, आम तौर पर ADDRESS टैग वाली लैंडमार्क की तुलना में मंज़िल के ज़्यादा करीब होती है.

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

फ़ील्ड
navigation_point_token

string

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

LocalizedText

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

LatLng

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

NavigationPoint.TravelMode

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

NavigationPoint.Usage

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

StreetViewThumbnail

Street View की थंबनेल इमेज, जिसमें नेविगेशन पॉइंट दिखता है. हालांकि, ऐसा तब होता है, जब यह उपलब्ध हो. Street View Static API से इमेज का अनुरोध किया जा सकता है. https://developers.google.com/maps/documentation/streetview/request-streetview देखें.
entrance_annotation

ImageAnnotation

अगर उपलब्ध हो, तो ऊपर दिए गए street_view_thumbnail पर इस नेविगेशन पॉइंट से जुड़े प्रवेश द्वार की जानकारी.
altitude_meters

float

डब्ल्यूजीएस-84 एलिप्सॉइड के हिसाब से, नेविगेशन पॉइंट की ऊंचाई मीटर में.

TravelMode

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

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

इस्तेमाल

इस नेविगेशन पॉइंट के लिए इस्तेमाल किए जा सकने वाले मोड. आने वाले समय में, नई वैल्यू जोड़ी जा सकती हैं.

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

PlaceView

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

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

फ़ील्ड
place

string

इस जगह के संसाधन का नाम, places/{placeId} फ़ॉर्मैट में. इसका इस्तेमाल, जगह की जानकारी देखने के लिए किया जा सकता है.
place_id

string

किसी जगह का यूनीक आइडेंटिफ़ायर.
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

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

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

PlaceView.AddressComponent

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

AddressComponent

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

फ़ील्ड
long_text

string

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

string

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

string

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

ये वैल्यू, Places API के इस्तेमाल किए जाने वाले पते के टाइप और पते के कॉम्पोनेंट टाइप की टेबल से ली जाती हैं: https://developers.google.com/maps/documentation/places/web-service/place-types#address-types
language_code

string

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

StructureType

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

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

PlusCode

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

फ़ील्ड
global_code

string

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

string

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

SearchDestinationsRequest

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

फ़ील्ड
travel_modes[]

NavigationPoint.TravelMode

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

string

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

string

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

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

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

ध्यान दें: सिर्फ़ ऐसी जगहों और पतों की जानकारी दी जा सकती है जिन पर नेविगेट किया जा सकता है. उदाहरण के लिए, किसी घर या अपार्टमेंट कॉम्प्लेक्स को दिखाने वाली जगह को प्राथमिक क्वेरी के तौर पर इस्तेमाल किया जा सकता है. हालांकि, किसी मोहल्ले या राज्य को दिखाने वाली जगहों को प्राथमिक क्वेरी के तौर पर इस्तेमाल नहीं किया जा सकता. 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

अक्षांश और देशांतर के हिसाब से जगह की सटीक जानकारी.

PlaceFilter

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

फ़ील्ड
structure_type

PlaceView.StructureType

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

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

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

SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability

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

टारगेट करने की सुविधा

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

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

SearchDestinationsResponse

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

फ़ील्ड
destinations[]

Destination

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

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

StreetViewThumbnail

Google Street View के थंबनेल को दिखाने के लिए पैरामीटर. इन पैरामीटर का इस्तेमाल, Street View Static API से Street View की इमेज का अनुरोध करने के लिए किया जा सकता है. https://developers.google.com/maps/documentation/streetview/request-streetview देखें.

फ़ील्ड
pano

string

कोई खास पैनोरामा आईडी.
width_px

int32

पिक्सल में, आउटपुट थंबनेल इमेज की चौड़ाई. ध्यान दें: थंबनेल के साथ एनोटेशन का अनुरोध करते समय, Street View API के अनुरोध में ऊंचाई और चौड़ाई की इन वैल्यू का इस्तेमाल करना ज़रूरी है. इससे यह पक्का किया जा सकेगा कि एनोटेशन के निर्देशांक, इमेज के साथ सही तरीके से अलाइन हों.
height_px

int32

पिक्सल में, आउटपुट थंबनेल इमेज की लंबाई. ध्यान दें: थंबनेल के साथ एनोटेशन का अनुरोध करते समय, Street View API के अनुरोध में ऊंचाई और चौड़ाई की इन वैल्यू का इस्तेमाल करना ज़रूरी है. इससे यह पक्का किया जा सकेगा कि एनोटेशन के निर्देशांक, इमेज के साथ सही तरीके से अलाइन हों.
heading_degree

float

डिग्री में, कैमरे का हॉरिज़ॉन्टल ओरिएंटेशन. रेंज [0, 360). 0 का मतलब उत्तर और 90 का मतलब पूर्व है.
pitch_degree

float

कैमरे का वर्टिकल ओरिएंटेशन, डिग्री में. रेंज [-90, 90]. 0 का मतलब क्षितिज है, +90 का मतलब सीधे ऊपर है, और -90 का मतलब सीधे नीचे है.
fov_degree

float

डिग्री में, हॉरिज़ॉन्टल फ़ील्ड ऑफ़ व्यू (कैमरे से दिख रहा व्यू). रेंज (0, 180]. इससे ज़ूम करने का लेवल कंट्रोल किया जाता है. एफ़ओवी जितना कम होगा, ज़ूम उतना ही ज़्यादा होगा.