जगहें लाइब्रेरी

खास जानकारी

जगहें लाइब्रेरी के फ़ंक्शन, Maps JavaScript API आपके ऐप्लिकेशन को चालू करते हैं जगहें खोजने के लिए (इस एपीआई में संस्थान, भौगोलिक स्थिति के तौर पर बताया गया है) किसी इलाके में मौजूद हो या खास जगह में हो. जैसे, किसी मैप के बाउंड्री या किसी तय पॉइंट के आस-पास.

Places API में अपने-आप पूरा होने वाली सुविधा मिलती है. इसका इस्तेमाल करके, आपके ऐप्लिकेशन को Google मैप के आगे खोज व्यवहार खोज फ़ील्ड. जब कोई उपयोगकर्ता एक पता लिखना शुरू करता है, तो ऑटोकंप्लीट की सुविधा बाकी को पूरा करें. ज़्यादा जानकारी के लिए, देखें अपने-आप पूरा होना दस्तावेज़ में दिया गया है.

शुरू करना

अगर आपको Maps JavaScript API या Maps JavaScript एपीआई के बारे में जानकारी नहीं है तो हम JavaScript की समीक्षा करने और पहले एपीआई पासकोड पाएं बेहद ज़रूरी है.

एपीआई चालू करें

Maps JavaScript API में Places लाइब्रेरी का इस्तेमाल करने से पहले, पक्का करें कि कि Google Cloud Console में जगहें एपीआई चालू है, प्रोजेक्ट होता है, जिसे आपने Maps JavaScript API के लिए सेट अप किया होता है.

अपने चालू एपीआई की सूची देखने के लिए:

  1. YouTube Studio के Google Cloud Console.
  2. प्रोजेक्ट चुनें बटन पर क्लिक करें. इसके बाद, वही प्रोजेक्ट चुनें जिसे आपने सेट अप किया है Maps JavaScript API के लिए, खोलें पर क्लिक करें.
  3. डैशबोर्ड पर एपीआई की सूची से, Places API.
  4. अगर आपको सूची में Places API दिखता है, तो इसका मतलब है कि वह पहले से चालू है. अगर एपीआई सूची में नहीं है, तो इसे चालू करें:
    1. पेज पर सबसे ऊपर, एपीआई और सेवाएं चालू करें चुनें. ऐसा करने पर, आपको लाइब्रेरी टैब. इसके अलावा, बाईं ओर दिए गए मेन्यू से, लाइब्रेरी चुनें.
    2. Place API खोजें, फिर उसे नतीजों की सूची.
    3. चालू करें को चुनें. प्रोसेस पूरी होने के बाद, places API, एपीआई की सूची में डैशबोर्ड.

लाइब्रेरी लोड हो रही है

Places सेवा एक सेल्फ़-कंटेन्ड लाइब्रेरी है. यह मुख्य लाइब्रेरी से अलग होती है Maps JavaScript एपीआई कोड. इसमें मौजूद फ़ंक्शन का इस्तेमाल करने के लिए इस लाइब्रेरी में, आपको पहले इसे लोड करने के लिए libraries का इस्तेमाल करना होगा मैप API बूटस्ट्रैप URL में पैरामीटर:

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&loading=async&libraries=places&callback=initMap">
</script>

लाइब्रेरी के बारे में खास जानकारी देखें.

API कुंजी की API प्रतिबंध सूची में Places API जोड़ें

अपनी कुंजियों पर एपीआई से जुड़ी पाबंदियों को लागू करने से, एपीआई पासकोड का इस्तेमाल एक या उससे ज़्यादा ज़्यादा एपीआई या SDK टूल इस्तेमाल किए जा सकते हैं. एपीआई पासकोड से जुड़े किसी एपीआई या SDK टूल को किए जाने वाले अनुरोध प्रोसेस न हो. अगर किसी ऐसे एपीआई या SDK टूल को अनुरोध किया जाता है जो एपीआई पासकोड से जुड़ा नहीं है, तो विफल. किसी एपीआई पासकोड को जगहें लाइब्रेरी के साथ इस्तेमाल करने से रोकने के लिए, Maps JavaScript API:
  1. Google Cloud Console पर जाएं.
  2. प्रोजेक्ट ड्रॉप-डाउन पर क्लिक करें और वह प्रोजेक्ट चुनें जिसमें वह एपीआई पासकोड जिसे आपको सुरक्षित करना है.
  3. मेन्यू बटन पर क्लिक करें और Google Maps Platform > क्रेडेंशियल.
  4. क्रेडेंशियल पेज पर, एपीआई के नाम पर क्लिक करें कुंजी है जिसे आप सुरक्षित करना चाहते हैं.
  5. एपीआई पासकोड पर पाबंदी लगाएं और उसका नाम बदलें पेज पर, पाबंदियां सेट करें:
    • एपीआई से जुड़ी पाबंदियां
      • कुंजी पर पाबंदी लगाएं को चुनें.
      • एपीआई चुनें पर क्लिक करें और Maps JavaScript API और Place API, दोनों को चुनें.
        अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है (अगर दोनों में से कोई भी एपीआई सूची में नहीं है, तो आपको उसे चालू करना होगा.)
  6. सेव करें पर क्लिक करें.

इस्तेमाल करने की सीमाएं और नीतियां

कोटा

Places लाइब्रेरी इनके साथ इस्तेमाल का कोटा शेयर करती है Places API के बारे में, इस्तेमाल की सीमा से जुड़े दस्तावेज़ में बताया गया है Places API.

नीतियां

Maps JavaScript API को जगहें लाइब्रेरी का इस्तेमाल करने पर, बताई गई नीतियों के बारे में जानकारी जगहें एपीआई के लिए.

जगह की खोज

स्थल सेवा के साथ आप निम्न प्रकार की खोजें कर सकते हैं:

  • क्वेरी से जगह ढूंढें टेक्स्ट क्वेरी के आधार पर किसी जगह की जानकारी देता है (उदाहरण के लिए, इसका नाम या पता जगह).
  • फ़ोन से जगह ढूंढें नंबर, फ़ोन नंबर के आधार पर किसी जगह की जानकारी देता है.
  • आस-पास खोज उपयोगकर्ता की जगह की जानकारी के आधार पर, आस-पास की जगहों की सूची दिखाता है.
  • टेक्स्ट खोज किसी खोज स्ट्रिंग के आधार पर आस-पास के स्थानों की सूची देता है, उदा. "पिज़्ज़ा".
  • जगह की जानकारी के लिए अनुरोध किसी विशिष्ट स्थान के बारे में ज़्यादा विस्तृत जानकारी देता है, इसमें ये शामिल हैं उपयोगकर्ता की समीक्षाएं.

वापस की गई जानकारी में संस्थान की जानकारी शामिल हो सकती है — जैसे रेस्टोरेंट, स्टोर, और ऑफ़िस. साथ ही, 'जियोकोड' नतीजे, जिनमें पते, राजनैतिक क्षेत्रों, जैसे कि नगर और शहर, और अन्य लोकप्रिय जगहें.

जगह से जुड़े अनुरोध देखना

कोई जगह ढूंढें अनुरोध आपको टेक्स्ट क्वेरी या टेक्स्ट क्वेरी या फ़ोन नंबर. जगह ढूंढें के लिए अनुरोध दो तरह के होते हैं:

क्वेरी से जगह ढूंढें

क्वेरी से स्थान खोजें कोई टेक्स्ट इनपुट लेता है और स्थान देता है. इनपुट ये काम कर सकते हैं किसी भी तरह की जगह का डेटा होना चाहिए, जैसे कि कारोबार का नाम या पता. किसी क्वेरी अनुरोध से स्थान ढूंढें, PlacesService के findPlaceFromQuery() तरीका, जिसमें इन पैरामीटर की ज़रूरत होती है:

  • query (ज़रूरी है) वह टेक्स्ट स्ट्रिंग जिस पर खोज करनी है, उदाहरण: "रेस्टोरेंट" या "123 मेन स्ट्रीट". यह एक जगह का नाम होना चाहिए, पता या कारोबार की कैटगरी के बारे में जानकारी हो सकती है. किसी और तरह का इनपुट जनरेट किया जा सकता है और इस बात की कोई गारंटी नहीं है कि इससे मान्य नतीजे वापस मिलेंगे. Places API इस स्ट्रिंग के आधार पर उम्मीदवार के नतीजे मैच करेगा और नतीजों को क्रम से दिखाएगा और उनकी समझ के आधार पर.
  • fields (ज़रूरी है) एक या इससे ज़्यादा फ़ील्ड दिए जाने वाले स्थान डेटा के प्रकार तय करना.
  • locationBias (ज़रूरी नहीं) खोजा जाने वाला इलाका तय करने वाले कोऑर्डिनेट. यह इनमें से एक हो सकता है: फ़ॉलो किया जा रहा है:
    • अक्षांश/देशांतर निर्देशांक का एक सेट, जिसे इस रूप में बताया गया है LatLngLiteral या LatLng ऑब्जेक्ट
    • आयताकार बाउंड (दो अक्षांश/lng जोड़े या LatLngBounds ऑब्जेक्ट)
    • अक्षांश/देशांतर पर केंद्रित दायरा (मीटर में)

