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)

यह तरीका, पते को जियोकोड करता है. इससे किसी पते को 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

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

Destination.ParkingOptions

इस जगह के लिए पार्किंग के विकल्प.
arrival_summary

Destination.ArrivalSummary

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

ArrivalSummary

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

फ़ील्ड
text

LocalizedText

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

string

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

LocalizedText

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

ParkingOptions

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

फ़ील्ड
availability

Destination.ParkingOptions.Availability

इस जगह पर पार्किंग की सुविधा उपलब्ध है या नहीं.
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 पार्किंग की जगह ढूंढना बहुत मुश्किल है.

प्रवेश

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

फ़ील्ड
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

v4alpha/v4beta वर्शन के उपयोगकर्ताओं के लिए ज़रूरी कार्रवाई: इस फ़ील्ड को जल्द ही पुराने फ़ॉर्मैट "//places.googleapis.com/places/{placeID}" से नए फ़ॉर्मैट "places/{placeId}" में अपडेट किया जाएगा. पक्का करें कि ट्रांज़िशन की अवधि के दौरान, आपका ऐप्लिकेशन दोनों फ़ॉर्मैट को हैंडल कर सकता हो. उम्मीद है कि मई 2026 के आखिर तक, पुराने फ़ॉर्मैट को पूरी तरह से बंद कर दिया जाएगा.

इस नतीजे के लिए, जगह का पूरी तरह से क्वालिफ़ाइड आइडेंटिफ़ायर. यह "//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 अन्य सभी.

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" या "Gate 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

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

TravelMode

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

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

इस्तेमाल

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

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

PlaceView

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

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

फ़ील्ड
place

string

v4alpha/v4beta वर्शन के उपयोगकर्ताओं के लिए ज़रूरी कार्रवाई: इस फ़ील्ड को जल्द ही पुराने फ़ॉर्मैट "//places.googleapis.com/places/{placeID}" से नए फ़ॉर्मैट "places/{placeId}" में अपडेट किया जाएगा. पक्का करें कि ट्रांज़िशन की अवधि के दौरान, आपका ऐप्लिकेशन दोनों फ़ॉर्मैट को हैंडल कर सकता हो. उम्मीद है कि मई 2026 के आखिर तक, पुराने फ़ॉर्मैट को पूरी तरह से बंद कर दिया जाएगा.

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

जगह की पॉलीगॉन आउटलाइन, RFC 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

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

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

string

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

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

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

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

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]. इससे ज़ूम करने का लेवल कंट्रोल किया जाता है. एफ़ओवी कम होने का मतलब है कि ज़ूम ज़्यादा होगा.