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

Places API (New), जगह की जानकारी के डेटा के लिए कई तरीकों से अनुरोध स्वीकार करता है. 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 लिंक होता है, ताकि आप इसे ब्राउज़र में देख सकें.

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

इसे आज़माएं!

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

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

जगहों के बारे में दिए गए जवाब में सभी लिंक शामिल करें

जगहों की जानकारी वाले जवाब में मौजूद लिंक, 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 फ़ील्ड में जवाब के तौर पर Maps के दिशा-निर्देशों का लिंक शामिल करने के लिए, आस-पास की जगहों के बारे में खोजने की सुविधा (नई) का इस्तेमाल किया गया है:

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. एपीआई एक्सप्लोरर पैनल में, fullscreen चुनें

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