आपको findPlaceFromQuery() को कॉलबैक का तरीका भी पास करना होगा, नतीजे ऑब्जेक्ट और google.maps.places.PlacesServiceStatus को मैनेज करने के लिए जवाब.

नीचे दिए गए उदाहरण में, findPlaceFromQuery() को किया गया कॉल दिखाया गया है. के लिए खोज रहे हैं "म्यूज़ियम ऑफ़ कंटेंपररी आर्ट ऑस्ट्रेलिया", और शामिल है name और geometry फ़ील्ड.

var map;
var service;
var infowindow;

function initMap() {
  var sydney = new google.maps.LatLng(-33.867, 151.195);

  infowindow = new google.maps.InfoWindow();

  map = new google.maps.Map(
      document.getElementById('map'), {center: sydney, zoom: 15});

  var request = {
    query: 'Museum of Contemporary Art Australia',
    fields: ['name', 'geometry'],
  };

  var service = new google.maps.places.PlacesService(map);

  service.findPlaceFromQuery(request, function(results, status) {
    if (status === google.maps.places.PlacesServiceStatus.OK) {
      for (var i = 0; i < results.length; i++) {
        createMarker(results[i]);
      }
      map.setCenter(results[0].geometry.location);
    }
  });
}
 उदाहरण देखें

फ़ोन नंबर से जगह ढूंढें

'फ़ोन नंबर से जगह ढूंढें' सुविधा, फ़ोन नंबर लेकर किसी जगह की जानकारी देती है. यहां की यात्रा पर हूं फ़ोन नंबर से स्थान ढूंढने का अनुरोध करें, PlacesService का findPlaceFromPhoneNumber() तरीका, जिसमें इन पैरामीटर की ज़रूरत होती है:

  • phoneNumber (ज़रूरी है) E.164 फ़ॉर्मैट में कोई फ़ोन नंबर.
  • fields (ज़रूरी है) एक या इससे ज़्यादा फ़ील्ड दिए जाने वाले स्थान डेटा के प्रकार तय करना.
  • locationBias (ज़रूरी नहीं) इलाका तय करने वाले निर्देशांक खोजें. यह इनमें से एक हो सकता है:
    • अक्षांश/देशांतर निर्देशांक का एक सेट, जिसे इस रूप में बताया गया है LatLngLiteral या LatLng ऑब्जेक्ट
    • आयताकार सीमाएं (चार lat/lng पॉइंट या LatLngBounds ऑब्जेक्ट)
    • अक्षांश/देशांतर पर केंद्रित दायरा (मीटर में)

आपको findPlaceFromPhoneNumber() को कॉलबैक का तरीका भी पास करना होगा, नतीजे ऑब्जेक्ट और google.maps.places.PlacesServiceStatus को मैनेज करने के लिए जवाब.

फ़ील्ड (जगह के तरीके देखना)

नतीजे में, जगह की जानकारी के टाइप का कलेक्शन तय करने के लिए fields पैरामीटर का इस्तेमाल करें. उदाहरण के लिए: fields: ['formatted_address', 'opening_hours', 'geometry']. कंपाउंड वैल्यू तय करते समय डॉट का इस्तेमाल करें. उदाहरण के लिए: opening_hours.weekday_text.

जगह के बारे में खोज के नतीजे के मुताबिक फ़ील्ड मौजूद हैं. इन्हें बांट दिया गया है तीन बिलिंग कैटगरी में बांटें: बुनियादी, संपर्क, और माहौल. बेसिक फ़ील्ड ये हैं की बिलिंग बुनियादी दर से की जाती है और इसके लिए कोई अतिरिक्त शुल्क नहीं देना पड़ता. संपर्क और माहौल फ़ील्ड के लिए ज़्यादा बिल चुकाना होता है. कीमत वाली शीट देखें हमारा वीडियो देखें. एट्रिब्यूशन (html_attributions) हमेशा ऐसा होता है हर कॉल के साथ लौटाए जाते हैं, चाहे फ़ील्ड अनुरोध किया गया है.

बेसिक जानकारी

बेसिक कैटगरी में ये फ़ील्ड शामिल होते हैं:
business_status, formatted_address, geometry, icon,icon_mask_base_uri, icon_background_color, name, permanently_closed (अब सेवा में नहीं है), photos, place_id, plus_code, types

संपर्क करना

संपर्क कैटगरी में ये फ़ील्ड शामिल होते हैं: opening_hours
(अब सेवा में नहीं है जगहें लाइब्रेरी, Maps JavaScript API में देखें. पाने के लिए स्थान विवरण अनुरोध का उपयोग करें opening_hours नतीजे).

वायुमंडल

माहौल की कैटगरी में ये फ़ील्ड शामिल होते हैं: price_level, rating, और user_ratings_total

findPlaceFromQuery() और findPlaceFromPhoneNumber() विधियों में से हर एक फ़ील्ड और अपने संबंधित जवाबों में समान फ़ील्ड लौटा सकते हैं.

स्थान पूर्वाग्रह सेट करें (जगह के तरीके ढूंढें)

जगह ढूंढें के अनुकूल नतीजे पाने के लिए locationBias पैरामीटर का इस्तेमाल करें किसी इलाके में दिखता है. locationBias को इनमें से किसी एक में सेट किया जा सकता है तरीके:

किसी खास इलाके के लिए पक्षपात का इस्तेमाल:

locationBias: {lat: 37.402105, lng: -122.081974}

खोजने के लिए एक आयताकार क्षेत्र परिभाषित करें:

locationBias: {north: 37.41, south: 37.40, east: -122.08, west: -122.09}

आपके पास LatLngBounds का इस्तेमाल करने का भी विकल्प है.

किसी खास इलाके को ध्यान में रखते हुए, खोजने के लिए दायरा (मीटर में) तय करें:

locationBias: {radius: 100, center: {lat: 37.402105, lng: -122.081974}}

आस-पास की खोज के अनुरोध

आस-पास की खोज की मदद से आप किसी खास इलाके में जगहें खोज सकते हैं कीवर्ड या टाइप आस-पास की खोज में हमेशा एक ऐसा स्थान शामिल होना चाहिए, जो इसे दो में से किसी एक तरीके से दिखाया जाना चाहिए:

  • LatLngBounds.
  • एक वृत्तीय क्षेत्र जिसे location के संयोजन के रूप में परिभाषित किया गया है प्रॉपर्टी — वृत्त के केंद्र को LatLng ऑब्जेक्ट — और एक रेडियस, मीटर में मापा गया.

आस-पास के स्थल की खोज PlacesService का nearbySearch() तरीका, जिससे क्लास का कलेक्शन दिखाएं PlaceResult ऑब्जेक्ट. ध्यान दें कि nearbySearch() विधि, वर्शन 3.9 से search() विधि की जगह ले रही है.

service = new google.maps.places.PlacesService(map);
service.nearbySearch(request, callback);

