Google Maps से लिंक करना

Places API (नया वर्शन), जगह की जानकारी के डेटा के लिए अनुरोधों को कई तरीकों से स्वीकार करता है. Places API (New) से मिले जवाब में, किसी जगह के बारे में डेटा होता है. इसमें जगह की जानकारी का डेटा और तस्वीरें/तस्वीरों का संग्रह, भौगोलिक जगहें, और लोकप्रिय जगहें शामिल हैं.

टेक्स्ट से खोजें (नया), आस-पास की जगहों की जानकारी (नया), और जगह की जानकारी (नया) के जवाब में, Google Maps के लिंक भी शामिल हो सकते हैं. आपके उपयोगकर्ता, Google Maps के इन लिंक पर जाकर, जवाब में किसी जगह के बारे में ज़्यादा जानकारी देख सकते हैं.

उदाहरण के लिए, आपने सैन फ़्रांसिस्को, कैलिफ़ोर्निया में मौजूद हवाई अड्डों को खोजा. इसके बाद, जवाब में जगहों की सूची में सैन फ़्रांसिस्को अंतरराष्ट्रीय हवाई अड्डे (एसएफ़ओ) को शामिल किया जाता है. जवाब में, SFO के लिए Place ऑब्जेक्ट में googleMapsUri फ़ील्ड जोड़ा गया है. इसमें Google Maps के लिंक शामिल हैं. इन लिंक का इस्तेमाल करके, Google Maps पर जगह की जानकारी, वहां जाने का रास्ता, जगह की समीक्षाएं, और जगह की फ़ोटो देखी जा सकती हैं.

Place ऑब्जेक्ट में जोड़े गए लिंक के साथ-साथ, googleMapsUri फ़ील्ड को भी रिस्पॉन्स में मौजूद Reviews और Photos ऑब्जेक्ट में जोड़ा जाता है:

• Reviews.googleMapsUri: इसमें समीक्षा का Google Maps लिंक होता है, ताकि आप इसे ब्राउज़र में देख सकें.

• Photos.googleMapsUri: इसमें फ़ोटो का Google Maps में किसी जगह पर ले जाने वाला लिंक होता है, ताकि आप उसे ब्राउज़र में देख सकें.

APIs Explorer की मदद से, लाइव अनुरोध किए जा सकते हैं. इससे आपको इन नए विकल्पों के बारे में जानने में मदद मिलती है:

इसे आज़माएं!

किसी जगह के लिए, Google Maps में ले जाने वाले लिंक

इस टेबल में, Google Maps के उन लिंक के बारे में बताया गया है जिन्हें जवाब में शामिल किया जा सकता है:

Places के जवाब में सभी लिंक शामिल करना

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

उदाहरण के लिए, यहां दिए गए टेक्स्ट से खोजें (नया) में, जवाब के तौर पर सभी Maps में किसी जगह पर ले जाने वाला लिंक शामिल हैं:

curl -X POST -d '{
  "textQuery" : "San Francisco International Airport"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,places.googleMapsLinks' \
'https://places.googleapis.com/v1/places:searchText'

जवाब इस फ़ॉर्म में है:

{
  "places": [
    {
      "formattedAddress": "San Francisco, CA 94128, USA",
      "displayName": {
        "text": "San Francisco International Airport",
        "languageCode": "en"
      },
      "googleMapsLinks": {
        "placeUri": "https://maps.google.com/?cid=11885663895765773631",
        "directionsUri": "https://www.google.com/maps/dir//''/data=!4m7!4m6!1m1!4e2!1m2!1m1!1s0x808f778c55555555:0xa4f25c571acded3f!3e0",
        "writeAReviewUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x808f778c55555555:0xa4f25c571acded3f!12e1",
        "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x808f778c55555555:0xa4f25c571acded3f!9m1!1b1",
        "photosUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x808f778c55555555:0xa4f25c571acded3f!10e5"
      }
    }
  ]
}

जवाब में कोई लिंक शामिल करना

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

curl -X POST -d '{
  "textQuery" : "San Francisco International Airport"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,places.googleMapsLinks.photosURI' \
'https://places.googleapis.com/v1/places:searchText'

जवाब में दिशा-निर्देश शामिल करो

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

अगले उदाहरण में, आस-पास की जगहों की जानकारी (नया वर्शन) का इस्तेमाल करके, directionsUri फ़ील्ड में जवाब के तौर पर मैप के निर्देशों का लिंक शामिल किया गया है:

curl -X POST -d '{
  "includedTypes": ["restaurant"],
  "maxResultCount": 10,
  "locationRestriction": {
    "circle": {
      "center": {
        "latitude": -33.8688,
        "longitude": 151.1957362},
      "radius": 500.0
    }
  }
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key:API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.googleMapsLinks.directionsUri' \
https://places.googleapis.com/v1/places:searchNearby

समीक्षाओं और फ़ोटो के लिंक शामिल करें

इस रिलीज़ में, रिस्पॉन्स में मौजूद Reviews और Photos ऑब्जेक्ट में googleMapsUri फ़ील्ड जोड़ा गया है. इन लिंक पर जाने से, Google Maps में समीक्षा या फ़ोटो खुल जाती है.

उदाहरण के लिए, यहां दिए गए टेक्स्ट सर्च (नया) में, जवाब में मौजूद हर जगह के लिए समीक्षाएं और फ़ोटो शामिल हैं:

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.reviews,places.photos' \
'https://places.googleapis.com/v1/places:searchText'

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

इसे आज़माएं!

API Explorer की मदद से, सैंपल अनुरोध किए जा सकते हैं. इससे आपको एपीआई और एपीआई के विकल्पों के बारे में जानकारी मिलती है.

1. पेज की दाईं ओर मौजूद, api API आइकॉन को चुनें.

2. इसके अलावा, स्टैंडर्ड पैरामीटर दिखाएं को बड़ा करें और fields पैरामीटर को फ़ील्ड मास्क पर सेट करें.

3. अनुरोध के मुख्य हिस्से में बदलाव करें. हालाँकि, ऐसा करना ज़रूरी नहीं है.

4. लागू करें बटन को चुनें. डायलॉग बॉक्स में, वह खाता चुनें जिसका इस्तेमाल करके आपको अनुरोध करना है.

5. API एक्सप्लोरर पैनल में, fullscreen

   एपीआई एक्सप्लोरर विंडो को बड़ा करने के लिए, फ़ुलस्क्रीन का इस्तेमाल करें.