यह प्रॉडक्ट या सुविधा झलक (प्री-GA) में मौजूद है. Pre-GA प्रॉडक्ट और सुविधाओं में सीमित सहायता हो सकती है और Pre-GA प्रॉडक्ट और सुविधाओं में किए गए बदलाव शायद Pre-GA वर्शन के साथ काम नहीं करते. Pre-GA ऑफ़र, Google Maps Platform की सेवा की खास शर्तों के तहत आते हैं. ज़्यादा जानकारी के लिए, लॉन्च के चरण की जानकारी देखें.

उन जगहों को खोजने के लिए जहां आपको जाना है

यूरोपियन इकनॉमिक एरिया (ईईए) के डेवलपर

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

Geocoding API का SearchDestinations एंडपॉइंट, आपको अलग-अलग इनपुट शर्तों के आधार पर, अलग-अलग जगहों के बारे में ज़्यादा जानकारी पाने की सुविधा देता है. जैसे, पता, जगह का आईडी या अक्षांश और देशांतर के निर्देशांक.

मंज़िलें खोजने का अनुरोध

डेस्टिनेशन खोजने का अनुरोध, इस तरह के यूआरएल के लिए एचटीटीपी पोस्ट अनुरोध होता है:

https://geocode.googleapis.com/v4alpha/geocode/destinations

सभी पैरामीटर को JSON अनुरोध के मुख्य हिस्से में या हेडर में, POST अनुरोध के हिस्से के तौर पर पास करें. उदाहरण के लिए:

curl -X POST -d '{
  "place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w"
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4alpha/geocode/destinations

मंज़िल खोजने के लिए, जगह की जानकारी इन तीन तरीकों में से किसी एक तरीके से दी जा सकती है:

पता
जगह का आईडी
अक्षांश और देशांतर निर्देशांक

पते के हिसाब से मंज़िल खोजना

पते को बिना किसी स्ट्रक्चर वाली स्ट्रिंग के तौर पर सेट किया जा सकता है:

curl -X POST -d '{
  "addressQuery": {
    "addressQuery": "601 S Bernardo Ave, Sunnyvale, CA 94087, USA"
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4alpha/geocode/destinations

या postalAddress के तौर पर:

curl -X POST -d '{
  "addressQuery": {
    "address": {
      "addressLines": ["601 S Bernardo Ave"],
      "locality": "Sunnyvale",
      "postalCode": "94087",
      "administrativeArea": "CA",
      "regionCode": "US"
    }
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4alpha/geocode/destinations

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

जगह के आईडी से मंज़िल खोजना

जगह का आईडी देकर, किसी डेस्टिनेशन को वापस पाया जा सकता है:

curl -X POST -d '{
  "place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w"
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4alpha/geocode/destinations

जगह के हिसाब से मंज़िल खोजना

अक्षांश और देशांतर के निर्देशांक देकर, किसी डेस्टिनेशन को खोजा जा सकता है:

curl -X POST -d '{
  "locationQuery": {
    "location": {
      "latitude": 37.37348780,
      "longitude": -122.05678064
    }
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4alpha/geocode/destinations

अनुरोध करने के लिए OAuth का इस्तेमाल करना

Geocoding API v4, पुष्टि करने के लिए OAuth 2.0 का इस्तेमाल करता है. Geocoding API के साथ OAuth का इस्तेमाल करने के लिए, OAuth टोकन को सही स्कोप असाइन किया जाना चाहिए. Geocoding API, Destinations एंडपॉइंट के साथ इस्तेमाल करने के लिए इन स्कोप के साथ काम करता है:

https://www.googleapis.com/auth/maps-platform.geocode — इसका इस्तेमाल Geocoding API के सभी एंडपॉइंट के साथ किया जाता है.

इसके अलावा, Geocoding API के सभी एंडपॉइंट के लिए, सामान्य https://www.googleapis.com/auth/cloud-platform स्कोप का इस्तेमाल किया जा सकता है. यह स्कोप डेवलपमेंट के दौरान काम आता है, लेकिन प्रोडक्शन के दौरान नहीं. ऐसा इसलिए, क्योंकि यह एक सामान्य स्कोप है, जो सभी एंडपॉइंट को ऐक्सेस करने की अनुमति देता है.

ज़्यादा जानकारी और उदाहरणों के लिए, OAuth का इस्तेमाल करना लेख पढ़ें.

मंज़िलें खोजने के अनुरोध का जवाब

जगह के बारे में हाइपरलोकल कॉन्टेक्स्ट

Search Destinations API से मिले जवाब में, जगह के बारे में ज़्यादा जानकारी और आस-पास की जगहों के बारे में कॉन्टेक्स्ट मिलता है. मुख्य फ़ील्ड में ये शामिल हैं:

primary: अनुरोध में मौजूद क्वेरी से पता चलने वाली मुख्य जगह.
containingPlaces: बड़ी इकाइयां, जिनमें प्राइमरी डेस्टिनेशन शामिल होता है. उदाहरण के लिए, मॉल में मौजूद कोई स्टोर.
subDestinations: मुख्य डेस्टिनेशन के अंदर मौजूद ज़्यादा सटीक जगहें (उदाहरण के लिए, किसी बिल्डिंग में मौजूद अपार्टमेंट).
entrances: मंज़िल के लिए एंट्री और एग्ज़िट पॉइंट.
navigationPoints: सड़क के आस-पास की ऐसी जगहें जहां नेविगेशन खत्म किया जा सकता है.
arrivalSummary: एआई की मदद से मिलने वाली अहम जानकारी, जो आपको गंतव्य तक पहुंचने में मदद करती है. एआई की मदद से तैयार की गई खास जानकारी देखें.
landmarks: आस-पास की खास जगहों की जानकारी, ताकि लोगों को मंज़िल के आस-पास की जगहों के बारे में पता चल सके.

जवाब के सभी फ़ील्ड के बारे में पूरी जानकारी के लिए, एपीआई रेफ़रंस देखें.

जवाब का फ़ॉर्मैट

SearchDestinations, इस JSON फ़ॉर्म का SearchDestinationsResponse दिखाता है:

{
  "destinations": [
    {
      "primary": {
        "place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w",
        "displayName": {
          "text": "Arby's",
          "languageCode": "en"
        },
        "primaryType": "fast_food_restaurant",
        "types": [
          "fast_food_restaurant",
          "sandwich_shop",
          "deli",
          "american_restaurant",
          "meal_takeaway",
          "restaurant",
          "food_store",
          "food",
          "point_of_interest",
          "store",
          "establishment"
        ],
        "formattedAddress": "Arby's, 601 S Bernardo Ave, Sunnyvale, CA 94087, USA",
        "postalAddress": {
          "regionCode": "US",
          "languageCode": "en",
          "postalCode": "94087",
          "administrativeArea": "CA",
          "locality": "Sunnyvale",
          "addressLines": [
            "601 S Bernardo Ave"
          ]
        },
        "structureType": "BUILDING",
        "location": {
          "latitude": 37.3734545,
          "longitude": -122.05693269999998
        },
        "displayPolygon": { ... }
 {
          "type": "Polygon",
          "coordinates": [
            [
              [
                -122.056930138027,
                37.3735253692531
              ],
              [
                -122.056960139391,
                37.3735372663597
              ],
              [
                -122.056994129366,
                37.3734828786847
              ],
              [
                -122.056969677395,
                37.3734731161089
              ],
              [
                -122.057061762447,
                37.3733261309656
              ],
              [
                -122.056979388817,
                37.3732935577128
              ],
              [
                -122.056798860285,
                37.3735818838642
              ],
              [
                -122.056875858081,
                37.3736121235316
              ],
              [
                -122.056930138027,
                37.3735253692531
              ]
            ]
          ]
        }
      },
      "containingPlaces": [
        {
          "place": "places/ChIJYfdAFum2j4ARIcL2tjME3Sw",
          "displayName": {
            "text": "Cherry Chase Shopping Center",
            "languageCode": "en"
          },
          "primaryType": "shopping_mall",
          "types": [
            "shopping_mall",
            "point_of_interest",
            "establishment"
          ],
          "formattedAddress": "Cherry Chase Shopping Center, 663 S Bernardo Ave, Sunnyvale, CA 94087, USA",
          "postalAddress": {
            "regionCode": "US",
            "languageCode": "en",
            "postalCode": "94087-1020",
            "administrativeArea": "CA",
            "locality": "Sunnyvale",
            "addressLines": [
              "663 S Bernardo Ave"
            ]
          },
          "structureType": "GROUNDS",
          "location": {
            "latitude": 37.3731231,
            "longitude": -122.0578211
          },
          "displayPolygon": { ... }
 {
            "type": "Polygon",
            "coordinates": [
              [
                [
                  -122.057112227103,
                  37.3714618008523
                ],
                [
                  -122.057076849821,
                  37.3715743611411
                ],
                [
                  -122.056963607756,
                  37.3719081793948
                ],
                [
                  -122.056865279559,
                  37.3722026053835
                ],
                [
                  -122.056687872374,
                  37.3727258358476
                ],
                [
                  -122.056580005889,
                  37.3730511370747
                ],
                [
                  -122.056498845827,
                  37.3732994782583
                ],
                [
                  -122.056338259713,
                  37.3737878663325
                ],
                [
                  -122.056618678291,
                  37.373887693582
                ],
                [
                  -122.056912102521,
                  37.3740010327191
                ],
                [
                  -122.057532418159,
                  37.3742476426462
                ],
                [
                  -122.057673926626,
                  37.3742441740031
                ],
                [
                  -122.057735663106,
                  37.3742328516943
                ],
                [
                  -122.057766531332,
                  37.3742220604378
                ],
                [
                  -122.057797572967,
                  37.37420520725
                ],
                [
                  -122.057828267759,
                  37.3741852342085
                ],
                [
                  -122.058060299297,
                  37.3740060842535
                ],
                [
                  -122.058199726081,
                  37.3737861673422
                ],
                [
                  -122.05836707267,
                  37.373524542556
                ],
                [
                  -122.058569622393,
                  37.3732018598683
                ],
                [
                  -122.0587638478,
                  37.3728890198039
                ],
                [
                  -122.058934661823,
                  37.3726036257774
                ],
                [
                  -122.059164956851,
                  37.3722498383629
                ],
                [
                  -122.058997784906,
                  37.3721804442035
                ],
                [
                  -122.057936479838,
                  37.3717605636234
                ],
                [
                  -122.057495827092,
                  37.3715860151634
                ],
                [
                  -122.057112227103,
                  37.3714618008523
                ]
              ]
            ]
          }
        }
      ],
      "landmarks": [ ... ]
 [
        {
          "place": {
            "place": "places/ChIJteQ0Fum2j4ARGi3tqK4Zm14",
            "displayName": {
              "text": "Safeway",
              "languageCode": "en"
            },
            "primaryType": "grocery_store",
            "types": [
              "grocery_store",
              "florist",
              "butcher_shop",
              "deli",
              "bakery",
              "food_delivery",
              "supermarket",
              "market",
              "food_store",
              "food",
              "point_of_interest",
              "store",
              "establishment"
            ],
            "formattedAddress": "Safeway, 639 S Bernardo Ave, Sunnyvale, CA 94087, USA",
            "postalAddress": {
              "regionCode": "US",
              "languageCode": "en",
              "postalCode": "94087",
              "administrativeArea": "CA",
              "locality": "Sunnyvale",
              "addressLines": [
                "639 S Bernardo Ave"
              ]
            },
            "structureType": "POINT",
            "location": {
              "latitude": 37.3727912,
              "longitude": -122.0581172
            }
          },
          "tags": [
            "ARRIVAL",
            "ADDRESS"
          ],
          "relationalDescription": {
            "text": "Around the corner from Safeway",
            "languageCode": "en"
          },
          "straightLineDistanceMeters": 158.65607,
          "travelDistanceMeters": 131.16699
        },
        {
          "place": {
            "place": "places/ChIJ8enMlui2j4AR2xXK5EHDhBs",
            "displayName": {
              "text": "Starbird Chicken",
              "languageCode": "en"
            },
            "types": [
              "fast_food_restaurant",
              "restaurant",
              "food",
              "point_of_interest",
              "establishment"
            ],
            "formattedAddress": "Starbird Chicken, 1241 W El Camino Real, Sunnyvale, CA 94087, USA",
            "postalAddress": {
              "regionCode": "US",
              "languageCode": "en",
              "postalCode": "94087-1028",
              "administrativeArea": "CA",
              "locality": "Sunnyvale",
              "addressLines": [
                "1241 W El Camino Real"
              ]
            },
            "structureType": "BUILDING",
            "location": {
              "latitude": 37.3746764,
              "longitude": -122.05708860000001
            },
            "displayPolygon": { ... }
 {
              "type": "Polygon",
              "coordinates": [
                [
                  [
                    -122.057003840785,
                    37.3747648209809
                  ],
                  [
                    -122.057136852459,
                    37.3747919153144
                  ],
                  [
                    -122.057205005705,
                    37.3745815131859
                  ],
                  [
                    -122.057071994114,
                    37.3745544186944
                  ],
                  [
                    -122.057003840785,
                    37.3747648209809
                  ]
                ]
              ]
            }
          },
          "tags": [
            "ARRIVAL",
            "ADDRESS"
          ],
          "relationalDescription": {
            "text": "Near Starbird Chicken",
            "languageCode": "en"
          },
          "straightLineDistanceMeters": 87.34801,
          "travelDistanceMeters": 214.08084
        },
        {
          "place": {
            "place": "places/ChIJXXTe7Oi2j4ARoMTA-D6Hjpg",
            "displayName": {
              "text": "Chase Bank",
              "languageCode": "en"
            },
            "primaryType": "bank",
            "types": [
              "bank",
              "atm",
              "finance",
              "point_of_interest",
              "establishment"
            ],
            "formattedAddress": "Chase Bank, 1234 W El Camino Real, Sunnyvale, CA 94087, USA",
            "postalAddress": {
              "regionCode": "US",
              "languageCode": "en",
              "postalCode": "94087",
              "administrativeArea": "CA",
              "locality": "Sunnyvale",
              "addressLines": [
                "1234 W El Camino Real"
              ]
            },
            "structureType": "POINT",
            "location": {
              "latitude": 37.373579,
              "longitude": -122.05752700000001
            }
          },
          "tags": [
            "ARRIVAL",
            "ADDRESS"
          ],
          "relationalDescription": {
            "text": "Near Chase Bank",
            "languageCode": "en"
          },
          "straightLineDistanceMeters": 61.182194,
          "travelDistanceMeters": 63.075645
        },
        {
          "place": {
            "place": "places/ChIJlbIO1Oi2j4ARp17Uf24xkHk",
            "displayName": {
              "text": "Madras Café",
              "languageCode": "en"
            },
            "primaryType": "indian_restaurant",
            "types": [
              "indian_restaurant",
              "coffee_shop",
              "cafe",
              "restaurant",
              "food_store",
              "food",
              "point_of_interest",
              "store",
              "establishment"
            ],
            "formattedAddress": "Madras Café, 1177 W El Camino Real, Sunnyvale, CA 94087, USA",
            "postalAddress": {
              "regionCode": "US",
              "languageCode": "en",
              "postalCode": "94087-1026",
              "administrativeArea": "CA",
              "locality": "Sunnyvale",
              "addressLines": [
                "1177 W El Camino Real"
              ]
            },
            "structureType": "POINT",
            "location": {
              "latitude": 37.3743,
              "longitude": -122.0549333
            }
          },
          "tags": [
            "ARRIVAL",
            "ADDRESS"
          ],
          "relationalDescription": {
            "text": "Near Madras Café",
            "languageCode": "en"
          },
          "straightLineDistanceMeters": 204.45102,
          "travelDistanceMeters": 235.12041
        }
      ],
      "entrances": [
        {
          "location": {
            "latitude": 37.373531299999996,
            "longitude": -122.05694519999999
          },
          "tags": [
            "PREFERRED"
          ],
          "place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w"
        }
      ],
      "navigationPoints": [
        {
          "location": {
            "latitude": 37.3738659,
            "longitude": -122.05693620000001
          },
          "travelModes": [
            "DRIVE",
            "WALK"
          ],
          "usages": [
            "UNKNOWN"
          ]
        }
      ]
    }
  ]
}

ज़रूरी पैरामीटर

एपीआई अनुरोध में, यहां दिए गए तीन पैरामीटर में से कोई एक पैरामीटर होना चाहिए. इससे, मंज़िल का पता, जगह या जगह की जानकारी मिलती है:
- addressQuery - वह पता जिसे खोजना है.
- place - वह प्लेस आईडी जिसकी जानकारी खोजनी है.
- locationQuery - वह जगह जिसके अक्षांश और देशांतर निर्देशांकों को खोजना है.
FieldMask

जवाब के फ़ील्ड मास्क बनाकर, जवाब में दिखाए जाने वाले फ़ील्ड की सूची तय करें. यूआरएल पैरामीटर $fields या fields का इस्तेमाल करके या एचटीटीपी हेडर X-Goog-FieldMask का इस्तेमाल करके, रिस्पॉन्स फ़ील्ड मास्क को तरीके से पास करें. उदाहरण के लिए, नीचे दिए गए अनुरोध से सिर्फ़ मुख्य डेस्टिनेशन के एंट्री पॉइंट, नेविगेशन पॉइंट, और जगह का आईडी मिलेगा.
```
  curl -X POST -d '{"place": "places/ChIJG3kh4hq6j4AR_XuFQnV0_t8"}' \
    -H "X-Goog-Api-Key: API_KEY" \
    -H "Content-Type: application/json" \
    -H "X-Goog-FieldMask: destinations.entrances,destinations.navigationPoints,destinations.primary.place" \
    https://geocode.googleapis.com/v4alpha/geocode/destinations
  
```
जवाब में, लौटाए गए फ़ील्ड की कोई डिफ़ॉल्ट सूची नहीं होती. फ़ील्ड मास्क को शामिल न करने पर, यह तरीका गड़बड़ी का मैसेज दिखाता है. सभी फ़ील्ड वापस लाने के लिए, फ़ील्ड मास्क को * पर सेट करें. ज़्यादा जानकारी के लिए, जवाब में दिखाने के लिए फ़ील्ड चुनना लेख पढ़ें.

ज़रूरी नहीं पैरामीटर

travelModes

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

वह भाषा जिसमें नतीजे दिखाने हैं.
- इस्तेमाल की जा सकने वाली भाषाओं की सूची देखें. Google, अक्सर उन भाषाओं को अपडेट करता है जिनमें Gemini Apps काम करता है. इसलिए, हो सकता है कि इस सूची में पूरी जानकारी शामिल न हो.
- अगर languageCode नहीं दिया गया है, तो एपीआई डिफ़ॉल्ट रूप से en पर सेट हो जाता है. अगर आपने अमान्य भाषा कोड डाला है, तो एपीआई INVALID_ARGUMENT गड़बड़ी का मैसेज दिखाता है.
- एपीआई, मोहल्ले का ऐसा पता देने की पूरी कोशिश करता है जिसे उपयोगकर्ता और स्थानीय लोग, दोनों आसानी से पढ़ सकें. इस लक्ष्य को पूरा करने के लिए, यह स्थानीय भाषा में सड़क के पते दिखाता है. अगर ज़रूरी हो, तो यह पते को ऐसी स्क्रिप्ट में लिप्यंतरित करता है जिसे उपयोगकर्ता पढ़ सकता है. ऐसा करते समय, यह उपयोगकर्ता की पसंदीदा भाषा का ध्यान रखता है. अन्य सभी पते, चुनी गई भाषा में दिखाए जाते हैं. पते के सभी कॉम्पोनेंट, एक ही भाषा में दिखाए जाते हैं. यह भाषा, पहले कॉम्पोनेंट से चुनी जाती है.
- अगर नाम आपकी पसंदीदा भाषा में उपलब्ध नहीं है, तो एपीआई सबसे मिलते-जुलते नाम का इस्तेमाल करता है.
- पसंदीदा भाषा का असर, एपीआई से मिले नतीजों के सेट और उनके क्रम पर पड़ता है. जियोकोडर, भाषा के हिसाब से अब्रिविएशन का अलग-अलग मतलब निकालता है. जैसे, सड़क के टाइप के लिए अब्रिविएशन या ऐसे समानार्थी शब्द जो एक भाषा में मान्य हो सकते हैं, लेकिन दूसरी भाषा में नहीं.
regionCode

देश/इलाके का कोड, दो वर्णों वाले CLDR कोड की वैल्यू के तौर पर. कोई डिफ़ॉल्ट वैल्यू नहीं है. ज़्यादातर CLDR कोड, ISO 3166-1 कोड के जैसे ही होते हैं.
किसी पते को जियोकोड करते समय, फ़ॉरवर्ड जियोकोडिंग, यह पैरामीटर सेवा से मिले नतीजों को किसी खास इलाके के हिसाब से फ़िल्टर कर सकता है. हालांकि, यह पूरी तरह से ऐसा नहीं करता. किसी जगह या लोकेशन की जियोकोडिंग करते समय, रिवर्स जियोकोडिंग या जगह की जियोकोडिंग के लिए, इस पैरामीटर का इस्तेमाल पते को फ़ॉर्मैट करने के लिए किया जा सकता है. सभी मामलों में, लागू कानून के आधार पर इस पैरामीटर का असर नतीजों पर पड़ सकता है.
placeFilter

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

स्ट्रक्चरल ग्रैन्युलैरिटी के हिसाब से फ़िल्टर करना

structureType फ़िल्टर की मदद से, यह तय किया जा सकता है कि क्वेरी के जवाब में किस तरह के स्ट्रक्चर दिखाए जाएं:
- बिल्डिंग की जानकारी अलग से दिखाना: मैप पर बिल्डिंग की आउटलाइन दिखाने या किसी स्ट्रक्चर के बारे में जानकारी पाने के लिए, "structureType": "BUILDING" का इस्तेमाल करें.
- कॉम्प्लेक्स को समझना: "structureType": "GROUNDS" का इस्तेमाल करके यह पक्का करें कि मुख्य नतीजा, सभी आधारों पर आधारित हो. यह तब काम आता है, जब आपको यूनिवर्सिटी कैंपस या शॉपिंग मॉल जैसी बड़ी जगहों के बारे में क्वेरी करनी हो.
- यूनिट/सेक्शन पर फ़ोकस करना: किसी बिल्डिंग में मौजूद सेक्शन की पहचान करने के लिए, "structureType": "SECTION" का इस्तेमाल करें.
पक्का करें कि पते काम के हों

सभी जगहों के लिए, सड़क के लेवल का पता साफ़ तौर पर उपलब्ध नहीं होता. addressability फ़िल्टर की मदद से, नतीजों में पतों की क्वालिटी को कंट्रोल किया जा सकता है:
- मुख्य पते की जानकारी साफ़ तौर पर देना ज़रूरी है: यह पक्का करने के लिए कि मुख्य डेस्टिनेशन के नतीजे में हमेशा सड़क के लेवल का पता या नाम शामिल हो, "addressability": "PRIMARY" का इस्तेमाल करें. यह नेविगेशन या डिसप्ले के लिए फ़ायदेमंद है. इनमें साफ़ तौर पर पता दिखना ज़रूरी है.
- उप-डेस्टिनेशन में पतों की अनुमति दें: ऐसे मामलों में जहां मुख्य जगह का पता नहीं है, लेकिन उसके अंदर की इकाइयों का पता है (जैसे, किसी बिल्डिंग में अपार्टमेंट), "addressability": "WEAK" यह पक्का करता है कि कम से कम मुख्य जगह या उसके किसी एक उप-डेस्टिनेशन का पता मौजूद हो.
- कोई भी नतीजा: अगर पते की मौजूदगी आपके इस्तेमाल के उदाहरण के लिए काम की नहीं है, तो "addressability": "ANY" का इस्तेमाल करें.
उदाहरण: टारगेट किए जा सकने वाले पतों के हिसाब से फ़िल्टर करना
```
curl -X POST -d '{
  "locationQuery": {
    "location": {
      "latitude": 37.37348780,
      "longitude": -122.05678064
    },
    "placeFilter": {
      "structureType": "BUILDING",
      "addressability": "PRIMARY"
    }
  },
  "languageCode": "en"
}' \\
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \\
-H "X-Goog-FieldMask: place" \\
https://geocode.googleapis.com/v4alpha/geocode/destinations
```

सुझाव/राय दें या शिकायत करें

यह Geocoding API का एक्सपेरिमेंटल एंडपॉइंट है. हमें आपके सुझाव/राय/शिकायत का इंतज़ार रहेगा. इसके लिए, geocoding-feedback-channel@google.com पर ईमेल भेजें.

मंज़िलें खोजने का अनुरोध

पते के हिसाब से मंज़िल खोजना

जगह के आईडी से मंज़िल खोजना

जगह के हिसाब से मंज़िल खोजना

अनुरोध करने के लिए OAuth का इस्तेमाल करना

मंज़िलें खोजने के अनुरोध का जवाब

जगह के बारे में हाइपरलोकल कॉन्टेक्स्ट

जवाब का फ़ॉर्मैट

ज़रूरी पैरामीटर

FieldMask

ज़रूरी नहीं पैरामीटर

travelModes

languageCode

regionCode

placeFilter

स्ट्रक्चरल ग्रैन्युलैरिटी के हिसाब से फ़िल्टर करना

पक्का करें कि पते काम के हों

सुझाव/राय दें या शिकायत करें