इस तरीके में, नीचे दिए गए फ़ील्ड वाला अनुरोध स्वीकार किया जाता है:

  • इनमें से कोई एक:
    • bounds, जो आयताकार के बारे में जानकारी देने वाला google.maps.LatLngBounds ऑब्जेक्ट क्षेत्र खोजें. सीमाओं के लिए अधिकतम समर्थित विकर्ण दूरी क्षेत्रफल करीब 1,00,000 मीटर का होता है.
    • location और radius; पहले वाले ने google.maps.LatLng ऑब्जेक्ट है और बाद वाले आइटम को पूर्णांक, जो वृत्त की रेडियस मीटर में दिखाता है. ज़्यादा से ज़्यादा दायरा 50,000 मीटर तक हो सकता है. ध्यान दें कि जब rankBy DISTANCE पर सेट है, आपको साफ़ तौर पर बताना होगा location, लेकिन कोई radius तय नहीं किया जा सकता या bounds.
  • keyword (ज़रूरी नहीं) — मिलान किया जाने वाला कोई शब्द सभी उपलब्ध फ़ील्ड के लिए, जिसमें नाम, टाइप, और और साथ ही ग्राहक समीक्षाएं और अन्य तृतीय-पक्ष सामग्री
  • minPriceLevel और maxPriceLevel (ज़रूरी नहीं) — नतीजों को सिर्फ़ उन जगहों तक सीमित करता है: बताई गई सीमा है. वैल्यू की मान्य रेंज 0 के बीच है (सबसे किफ़ायती) से लेकर 4 (सबसे महंगा) तक, दोनों शामिल हैं.
  • name अब काम नहीं करता. keyword के बराबर. मान इस फ़ील्ड को keyword फ़ील्ड की वैल्यू के साथ जोड़ा जाता है और उसी खोज स्ट्रिंग के हिस्से के रूप में पास किया गया हो.
  • openNow (ज़रूरी नहीं) — एक बूलियन वैल्यू, यह इंगित करता है कि Places सेवा को केवल वे स्थान लौटाने चाहिए जो क्वेरी भेजे जाने के समय कारोबार के लिए खुले हों. वे जगहें जो शायद नहीं Google स्थल डेटाबेस में समय तय नहीं करेगा अगर आप अपनी क्वेरी में इस पैरामीटर को शामिल करते हैं, तो यह फ़ंक्शन लौटाया जाता है. सेटिंग openNow से false पर कोई असर नहीं पड़ता.
  • rankBy (ज़रूरी नहीं) — इससे ऑर्डर का पता चलता है कौनसे नतीजे सूची में हैं. आपको ये वैल्यू दिख सकती हैं:
    • google.maps.places.RankBy.PROMINENCE (डिफ़ॉल्ट). यह विकल्प, नतीजों को उनकी अहमियत के आधार पर क्रम से लगाता है. रैंकिंग में आस-पास के किसी खास दायरे में मौजूद प्रमुख जगहों को पसंद करें मिलती-जुलती जगहें हैं, लेकिन कम प्रमुखता से दिखती हैं. कॉन्टेंट को प्रमुखता से दिखाया जा सकता है पर Google के इंडेक्स में किसी जगह की रैंकिंग, दुनिया भर में लोकप्रियता, और अन्य कारक शामिल होते हैं. टास्क कब शुरू होगा google.maps.places.RankBy.PROMINENCE है तय किया गया है, तो radius पैरामीटर ज़रूरी है.
    • google.maps.places.RankBy.DISTANCE. यह विकल्प तय की गई दूरी से दूरी के आधार पर, नतीजों को बढ़ते क्रम में क्रम से लगाता है location (ज़रूरी है). ध्यान दें कि आप कस्टम bounds और/या radius, अगर आपने RankBy.DISTANCE तय करें. जब आप तय करें RankBy.DISTANCE, इसका एक या ज़्यादा keyword, name या type है आवश्यक.
  • type — इस पर पाबंदी लगाती है तय टाइप से मेल खाने वाली जगहों पर खोज के नतीजे दिखा सकता है. सिर्फ़ एक टाइप (अगर एक से ज़्यादा प्रकार दिया गया है, तो पहले एंट्री को अनदेखा किया जाता है). इनकी सूची देखें इस्तेमाल किए जा सकने वाले टाइप हैं.

आपको nearbySearch() को कॉलबैक का तरीका भी पास करना होगा, ताकि नतीजे के ऑब्जेक्ट को मैनेज करें और google.maps.places.PlacesServiceStatus जवाब.

var map;
var service;
var infowindow;

function initialize() {
  var pyrmont = new google.maps.LatLng(-33.8665433,151.1956316);

  map = new google.maps.Map(document.getElementById('map'), {
      center: pyrmont,
      zoom: 15
    });

  var request = {
    location: pyrmont,
    radius: '500',
    type: ['restaurant']
  };

  service = new google.maps.places.PlacesService(map);
  service.nearbySearch(request, callback);
}

function callback(results, status) {
  if (status == google.maps.places.PlacesServiceStatus.OK) {
    for (var i = 0; i < results.length; i++) {
      createMarker(results[i]);
    }
  }
}

उदाहरण देखें

टेक्स्ट खोज के अनुरोध

Google स्थल टेक्स्ट खोज सेवा एक ऐसी वेब सेवा है जो स्ट्रिंग के आधार पर स्थानों के सेट के बारे में जानकारी — उदाहरण के लिए "दिल्ली में पिज़्ज़ा" या "ओटावा के आस-पास जूतों की दुकानें" हैं. सेवा इस मैसेज का जवाब देती है: टेक्स्ट स्ट्रिंग और किसी भी स्थान पूर्वाग्रह से मेल खाने वाली स्थानों की सूची जिसमें सेट कर दिया गया है. खोज के जवाब में जगहों की सूची शामिल होगी. आप किसी भी स्थान के बारे में और जानकारी के लिए स्थान विवरण का अनुरोध जवाब.

टेक्स्ट की खोज, इस ईमेल पते पर कॉल करके शुरू की जाती है PlacesService का textSearch() तरीका. 

service = new google.maps.places.PlacesService(map);
service.textSearch(request, callback);

इस तरीके में, नीचे दिए गए फ़ील्ड वाला अनुरोध स्वीकार किया जाता है:

  • query (ज़रूरी है) वह टेक्स्ट स्ट्रिंग जिस पर खोजें, उदाहरण के लिए: "रेस्टोरेंट" या "123 मेन स्ट्रीट". यह एक स्थान होना चाहिए होटल का नाम, पता या उसकी कैटगरी. किसी अन्य तरह के इनपुट से इससे गड़बड़ियां पैदा होती हैं और इस बात की कोई गारंटी नहीं है कि वे मान्य नतीजे देंगे. जगहें सेवा इस स्ट्रिंग के आधार पर उम्मीदवार मिलानों को दिखाएगी और के हिसाब से खोज के नतीजे मिलते हैं. यह पैरामीटर वैकल्पिक हो जाता है अगर खोज अनुरोध में type पैरामीटर का भी इस्तेमाल किया गया है.
  • विकल्प के तौर पर:
    • openNow — एक बूलियन वैल्यू, यह इंगित करता है कि Places सेवा को केवल वे स्थान लौटाने चाहिए जो क्वेरी भेजे जाने के समय कारोबार के लिए खुले हों. वे जगहें जो शायद नहीं Google स्थल डेटाबेस में समय तय नहीं करेगा अगर आप अपनी क्वेरी में इस पैरामीटर को शामिल करते हैं, तो यह फ़ंक्शन लौटाया जाता है. सेटिंग openNow से false पर कोई असर नहीं पड़ता.
    • minPriceLevel और maxPriceLevel — परिणामों को केवल उन स्थानों तक सीमित करता है कीमत का तय किया गया समय डालें. मान्य वैल्यू, शून्य से रेंज में हैं (सबसे किफ़ायती) से लेकर 4 (सबसे महंगा) तक, दोनों शामिल हैं.
    • इनमें से कोई एक:
      • bounds, जो आयताकार के बारे में जानकारी देने वाला google.maps.LatLngBounds ऑब्जेक्ट क्षेत्र खोजें. सीमाओं के लिए अधिकतम समर्थित विकर्ण दूरी क्षेत्रफल करीब 1,00,000 मीटर का होता है.
      • location और radius — आप किसी खास वृत्त में location और एक radius पैरामीटर. इससे स्थल सेवा को उसके भीतर के परिणाम दिखाने को प्राथमिकता देने के लिए निर्देश दें मंडली. तय किए गए इलाके से बाहर के नतीजे अब भी दिखाए जा सकते हैं. जगह की जानकारी के लिए, google.maps.LatLng ऑब्जेक्ट लेना होता है और त्रिज्या के लिए सामान्य पूर्णांक लिया जाता है, जो वृत्त की त्रिज्या को दर्शाता है मीटर में. ज़्यादा से ज़्यादा 50,000 मीटर का दायरा छोड़ा जा सकता है.
    • type — नतीजों को मेल खाने वाली जगहों तक सीमित करता है बताया गया है. सिर्फ़ एक टाइप दिया जा सकता है (अगर एक से ज़्यादा हो) टाइप दिया जाता है, तो पहली एंट्री के बाद के सभी टाइप को अनदेखा कर दिया जाता है). यहां जाएं: इस्तेमाल किए जा सकने वाले टाइप की सूची देखें.

