PlacesService class
google.maps.places.PlacesService
class
כולל שיטות שקשורות לחיפוש מקומות ולאחזור פרטים על מקום.
אפשר להתקשר אל const {PlacesService} = await google.maps.importLibrary("places") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.
יצרן | |
|---|---|
PlacesService |
PlacesService(attrContainer)פרמטרים:
יוצרת מופע חדש של PlacesService שמציג שיוכים בקונטיינר שצוין. |
Methods | |
|---|---|
findPlaceFromPhoneNumber |
findPlaceFromPhoneNumber(request, callback)פרמטרים:
ערך מוחזר: אין
מאחזרת רשימה של מקומות על סמך מספר טלפון. ברוב המקרים אמור להיות רק פריט אחד ברשימת התוצאות, אבל אם הבקשה לא ברורה יכול להיות שיוחזרו יותר מתוצאה אחת. ה- PlaceResults שמועברים אל פונקציית הקריאה החוזרת הם תת-קבוצות של PlaceResult מלא. האפליקציה יכולה לקבל PlaceResult מפורט יותר לכל מקום על ידי הפעלת PlacesService.getDetails והעברת PlaceResult.place_id למקום הרצוי. |
findPlaceFromQuery |
findPlaceFromQuery(request, callback)פרמטרים:
ערך מוחזר: אין
מאחזרת רשימה של מקומות על סמך מחרוזת שאילתה. ברוב המקרים אמור להיות רק פריט אחד ברשימת התוצאות, אבל אם הבקשה לא ברורה יכול להיות שיוחזרו יותר מתוצאה אחת. ה- PlaceResults שמועברים אל פונקציית הקריאה החוזרת הם תת-קבוצות של PlaceResult מלא. האפליקציה יכולה לקבל PlaceResult מפורט יותר לכל מקום על ידי הפעלת PlacesService.getDetails והעברת PlaceResult.place_id למקום הרצוי. |
getDetails |
getDetails(request, callback)פרמטרים:
ערך מוחזר: אין
אחזור פרטים על המקום שזוהה על ידי placeId שצוין. |
nearbySearch |
nearbySearch(request, callback)פרמטרים:
ערך מוחזר: אין
אחזור רשימה של מקומות ליד מיקום מסוים, על סמך מילת מפתח או סוג. תמיד צריך לציין מיקום, באמצעות העברת פרמטר LatLngBounds או פרמטרים location ו-radius. ה-PlaceResults שמועברים לקריאה החוזרת הם קבוצות משנה של ה-PlaceResult המלא. האפליקציה יכולה לקבל PlaceResult מפורט יותר לכל מקום על ידי שליחת בקשה לפרטי מקום עם PlaceResult.place_id של המקום הרצוי. אפשר להשתמש באובייקט PlaceSearchPagination כדי לאחזר דפים נוספים של תוצאות (הערך הוא null אם זה הדף האחרון של התוצאות או אם יש רק דף אחד של תוצאות). |
textSearch |
textSearch(request, callback)פרמטרים:
ערך מוחזר: אין
מאחזר רשימה של מקומות על סמך מחרוזת שאילתה (לדוגמה, 'פיצה בניו יורק' או 'חנויות נעליים ליד אוטווה'). פרמטרים של מיקום הם אופציונליים. כשמציינים מיקום, התוצאות מוטות רק לתוצאות בקרבת מקום, ולא מוגבלות למקומות בתוך האזור. משתמשים ב- textSearch כשרוצים לחפש מקומות באמצעות מחרוזת שרירותית, ובמקרים שבהם לא רוצים להגביל את תוצאות החיפוש למיקום מסוים. אפשר להשתמש באובייקט PlaceSearchPagination כדי לאחזר דפים נוספים של תוצאות (הערך הוא null אם זה הדף האחרון של התוצאות או אם יש רק דף אחד של תוצאות). |
PlaceDetailsRequest interface
google.maps.places.PlaceDetailsRequest
ממשק
שאילתת פרטי מקום שתישלח אל PlacesService.
מאפיינים | |
|---|---|
placeId |
סוג:
stringמזהה המקום של המקום שלגביו מתבקשים פרטים. |
fields optional |
סוג:
Array<string> optionalהשדות שייכללו בתגובת הפרטים, שעליהם יחויב. אם לא מציינים שדות או מעבירים את הערך ['ALL'], כל השדות הזמינים יוחזרו ותחויבו עליהם (לא מומלץ לפריסות בסביבת ייצור). רשימת השדות זמינה בכתובת PlaceResult. אפשר לציין שדות מקוננים באמצעות נתיבים עם נקודות (לדוגמה, "geometry.location"). |
language optional |
סוג:
string optionalמזהה שפה של השפה שבה צריך להחזיר את הפרטים. כאן אפשר לעיין ברשימת השפות הנתמכות. |
region optional |
סוג:
string optionalקוד האזור של האזור שבו נמצא המשתמש. ההגדרה הזו יכולה להשפיע על התמונות שיוצגו, ואולי גם על דברים אחרים. קוד האזור יכול להיות ccTLD (דומיין ברמה העליונה) באורך שני תווים. רוב קודי ה-ccTLD זהים לקודי ISO 3166-1, אבל יש כמה יוצאים מן הכלל. לדוגמה, דומיין ccTLD של בריטניה הוא uk ( .co.uk), אבל קוד ISO 3166-1 שלה הוא gb (מבחינה טכנית, עבור הישות 'ממלכת בריטניה הגדולה וצפון אירלנד'). |
sessionToken optional |
סוג:
AutocompleteSessionToken optionalהפניה ייחודית שמשמשת לאגד את בקשת הפרטים עם סשן של השלמה אוטומטית. |
FindPlaceFromPhoneNumberRequest interface
google.maps.places.FindPlaceFromPhoneNumberRequest
ממשק
בקשה לחיפוש מקום מתוך חיפוש טקסט שתישלח אל PlacesService.findPlaceFromPhoneNumber.
מאפיינים | |
|---|---|
fields |
סוג:
Array<string>השדות שייכללו בתשובה, שעליהם יחויב המשתמש. אם מעבירים את הערך ['ALL'], כל השדות הזמינים יוחזרו ותחויבו עליהם (לא מומלץ להשתמש באפשרות הזו בפריסות של מוצרים). רשימת השדות זמינה בכתובת PlaceResult. אפשר לציין שדות מקוננים באמצעות נתיבים עם נקודות (לדוגמה, "geometry.location"). |
phoneNumber |
סוג:
stringמספר הטלפון של המקום שרוצים לחפש. הפורמט צריך להיות E.164. |
language optional |
סוג:
string optionalמזהה שפה לשפה שבה צריך להחזיר את השמות והכתובות, אם אפשר. כאן אפשר לעיין ברשימת השפות הנתמכות. |
locationBias optional |
סוג:
LocationBias optionalההטיה שמשמשת לחיפוש מקום. התוצאה תהיה מוטה לכיוון LocationBias שצוין, אבל לא תוגבל אליו. |
FindPlaceFromQueryRequest interface
google.maps.places.FindPlaceFromQueryRequest
ממשק
בקשה לחיפוש מקום מתוך חיפוש טקסט שתישלח אל PlacesService.findPlaceFromQuery.
מאפיינים | |
|---|---|
fields |
סוג:
Array<string>השדות שייכללו בתשובה, שעליהם יחויב המשתמש. אם מעבירים את הערך ['ALL'], כל השדות הזמינים יוחזרו ותחויבו עליהם (לא מומלץ להשתמש באפשרות הזו בפריסות של מוצרים). רשימת השדות זמינה בכתובת PlaceResult. אפשר לציין שדות מקוננים באמצעות נתיבים עם נקודות (לדוגמה, "geometry.location"). |
query |
סוג:
stringהשאילתה של הבקשה. לדוגמה, השם או הכתובת של מקום. |
language optional |
סוג:
string optionalמזהה שפה לשפה שבה צריך להחזיר את השמות והכתובות, אם אפשר. כאן אפשר לעיין ברשימת השפות הנתמכות. |
locationBias optional |
סוג:
LocationBias optionalההטיה שמשמשת לחיפוש מקום. התוצאה תהיה מוטה לכיוון LocationBias שצוין, אבל לא תוגבל אליו. |
PlaceSearchRequest interface
google.maps.places.PlaceSearchRequest
ממשק
שאילתת חיפוש של מקום שתישלח אל PlacesService.
מאפיינים | |
|---|---|
bounds optional |
סוג:
LatLngBounds|LatLngBoundsLiteral optionalהגבולות שבהם יתבצע החיפוש של מקומות. אם המדיניות bounds מוגדרת, המערכת מתעלמת גם מהמדיניות location וגם מהמדיניות radius. |
keyword optional |
סוג:
string optionalמונח שיושווה לכל השדות הזמינים, כולל, בין היתר, שם, סוג וכתובת, וגם ביקורות של לקוחות ותוכן אחר של צד שלישי. |
language optional |
סוג:
string optionalמזהה שפה לשפה שבה צריך להחזיר את השמות והכתובות, אם אפשר. כאן אפשר לעיין ברשימת השפות הנתמכות. |
location optional |
סוג:
LatLng|LatLngLiteral optionalהמיקום שסביבו יתבצע החיפוש של מקומות. |
maxPriceLevel optional |
סוג:
number optionalהגבלת התוצאות למקומות ברמת המחיר שצוינה או ברמה נמוכה יותר. הערכים החוקיים הם 0 (המחיר הכי משתלם) עד 4 (המחיר הכי גבוה), כולל. אם מציינים ערך, הוא חייב להיות גדול מ- minPrice או שווה לו. |
minPriceLevel optional |
סוג:
number optionalהגבלת התוצאות למקומות ברמת המחיר שצוינה או ברמה גבוהה יותר. הערכים החוקיים הם 0 (המחיר הכי משתלם) עד 4 (המחיר הכי גבוה), כולל. אם מציינים ערך, הוא חייב להיות קטן מ- maxPrice או שווה לו. |
|
סוג:
string optionalשווה ערך ל- keyword. הערכים בשדה הזה משולבים עם הערכים בשדה keyword ומועברים כחלק מאותה מחרוזת חיפוש. |
openNow optional |
סוג:
boolean optionalהגבלת התוצאות רק למקומות שפתוחים כרגע. |
radius optional |
סוג:
number optionalהמרחק מהמיקום שצוין שבמסגרתו יתבצע חיפוש של מקומות, במטרים. הערך המקסימלי המותר הוא 50,000. |
rankBy optional |
סוג:
RankBy optionalברירת מחדל:
RankBy.PROMINENCEמציין את שיטת הדירוג שתשמש להחזרת התוצאות. הערה: אם הערך של rankBy הוא DISTANCE, צריך לציין location אבל אי אפשר לציין radius או bounds. |
type optional |
סוג:
string optionalחיפוש של מקומות מהסוג שצוין. הסוג מתורגם לשפה המקומית של מיקום היעד של הבקשה ומשמש כמחרוזת שאילתה. אם מסופקת גם שאילתה, היא מצורפת למחרוזת הסוג המותאמת לשוק המקומי. תוצאות מסוג אחר מושמטות מהתשובה. אפשר להשתמש בשדה הזה כדי לבצע חיפושים קטגוריים שלא תלויים בשפה או באזור. הסוגים התקינים מפורטים כאן. |
TextSearchRequest ממשק
google.maps.places.TextSearchRequest
ממשק
בקשת חיפוש טקסט שתישלח אל PlacesService.
מאפיינים | |
|---|---|
bounds optional |
סוג:
LatLngBounds|LatLngBoundsLiteral optionalגבולות שמשמשים להטיית התוצאות כשמחפשים מקומות (אופציונלי). אם המדיניות bounds מוגדרת, המערכת מתעלמת גם מהמדיניות location וגם מהמדיניות radius. התוצאות לא יוגבלו לאלה שנמצאות בתוך הגבולות האלה, אבל התוצאות שנמצאות בתוך הגבולות ידורגו גבוה יותר. |
language optional |
סוג:
string optionalמזהה שפה לשפה שבה צריך להחזיר את השמות והכתובות, אם אפשר. כאן אפשר לעיין ברשימת השפות הנתמכות. |
location optional |
סוג:
LatLng|LatLngLiteral optionalמרכז האזור שמשמש להטיית התוצאות כשמחפשים מקומות. |
query optional |
סוג:
string optionalמונח השאילתה של הבקשה. לדוגמה, שם של מקום ('מגדל אייפל'), קטגוריה ואחריה שם של מיקום ('פיצה בניו יורק'), או שם של מקום ואחריו מזהה מיקום ('סטארבקס בסידני'). |
radius optional |
סוג:
number optionalרדיוס האזור שמשמש להטיית התוצאות כשמחפשים מקומות, במטרים. |
region optional |
סוג:
string optionalקוד אזור להטיית התוצאות. קוד האזור יכול להיות ccTLD (דומיין ברמה העליונה) באורך שני תווים. רוב קודי ה-ccTLD זהים לקודי ISO 3166-1, אבל יש כמה יוצאים מן הכלל. לדוגמה, דומיין ccTLD של בריטניה הוא uk ( .co.uk), אבל קוד ISO 3166-1 שלה הוא gb (מבחינה טכנית, עבור הישות 'ממלכת בריטניה הגדולה וצפון אירלנד'). |
type optional |
סוג:
string optionalחיפוש של מקומות מהסוג שצוין. הסוג מתורגם לשפה המקומית של מיקום היעד של הבקשה ומשמש כמחרוזת שאילתה. אם מסופקת גם שאילתה, היא מצורפת למחרוזת הסוג המותאמת לשוק המקומי. תוצאות מסוג אחר מושמטות מהתשובה. אפשר להשתמש בשדה הזה כדי לבצע חיפושים קטגוריים שלא תלויים בשפה או באזור. הסוגים התקינים מפורטים |