किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा, Maps JavaScript API में Places लाइब्रेरी की एक सुविधा है. ऑटोकंप्लीट सुविधा का इस्तेमाल करके, अपने ऐप्लिकेशन को Google Maps के खोज फ़ील्ड में टाइप-अहेड-सर्च की सुविधा दी जा सकती है.
इस पेज पर, किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा के लेगसी और नए वर्शन के बीच के अंतर के बारे में बताया गया है. दोनों वर्शन में, ऑटोकंप्लीट की सुविधा को इंटिग्रेट करने के दो सामान्य तरीके हैं:
- प्रोग्रामैटिक इंटरफ़ेस: यह उन डेवलपर के लिए है जो ऑटोकंप्लीट की सुविधा को अपनी पसंद के मुताबिक ज़्यादा बेहतर तरीके से इस्तेमाल करना चाहते हैं.
- किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा वाला विजेट: यह एक खोज बार होता है, जिसे किसी मैप या वेब पेज पर एम्बेड किया जा सकता है.
ऑटोकंप्लीट प्रोग्रामैटिक इंटरफ़ेस
यहां दी गई टेबल में, किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा (लेगसी) और ऑटोकंप्लीट डेटा एपीआई (नया) के बीच, प्रोग्राम के हिसाब से किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा के इस्तेमाल में कुछ मुख्य अंतर बताए गए हैं:
PlacesService (लेगसी) |
Place (नया) |
|---|---|
| Places Autocomplete Service रेफ़रंस | ऑटोकंप्लीट डेटा (नया) के बारे में जानकारी |
AutocompletionRequest |
AutocompleteRequest |
AutocompleteService.getPlacePredictions |
AutocompleteSuggestion.fetchAutocompleteSuggestions |
AutocompletePrediction |
PlacePrediction |
नतीजों के ऑब्जेक्ट और PlacesServiceStatus रिस्पॉन्स को मैनेज करने के लिए, तरीकों में कॉलबैक का इस्तेमाल करना ज़रूरी है. |
यह Promises का इस्तेमाल करता है और एसिंक्रोनस तरीके से काम करता है. |
इन तरीकों के लिए, PlacesServiceStatus की जांच ज़रूरी है. |
स्टेटस की जांच करने की ज़रूरत नहीं है. गड़बड़ी को ठीक करने के लिए, स्टैंडर्ड तरीके का इस्तेमाल किया जा सकता है. ज़्यादा जानें. |
Autocomplete इंस्टेंस बनाते समय, जगह की जानकारी वाले डेटा फ़ील्ड को विकल्पों के तौर पर सेट किया जाता है. |
जगह की जानकारी के डेटा फ़ील्ड, fetchFields() को कॉल करने के बाद सेट किए जाते हैं. |
क्वेरी के सुझाव देने की सुविधा काम करती है (सिर्फ़ SearchBox). |
Autocomplete क्लास में, क्वेरी के सुझाव उपलब्ध नहीं हैं. |
| यह जगह के टाइप और जगह के डेटा फ़ील्ड के तय सेट तक सीमित है. | जगह के टाइप और जगह के डेटा फ़ील्ड के ज़्यादा विकल्पों का ऐक्सेस. |
ऑटोकंप्लीट की सुविधा वाले पुराने और नए एपीआई, दोनों में इनका इस्तेमाल किया जाता है:
कोड की तुलना (प्रोग्रामैटिक)
इस सेक्शन में, ऑटोकंप्लीट के लिए कोड की तुलना की गई है. इससे, प्रोग्रामैटिक इंटरफ़ेस के लिए, Places सेवा और Place क्लास के बीच के अंतर को समझने में मदद मिलती है.
ऑटोकंप्लीट के सुझाव पाना (लेगसी)
लेगसी Places Service की मदद से, प्रोग्राम के हिसाब से ऑटोकंप्लीट के सुझाव पाए जा सकते हैं. इससे आपको Autocomplete क्लास के मुकाबले, यूज़र इंटरफ़ेस पर ज़्यादा कंट्रोल मिलता है. यहां दिए गए उदाहरण में, "par" के लिए एक अनुरोध किया गया है. इसमें AutocompletionRequest में इनपुट वैल्यू और अनुमान को बायस करने के लिए बाउंड का एक सेट शामिल है. इस उदाहरण में, AutocompletePrediction इंस्टेंस की सूची दिखती है. साथ ही, हर इंस्टेंस का ब्यौरा दिखता है. उदाहरण के तौर पर दिया गया फ़ंक्शन, सेशन टोकन भी बनाता है और उसे अनुरोध पर लागू करता है.
function init() {
const placeInfo = document.getElementById("prediction");
const service = new google.maps.places.AutocompleteService();
const placesService = new google.maps.places.PlacesService(placeInfo);
var sessionToken = new google.maps.places.AutocompleteSessionToken();
// Define request options.
let request = {
input: "par",
sessionToken: sessionToken,
bounds: {
west: -122.44,
north: 37.8,
east: -122.39,
south: 37.78,
},
}
// Display the query string.
const title = document.getElementById("title");
title.appendChild(
document.createTextNode('Place predictions for "' + request.input + '":'),
);
// Perform the query and display the results.
const displaySuggestions = function (predictions, status) {
// Check the status of the Places Service.
if (status != google.maps.places.PlacesServiceStatus.OK || !predictions) {
alert(status);
return;
}
predictions.forEach((prediction) => {
const li = document.createElement("li");
li.appendChild(document.createTextNode(prediction.description));
document.getElementById("results").appendChild(li);
});
const placeRequest = {
placeId: predictions[0].place_id,
fields: ["name", "formatted_address"],
};
placesService.getDetails(placeRequest, (place, status) => {
if (status == google.maps.places.PlacesServiceStatus.OK && place) {
placeInfo.textContent = `
First predicted place: ${place.name} at ${place.formatted_address}`
}
});
};
// Show the results of the query.
service.getPlacePredictions(request, displaySuggestions);
}
- प्रोग्राम के हिसाब से, किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सेवा से सुझाव पाना
- किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा का उदाहरण
- सेशन टोकन
AutocompletionRequestरेफ़रंसAutocompletePredictionरेफ़रंस
ऑटोकंप्लीट के सुझाव पाना (नया)
नई Place क्लास की मदद से, प्रोग्राम के हिसाब से ऑटोकंप्लीट के सुझाव भी पाए जा सकते हैं. इससे आपको यूज़र इंटरफ़ेस पर ज़्यादा कंट्रोल मिलता है. यह कंट्रोल, PlaceAutocompleteElement क्लास से मिलने वाले कंट्रोल से ज़्यादा होता है. नीचे दिए गए उदाहरण में, "par" के लिए एक अनुरोध किया गया है. इसमें एक AutocompleteRequest शामिल है, जिसमें इनपुट वैल्यू और अनुमान को बायस करने के लिए बाउंड का एक सेट शामिल है. इस उदाहरण में, placePrediction इंस्टेंस की सूची दिखती है. साथ ही, हर इंस्टेंस का ब्यौरा दिखता है. उदाहरण के तौर पर दिया गया फ़ंक्शन, सेशन टोकन भी बनाता है और उसे अनुरोध पर लागू करता है.
async function init() {
let sessionToken = new google.maps.places.AutocompleteSessionToken();
// Define request options.
let request = {
input: "par",
sessionToken: sessionToken,
locationBias: {
west: -122.44,
north: 37.8,
east: -122.39,
south: 37.78,
},
};
// Display the query string.
const title = document.getElementById("title");
title.appendChild(
document.createTextNode('Place predictions for "' + request.input + '":'),
);
// Perform the query and display the results.
const { suggestions } =
await google.maps.places.AutocompleteSuggestion.fetchAutocompleteSuggestions(request);
const resultsElement = document.getElementById("results");
for (let suggestion of suggestions) {
const placePrediction = suggestion.placePrediction;
const listItem = document.createElement("li");
listItem.appendChild(
document.createTextNode(placePrediction.text.text),
);
resultsElement.appendChild(listItem);
}
// Show the first predicted place.
let place = suggestions[0].placePrediction.toPlace();
await place.fetchFields({
fields: ["displayName", "formattedAddress"],
});
const placeInfo = document.getElementById("prediction");
placeInfo.textContent = `
First predicted place: ${place.displayName} at ${place.formattedAddress}`
}
- Place Autocomplete Data API
- किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा के डेटा के अनुमान का उदाहरण
- Place Autocomplete Data Sessions का उदाहरण
- सेशन टोकन
AutocompleteRequestइंटरफ़ेस रेफ़रंसAutocompleteSuggestionक्लास रेफ़रंसPlacePredictionक्लास रेफ़रंस
किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा वाला विजेट
यहां दी गई टेबल में, Places सेवा (लेगसी) और Place क्लास (नई) के बीच, ऑटोकंप्लीट विजेट के इस्तेमाल में होने वाले कुछ मुख्य अंतरों की सूची दी गई है:
| Places Service (लेगसी) | जगह (नया) |
|---|---|
Autocomplete क्लास
का इस्तेमाल करें.
|
PlaceAutocompleteElement क्लास
का इस्तेमाल करें.
|
क्वेरी के अनुमानों के लिए SearchBox क्लास. |
Autocomplete क्लास में, क्वेरी के सुझाव उपलब्ध नहीं हैं.
|
| सिर्फ़ डिफ़ॉल्ट इनपुट प्लेसहोल्डर टेक्स्ट को स्थानीय भाषा में बदला जाता है. | टेक्स्ट इनपुट प्लेसहोल्डर, अनुमानों की सूची का लोगो, और जगह के अनुमान, सभी क्षेत्रीय स्थानीयकरण के साथ काम करते हैं. |
विजेट, खोज को तय की गई सीमाओं तक सीमित करने के लिए, setBounds() या autocomplete.bindTo() का इस्तेमाल करता है. साथ ही, नतीजों को तय की गई सीमाओं तक सीमित करने के लिए, strictBounds का इस्तेमाल करता है.
|
विजेट, locationBias प्रॉपर्टी का इस्तेमाल करके, नतीजों को तय की गई सीमाओं के हिसाब से दिखाता है. साथ ही, locationRestriction प्रॉपर्टी का इस्तेमाल करके, खोज को तय की गई सीमाओं तक सीमित करता है.
|
| विजेट को सिर्फ़ स्टैंडर्ड एचटीएमएल इनपुट एलिमेंट का इस्तेमाल करके इंटिग्रेट किया जा सकता है. | विजेट को स्टैंडर्ड एचटीएमएल इनपुट एलिमेंट या gmp-place-autocomplete एलिमेंट का इस्तेमाल करके इंटिग्रेट किया जा सकता है. |
| विजेट का इस्तेमाल करते समय, हो सकता है कि उपयोगकर्ता ऐसी चीज़ों का अनुरोध करें जो मान्य न हों (उदाहरण के लिए, "bisneyland"). इस मामले को साफ़ तौर पर हैंडल किया जाना चाहिए. | विजेट सिर्फ़ दिए गए सुझावों के नतीजे दिखाएगा. यह किसी भी वैल्यू के लिए अनुरोध नहीं कर सकता. इसलिए, अमान्य अनुरोधों को मैनेज करने की ज़रूरत नहीं है. |
यह लेगसी
PlaceResult इंस्टेंस दिखाता है. |
यह
Place इंस्टेंस दिखाता है. |
जगह की जानकारी के डेटा फ़ील्ड, Autocomplete ऑब्जेक्ट के लिए विकल्प के तौर पर सेट किए जाते हैं. |
जगह के डेटा फ़ील्ड तब सेट होते हैं, जब उपयोगकर्ता कोई विकल्प चुनता है और fetchFields() को कॉल किया जाता है. |
| यह जगह के टाइप और जगह के डेटा फ़ील्ड के तय सेट तक सीमित है. | जगह के टाइप और जगह के डेटा फ़ील्ड के ज़्यादा विकल्पों का ऐक्सेस. |
कोड की तुलना (विजेट)
इस सेक्शन में, ऑटोकंप्लीट के लिए कोड की तुलना की गई है. इससे, किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा वाले लेगसी विजेट और किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा वाले नए एलिमेंट के बीच के अंतर को समझने में मदद मिलती है.
किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा वाला विजेट (लेगसी)
Places Service में, ऑटोकंप्लीट की सुविधा वाले दो तरह के विजेट मिलते हैं. इन्हें Autocomplete और SearchBox क्लास का इस्तेमाल करके जोड़ा जा सकता है.
हर तरह के विजेट को मैप कंट्रोल के तौर पर मैप में जोड़ा जा सकता है या सीधे तौर पर किसी वेब पेज पर एम्बेड किया जा सकता है. यहां दिए गए कोड के उदाहरण में, मैप कंट्रोल के तौर पर Autocomplete विजेट को एम्बेड करने का तरीका बताया गया है.
Autocompleteविजेट कंस्ट्रक्टर में दो आर्ग्युमेंट होते हैं:textटाइप का एचटीएमएलinputएलिमेंट. यह वह इनपुट फ़ील्ड है जिसकी निगरानी, ऑटोकंप्लीट की सेवा करेगी और अपने नतीजे अटैच करेगी.- एक वैकल्पिक
AutocompleteOptionsआर्ग्युमेंट, जहां क्वेरी को सीमित करने के लिए ज़्यादा विकल्प तय किए जा सकते हैं.
- बाउंड सेट करने के लिए,
Autocompleteइंस्टेंस कोautocomplete.bindTo()को कॉल करके, साफ़ तौर पर मैप से जोड़ा जा सकता है. - ऑटोकंप्लीट की सुविधा के विकल्पों में, जगह की जानकारी वाले डेटा फ़ील्ड की जानकारी दें.
function initMap() {
const map = new google.maps.Map(document.getElementById("map"), {
center: { lat: 40.749933, lng: -73.98633 },
zoom: 13,
mapTypeControl: false,
});
const card = document.getElementById("pac-card");
const input = document.getElementById("pac-input");
const options = {
fields: ["formatted_address", "geometry", "name"],
strictBounds: false,
};
map.controls[google.maps.ControlPosition.TOP_LEFT].push(card);
const autocomplete = new google.maps.places.Autocomplete(input, options);
// Bind the map's bounds (viewport) property to the autocomplete object,
// so that the autocomplete requests use the current map bounds for the
// bounds option in the request.
autocomplete.bindTo("bounds", map);
const infowindow = new google.maps.InfoWindow();
const infowindowContent = document.getElementById("infowindow-content");
infowindow.setContent(infowindowContent);
const marker = new google.maps.Marker({
map,
anchorPoint: new google.maps.Point(0, -29),
});
autocomplete.addListener("place_changed", () => {
infowindow.close();
marker.setVisible(false);
const place = autocomplete.getPlace();
if (!place.geometry || !place.geometry.location) {
// User entered the name of a Place that was not suggested and
// pressed the Enter key, or the Place Details request failed.
window.alert("No details available for input: '" + place.name + "'");
return;
}
// If the place has a geometry, then present it on a map.
if (place.geometry.viewport) {
map.fitBounds(place.geometry.viewport);
} else {
map.setCenter(place.geometry.location);
map.setZoom(17);
}
marker.setPosition(place.geometry.location);
marker.setVisible(true);
infowindowContent.children["place-name"].textContent = place.name;
infowindowContent.children["place-address"].textContent =
place.formatted_address;
infowindow.open(map, marker);
});
}
- किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा से जुड़ा दस्तावेज़
- किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा वाले विजेट का उदाहरण
- Places Search Box का उदाहरण
Autocompleteक्लास रेफ़रंस
किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा वाला विजेट (नया)
Place क्लास में
PlaceAutocompleteElement मौजूद होता है.
यह HTMLElement की सबक्लास है, जो यूज़र इंटरफ़ेस (यूआई) कॉम्पोनेंट उपलब्ध कराती है. इसे मैप कंट्रोल के तौर पर मैप में जोड़ा जा सकता है या सीधे वेब पेज पर एम्बेड किया जा सकता है. यहां दिए गए कोड के उदाहरण में, PlaceAutocompleteElement विजेट को मैप कंट्रोल के तौर पर एम्बेड करने का तरीका बताया गया है.
किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा वाले विजेट को इन तरीकों से बेहतर बनाया गया है:
- ऑटोकंप्लीट विजेट का यूज़र इंटरफ़ेस (यूआई), टेक्स्ट इनपुट प्लेसहोल्डर, सुझावों की सूची के लोगो, और जगह के सुझावों के लिए, क्षेत्रीय भाषा (दाएं से बाएं लिखी जाने वाली भाषाओं के साथ) के साथ काम करता है.
- बेहतर सुलभता सुविधाएं, जैसे कि स्क्रीन रीडर और कीबोर्ड इंटरैक्शन की सुविधा.
- अपने-आप पूरा होने वाला विजेट, नई
Placeक्लास दिखाता है. इससे, दिखाए गए ऑब्जेक्ट को मैनेज करना आसान हो जाता है. - मोबाइल डिवाइसों और छोटी स्क्रीन के लिए बेहतर सहायता.
- बेहतर परफ़ॉर्मेंस और बेहतर ग्राफ़िक.
इन्हें लागू करने की प्रोसेस में ये मुख्य अंतर होते हैं:
PlaceAutocompleteElementअपना इनपुट फ़ील्ड उपलब्ध कराता है. इसे एचटीएमएल या JavaScript का इस्तेमाल करके, सीधे पेज में डाला जाता है. हालांकि, इसके लिए पहले से मौजूद इनपुट एलिमेंट का इस्तेमाल नहीं किया जाता.- क्वेरी के सुझाव,
Autocompleteक्लास में उपलब्ध नहीं हैं. PlaceAutocompleteElementकोPlaceAutocompleteElementOptionsका इस्तेमाल करके बनाया जाता है.- जगह के डेटा फ़ील्ड, चुने जाने के समय तय किए जाते हैं. ऐसा तब होता है, जब
fetchFields()को कॉल किया जाता है.
- जगह के डेटा फ़ील्ड, चुने जाने के समय तय किए जाते हैं. ऐसा तब होता है, जब
locationBoundsयाlocationRestrictionविकल्प का इस्तेमाल करके, बाउंड सेट करें.
let map;
let marker;
let infoWindow;
async function initMap() {
// Request needed libraries.
const [{ Map }, { AdvancedMarkerElement }] = await Promise.all([
google.maps.importLibrary("marker"),
google.maps.importLibrary("places"),
]);
// Initialize the map.
map = new google.maps.Map(document.getElementById("map"), {
center: { lat: 40.749933, lng: -73.98633 },
zoom: 13,
mapId: "4504f8b37365c3d0",
mapTypeControl: false,
});
const placeAutocomplete =
new google.maps.places.PlaceAutocompleteElement({
locationRestriction: map.getBounds(),
});
placeAutocomplete.id = "place-autocomplete-input";
const card = document.getElementById("place-autocomplete-card");
card.appendChild(placeAutocomplete);
map.controls[google.maps.ControlPosition.TOP_LEFT].push(card);
// Create the marker and infowindow.
marker = new google.maps.marker.AdvancedMarkerElement({
map,
});
infoWindow = new google.maps.InfoWindow({});
// Add the gmp-select listener, and display the results on the map.
placeAutocomplete.addEventListener("gmp-select", async ( event ) => {
const place = event.placePrediction.toPlace();
await place.fetchFields({
fields: ["displayName", "formattedAddress", "location", "viewport"],
});
// If the place has a geometry, then present it on a map.
if (place.viewport) {
map.fitBounds(place.viewport);
} else {
map.setCenter(place.location);
map.setZoom(17);
}
let content =
'<div id="infowindow-content">' +
'<span id="place-displayname" class="title">' +
place.displayName +
'</span><br />' +
'<span id="place-address">' +
place.formattedAddress +
'</span>' +
'</div>';
updateInfoWindow(content, place.location);
marker.position = place.location;
});
}
// Helper function to create an info window.
function updateInfoWindow(content, center) {
infoWindow.setContent(content);
infoWindow.setPosition(center);
infoWindow.open({
map,
anchor: marker,
shouldFocus: false,
});
}
- किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा वाले विजेट (झलक) का दस्तावेज़
- किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा वाले विजेट का उदाहरण
- किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा वाले एलिमेंट का उदाहरण
PlaceAutocompleteElementक्लास रेफ़रंस