आपको textSearch() को कॉलबैक का तरीका भी पास करना होगा, ताकि नतीजे ऑब्जेक्ट को मैनेज करें और google.maps.places.PlacesServiceStatus जवाब.

var map;
var service;
var infowindow;

function initialize() {
  var pyrmont = new google.maps.LatLng(-33.8665433,151.1956316);

  map = new google.maps.Map(document.getElementById('map'), {
      center: pyrmont,
      zoom: 15
    });

  var request = {
    location: pyrmont,
    radius: '500',
    query: 'restaurant'
  };

  service = new google.maps.places.PlacesService(map);
  service.textSearch(request, callback);
}

function callback(results, status) {
  if (status == google.maps.places.PlacesServiceStatus.OK) {
    for (var i = 0; i < results.length; i++) {
      var place = results[i];
      createMarker(results[i]);
    }
  }
}

खोज के जवाब

स्थिति कोड

PlacesServiceStatus रिस्पॉन्स ऑब्जेक्ट में यह स्टेटस है साथ ही, उसमें डीबग की जानकारी भी शामिल हो सकती है, ताकि आप उसे आसानी से ट्रैक कर सकें स्थान अनुरोध विफल क्यों हो रहा है. संभावित स्थिति की वैल्यू ये हैं:

  • INVALID_REQUEST: यह अनुरोध अमान्य था.
  • OK: जवाब में मान्य नतीजा मौजूद है.
  • OVER_QUERY_LIMIT: वेबपेज ने अपने अनुरोध पर कार्रवाई कर ली है कोटा.
  • REQUEST_DENIED: वेबपेज को PlacesService.
  • UNKNOWN_ERROR: PlacesService अनुरोध नहीं किया जा सका सर्वर की गड़बड़ी की वजह से प्रोसेस हुआ. फिर से कोशिश करने पर, अनुरोध पूरा हो सकता है.
  • ZERO_RESULTS: इस अनुरोध के लिए कोई नतीजा नहीं मिला.

स्थान खोज परिणाम

findPlace(), nearbySearch() और textSearch() फ़ंक्शन, PlaceResult ऑब्जेक्ट.

हर PlaceResult ऑब्जेक्ट में ये प्रॉपर्टी शामिल हो सकती हैं:

  • business_status बताता है कि ऑपरेशनल अगर वह कारोबार है, तो उस जगह की स्थिति. इसमें नीचे दिए गए मान:
    • OPERATIONAL
    • CLOSED_TEMPORARILY
    • CLOSED_PERMANENTLY
    अगर कोई डेटा मौजूद नहीं है, तो business_status नहीं लौटाया जाता.
  • formatted_address ऐसी स्ट्रिंग है जिसमें मौजूद कॉन्टेंट को कोई भी व्यक्ति आसानी से पढ़ सकता है इस जगह का पता. सिर्फ़ formatted_address प्रॉपर्टी टेक्स्ट सर्च के लिए दिखाया गया.

    अक्सर यह पता, डाक पते के बराबर होता है. ध्यान दें कि कुछ यूनाइटेड किंगडम जैसे देशों में, किसी भी समयावधि में डाक पते न भेजें.

    फ़ॉर्मैट किया गया पता, लॉजिकल तरीके से एक या एक से ज़्यादा पते वाले फ़ॉर्मैट में लिखा जाता है कॉम्पोनेंट के तौर पर दिखता है. उदाहरण के लिए, पता "111 8th Avenue, New York, NY" इसमें ये कॉम्पोनेंट शामिल होते हैं: "111" (सड़क का नंबर), "एट्थ ऐवेन्यू" (रूट), "न्यूयॉर्क" (शहर) और "NY" (अमेरिका का राज्य).

    फ़ॉर्मैट किए गए पते को प्रोग्राम के हिसाब से पार्स न करें. इसके बजाय, आपको पते के अलग-अलग कॉम्पोनेंट, जिन्हें एपीआई के जवाब में शामिल किया जाता है लिंक किया गया है.

  • geometry: जगह की ज्यामिति से जुड़ी जानकारी. यह शामिल हैं:
    • location इसका अक्षांश और देशांतर देता है जगह.
    • viewport, मैप पर पसंदीदा व्यूपोर्ट के बारे में बताता है, जब इस स्थान को देख रहे हैं.
  • permanently_closed (अब सेवा में नहीं है) बूलियन फ़्लैग से पता चलता है कि वह जगह या तो बंद हो गई है या नहीं स्थायी या अस्थायी रूप से (मान true). इस्तेमाल न करें permanently_closed. इसके बजाय, business_status का इस्तेमाल करें कारोबारों के काम करने का स्टेटस जानने के लिए.
  • plus_code (देखें लोकेशन कोड खोलें और प्लस कोड) कोड में बदली गई जगह का रेफ़रंस होता है, जो अक्षांश और देशांतर निर्देशांक से लिया जाता है, क्षेत्र के बारे में बताता है: डिग्री का 1/8000वां x डिग्री का 1/8000वां (भूमध्य रेखा पर करीब 14 मीटर x 14 मीटर) या इससे छोटा. प्लस कोड का इस्तेमाल इनकी जगह पर किया जा सकता है उन स्थानों के पते जहां वे मौजूद नहीं हैं (जहां इमारतों को क्रमांकित न किया गया हो या सड़कों के नाम नहीं दिए गए हैं).

    प्लस कोड को एक ग्लोबल कोड और एक कंपाउंड कोड के रूप में फ़ॉर्मैट किया जाता है:

    • global_code, चार वर्णों का एरिया कोड और छह या इससे लंबा लोकल कोड है (849VCW8+R9).
    • compound_code, छह या इससे ज़्यादा वर्णों का लोकल कोड है. इसमें जगह की जानकारी साफ़ तौर पर दी गई है (CW8+R9, माउंटेन व्यू, कैलिफ़ोर्निया, अमेरिका). इस कॉन्टेंट को प्रोग्राम के हिसाब से पार्स न करें.
    आम तौर पर, ग्लोबल कोड और कंपाउंड कोड, दोनों दिखते हैं. हालांकि, अगर नतीजा किसी दूर की जगह (उदाहरण के लिए, महासागर या रेगिस्तान) के लिए सिर्फ़ ग्लोबल कोड लौटाया जा सकता है.
  • html_attributions: एट्रिब्यूशन का कलेक्शन दिखाई देती है. कलेक्शन की हर एंट्री में किसी एक एट्रिब्यूशन के लिए एचटीएमएल टेक्स्ट में बदल सकते हैं. ध्यान दें: यह पूरे खोज जवाब के लिए सभी एट्रिब्यूशन का एग्रीगेशन. सभी इसलिए, जवाब में PlaceResult ऑब्जेक्ट में ये शामिल हैं एक जैसी एट्रिब्यूशन सूचियां.
  • icon, 71px x 71px रंग के PNG आइकॉन के लिए यूआरएल दिखाता है.
  • icon_mask_base_uri, बिना रंगों वाले यूआरएल के लिए बेस यूआरएल दिखाता है आइकॉन में से .svg या .png एक्सटेंशन घटाएं.
  • icon_background_color इसके लिए डिफ़ॉल्ट HEX रंग कोड लौटाता है जगह की कैटगरी को चुनें.
  • name: जगह का नाम.
  • opening_hours में यह जानकारी हो सकती है:
    • open_now एक बूलियन वैल्यू है, जो बताती है कि क्या जगह मौजूदा समय में खोलें (अब काम नहीं करता स् थान लाइब्रेरी, Maps JavaScript API में, utc_offset_minutes का उपयोग करें आज़माएं).
  • place_id एक टेक्स्ट आइडेंटिफ़ायर है, जो जगह. स्थान के बारे में जानकारी पुनर्प्राप्त करने के लिए, इस पहचानकर्ता को जगह की जानकारी request. किसी जगह का रेफ़रंस देने के तरीके के बारे में ज़्यादा जानें स्थान आईडी के साथ.
  • rating में जगह की रेटिंग शामिल है. रेटिंग 0.0 से लेकर 5.0 तक के बीच है लोगों की समीक्षाओं के हिसाब से.
  • types इसकी रेंज इस जगह के लिए टाइप (उदाहरण, ["political", "locality"] या ["restaurant", "lodging"]). इस कलेक्शन में एक से ज़्यादा वैल्यू हो सकती हैं या खाली. बिना किसी सूचना के नई वैल्यू दिखाई जा सकती हैं. इसकी सूची देखें अलग-अलग तरह के फ़ॉर्मैट में काम करता है.
  • vicinity: जगह का आसान पता (इसमें ये शामिल हैं) सड़क का नाम, सड़क का नंबर, और मोहल्ला प्रांत/राज्य, पिन कोड या देश का नाम हो. उदाहरण के लिए, Google का सिडनी, ऑस्ट्रेलिया के ऑफ़िस की वैल्यू vicinity है और इसकी वैल्यू 5/48 Pirrama Road, Pyrmont है.

