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

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

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

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

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

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

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

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

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

इसे आज़माएं!

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

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

Google Maps का लिंक	ब्यौरा	फ़ील्ड का नाम
जगह	Google Maps में जगह की जानकारी खोलने के लिए लिंक.	googleMapsLinks.placeUri
निर्देश	Google Maps में जगह के लिए निर्देश खोलने वाला लिंक.	googleMapsLinks.directionsUri
समीक्षा लिखें	Google Maps में किसी जगह की समीक्षा करने के लिए लिंक.	googleMapsLinks.writeAReviewUri
समीक्षाएं पढ़ें	जगह की Google Maps पर की गई समीक्षाएं दिखाने के लिए लिंक.	googleMapsLinks.reviewsUri
फ़ोटो	Google Maps पर जगह की फ़ोटो दिखाने के लिए लिंक.	googleMapsLinks.photosUri

ध्यान दें: इस रिलीज़ में, समीक्षा पढ़ने या लिखने और किसी जगह की फ़ोटो देखने के लिंक, सिर्फ़ Google Maps के वेब वर्शन पर काम करते हैं. ये Google Maps के मोबाइल वर्शन पर काम नहीं करते.

कीमत

यह सुविधा, GA के रिलीज़ होने से पहले की झलक के तौर पर उपलब्ध है. इसका इस्तेमाल करने के लिए कोई शुल्क नहीं लिया जाता. इसका मतलब है कि झलक के दौरान इस्तेमाल करने के लिए, बिलिंग 0 डॉलर होगी. सुझाई गई कीमत के बारे में ज़्यादा जानने के लिए, Places API के इस्तेमाल और बिलिंग देखें.

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

जगहों के जवाब में मौजूद लिंक, googleMapsLinks फ़ील्ड में होते हैं. अगर आपको जवाब में 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"
      }
    }
  ]
}

ध्यान दें: इस रिलीज़ से पहले, रिस्पॉन्स में मौजूद Place ऑब्जेक्ट में place.googleMapsURI फ़ील्ड शामिल था. इसमें, जगह का Google Maps लिंक होता था. रिस्पॉन्स में मौजूद नए place.googleMapsLinks.placeURI फ़ील्ड में वही वैल्यू होती है जो place.googleMapsURI में होती है.

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

आपको जवाब में सभी लिंक नहीं दिखाने होंगे. उदाहरण के लिए, अगर आपको रिस्पॉन्स में सिर्फ़ फ़ोटो का लिंक चाहिए, तो सिर्फ़ 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 के सभी तरीके, जवाब में निर्देशों का लिंक जनरेट करने की सुविधा देते हैं. मौजूदा जगह की जानकारी को ऑरिजिन के तौर पर इस्तेमाल किया जाता है, जगह की जानकारी को डेस्टिनेशन के तौर पर इस्तेमाल किया जाता है, और यात्रा का मोड ड्राइव है.

अगले उदाहरण में, 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

ध्यान दें: टेक्स्ट सर्च और आस-पास के कारोबारों को खोजने की सुविधा के लिए, routingParameters रिक्वेस्ट पैरामीटर का इस्तेमाल करके, किसी खास सोर्स की जानकारी दी जा सकती है. हालांकि, ऐसा करना ज़रूरी नहीं है. अनुरोध पैरामीटर, रिस्पॉन्स में रास्ते की खास जानकारी और रास्ते पर खोज पर असर डालता है. हालांकि, Google Maps के निर्देशों का हिसाब हमेशा मौजूदा जगह से लगाया जाता है.

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

इस रिलीज़ में, रिस्पॉन्स में 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 फ़ील्ड होता है. इसकी मदद से, ब्राउज़र में समीक्षा या फ़ोटो को खोला जा सकता है.

इसे आज़माएं!

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

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

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

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

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

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