अतिरिक्त नतीजे ऐक्सेस करना

डिफ़ॉल्ट रूप से, हर जगह की खोज हर क्वेरी के लिए ज़्यादा से ज़्यादा 20 नतीजे दिखाती है. हालांकि, हर खोज, तीन पेजों में बंटे हुए ज़्यादा से ज़्यादा 60 नतीजे दे सकती है. PlaceSearchPagination के ज़रिए अन्य पेज उपलब्ध हैं ऑब्जेक्ट है. अतिरिक्त पेजों को ऐक्सेस करने के लिए, आपको कॉलबैक फ़ंक्शन के ज़रिए PlaceSearchPagination ऑब्जेक्ट. कॉन्टेंट बनाने PlaceSearchPagination ऑब्जेक्ट इस तरह परिभाषित किया गया है:

  • hasNextPage एक बूलियन प्रॉपर्टी है, जो यह बताती है कि क्या इससे ज़्यादा नतीजे उपलब्ध हैं. true, जब अतिरिक्त खोज नतीजों के पेज पर.
  • nextPage() वह फ़ंक्शन जो इसका अगला सेट देगा नतीजे. खोज करने के बाद, आपको दो इंतज़ार करना होगा अगला पेज उपलब्ध होने से कुछ सेकंड पहले.

नतीजों का अगला सेट देखने के लिए, nextPage पर कॉल करें. परिणामों के प्रत्येक पृष्ठ को निम्न के अगले पृष्ठ को प्रदर्शित करने से पहले प्रदर्शित किया जाना चाहिए नतीजे. ध्यान दें कि हर खोज की गिनती, आपकी इस्तेमाल करने की सीमा तय करें.

नीचे दिया गया उदाहरण दिखाता है कि अपने कॉलबैक फ़ंक्शन को PlaceSearchPagination ऑब्जेक्ट को कैप्चर करें, ताकि आप समस्या जारी कर सकें खोज के एक से ज़्यादा अनुरोध हैं.

TypeScript

// This example requires the Places library. Include the libraries=places
// parameter when you first load the API. For example:
// <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&libraries=places">

function initMap(): void {
  // Create the map.
  const pyrmont = { lat: -33.866, lng: 151.196 };
  const map = new google.maps.Map(
    document.getElementById("map") as HTMLElement,
    {
      center: pyrmont,
      zoom: 17,
      mapId: "8d193001f940fde3",
    } as google.maps.MapOptions
  );

  // Create the places service.
  const service = new google.maps.places.PlacesService(map);
  let getNextPage: () => void | false;
  const moreButton = document.getElementById("more") as HTMLButtonElement;

  moreButton.onclick = function () {
    moreButton.disabled = true;

    if (getNextPage) {
      getNextPage();
    }
  };

  // Perform a nearby search.
  service.nearbySearch(
    { location: pyrmont, radius: 500, type: "store" },
    (
      results: google.maps.places.PlaceResult[] | null,
      status: google.maps.places.PlacesServiceStatus,
      pagination: google.maps.places.PlaceSearchPagination | null
    ) => {
      if (status !== "OK" || !results) return;

      addPlaces(results, map);
      moreButton.disabled = !pagination || !pagination.hasNextPage;

      if (pagination && pagination.hasNextPage) {
        getNextPage = () => {
          // Note: nextPage will call the same handler function as the initial call
          pagination.nextPage();
        };
      }
    }
  );
}

function addPlaces(
  places: google.maps.places.PlaceResult[],
  map: google.maps.Map
) {
  const placesList = document.getElementById("places") as HTMLElement;

  for (const place of places) {
    if (place.geometry && place.geometry.location) {
      const image = {
        url: place.icon!,
        size: new google.maps.Size(71, 71),
        origin: new google.maps.Point(0, 0),
        anchor: new google.maps.Point(17, 34),
        scaledSize: new google.maps.Size(25, 25),
      };

      new google.maps.Marker({
        map,
        icon: image,
        title: place.name!,
        position: place.geometry.location,
      });

      const li = document.createElement("li");

      li.textContent = place.name!;
      placesList.appendChild(li);

      li.addEventListener("click", () => {
        map.setCenter(place.geometry!.location!);
      });
    }
  }
}

declare global {
  interface Window {
    initMap: () => void;
  }
}
window.initMap = initMap;
index.ts

JavaScript

// This example requires the Places library. Include the libraries=places
// parameter when you first load the API. For example:
// <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&libraries=places">
function initMap() {
  // Create the map.
  const pyrmont = { lat: -33.866, lng: 151.196 };
  const map = new google.maps.Map(document.getElementById("map"), {
    center: pyrmont,
    zoom: 17,
    mapId: "8d193001f940fde3",
  });
  // Create the places service.
  const service = new google.maps.places.PlacesService(map);
  let getNextPage;
  const moreButton = document.getElementById("more");

  moreButton.onclick = function () {
    moreButton.disabled = true;
    if (getNextPage) {
      getNextPage();
    }
  };

  // Perform a nearby search.
  service.nearbySearch(
    { location: pyrmont, radius: 500, type: "store" },
    (results, status, pagination) => {
      if (status !== "OK" || !results) return;

      addPlaces(results, map);
      moreButton.disabled = !pagination || !pagination.hasNextPage;
      if (pagination && pagination.hasNextPage) {
        getNextPage = () => {
          // Note: nextPage will call the same handler function as the initial call
          pagination.nextPage();
        };
      }
    },
  );
}

function addPlaces(places, map) {
  const placesList = document.getElementById("places");

  for (const place of places) {
    if (place.geometry && place.geometry.location) {
      const image = {
        url: place.icon,
        size: new google.maps.Size(71, 71),
        origin: new google.maps.Point(0, 0),
        anchor: new google.maps.Point(17, 34),
        scaledSize: new google.maps.Size(25, 25),
      };

      new google.maps.Marker({
        map,
        icon: image,
        title: place.name,
        position: place.geometry.location,
      });

      const li = document.createElement("li");

      li.textContent = place.name;
      placesList.appendChild(li);
      li.addEventListener("click", () => {
        map.setCenter(place.geometry.location);
      });
    }
  }
}

window.initMap = initMap;
index.js
उदाहरण देखें

सैंपल आज़माएं

जगह की जानकारी

किसी इलाके के अंदर की जगहों की सूची देने के अलावा, 'जगहें' सेवा किसी विशिष्ट स्थान के बारे में विस्तृत जानकारी भी लौटा सकती है. एक बार किसी स् थान के खोज प्रतिसाद में एक स् थान के बारे में बताया गया है, इसके जगह का आईडी का इस्तेमाल, अतिरिक्त जानकारी मांगने के लिए किया जा सकता है उस जगह के बारे में जानकारी, जैसे कि उसका पूरा पता, फ़ोन नंबर, उपयोगकर्ता रेटिंग और समीक्षाएं वगैरह.

जगह की जानकारी के लिए किए गए अनुरोध

स्थान विवरण के लिए सेवा के getDetails() तरीका.

service = new google.maps.places.PlacesService(map);
service.getDetails(request, callback);

इस तरीके में, आपकी पसंद की जगह से जुड़ा अनुरोध स्वीकार किया जाता है placeId, और वे फ़ील्ड जो बताते हैं कि Places का किस तरह का डेटा है वापस जाने के लिए. इसके बारे में ज़्यादा जानें जगह के आईडी से जगह का रेफ़रंस देने का तरीका.

यह एक कॉलबैक तरीका भी लेता है, जिसे पास किए गए स्टेटस कोड को मैनेज करना होता है google.maps.places.PlacesServiceStatus के जवाब में भी google.maps.places.PlaceResult ऑब्जेक्ट के तौर पर.

var request = {
  placeId: 'ChIJN1t_tDeuEmsRUsoyG83frY4',
  fields: ['name', 'rating', 'formatted_phone_number', 'geometry']
};

service = new google.maps.places.PlacesService(map);
service.getDetails(request, callback);

function callback(place, status) {
  if (status == google.maps.places.PlacesServiceStatus.OK) {
    createMarker(place);
  }
}

उदाहरण देखें

फ़ील्ड (जगह की जानकारी)

fields पैरामीटर, स्ट्रिंग (फ़ील्ड के नाम) का कलेक्शन लेता है.

नतीजे में, जगह की जानकारी के टाइप का कलेक्शन तय करने के लिए fields पैरामीटर का इस्तेमाल करें. उदाहरण के लिए: fields: ['address_components', 'opening_hours', 'geometry']. कंपाउंड वैल्यू तय करते समय डॉट का इस्तेमाल करें. उदाहरण के लिए: opening_hours.weekday_text.

फ़ील्ड जगह की जानकारी के मुताबिक हैं नतीजों को तीन बिलिंग कैटगरी में बांटा जाता है: बुनियादी, संपर्क, और माहौल. बेसिक फ़ील्ड का बिल, मूल दर के हिसाब से भेजा जाता है. इसके लिए, अलग से कोई शुल्क नहीं देना पड़ता शुल्क. संपर्क और वातावरण फ़ील्ड के लिए ज़्यादा शुल्क लिया जाता है. कीमत वाली शीट देखें हमारा वीडियो देखें. एट्रिब्यूशन (html_attributions) हमेशा ऐसा होता है इस बात पर ध्यान दिए बिना कि हर कॉल का अनुरोध किया गया है या नहीं, हर कॉल के साथ नतीजे मिलते हैं.

बेसिक जानकारी

बेसिक कैटगरी में ये फ़ील्ड शामिल होते हैं:
address_components, adr_address, business_status, formatted_address, geometry, icon, icon_mask_base_uri, icon_background_color,name, permanently_closed (अब सेवा में नहीं है), photo, place_id, plus_code, type, url, utc_offset (अब सेवा में नहीं है स् थान लाइब्रेरी, Maps JavaScript API में), utc_offset_minutes, vicinity

संपर्क करना

संपर्क कैटगरी में ये फ़ील्ड शामिल हैं:
formatted_phone_number, international_phone_number, opening_hours, website

वायुमंडल

माहौल की कैटगरी में ये फ़ील्ड शामिल होते हैं: price_level, rating, reviews, user_ratings_total

इसके बारे में ज़्यादा जानें जगह की जानकारी के फ़ील्ड. ज़्यादा के लिए स्थान डेटा अनुरोधों को बिल करने के तरीके के बारे में जानकारी, देखें इस्तेमाल और बिलिंग.

जगह की जानकारी के जवाब

स्थिति कोड

PlacesServiceStatus रिस्पॉन्स ऑब्जेक्ट में यह स्टेटस है साथ ही, उसमें डीबग की जानकारी भी शामिल हो सकती है, ताकि आप उसे आसानी से ट्रैक कर सकें स्थान विवरण अनुरोध विफल क्यों हो रहा है. संभावित स्थिति की वैल्यू ये हैं:

  • INVALID_REQUEST: यह अनुरोध अमान्य था.
  • OK: जवाब में मान्य नतीजा मौजूद है.
  • OVER_QUERY_LIMIT: वेबपेज ने अपने अनुरोध पर कार्रवाई कर ली है कोटा.
  • NOT_FOUND रेफ़र की गई जगह यह नहीं थी जगहें डेटाबेस में मिला था.
  • REQUEST_DENIED: वेबपेज को PlacesService.
  • UNKNOWN_ERROR: PlacesService अनुरोध नहीं किया जा सका सर्वर की गड़बड़ी की वजह से प्रोसेस हुआ. फिर से कोशिश करने पर, अनुरोध पूरा हो सकता है.
  • ZERO_RESULTS: इस अनुरोध के लिए कोई नतीजा नहीं मिला.

जगह की जानकारी के नतीजे

सफल getDetails() कॉल इन प्रॉपर्टी वाला PlaceResult ऑब्जेक्ट:

  • address_components: ऐसा अरे जिसमें अलग से इस पते पर लागू होने वाले कॉम्पोनेंट.

    पते के हर कॉम्पोनेंट में आम तौर पर ये फ़ील्ड शामिल होते हैं:

    • types[] एक कलेक्शन है, जो वैल्यू के type को दिखाता है पता कॉम्पोनेंट. इसकी सूची देखें अलग-अलग तरह के फ़ॉर्मैट में काम करता है.
    • long_name पता कॉम्पोनेंट, जो जियोकोडर के वापस भेजा गया हो.
    • short_name, पते का छोटा टेक्स्ट नाम है कॉम्पोनेंट, अगर उपलब्ध हो. उदाहरण के लिए, राज्य के लिए पते का कॉम्पोनेंट अलास्का के लिए, "अलास्का" का long_name हो सकता है और एक "AK" में से short_name का उपयोग करें.

    address_components[] के बारे में इन बातों का ध्यान रखें कलेक्शन:

    • पते के कॉम्पोनेंट के कलेक्शन में, formatted_address.
    • यह ज़रूरी नहीं है कि कलेक्शन में वे सभी राजनैतिक इकाइयां शामिल हों जो में शामिल पता छोड़कर, उसका कोई पता नहीं होता formatted_address. सभी राजनैतिक इकाइयों को फिर से पाने के लिए का उपयोग करें, जिसमें एक विशिष्ट पता शामिल है, तो आपको रिवर्स जियोकोडिंग का उपयोग करना चाहिए अनुरोध के पैरामीटर के तौर पर पते का अक्षांश/देशांतर.
    • इस बात की कोई गारंटी नहीं है कि इन दोनों के बीच रिस्पॉन्स का फ़ॉर्मैट समान रहेगा अनुरोध. खास तौर पर, address_components की संख्या यह अनुरोध किए गए पते के आधार पर अलग-अलग होती है और समय के साथ एक ही पता. कोई कॉम्पोनेंट, अरे में जगह बदल सकता है. कॉम्पोनेंट का टाइप बदल सकता है. कोई खास कॉम्पोनेंट हम बाद के जवाब में गायब हो गए हैं.
  • business_status बताता है कि ऑपरेशनल अगर वह कारोबार है, तो उस जगह की स्थिति. इसमें नीचे दिए गए मान:
    • OPERATIONAL
    • CLOSED_TEMPORARILY
    • CLOSED_PERMANENTLY
    अगर कोई डेटा मौजूद नहीं है, तो business_status नहीं लौटाया जाता.
  • formatted_address: इस जगह का ऐसा पता जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है.

    अक्सर यह पता, डाक पते के बराबर होता है. ध्यान दें कि कुछ यूनाइटेड किंगडम जैसे देशों में, किसी भी समयावधि में डाक पते न भेजें.

    फ़ॉर्मैट किया गया पता, लॉजिकल तरीके से एक या एक से ज़्यादा पते वाले फ़ॉर्मैट में लिखा जाता है कॉम्पोनेंट के तौर पर दिखता है. उदाहरण के लिए, पता "111 8th Avenue, New York, NY" इसमें ये कॉम्पोनेंट शामिल होते हैं: "111" (सड़क का नंबर), "एट्थ ऐवेन्यू" (रूट), "न्यूयॉर्क" (शहर) और "NY" (अमेरिका का राज्य).

    फ़ॉर्मैट किए गए पते को प्रोग्राम के हिसाब से पार्स न करें. इसके बजाय, आपको पते के अलग-अलग कॉम्पोनेंट, जिन्हें एपीआई के जवाब में शामिल किया जाता है लिंक किया गया है.

  • formatted_phone_number: जगह का फ़ोन नंबर, फ़ॉर्मैट किया गया इसके अनुसार रीजनल कन्वेंशन में उपलब्ध कराया जाता है.
  • geometry: जगह की ज्यामिति से जुड़ी जानकारी. यह शामिल हैं:
    • location इसका अक्षांश और देशांतर देता है जगह.
    • viewport, मैप पर पसंदीदा व्यूपोर्ट के बारे में बताता है, जब इस स्थान को देख रहे हैं.
  • permanently_closed (अब सेवा में नहीं है) बूलियन फ़्लैग से पता चलता है कि वह जगह या तो बंद हो गई है या नहीं स्थायी या अस्थायी रूप से (मान true). इस्तेमाल न करें permanently_closed. इसके बजाय, business_status का इस्तेमाल करें कारोबारों के काम करने का स्टेटस जानने के लिए.
  • plus_code (देखें लोकेशन कोड खोलें और प्लस कोड) कोड में बदली गई जगह का रेफ़रंस होता है, जो अक्षांश और देशांतर निर्देशांक से लिया जाता है, क्षेत्र के बारे में बताता है: डिग्री का 1/8000वां x डिग्री का 1/8000वां (भूमध्य रेखा पर करीब 14 मीटर x 14 मीटर) या इससे छोटा. प्लस कोड का इस्तेमाल इनकी जगह पर किया जा सकता है उन स्थानों के पते जहां वे मौजूद नहीं हैं (जहां इमारतों को क्रमांकित न किया गया हो या सड़कों के नाम नहीं दिए गए हैं).

    प्लस कोड को एक ग्लोबल कोड और एक कंपाउंड कोड के रूप में फ़ॉर्मैट किया जाता है:

    • global_code, चार वर्णों का एरिया कोड और छह या इससे लंबा लोकल कोड है (849VCW8+R9).
    • compound_code, छह या इससे ज़्यादा वर्णों का लोकल कोड है. इसमें जगह की जानकारी साफ़ तौर पर दी गई है (CW8+R9, माउंटेन व्यू, कैलिफ़ोर्निया, अमेरिका). इस कॉन्टेंट को प्रोग्राम के हिसाब से पार्स न करें.
    आम तौर पर, ग्लोबल कोड और कंपाउंड कोड, दोनों दिखते हैं. हालांकि, अगर नतीजा किसी दूर की जगह (उदाहरण के लिए, महासागर या रेगिस्तान) के लिए सिर्फ़ ग्लोबल कोड लौटाया जा सकता है.
  • html_attributions: इसके लिए दिखाया जाने वाला एट्रिब्यूशन टेक्स्ट इस जगह के नतीजे.
  • icon: इमेज संसाधन का यूआरएल, जिसका इस्तेमाल इन कामों के लिए किया जा सकता है इस जगह का टाइप दिखाता है.
  • international_phone_number में जगह का फ़ोन शामिल है अंतरराष्ट्रीय फ़ॉर्मैट में नंबर डालें. अंतरराष्ट्रीय फ़ॉर्मैट में देश शामिल है है और इसके आगे प्लस (+) का निशान लगाया गया है. उदाहरण के लिए, Google के सिडनी, ऑस्ट्रेलिया के लिए international_phone_number ऑफ़िस का पता +61 2 9374 4000 है.
  • name: जगह का नाम.
  • utc_offset अब काम नहीं करता इसके बजाय, Places लाइब्रेरी, Maps JavaScript API में मौजूद utc_offset_minutes का इस्तेमाल करें.
  • utc_offset_minutes में इतने मिनट हैं जगह का मौजूदा टाइमज़ोन यूटीसी से ऑफ़सेट है. उदाहरण के लिए, सिडनी, ऑस्ट्रेलिया में डेलाइट सेविंग टाइम के दौरान यह 660 (+11 घंटे) होगा यूटीसी से) और कैलिफ़ोर्निया में डेलाइट सेविंग टाइम से बाहर की जगहों के लिए यह -480 (यूटीसी से 8 घंटे) होगा.
  • opening_hours में यह जानकारी शामिल है:
    • open_now (अब काम नहीं करता जगहें लाइब्रेरी, Maps JavaScript API में दिखेंगी; इस्तेमाल इसके बजाय, opening_hours.isOpen() का इस्तेमाल करें. इस्तेमाल करने का तरीका जानने के लिए, यह वीडियो देखें जगह की जानकारी के साथ isOpen.) एक बूलियन वैल्यू है, जो यह बताती है कि कारोबार की मौजूदा जगह खुली है या नहीं समय.
    • periods[], ओपनिंग पीरियड का कलेक्शन है, जिसमें सात साल शामिल हैं दिन, रविवार से शुरू, समय के हिसाब से क्रम में दिखेंगे. हर अवधि इसमें शामिल है:
      • open में दिन और समय ऑब्जेक्ट का जोड़ा है जगह के खुलने का समय बताने वाला:
        • दिनों के हिसाब से, 0 से 6 तक की कोई संख्या day हफ़्ते के सबसे पहले, रविवार से शुरू होगा. उदाहरण के लिए, 2 का मतलब मंगलवार.
        • time में दिन का समय 24-घंटे hhmm में हो सकता है फ़ॉर्मैट (वैल्यू 0000 से 2359 के बीच है). कॉन्टेंट बनाने time की रिपोर्ट, जगह के टाइमज़ोन के हिसाब से दी जाएगी.
      • close में दिन और समय ऑब्जेक्ट का जोड़ा हो सकता है जो जगह के बंद होने का समय बताता है. ध्यान दें: अगर किसी जगह पर हमेशा खुला रहता है, तो close सेक्शन इन्हें जवाब में शामिल नहीं किया जाना चाहिए. ऐप्लिकेशन हमेशा चालू रहने वाले मॉडल पर भरोसा कर सकते हैं ऐसी open अवधि के रूप में दिखाया जा रहा है जिसमें शामिल है day की वैल्यू 0 है और time वैल्यू के साथ 0000 है, और नहीं close.
    • weekday_text सात स्ट्रिंग का कलेक्शन है जो हफ़्ते के हर दिन के लिए, कारोबार के खुले होने का समय. अगर कोई जगह की जानकारी में language पैरामीटर दिया गया था अनुरोध है, तो स्थल सेवा खुलने के समय का फ़ॉर्मेट और स्थानीय भाषा में अनुवाद करेगी उस भाषा के हिसाब से सही है. इसमें एलिमेंट का क्रम अरे, language पैरामीटर पर निर्भर करता है. कुछ भाषाएं हफ़्ते की शुरुआत सोमवार से होती है. वहीं, कुछ की शुरुआत रविवार से होती है.
  • permanently_closed (अब सेवा में नहीं है) बूलियन फ़्लैग से पता चलता है कि वह जगह या तो बंद हो गई है या नहीं स्थायी या अस्थायी रूप से (मान true). इस्तेमाल न करें permanently_closed. इसके बजाय, business_status का इस्तेमाल करें कारोबारों के कामकाज का स्टेटस जानने के लिए.
  • photos[]: PlacePhoto ऑब्जेक्ट का कलेक्शन. PlacePhoto का इस्तेमाल करके, getUrl() तरीका इस्तेमाल किया जा सकता है या नीचे दिए गए मान:
    • height: पिक्सल में इमेज की ज़्यादा से ज़्यादा ऊंचाई.
    • width: पिक्सल में इमेज की ज़्यादा से ज़्यादा चौड़ाई.
    • html_attributions: दिखाया जाने वाला एट्रिब्यूशन टेक्स्ट इस स्थान की फ़ोटो के साथ.
  • place_id: एक टेक्स्ट आइडेंटिफ़ायर, जो किसी है और इसका इस्तेमाल किसी यूआरएल की मदद से स्थान विवरण request. किसी जगह का रेफ़रंस देने के तरीके के बारे में ज़्यादा जानें स्थान आईडी के साथ.
  • rating: स्थान की रेटिंग, 0.0 से 5.0 तक, इसके आधार पर उपयोगकर्ताओं की कुल समीक्षाएं.
  • ज़्यादा से ज़्यादा पांच समीक्षाओं का कलेक्शन reviews. हर समीक्षा इसमें कई कॉम्पोनेंट शामिल होते हैं:
    • aspects[] में PlaceAspectRating ऑब्जेक्ट हैं, जिनमें से हर एक की रेटिंग सिर्फ़ एक एट्रिब्यूट की वैल्यू देता है. पहला ऑब्जेक्ट उस कलेक्शन को मुख्य पहलू माना जाता है. हर PlaceAspectRating को इस तरह से परिभाषित किया गया है:
      • type जिस पहलू को रेटिंग दी जा रही है उसका नाम. इन टाइप का इस्तेमाल किया जा सकता है: appeal, atmosphere, decor, facilities, food, overall, quality और service.
      • rating इस इवेंट के लिए उपयोगकर्ता की रेटिंग पहलू, 0 से 3 तक.
    • author_name उस उपयोगकर्ता का नाम जिसने समीक्षा करें. "Google उपयोगकर्ता" की पहचान छिपाकर की गई समीक्षाएं. अगर कोई भाषा का पैरामीटर सेट किया गया था, फिर वाक्यांश "एक Google उपयोगकर्ता" वसीयत स्थानीय जगह के अनुसार स्ट्रिंग दिखाता है.
    • उपयोगकर्ता की Google+ प्रोफ़ाइल का यूआरएल author_url, अगर उपलब्ध हैं.
    • language एक आईईटीएफ़ भाषा कोड है जो भाषा को दिखाता है का इस्तेमाल किया गया है. इस फ़ील्ड में मुख्य भाषा का टैग है नहीं, बल्कि देश या क्षेत्र को दिखाने वाला सेकंडरी टैग होता है. इसके लिए उदाहरण के लिए, अंग्रेज़ी की सभी समीक्षाओं को 'en' के तौर पर टैग किया गया है, न कि 'en-AU' से या 'en-यूनाइटेड किंगडम' वगैरह.
    • इस जगह के लिए, उपयोगकर्ता की कुल रेटिंग rating. यह 1 से 5 के बीच की एक पूरी संख्या है.
    • उपयोगकर्ता की समीक्षा text. किसी आपके स्थान, टेक्स्ट समीक्षाओं को वैकल्पिक समझा जाता है; इसलिए, यह फ़ील्ड खाली हो सकता है.
  • types इसकी रेंज इस जगह के लिए टाइप (उदाहरण, ["political", "locality"] या ["restaurant", "lodging"]). इस कलेक्शन में एक से ज़्यादा वैल्यू हो सकती हैं या खाली. बिना किसी सूचना के नई वैल्यू दिखाई जा सकती हैं. इसकी सूची देखें अलग-अलग तरह के फ़ॉर्मैट में काम करता है.
  • url: इसके लिए आधिकारिक Google पेज का यूआरएल जगह. यह Google के मालिकाना हक वाला पेज है. इस पेज पर देखें. ऐप्लिकेशन को लिंक करना या एम्बेड करना आवश्यक है यह पेज किसी भी स्क्रीन पर, जो कि उपयोगकर्ता.
  • vicinity: जगह का आसान पता (इसमें ये शामिल हैं) सड़क का नाम, सड़क का नंबर, और मोहल्ला प्रांत/राज्य, पिन कोड या देश का नाम हो. उदाहरण के लिए, Google का सिडनी, ऑस्ट्रेलिया के ऑफ़िस की वैल्यू vicinity है और इसकी वैल्यू 5/48 Pirrama Road, Pyrmont है. सिर्फ़ vicinity प्रॉपर्टी दिखाई जाती है आस-पास खोज के लिए.
  • website इस जगह के लिए आधिकारिक वेबसाइट की सूची बनाता है, जैसे कारोबार के तौर पर' होम पेज पर जाएं.

ध्यान दें: हो सकता है कि ये दोनों डाइमेंशन के लिए उपलब्ध न हों सभी स्थानों पर. अगर बहुत कम समीक्षाएं हैं, तो पूरी जानकारी के साथ जवाब या तो 0.0 से 5.0 के स्केल पर एक लेगसी रेटिंग (अगर उपलब्ध हो) शामिल करें या नहीं को रेटिंग नहीं मिलेगी.

जगह की खास जानकारी वाले कॉम्पोनेंट का इस्तेमाल करना

ध्यान दें: यह सैंपल ओपन सोर्स लाइब्रेरी का इस्तेमाल करता है. ज़्यादा जानकारी के लिए, मदद के लिए README के सुझाव भी देते हैं.

वेब कॉम्पोनेंट आज़माएं. का उपयोग करें विज़ुअल प्रज़ेंटेशन के साथ जगह की जानकारी पाने के लिए, जगह की खास जानकारी वाले वेब कॉम्पोनेंट का इस्तेमाल करें.

इमेज के x-छोटे, छोटे, मीडियम, बड़े, और बड़े साइज़ के वैरिएंट उपयोगकर्ता के डाले गए साइज़ फ़ील्ड के आधार पर, जगह की खास जानकारी वाला कॉम्पोनेंट दिखाया गया है.
पहली इमेज: साइज़ के पांच अलग-अलग वैरिएशन के साथ जगह की जानकारी

जगह के आईडी के साथ किसी जगह का रेफ़रंस देना

जगह का आईडी, Google Maps पर मौजूद किसी जगह का एक यूनीक रेफ़रंस होता है. जगह के आईडी ज़्यादातर जगहों के लिए उपलब्ध हैं. इनमें कारोबार, लैंडमार्क, पार्क, और और चौराहों.

अपने ऐप्लिकेशन में जगह का आईडी इस्तेमाल करने के लिए, सबसे पहले आपको आईडी खोजना होगा. किसी स् थान खोज या विवरण अनुरोध के PlaceResult में उपलब् ध है. इसके बाद, आप इस जगह के आईडी का इस्तेमाल करके, जगह जानकारी.

जगह के आईडी को कैश मेमोरी में सेव करने की पाबंदियों से छूट मिली है के सेक्शन 3.2.3(b) में Google Maps Platform की सेवा की शर्तें. इसलिए, बाद में इस्तेमाल करने के लिए, जगह के आईडी की वैल्यू को सेव किया जा सकता है. इसके लिए प्लेस आईडी स्टोर करने के सबसे सही तरीके हैं, तो जगह के आईडी की खास जानकारी.

var map;

function initialize() {
  // Create a map centered in Pyrmont, Sydney (Australia).
  map = new google.maps.Map(document.getElementById('map'), {
    center: {lat: -33.8666, lng: 151.1958},
    zoom: 15
  });

  // Search for Google's office in Australia.
  var request = {
    location: map.getCenter(),
    radius: '500',
    query: 'Google Sydney'
  };

  var service = new google.maps.places.PlacesService(map);
  service.textSearch(request, callback);
}

// Checks that the PlacesServiceStatus is OK, and adds a marker
// using the place ID and location from the PlacesService.
function callback(results, status) {
  if (status == google.maps.places.PlacesServiceStatus.OK) {
    var marker = new google.maps.Marker({
      map: map,
      place: {
        placeId: results[0].place_id,
        location: results[0].geometry.location
      }
    });
  }
}

google.maps.event.addDomListener(window, 'load', initialize);

जगह की फ़ोटो

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

PlacePhoto ऑब्जेक्ट का कलेक्शन, किसी भी getDetails() के लिए PlaceResult ऑब्जेक्ट, textSearch() या PlacesService के ख़िलाफ़ nearbySearch() अनुरोध किया गया.

ध्यान दें: वापस की जाने वाली फ़ोटो की संख्या, अनुरोध के हिसाब से अलग-अलग होती है.

  • कोई आस-पास खोज या लेख खोज अधिकतम एक ही लौटेगा PlacePhoto ऑब्जेक्ट.
  • ज़्यादा जानकारी वाले अनुरोध में, ज़्यादा से ज़्यादा 10 PlacePhoto ऑब्जेक्ट दिखाए जाएंगे.

आप PlacePhoto.getUrl() तरीका इस्तेमाल करके, मान्य नतीजे पास किए जा रहे हैं PhotoOptions ऑब्जेक्ट. PhotoOptions ऑब्जेक्ट अनुमति देता है आपके पास इमेज की ज़्यादा से ज़्यादा ऊंचाई और चौड़ाई तय करने का विकल्प है. अगर आपको maxHeight और maxWidth, दोनों के लिए वैल्यू तय करें. तो फ़ोटो सेवा, चित्र का आकार बदलकर उसे दोनों में से छोटे आकार में कर देगी. ओरिजनल आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) में बनाए रखें.

नीचे दिया गया कोड स्निपेट एक प्लेस ऑब्जेक्ट स्वीकार करता है और एक मार्कर जोड़ता है मैप में जोड़ दें. डिफ़ॉल्ट मार्कर चित्र बदल दिया गया है उसके छोटे वर्शन की मदद से बनाया जाता है.

function createPhotoMarker(place) {
  var photos = place.photos;
  if (!photos) {
    return;
  }

  var marker = new google.maps.Marker({
    map: map,
    position: place.geometry.location,
    title: place.name,
    icon: photos[0].getUrl({maxWidth: 35, maxHeight: 35})
  });
}

फ़ोटो सेवा से वापस ली गई फ़ोटो कई तरह की फ़ोटो से ली गई हैं शामिल हैं, जिनमें कारोबार के मालिक और उपयोगकर्ता के योगदान से मिली फ़ोटो शामिल हैं. ज़्यादातर इन फ़ोटो को एट्रिब्यूशन के बिना उपयोग किया जा सकता है या एट्रिब्यूशन को इमेज के हिस्से के रूप में शामिल किया गया है. हालांकि, यदि photo एलिमेंट में html_attributions फ़ील्ड, आपको अतिरिक्त जानकारी शामिल करनी होगी एट्रिब्यूशन को लागू करने की अनुमति दें.