Places Widgets

המחלקה PlaceAutocompleteElement

class google.maps.places.PlaceAutocompleteElement extends HTMLElement implements PlaceAutocompleteElementOptions
library "places"

‫PlaceAutocompleteElement הוא תת-מחלקה של HTMLElement שמספקת רכיב ממשק משתמש ל-API של השלמה אוטומטית למקומות.

הרכיב PlaceAutocompleteElement משתמש באופן אוטומטי ב-AutocompleteSessionToken באופן פנימי כדי לקבץ את שלבי השאילתה והבחירה של חיפוש בהשלמה אוטומטית של משתמש.

הקריאה הראשונה ל-Place.fetchFields ב-Place שמוחזר על ידי PlacePrediction.toPlace תכלול באופן אוטומטי את הטוקן לסשן ששימש לאחזור של PlacePrediction.

מידע נוסף על אופן הפעולה של טוקנים לסשן זמין בכתובת https://developers.google.com/maps/documentation/places/web-service/place-session-tokens.

<gmp-place-autocomplete
  description="string"
  disabled
  future-opening-businesses-included
  included-primary-types="type1 type2 type3..."
  included-region-codes="c1 c2 c3..."
  internal-usage-attribution-ids="space separated strings"
  maxlength="number"
  name="string"
  no-clear-button
  no-input-icon
  origin="lat,lng"
  placeholder="string"
  pure-service-area-businesses-included
  readonly
  requested-language="string"
  requested-region="string"
  unit-system="value-name">
</gmp-place-autocomplete>
const {PlaceAutocompleteElement} = await google.maps.importLibrary("places");
PlaceAutocompleteElement
PlaceAutocompleteElement([options])
פרמטרים:
description
attr: description
סוג: string optional
התיאור שישמש לרכיב הקלט. קוראי מסך יזהו את זה כשהמיקוד יהיה על רכיב הקלט. פרטים נוספים זמינים בכתובת https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-describedby.
מאפיין HTML: description="string"
disabled
attr: disabled
סוג הקלט: boolean optional
סוג הפלט: boolean
אם רכיב הקלט מושבת. פרטים נוספים זמינים בכתובת https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#disabled.
מאפיין HTML: disabled
futureOpeningBusinessesIncluded
attr: future-opening-businesses-included
סוג: boolean optional
האם לכלול מקומות שעדיין לא נפתחו אבל צפויים להיפתח בעתיד.
מאפיין HTML: future-opening-businesses-included
includedPrimaryTypes
attr: included-primary-types
סוג: Array<string> optional
סוג המקום הראשי שנכלל (לדוגמה, "מסעדה" או "תחנת דלק").

מקום יוחזר רק אם הסוג הראשי שלו נכלל ברשימה הזו. אפשר לציין עד 5 ערכים. אם לא מציינים סוגים, מוחזרים כל סוגי המקומות.
מאפיין HTML: included-primary-types="type1 type2 type3..."
includedRegionCodes
attr: included-region-codes
סוג: Array<string> optional
הצגת תוצאות רק באזורים שצוינו, שמוגדרים כעד 15 קודי אזור של CLDR באורך שני תווים. קבוצה ריקה לא תגביל את התוצאות. אם גם locationRestriction וגם includedRegionCodes מוגדרים, התוצאות יהיו באזור החיתוך.
מאפיין HTML: included-region-codes="c1 c2 c3..."
internalUsageAttributionIds
attr: internal-usage-attribution-ids
סוג הקלט: Iterable<string> optional
סוג הפלט: Array<string> optional
מזהים שמשמשים לשיוך קריאות לחבילות ספציפיות או לספריות OSS.
מאפיין HTML: internal-usage-attribution-ids="space separated strings"
locationBias
סוג: LocationBias optional
גבול רך או רמז לשימוש בחיפוש מקומות.
locationRestriction
סוג: LocationRestriction optional
גבולות להגבלת תוצאות החיפוש.
maxlength
attr: maxlength
סוג: number optional
מספר התווים המקסימלי שהמשתמש יכול להזין. פרטים נוספים זמינים בכתובת https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#maxlength.
מאפיין HTML: maxlength="number"
name
attr: name
סוג: string optional
השם שבו יש להשתמש עבור רכיב הקלט. פרטים נוספים זמינים בכתובת https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#name. ההתנהגות זהה לזו של מאפיין השם של הקלט. שימו לב שזה השם שיופיע כשהטופס יישלח. פרטים נוספים זמינים בכתובת https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form.
מאפיין HTML: name="string"
noClearButton
attr: no-clear-button
סוג הקלט: boolean optional
סוג הפלט: boolean
אם להסתיר את כפתור הניקוי.
מאפיין HTML: no-clear-button
noInputIcon
attr: no-input-icon
סוג הקלט: boolean optional
סוג הפלט: boolean
ההגדרה הזו קובעת אם להסתיר את סמל הקלט.
מאפיין HTML: no-input-icon
origin
attr: origin
סוג הקלט: LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional
סוג הפלט: LatLngAltitude optional
נקודת המוצא שממנה מחושב המרחק. אם לא מציינים מיקום, המערכת לא מחשבת את המרחק. אם מצוין גובה, הוא לא משמש לחישוב.
מאפיין HTML:
  • origin="lat,lng"
  • origin="lat,lng,altitude"
placeholder
attr: placeholder
סוג: string optional
הטקסט לדוגמה שיוצג ברכיב הקלט. פרטים נוספים זמינים בכתובת https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#placeholder.
מאפיין HTML: placeholder="string"
pureServiceAreaBusinessesIncluded
attr: pure-service-area-businesses-included
סוג: boolean optional
האם לכלול מקומות שהם עסקים שנותנים שירות באזור מוגדר (SAB) בלבד.
מאפיין HTML: pure-service-area-businesses-included
readonly
attr: readonly
סוג הקלט: boolean optional
סוג הפלט: boolean
אם רכיב הקלט הוא לקריאה בלבד. פרטים נוספים זמינים בכתובת https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#readonly.
מאפיין HTML: readonly
requestedLanguage
attr: requested-language
סוג: string optional
מזהה השפה שבה התוצאות צריכות להופיע, אם אפשר. יכול להיות שתוצאות בשפה שנבחרה יקבלו דירוג גבוה יותר, אבל ההצעות לא מוגבלות לשפה הזו. כאן אפשר לעיין ברשימת השפות הנתמכות.
מאפיין HTML: requested-language="string"
requestedRegion
attr: requested-region
סוג: string optional
קוד אזור שמשמש לעיצוב ולסינון של התוצאות. ההצעות לא מוגבלות למדינה הזו. קוד האזור מקבל ערך ccTLD (דומיין ברמה העליונה) באורך שני תווים. רוב קודי ה-ccTLD זהים לקודי ISO 3166-1, עם כמה חריגים בולטים. לדוגמה, ה-ccTLD של בריטניה הוא uk‏ (.co.uk) וקוד ה-ISO 3166-1 שלה הוא gb (מבחינה טכנית, עבור הישות "הממלכה המאוחדת של בריטניה הגדולה וצפון אירלנד").
מאפיין HTML: requested-region="string"
unitSystem
attr: unit-system
סוג הקלט: UnitSystem optional
סוג הפלט: UnitSystem optional
מערכת היחידות שמשמשת להצגת מרחקים. אם לא מציינים מערכת יחידות, היא נקבעת לפי requestedRegion.
מאפיין HTML: unit-system="value-name"
value
סוג הקלט: string optional
סוג הפלט: string
הערך של רכיב הקלט.
clear-icon
ממקם את הרכיב עם החריץ במיקום של סמל הניקוי. כפתור הניקוי מוצג בסוף תיבת הקלט כשיש טקסט בקלט.
input-icon
ממקם את הרכיב עם החריץ במיקום של סמל הקלט. סמל הקלט מוצג בתחילת תיבת הקלט במצב מוטבע.
prediction-item-icon
המשבצת הזו מקבלת בדיוק רכיב <template> אחד שיוצג כסמל לצד פריט החיזוי.
focus-ring
הרכיב שמשמש להצגת טבעת המיקוד מסביב לרכיב שבמיקוד (קלט או פריטי חיזוי)
input
רכיב הקלט של רכיב ההשלמה האוטומטית.
prediction-item
פריט בתפריט הנפתח של החיזויים שמייצג חיזוי אחד.
prediction-item-icon
הסמל שמוצג מימין לכל פריט ברשימת החיזויים.
prediction-item-main-text
חלק מ-prediction-item שהוא הטקסט הראשי של החיזוי. במיקומים גיאוגרפיים, השדה הזה מכיל שם של מקום, כמו "תל אביב", או שם רחוב ומספר, כמו "רחוב המלך ג'ורג' 10". כברירת מחדל, הטקסט הראשי של פריט החיזוי הוא בצבע שחור. אם יש טקסט נוסף ב-prediction-item, הוא נמצא מחוץ ל-prediction-item-main-text והסגנון שלו עובר בירושה מ-prediction-item. כברירת מחדל, הוא בצבע אפור. הטקסט הנוסף הוא בדרך כלל כתובת.
prediction-item-match
החלק של החיזוי שהוחזר שתואם לקלט של המשתמש. כברירת מחדל, הטקסט התואם מודגש. שימו לב שהטקסט התואם מודגש רק בתוך prediction-item-main-text.
prediction-item-nonmatch
החלק בטקסט הראשי של החיזוי שלא תואם לקלט של המשתמש.
prediction-item-secondary-text
חלק מפריט החיזוי שהוא הטקסט המשני של החיזוי. הטקסט הנוסף הוא בדרך כלל כתובת.
prediction-item-selected
הפריט כשהמשתמש מנווט אליו באמצעות המקלדת. הערה: הפריטים שנבחרו יושפעו גם מהסגנונות של החלק הזה וגם מהסגנונות של החלק prediction-item.
prediction-list
הרכיב החזותי שמכיל את רשימת החיזויים שהוחזרו על ידי שירות ההשלמה האוטומטית למקומות. הרשימה הזו מופיעה כרשימה נפתחת מתחת ל-PlaceAutocompleteElement.
background-color
מבטל את צבע הרקע של הרכיב.
border
מבטל את הגבול של הרכיב.
border-radius
מבטל את רדיוס הגבולות של הרכיב.
color
משנה את הגופן של הרכיב.
color-scheme
מציין באיזו ערכת צבעים אפשר להציג את הרכיב הזה. פרטים נוספים זמינים במסמכי התיעוד של color-scheme. ברירת המחדל היא color-scheme: light dark.
font
משנה את הגופן של הרכיב.
font-family
משנה את הגופן של הרכיב.
font-size
משנה את הגופן של הרכיב.
font-style
משנה את הגופן של הרכיב.
font-weight
משנה את הגופן של הרכיב.
line-height
משנה את הגופן של הרכיב.
בירושה: addEventListener, removeEventListener
gmp-error
function(errorEvent)
ארגומנטים:
  • errorEvent: Event optional
האירוע הזה מופעל כשבקשה לקצה העורפי נדחתה (למשל, מפתח API שגוי). האירוע הזה לא מבעבע.
gmp-select
function(placePredictionSelectEvent)
ארגומנטים:
האירוע הזה מופעל כשמשתמש בוחר חיזוי מקום. מכיל אובייקט PlacePrediction שאפשר להמיר לאובייקט Place.

ממשק PlaceAutocompleteElementOptions

ממשק google.maps.places.PlaceAutocompleteElementOptions
מיושם על ידי PlaceAutocompleteElement

אפשרויות ליצירת PlaceAutocompleteElement. לתיאור של כל מאפיין, עיינו במאפיין עם אותו שם בכיתה PlaceAutocompleteElement.

description
אופציונלי
סוג: string optional
התיאור שישמש לרכיב הקלט. קוראי מסך יזהו את זה כשהמיקוד יהיה על רכיב הקלט.
disabled
אופציונלי
סוג: boolean optional
futureOpeningBusinessesIncluded
אופציונלי
סוג: boolean optional
includedPrimaryTypes
אופציונלי
סוג: Array<string> optional
includedRegionCodes
אופציונלי
סוג: Array<string> optional
internalUsageAttributionIds
אופציונלי
סוג: Iterable<string> optional
locationBias
אופציונלי
סוג: LocationBias optional
locationRestriction
אופציונלי
סוג: LocationRestriction optional
maxlength
אופציונלי
סוג: number optional
name
אופציונלי
סוג: string optional
noClearButton
אופציונלי
סוג: boolean optional
noInputIcon
אופציונלי
סוג: boolean optional
origin
אופציונלי
placeholder
אופציונלי
סוג: string optional
pureServiceAreaBusinessesIncluded
אופציונלי
סוג: boolean optional
readonly
אופציונלי
סוג: boolean optional
requestedLanguage
אופציונלי
סוג: string optional
requestedRegion
אופציונלי
סוג: string optional
unitSystem
אופציונלי
סוג: UnitSystem optional
value
אופציונלי
סוג: string optional
הערך של רכיב הקלט.

המחלקה PlacePredictionSelectEvent

class google.maps.places.PlacePredictionSelectEvent extends Event
library "places"

האירוע הזה נוצר אחרי שהמשתמש בוחר פריט חיזוי באמצעות PlaceAutocompleteElement. כדי לגשת לבחירה, לוחצים על event.placePrediction.

ממירים את placePrediction ל-Place באמצעות קריאה ל-PlacePrediction.toPlace.

const {PlacePredictionSelectEvent} = await google.maps.importLibrary("places");
placePrediction
readonly
כדי להמיר את זה ל-Place, צריך להתקשר למספר PlacePrediction.toPlace.

המחלקה BasicPlaceAutocompleteElement

class google.maps.places.BasicPlaceAutocompleteElement extends HTMLElement implements BasicPlaceAutocompleteElementOptions
library "places"

‫BasicPlaceAutocompleteElement הוא תת-מחלקה של HTMLElement שמספקת רכיב ממשק משתמש ל-API של השלמה אוטומטית למקומות.

<gmp-basic-place-autocomplete
  description="string"
  disabled
  future-opening-businesses-included
  included-primary-types="type1 type2 type3..."
  included-region-codes="c1 c2 c3..."
  internal-usage-attribution-ids="space separated strings"
  maxlength="number"
  name="string"
  no-clear-button
  no-input-icon
  origin="lat,lng"
  placeholder="string"
  pure-service-area-businesses-included
  readonly
  requested-language="string"
  requested-region="string"
  unit-system="value-name">
</gmp-basic-place-autocomplete>
const {BasicPlaceAutocompleteElement} = await google.maps.importLibrary("places");
BasicPlaceAutocompleteElement
BasicPlaceAutocompleteElement([options])
פרמטרים:
description
attr: description
סוג: string optional
התיאור שישמש לרכיב הקלט. קוראי מסך יזהו את זה כשהמיקוד יהיה על רכיב הקלט. פרטים נוספים זמינים בכתובת https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-describedby.
מאפיין HTML: description="string"
disabled
attr: disabled
סוג הקלט: boolean optional
סוג הפלט: boolean
אם רכיב הקלט מושבת. פרטים נוספים זמינים בכתובת https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#disabled.
מאפיין HTML: disabled
futureOpeningBusinessesIncluded
attr: future-opening-businesses-included
סוג: boolean optional
האם לכלול מקומות שעדיין לא נפתחו אבל צפויים להיפתח בעתיד.
מאפיין HTML: future-opening-businesses-included
includedPrimaryTypes
attr: included-primary-types
סוג: Array<string> optional
סוג המקום הראשי שנכלל (לדוגמה, "מסעדה" או "תחנת דלק").

מקום יוחזר רק אם הסוג הראשי שלו נכלל ברשימה הזו. אפשר לציין עד 5 ערכים. אם לא מציינים סוגים, מוחזרים כל סוגי המקומות.
מאפיין HTML: included-primary-types="type1 type2 type3..."
includedRegionCodes
attr: included-region-codes
סוג: Array<string> optional
הצגת תוצאות רק באזורים שצוינו, שמוגדרים כעד 15 קודי אזור של CLDR באורך שני תווים. קבוצה ריקה לא תגביל את התוצאות. אם גם locationRestriction וגם includedRegionCodes מוגדרים, התוצאות יהיו באזור החיתוך.
מאפיין HTML: included-region-codes="c1 c2 c3..."
internalUsageAttributionIds
attr: internal-usage-attribution-ids
סוג הקלט: Iterable<string> optional
סוג הפלט: Array<string> optional
מזהים שמשמשים לשיוך קריאות לחבילות ספציפיות או לספריות OSS.
מאפיין HTML: internal-usage-attribution-ids="space separated strings"
locationBias
סוג: LocationBias optional
גבול רך או רמז לשימוש בחיפוש מקומות.
locationRestriction
סוג: LocationRestriction optional
גבולות להגבלת תוצאות החיפוש.
maxlength
attr: maxlength
סוג: number optional
מספר התווים המקסימלי שהמשתמש יכול להזין. פרטים נוספים זמינים בכתובת https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#maxlength.
מאפיין HTML: maxlength="number"
name
attr: name
סוג: string optional
השם שבו יש להשתמש עבור רכיב הקלט. פרטים נוספים זמינים בכתובת https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#name. ההתנהגות זהה לזו של מאפיין השם של הקלט. שימו לב שזה השם שיופיע כשהטופס יישלח. פרטים נוספים זמינים בכתובת https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form.
מאפיין HTML: name="string"
noClearButton
attr: no-clear-button
סוג הקלט: boolean optional
סוג הפלט: boolean
אם להסתיר את כפתור הניקוי.
מאפיין HTML: no-clear-button
noInputIcon
attr: no-input-icon
סוג הקלט: boolean optional
סוג הפלט: boolean
ההגדרה הזו קובעת אם להסתיר את סמל הקלט.
מאפיין HTML: no-input-icon
origin
attr: origin
סוג הקלט: LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional
סוג הפלט: LatLngAltitude optional
נקודת המוצא שממנה מחושב המרחק. אם לא מציינים מיקום, המערכת לא מחשבת את המרחק. אם מצוין גובה, הוא לא משמש לחישוב.
מאפיין HTML:
  • origin="lat,lng"
  • origin="lat,lng,altitude"
placeholder
attr: placeholder
סוג: string optional
הטקסט לדוגמה שיוצג ברכיב הקלט. פרטים נוספים זמינים בכתובת https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#placeholder.
מאפיין HTML: placeholder="string"
pureServiceAreaBusinessesIncluded
attr: pure-service-area-businesses-included
סוג: boolean optional
האם לכלול מקומות שהם עסקים שנותנים שירות באזור מוגדר (SAB) בלבד.
מאפיין HTML: pure-service-area-businesses-included
readonly
attr: readonly
סוג הקלט: boolean optional
סוג הפלט: boolean
אם רכיב הקלט הוא לקריאה בלבד. פרטים נוספים זמינים בכתובת https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#readonly.
מאפיין HTML: readonly
requestedLanguage
attr: requested-language
סוג: string optional
מזהה השפה שבה התוצאות צריכות להופיע, אם אפשר. יכול להיות שתוצאות בשפה שנבחרה יקבלו דירוג גבוה יותר, אבל ההצעות לא מוגבלות לשפה הזו. כאן אפשר לעיין ברשימת השפות הנתמכות.
מאפיין HTML: requested-language="string"
requestedRegion
attr: requested-region
סוג: string optional
קוד אזור שמשמש לעיצוב ולסינון של התוצאות. ההצעות לא מוגבלות למדינה הזו. קוד האזור מקבל ערך ccTLD (דומיין ברמה העליונה) באורך שני תווים. רוב קודי ה-ccTLD זהים לקודי ISO 3166-1, עם כמה חריגים בולטים. לדוגמה, ה-ccTLD של בריטניה הוא uk‏ (.co.uk) וקוד ה-ISO 3166-1 שלה הוא gb (מבחינה טכנית, עבור הישות "הממלכה המאוחדת של בריטניה הגדולה וצפון אירלנד").
מאפיין HTML: requested-region="string"
unitSystem
attr: unit-system
סוג הקלט: UnitSystem optional
סוג הפלט: UnitSystem optional
מערכת היחידות שמשמשת להצגת מרחקים. אם לא מציינים מערכת יחידות, היא נקבעת לפי requestedRegion.
מאפיין HTML: unit-system="value-name"
clear-icon
ממקם את הרכיב עם החריץ במיקום של סמל הניקוי. כפתור הניקוי מוצג בסוף תיבת הקלט כשיש טקסט בקלט.
input-icon
ממקם את הרכיב עם החריץ במיקום של סמל הקלט. סמל הקלט מוצג בתחילת תיבת הקלט במצב מוטבע.
prediction-item-icon
המשבצת הזו מקבלת בדיוק רכיב <template> אחד שיוצג כסמל לצד פריט החיזוי.
focus-ring
הרכיב שמשמש להצגת טבעת המיקוד מסביב לרכיב שבמיקוד (קלט או פריטי חיזוי)
input
רכיב הקלט של רכיב ההשלמה האוטומטית.
prediction-item
פריט בתפריט הנפתח של החיזויים שמייצג חיזוי אחד.
prediction-item-icon
הסמל שמוצג מימין לכל פריט ברשימת החיזויים.
prediction-item-main-text
חלק מ-prediction-item שהוא הטקסט הראשי של החיזוי. במיקומים גיאוגרפיים, השדה הזה מכיל שם של מקום, כמו "תל אביב", או שם רחוב ומספר, כמו "רחוב המלך ג'ורג' 10". כברירת מחדל, הטקסט הראשי של פריט החיזוי הוא בצבע שחור. אם יש טקסט נוסף ב-prediction-item, הוא נמצא מחוץ ל-prediction-item-main-text והסגנון שלו עובר בירושה מ-prediction-item. כברירת מחדל, הוא בצבע אפור. הטקסט הנוסף הוא בדרך כלל כתובת.
prediction-item-match
החלק של החיזוי שהוחזר שתואם לקלט של המשתמש. כברירת מחדל, הטקסט התואם מודגש. שימו לב שהטקסט התואם מודגש רק בתוך prediction-item-main-text.
prediction-item-nonmatch
החלק בטקסט הראשי של החיזוי שלא תואם לקלט של המשתמש.
prediction-item-secondary-text
חלק מפריט החיזוי שהוא הטקסט המשני של החיזוי. הטקסט הנוסף הוא בדרך כלל כתובת.
prediction-item-selected
הפריט כשהמשתמש מנווט אליו באמצעות המקלדת. הערה: הפריטים שנבחרו יושפעו גם מהסגנונות של החלק הזה וגם מהסגנונות של החלק prediction-item.
prediction-list
הרכיב החזותי שמכיל את רשימת החיזויים שהוחזרו על ידי שירות ההשלמה האוטומטית למקומות. הרשימה הזו מופיעה כרשימה נפתחת מתחת ל-PlaceAutocompleteElement.
background-color
מבטל את צבע הרקע של הרכיב.
border
מבטל את הגבול של הרכיב.
border-radius
מבטל את רדיוס הגבולות של הרכיב.
color
משנה את הגופן של הרכיב.
color-scheme
מציין באיזו ערכת צבעים אפשר להציג את הרכיב הזה. פרטים נוספים זמינים במסמכי התיעוד של color-scheme. ברירת המחדל היא color-scheme: light dark.
font
משנה את הגופן של הרכיב.
font-family
משנה את הגופן של הרכיב.
font-size
משנה את הגופן של הרכיב.
font-style
משנה את הגופן של הרכיב.
font-weight
משנה את הגופן של הרכיב.
line-height
משנה את הגופן של הרכיב.
בירושה: addEventListener, removeEventListener
gmp-error
function(errorEvent)
ארגומנטים:
  • errorEvent: Event optional
האירוע הזה מופעל כשבקשה לקצה העורפי נדחתה (למשל, מפתח API שגוי). האירוע הזה לא מבעבע.
gmp-select
function(placeSelectEvent)
ארגומנטים:
האירוע הזה מופעל כשמשתמש בוחר חיזוי מקום. מכיל אובייקט Place.

ממשק BasicPlaceAutocompleteElementOptions

ממשק google.maps.places.BasicPlaceAutocompleteElementOptions
מיושם על ידי BasicPlaceAutocompleteElement

אפשרויות ליצירת BasicPlaceAutocompleteElement.

description
אופציונלי
סוג: string optional
התיאור שישמש לרכיב הקלט. קוראי מסך יזהו את זה כשהמיקוד יהיה על רכיב הקלט.
disabled
אופציונלי
סוג: boolean optional
futureOpeningBusinessesIncluded
אופציונלי
סוג: boolean optional
includedPrimaryTypes
אופציונלי
סוג: Array<string> optional
includedRegionCodes
אופציונלי
סוג: Array<string> optional
internalUsageAttributionIds
אופציונלי
סוג: Iterable<string> optional
locationBias
אופציונלי
סוג: LocationBias optional
locationRestriction
אופציונלי
סוג: LocationRestriction optional
maxlength
אופציונלי
סוג: number optional
name
אופציונלי
סוג: string optional
noClearButton
אופציונלי
סוג: boolean optional
noInputIcon
אופציונלי
סוג: boolean optional
origin
אופציונלי
placeholder
אופציונלי
סוג: string optional
pureServiceAreaBusinessesIncluded
אופציונלי
סוג: boolean optional
readonly
אופציונלי
סוג: boolean optional
requestedLanguage
אופציונלי
סוג: string optional
requestedRegion
אופציונלי
סוג: string optional
unitSystem
אופציונלי
סוג: UnitSystem optional

המחלקה PlaceDetailsElement

class google.maps.places.PlaceDetailsElement extends HTMLElement implements PlaceDetailsElementOptions
extended by AdvancedPlaceDetailsElement
library "places"

הצגת פרטים של מקום בפריסה מלאה. מוסיפים PlaceDetailsPlaceRequestElement או PlaceDetailsLocationRequestElement כדי לציין את המקום שרוצים לעבד. כדי לציין איזה תוכן לעבד, מוסיפים PlaceContentConfigElement,‏ PlaceStandardContentElement או PlaceAllContentElement.

דוגמה:

 <gmp-place-details>
  <gmp-place-details-place-request
    place="PLACE_ID"
  ></gmp-place-details-place-request>
  <gmp-place-content-config>
    <gmp-place-media lightbox-preferred></gmp-place-media>
  </gmp-place-content-config>
</gmp-place-details>

כדי להשתמש ברכיב הזה, צריך להפעיל את Places UI Kit API בפרויקט במסוף Google Cloud.

<gmp-place-details
  internal-usage-attribution-ids="space separated strings">
</gmp-place-details>
const {PlaceDetailsElement} = await google.maps.importLibrary("places");
PlaceDetailsElement
PlaceDetailsElement([options])
פרמטרים:
internalUsageAttributionIds
attr: internal-usage-attribution-ids
סוג הקלט: Iterable<string> optional
סוג הפלט: Array<string> optional
מזהים שמשמשים לשיוך קריאות לחבילות ספציפיות או לספריות OSS.
מאפיין HTML: internal-usage-attribution-ids="space separated strings"
place
readonly
סוג: Place optional
לקריאה בלבד. אובייקט של מקום שמכיל את המזהה, המיקום וחלון התצוגה של המקום שמוצג כרגע.
--gmp-button-border-color
צבע הגבול של הכפתור "פתיחה במפות".
--gmp-button-border-radius
רדיוס הגבול של הכפתור "פתיחה במפות Google".
--gmp-button-border-width
רוחב הגבול של הכפתור "פתיחה במפות Google".
--gmp-collage-border-radius-outer
רדיוס הגבול של הפינות החיצוניות של קולאז' המדיה.
--gmp-dialog-border-radius
רדיוס הגבול של תיבת הדו-שיח של גילוי נאות במפות Google.
--gmp-mat-color-disabled-surface
צבע הרקע שנועד להעביר מצבים מושבתים או חוסר נוכחות. משמש לכוכבי ביקורת ריקים.
--gmp-mat-color-info
צבע של רכיבים בממשק המשתמש עם סנטימנט אינפורמטיבי. משמש לסמל של כיסא הגלגלים.
--gmp-mat-color-negative
הצבע של רכיבים בממשק המשתמש עם סנטימנט שלילי. הטקסט "סגור" בסטטוס "פתוח עכשיו".
--gmp-mat-color-neutral-container
צבע הקונטיינר של רכיבים ניטרליים בממשק המשתמש. משמש לפלייסהולדרים של תמונות ולתג של תאריך פרסום הביקורת.
--gmp-mat-color-on-neutral-container
צבע הטקסט והסמלים לעומת צבע המאגר הניטרלי. משמש לתג של תאריך פרסום הביקורת ולתג של זמינות מטען לרכב חשמלי כשהוא לא זמין.
--gmp-mat-color-on-positive-container
צבע הטקסטים והסמלים לעומת צבע המכל החיובי. הערך הזה משמש לתג הזמינות של מטען לרכב חשמלי, אם הוא זמין.
--gmp-mat-color-on-secondary-container
צבע הטקסט והסמלים ביחס לצבע המשני של הצורה. משמש לטקסט ולסמלים בלחצן "פתיחה במפות".
--gmp-mat-color-on-surface
צבע לטקסט ולסמלים על כל צבע רקע. משמש לטקסט רגיל.
--gmp-mat-color-on-surface-variant
צבע פחות מודגש לטקסט ולסמלים על כל צבע משטח. משמש לטקסט פחות מודגש.
--gmp-mat-color-outline-decorative
צבע קו המתאר של רכיבים לא אינטראקטיביים. משמש לגבול של הרכיב.
--gmp-mat-color-positive
הצבע של רכיבים בממשק המשתמש עם סנטימנט חיובי. הטקסט "פתוח" בסטטוס "פתוח עכשיו".
--gmp-mat-color-positive-container
צבע המאגר של רכיבים בממשק המשתמש שמביעים רגש חיובי. הערך הזה משמש לתג הזמינות של מטען לרכב חשמלי, אם הוא זמין.
--gmp-mat-color-primary
הצבע של הטקסט והסמלים האינטראקטיביים לעומת צבע המשטח. משמש למספר הביקורות, לקישורים בתיבת הדו-שיח של הגילויים הנאותים במפות Google, לקישור לאתר, לסמלים בכרטיסייה "סקירה כללית" ולצבע הטקסט, המיקוד והמעבר מעל הכותרות בסרגל הכרטיסיות.
--gmp-mat-color-secondary-container
צבע מילוי פחות בולט על פני השטח, לרכיבים פחות בולטים כמו כפתורים בצבע אחד. משמש לרקע של הלחצן "פתיחה במפות Google".
--gmp-mat-color-surface
צבע לרקעים. משמש לרקעים של הרכיב ולתיבת הדו-שיח של גילוי נאות במפות Google.
--gmp-mat-font-body-medium
משמש לכתובת, לדירוג, לסוג, למחיר, לסטטוס "פתוח עכשיו", לשעות הפתיחה, לביקורת, למספר הטלפון, לאתר, ל-Plus Code, לתכונות המובילות ולטקסט הראשי בתיבת הדו-שיח של הגילוי הנאות במפות Google.
--gmp-mat-font-body-small
הטקסט הזה משמש כגוף הטקסט ברשימת התכונות בכרטיסייה "מידע כללי".
--gmp-mat-font-display-small
משמש לשם המקום ולטקסט של כל כותרת תכונה בכרטיסייה "מידע כללי".
--gmp-mat-font-family
משפחת הגופנים הבסיסית שמשמשת לכל הטקסט.
--gmp-mat-font-headline-medium
משמש כטקסט הכותרת בתיבת הדו-שיח של גילוי נאות במפות Google.
--gmp-mat-font-label-large
הצבע הזה משמש לכותרות של הכרטיסיות, לכפתור "פתיחה במפות Google", לטקסט לציון קרדיט למשתמש שכתב את הביקורת בגלריית התמונות, לטקסט לציון קרדיט למשתמש שכתב את הביקורת בקטע הביקורות ולקישורים בתיבת הדו-שיח של הגילויים הנאותים במפות Google.
--gmp-mat-font-label-medium
משמש לתג של מספר התמונות ולתג של תאריך פרסום הביקורת.
--gmp-mat-font-title-small
משמש לכותרת של כל קטע בכרטיסייה "מידע כללי".
--gmp-mat-spacing-extra-large
משמש לריווח בתוך הרכיב, כמו השוליים והריפוד מסביב לטקסט.
--gmp-mat-spacing-extra-small
משמש לריווח בתוך הרכיב, כמו השוליים והריפוד מסביב לטקסט.
--gmp-mat-spacing-large
משמש לריווח בתוך הרכיב, כמו השוליים והריפוד מסביב לטקסט.
--gmp-mat-spacing-medium
משמש לריווח בתוך הרכיב, כמו השוליים והריפוד מסביב לטקסט.
--gmp-mat-spacing-small
משמש לריווח בתוך הרכיב, כמו השוליים והריפוד מסביב לטקסט.
--gmp-mat-spacing-two-extra-large
משמש לריווח בתוך הרכיב, כמו השוליים והריפוד מסביב לטקסט.
--gmp-star-rating-color
צבע הכוכבים המלאים בדירוג.
background-color
מבטל את צבע הרקע של הרכיב.
border
מבטל את הגבול של הרכיב.
border-radius
מבטל את רדיוס הגבולות של הרכיב.
color-scheme
מציין באיזו ערכת צבעים אפשר להציג את הרכיב הזה. פרטים נוספים זמינים במסמכי התיעוד של color-scheme. ברירת המחדל היא color-scheme: light dark.
font-size
משנה את הגודל של כל הטקסט והסמלים ברכיב, שמוגדרים באופן פנימי ב-em. ברירת המחדל היא 16px.
בירושה: addEventListener, removeEventListener
gmp-error
function(event)
ארגומנטים:
האירוע הזה מופעל כשבקשה לקצה העורפי נדחתה (למשל, מפתח API שגוי). האירוע הזה לא מבעבע.
gmp-load
function(event)
ארגומנטים:
האירוע הזה מופעל כשהרכיב נטען ומציג את התוכן שלו. האירוע הזה לא מבעבע.

ממשק PlaceDetailsElementOptions

ממשק google.maps.places.PlaceDetailsElementOptions
מורחב על ידי AdvancedPlaceDetailsElementOptions
מיושם על ידי AdvancedPlaceDetailsElement, PlaceDetailsElement

אפשרויות לגבי PlaceDetailsElement.

internalUsageAttributionIds
אופציונלי
סוג: Iterable<string> optional
מזהים שמשמשים לשיוך קריאות לחבילות ספציפיות או לספריות OSS.

המחלקה PlaceDetailsCompactElement

class google.maps.places.PlaceDetailsCompactElement extends HTMLElement implements PlaceDetailsCompactElementOptions
extended by AdvancedPlaceDetailsCompactElement
library "places"

הצגת פרטים על מקום בפריסה קומפקטית. מוסיפים PlaceDetailsPlaceRequestElement או PlaceDetailsLocationRequestElement כדי לציין את המקום שרוצים לעבד. כדי לציין איזה תוכן לעבד, מוסיפים PlaceContentConfigElement,‏ PlaceStandardContentElement או PlaceAllContentElement.

דוגמה:

 <gmp-place-details-compact>
  <gmp-place-details-place-request
    place="PLACE_ID"
  ></gmp-place-details-place-request>
  <gmp-place-content-config>
    <gmp-place-media lightbox-preferred></gmp-place-media>
  </gmp-place-content-config>
</gmp-place-details-compact>

כדי להשתמש ברכיב הזה, צריך להפעיל את Places UI Kit API בפרויקט במסוף Google Cloud.

<gmp-place-details-compact
  internal-usage-attribution-ids="space separated strings"
  orientation="value-name"
  truncation-preferred>
</gmp-place-details-compact>
const {PlaceDetailsCompactElement} = await google.maps.importLibrary("places");
PlaceDetailsCompactElement
PlaceDetailsCompactElement([options])
פרמטרים:
internalUsageAttributionIds
attr: internal-usage-attribution-ids
סוג הקלט: Iterable<string> optional
סוג הפלט: Array<string> optional
מזהים שמשמשים לשיוך קריאות לחבילות ספציפיות או לספריות OSS.
מאפיין HTML: internal-usage-attribution-ids="space separated strings"
orientation
attr: orientation
סוג: PlaceDetailsOrientation optional
ברירת המחדל: PlaceDetailsOrientation.VERTICAL
הכיוון (אנכי או אופקי) של הרכיב.
מאפיין HTML: orientation="value-name"
place
readonly
סוג: Place optional
לקריאה בלבד. אובייקט של מקום שמכיל את המזהה, המיקום וחלון התצוגה של המקום שמוצג כרגע.
truncationPreferred
attr: truncation-preferred
סוג הקלט: boolean optional
סוג הפלט: boolean
ברירת המחדל: false
אם הערך הוא true, השם והכתובת של המקום נחתכים כדי להתאים לשורה אחת במקום לעבור לשורה הבאה.
מאפיין HTML: truncation-preferred
--gmp-button-border-color
צבע הגבול של הכפתור "פתיחה במפות".
--gmp-button-border-radius
רדיוס הגבול של הכפתור "פתיחה במפות Google".
--gmp-button-border-width
רוחב הגבול של הכפתור "פתיחה במפות Google".
--gmp-dialog-border-radius
רדיוס הגבול של תיבת הדו-שיח של גילוי נאות במפות Google.
--gmp-mat-color-info
צבע של רכיבים בממשק המשתמש עם סנטימנט אינפורמטיבי. משמש לסמל של כיסא הגלגלים.
--gmp-mat-color-negative
הצבע של רכיבים בממשק המשתמש עם סנטימנט שלילי. הטקסט "סגור" בסטטוס "פתוח עכשיו".
--gmp-mat-color-neutral-container
צבע הקונטיינר של רכיבים ניטרליים בממשק המשתמש. משמש לפלייסהולדרים של תמונות.
--gmp-mat-color-on-secondary-container
צבע הטקסט והסמלים ביחס לצבע המשני של הצורה. משמש לטקסט ולסמלים בלחצן "פתיחה במפות".
--gmp-mat-color-on-surface
צבע לטקסט ולסמלים על כל צבע רקע. משמש לטקסט רגיל.
--gmp-mat-color-on-surface-variant
צבע פחות מודגש לטקסט ולסמלים על כל צבע משטח. משמש לטקסט פחות מודגש.
--gmp-mat-color-outline-decorative
צבע קו המתאר של רכיבים לא אינטראקטיביים. משמש לגבול של הרכיב.
--gmp-mat-color-positive
הצבע של רכיבים בממשק המשתמש עם סנטימנט חיובי. הטקסט "פתוח" בסטטוס "פתוח עכשיו".
--gmp-mat-color-primary
הצבע של הטקסט והסמלים האינטראקטיביים לעומת צבע המשטח. משמש לספירת הביקורות, וגם לקישורים בתיבת הדו-שיח של גילוי נאות במפות Google.
--gmp-mat-color-secondary-container
צבע מילוי פחות בולט על פני השטח, לרכיבים פחות בולטים כמו כפתורים בצבע אחד. משמש לרקע של הלחצן "פתיחה במפות Google".
--gmp-mat-color-surface
צבע לרקעים. משמש לרקעים של הרכיב ולתיבת הדו-שיח של גילוי נאות במפות Google.
--gmp-mat-font-body-medium
משמש לטקסט הראשי בתיבת הדו-שיח של גילוי נאות במפות Google.
--gmp-mat-font-body-small
משמש לכתובת, לדירוג, לסוג, למחיר ולסטטוס "פתוח עכשיו" של המקום.
--gmp-mat-font-family
משפחת הגופנים הבסיסית שמשמשת לכל הטקסט.
--gmp-mat-font-headline-medium
משמש כטקסט הכותרת בתיבת הדו-שיח של גילוי נאות במפות Google.
--gmp-mat-font-label-large
משמש ללחצן "פתיחה במפות Google", וגם לקישורים בתיבת הדו-שיח של גילוי נאות במפות Google ולטקסט לציון קרדיט למשתמש שכתב את הביקורת בגלריית התמונות.
--gmp-mat-font-label-medium
משמש לתג של ספירת התמונות.
--gmp-mat-font-title-small
משמש לשם המקום.
--gmp-mat-spacing-extra-small
משמש לריווח בתוך הרכיב, כמו השוליים והריפוד מסביב לטקסט.
--gmp-mat-spacing-large
משמש לריווח בתוך הרכיב, כמו השוליים והריפוד מסביב לטקסט.
--gmp-mat-spacing-medium
משמש לריווח בתוך הרכיב, כמו השוליים והריפוד מסביב לטקסט.
--gmp-mat-spacing-small
משמש לריווח בתוך הרכיב, כמו השוליים והריפוד מסביב לטקסט.
--gmp-star-rating-color
צבע הכוכבים המלאים בדירוג.
--gmp-thumbnail-border-radius
רדיוס הגבול של התמונה הממוזערת של המקום.
background-color
מבטל את צבע הרקע של הרכיב.
border
מבטל את הגבול של הרכיב.
border-radius
מבטל את רדיוס הגבולות של הרכיב.
color-scheme
מציין באיזו ערכת צבעים אפשר להציג את הרכיב הזה. פרטים נוספים זמינים במסמכי התיעוד של color-scheme. ברירת המחדל היא color-scheme: light dark.
font-size
משנה את הגודל של כל הטקסט והסמלים ברכיב, שמוגדרים באופן פנימי ב-em. ברירת המחדל היא 16px.
בירושה: addEventListener, removeEventListener
gmp-error
function(event)
ארגומנטים:
האירוע הזה מופעל כשבקשה לקצה העורפי נדחתה (למשל, מפתח API שגוי). האירוע הזה לא מבעבע.
gmp-load
function(event)
ארגומנטים:
האירוע הזה מופעל כשהרכיב נטען ומציג את התוכן שלו. האירוע הזה לא מבעבע.

הממשק PlaceDetailsCompactElementOptions

ממשק google.maps.places.PlaceDetailsCompactElementOptions
מורחב על ידי AdvancedPlaceDetailsCompactElementOptions
מיושם על ידי AdvancedPlaceDetailsCompactElement, PlaceDetailsCompactElement

אפשרויות לגבי PlaceDetailsCompactElement.

internalUsageAttributionIds
אופציונלי
סוג: Iterable<string> optional
מזהים שמשמשים לשיוך קריאות לחבילות ספציפיות או לספריות OSS.
orientation
אופציונלי
סוג: PlaceDetailsOrientation optional
truncationPreferred
אופציונלי
סוג: boolean optional

המחלקה AdvancedPlaceDetailsElement

class google.maps.places.AdvancedPlaceDetailsElement extends PlaceDetailsElement, HTMLElement implements AdvancedPlaceDetailsElementOptions, PlaceDetailsElementOptions
library "places"

הצגת פרטים של מקום בפריסה מלאה. מוסיפים PlaceDetailsPlaceRequestElement או PlaceDetailsLocationRequestElement כדי לציין את המקום שרוצים לעבד. כדי להגדיר את התוכן שיוצג, מוסיפים ישירות רכיב PlaceStandardContentElement, PlaceAllContentElement או פרטי מקום.

דוגמה:

 <gmp-advanced-place-details>
  <gmp-place-details-place-request
    place="PLACE_ID"
  ></gmp-place-details-place-request>
  <gmp-place-standard-content>
  </gmp-place-standard-content>
</gmp-advanced-place-details>

כדי להשתמש ברכיב הזה, צריך להפעיל את Places UI Kit API בפרויקט במסוף Google Cloud.

<gmp-advanced-place-details
  internal-usage-attribution-ids="space separated strings">
</gmp-advanced-place-details>
const {AdvancedPlaceDetailsElement} = await google.maps.importLibrary("places");
AdvancedPlaceDetailsElement
AdvancedPlaceDetailsElement([options])
פרמטרים:
internalUsageAttributionIds
attr: internal-usage-attribution-ids
סוג הקלט: Iterable<string> optional
סוג הפלט: Array<string> optional
מזהים שמשמשים לשיוך קריאות לחבילות ספציפיות או לספריות OSS.
מאפיין HTML: internal-usage-attribution-ids="space separated strings"
place
readonly
סוג: Place optional
לקריאה בלבד. אובייקט של מקום שמכיל את המזהה, המיקום וחלון התצוגה של המקום שמוצג כרגע.
action-corner
משבצת זמן ל-PlaceLinkElement ול-PlaceButtonElement.
action-main
משבצת זמן ל-PlaceLinkElement ול-PlaceButtonElement.
Alphabasic-section-bottom
משבצת לתוכן HTML מותאם אישית שמוצג בתחתית הקטע של המידע הבסיסי, ישירות מתחת לכפתורי הפעולה הראשיים.
Alphabasic-section-top
משבצת לתוכן HTML בהתאמה אישית שמוצג בקטע המידע הבסיסי, ישירות מעל שם המקום.
עברו בירושה: --gmp-button-border-color, --gmp-button-border-radius, --gmp-button-border-width, --gmp-collage-border-radius-outer, --gmp-dialog-border-radius, --gmp-mat-color-disabled-surface, --gmp-mat-color-info, --gmp-mat-color-negative, --gmp-mat-color-neutral-container, --gmp-mat-color-on-neutral-container, --gmp-mat-color-on-positive-container, --gmp-mat-color-on-secondary-container, --gmp-mat-color-on-surface, --gmp-mat-color-on-surface-variant, --gmp-mat-color-outline-decorative, --gmp-mat-color-positive, --gmp-mat-color-positive-container, --gmp-mat-color-primary, --gmp-mat-color-secondary-container, --gmp-mat-color-surface, --gmp-mat-font-body-medium, --gmp-mat-font-body-small, --gmp-mat-font-display-small, --gmp-mat-font-family, --gmp-mat-font-headline-medium, --gmp-mat-font-label-large, --gmp-mat-font-label-medium, --gmp-mat-font-title-small, --gmp-mat-spacing-extra-large, --gmp-mat-spacing-extra-small, --gmp-mat-spacing-large, --gmp-mat-spacing-medium, --gmp-mat-spacing-small, --gmp-mat-spacing-two-extra-large, --gmp-star-rating-color, background-color, border, border-radius, color-scheme, font-size
בירושה: addEventListener, removeEventListener
בירושה: gmp-error, gmp-load

ממשק AdvancedPlaceDetailsElementOptions

ממשק google.maps.places.AdvancedPlaceDetailsElementOptions מרחיב את PlaceDetailsElementOptions
מוטמע על ידי AdvancedPlaceDetailsElement

אפשרויות לגבי AdvancedPlaceDetailsElement.

internalUsageAttributionIds
אופציונלי
סוג: Iterable<string> optional
מזהים שמשמשים לשיוך קריאות לחבילות ספציפיות או לספריות OSS.

המחלקה AdvancedPlaceDetailsCompactElement

class google.maps.places.AdvancedPlaceDetailsCompactElement extends PlaceDetailsCompactElement, HTMLElement implements AdvancedPlaceDetailsCompactElementOptions, PlaceDetailsCompactElementOptions
library "places"

הצגת פרטים על מקום בפריסה קומפקטית. מוסיפים PlaceDetailsPlaceRequestElement או PlaceDetailsLocationRequestElement כדי לציין את המקום שרוצים לעבד. כדי להגדיר את התוכן לעיבוד, צריך להוסיף PlaceStandardContentElement, PlaceAllContentElement או לציין צאצאים ספציפיים של תוכן.

כדי להשתמש ברכיב הזה, צריך להפעיל את Places UI Kit API בפרויקט במסוף Google Cloud.

<gmp-advanced-place-details-compact
  internal-usage-attribution-ids="space separated strings">
</gmp-advanced-place-details-compact>
const {AdvancedPlaceDetailsCompactElement} = await google.maps.importLibrary("places");
AdvancedPlaceDetailsCompactElement
AdvancedPlaceDetailsCompactElement([options])
פרמטרים:
internalUsageAttributionIds
attr: internal-usage-attribution-ids
סוג הקלט: Iterable<string> optional
סוג הפלט: Array<string> optional
מזהים שמשמשים לשיוך קריאות לחבילות ספציפיות או לספריות OSS.
מאפיין HTML: internal-usage-attribution-ids="space separated strings"
place
readonly
סוג: Place optional
לקריאה בלבד. אובייקט של מקום שמכיל את המזהה, המיקום וחלון התצוגה של המקום שמוצג כרגע.
בירושה: orientation (מאפיין: orientation), truncationPreferred (מאפיין: truncation-preferred)
action-corner
משבצת זמן ל-PlaceLinkElement ול-PlaceButtonElement.
action-main
משבצת זמן ל-PlaceLinkElement ול-PlaceButtonElement.
Alphabasic-section-bottom
משבצת לתוכן HTML מותאם אישית שמוצג בתחתית הקטע של המידע הבסיסי, ישירות מתחת לכפתורי הפעולה הראשיים.
Alphabasic-section-top
משבצת לתוכן HTML בהתאמה אישית שמוצג בקטע המידע הבסיסי, ישירות מעל שם המקום.
עברו בירושה: --gmp-button-border-color, --gmp-button-border-radius, --gmp-button-border-width, --gmp-dialog-border-radius, --gmp-mat-color-info, --gmp-mat-color-negative, --gmp-mat-color-neutral-container, --gmp-mat-color-on-secondary-container, --gmp-mat-color-on-surface, --gmp-mat-color-on-surface-variant, --gmp-mat-color-outline-decorative, --gmp-mat-color-positive, --gmp-mat-color-primary, --gmp-mat-color-secondary-container, --gmp-mat-color-surface, --gmp-mat-font-body-medium, --gmp-mat-font-body-small, --gmp-mat-font-family, --gmp-mat-font-headline-medium, --gmp-mat-font-label-large, --gmp-mat-font-label-medium, --gmp-mat-font-title-small, --gmp-mat-spacing-extra-small, --gmp-mat-spacing-large, --gmp-mat-spacing-medium, --gmp-mat-spacing-small, --gmp-star-rating-color, --gmp-thumbnail-border-radius, background-color, border, border-radius, color-scheme, font-size
בירושה: addEventListener, removeEventListener
בירושה: gmp-error, gmp-load

ממשק AdvancedPlaceDetailsCompactElementOptions

ממשק google.maps.places.AdvancedPlaceDetailsCompactElementOptions מרחיב את PlaceDetailsCompactElementOptions
מוטמע על ידי AdvancedPlaceDetailsCompactElement

אפשרויות לגבי AdvancedPlaceDetailsCompactElement.

internalUsageAttributionIds
אופציונלי
סוג: Iterable<string> optional
מזהים שמשמשים לשיוך קריאות לחבילות ספציפיות או לספריות OSS.
בירושה: orientation, truncationPreferred

קבועים של PlaceDetailsOrientation

constants google.maps.places.PlaceDetailsOrientation
ספרייה "places"

וריאציות של כיוון המסך ב-PlaceDetailsCompactElement.

אפשר להשתמש בקבועים האלה גם כמחרוזות. ב-TypeScript, המחרוזות המילוליות מוגדרות לפי הסוג PlaceDetailsOrientationString.

const {PlaceDetailsOrientation} = await google.maps.importLibrary("places");
HORIZONTAL כיוון אופקי.
VERTICAL כיוון אנכי.

המחלקה PlaceDetailsPlaceRequestElement

class google.maps.places.PlaceDetailsPlaceRequestElement extends HTMLElement implements PlaceDetailsPlaceRequestElementOptions
library "places"

מגדיר PlaceDetailsCompactElement או PlaceDetailsElement לטעינת נתונים על סמך אובייקט, מזהה או שם משאב של מקום. כדי לטעון נתונים של המקום שצוין, צריך להוסיף את הרכיב הזה כצאצא של PlaceDetailsCompactElement או PlaceDetailsElement. לדוגמה:

 <gmp-place-details>
  <gmp-place-details-place-request
    place="PLACE_ID"
  ></gmp-place-details-place-request>
</gmp-place-details>

<gmp-place-details-place-request
  place="places/###">
</gmp-place-details-place-request>
const {PlaceDetailsPlaceRequestElement} = await google.maps.importLibrary("places");
PlaceDetailsPlaceRequestElement
PlaceDetailsPlaceRequestElement([options])
פרמטרים:
place
attr: place
סוג הקלט: Place|string optional
סוג הפלט: Place optional
ברירת המחדל: null
אובייקט המקום, המזהה או שם המשאב שרוצים להציג את הפרטים שלו ברכיב Place Details Compact. המאפיין הזה משקף את המאפיין כשם משאב.
מאפיין HTML: place="places/###"
בירושה: addEventListener, removeEventListener

ממשק PlaceDetailsPlaceRequestElementOptions

ממשק google.maps.places.PlaceDetailsPlaceRequestElementOptions
מיושם על ידי PlaceDetailsPlaceRequestElement

אפשרויות לגבי PlaceDetailsPlaceRequestElement.

place
אופציונלי
סוג: Place|string optional

המחלקה PlaceDetailsLocationRequestElement

class google.maps.places.PlaceDetailsLocationRequestElement extends HTMLElement implements PlaceDetailsLocationRequestElementOptions
library "places"

הגדרה של PlaceDetailsCompactElement או PlaceDetailsElement לטעינת נתונים על סמך מיקום. כדי לטעון נתונים של המיקום שצוין, צריך להוסיף את הרכיב הזה כצאצא של PlaceDetailsCompactElement או PlaceDetailsElement. לדוגמה:

 <gmp-place-details>
  <gmp-place-details-location-request
    location="37.6207665,-122.4284806"
  ></gmp-place-details-location-request>
</gmp-place-details>

<gmp-place-details-location-request
  location="lat,lng">
</gmp-place-details-location-request>
const {PlaceDetailsLocationRequestElement} = await google.maps.importLibrary("places");
PlaceDetailsLocationRequestElement
PlaceDetailsLocationRequestElement([options])
פרמטרים:
location
attr: location
סוג הקלט: LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional
סוג הפלט: LatLngAltitude optional
ברירת המחדל: null
המיקום שבו יוצגו הפרטים ברכיב Place Details. הפונקציה מנרמלת ל-LatLngAltitude.
מאפיין HTML: location="lat,lng"
בירושה: addEventListener, removeEventListener

ממשק PlaceDetailsLocationRequestElementOptions

ממשק google.maps.places.PlaceDetailsLocationRequestElementOptions
מיושם על ידי PlaceDetailsLocationRequestElement

אפשרויות לגבי PlaceDetailsLocationRequestElement.

location
אופציונלי
המיקום שבו רוצים להציג את המקום.

המחלקה PlaceSearchElement

class google.maps.places.PlaceSearchElement extends HTMLElement implements PlaceSearchElementOptions
extended by AdvancedPlaceSearchElement
library "places"

הצגת התוצאות של חיפוש מקומות ברשימה. מוסיפים PlaceTextSearchRequestElement או PlaceNearbySearchRequestElement כדי לציין את הבקשה שרוצים להציג את התוצאות שלה. כדי לציין איזה תוכן לעבד, מוסיפים PlaceContentConfigElement,‏ PlaceStandardContentElement או PlaceAllContentElement.

דוגמה:

 <gmp-place-search>
  <gmp-place-text-search-request
    text-query="QUERY"
  ></gmp-place-text-search-request>
  <gmp-place-content-config>
    <gmp-place-media lightbox-preferred></gmp-place-media>
  </gmp-place-content-config>
</gmp-place-search>

כדי להשתמש ברכיב חיפוש מקומות, צריך להפעיל את Places UI Kit API בפרויקט במסוף Google Cloud.

<gmp-place-search
  attribution-position="value-name"
  internal-usage-attribution-ids="space separated strings"
  orientation="value-name"
  selectable
  truncation-preferred>
</gmp-place-search>
const {PlaceSearchElement} = await google.maps.importLibrary("places");
PlaceSearchElement
PlaceSearchElement([options])
פרמטרים:
attributionPosition
attr: attribution-position
סוג הקלט: PlaceSearchAttributionPosition optional
סוג הפלט: PlaceSearchAttributionPosition
ברירת המחדל: PlaceSearchAttributionPosition.TOP
המיקום של לוגו השיוך (Attribution) וכפתור הגילוי הנאות כנדרש בחוק.
מאפיין HTML: attribution-position="value-name"
internalUsageAttributionIds
attr: internal-usage-attribution-ids
סוג הקלט: Iterable<string> optional
סוג הפלט: Array<string> optional
מזהים שמשמשים לשיוך קריאות לחבילות ספציפיות או לספריות OSS.
מאפיין HTML: internal-usage-attribution-ids="space separated strings"
orientation
attr: orientation
סוג הקלט: PlaceSearchOrientation optional
סוג הפלט: PlaceSearchOrientation
ברירת המחדל: PlaceSearchOrientation.VERTICAL
הכיוון (אנכי או אופקי) של הרכיב.
מאפיין HTML: orientation="value-name"
places
readonly
סוג: Array<Place>
לקריאה בלבד. מערך של אובייקטים מסוג Place שמכילים את המזהים, המיקומים וחלונות התצוגה של המקומות שמוצגים כרגע.
selectable
attr: selectable
סוג הקלט: boolean optional
סוג הפלט: boolean
ברירת המחדל: false
אם אפשר לבחור את הפריטים ברשימה או לא. אם הערך הוא true, הפריטים ברשימה יהיו כפתורים ששולחים את האירוע gmp-select כשלוחצים עליהם. יש גם תמיכה בניווט ובבחירה באמצעות מקלדת נגישה.
מאפיין HTML: selectable
truncationPreferred
attr: truncation-preferred
סוג הקלט: boolean optional
סוג הפלט: boolean
ברירת המחדל: false
אם הערך הוא true, שורות תוכן מסוימות נחתכות כדי להתאים לשורה אחת במקום לעבור לשורה הבאה.
מאפיין HTML: truncation-preferred
--gmp-button-border-color
צבע הגבול של הכפתור "פתיחה במפות Google".
--gmp-button-border-radius
רדיוס הגבולות של הכפתור "פתיחה במפות Google".
--gmp-button-border-width
רוחב הגבול של הכפתור "פתיחה במפות Google".
--gmp-card-border-radius
רדיוס הגבולות של כרטיסי המקומות.
--gmp-dialog-border-radius
רדיוס הגבולות של תיבת הדו-שיח של הגילוי הנאות במפות Google.
--gmp-mat-color-info
צבע של רכיבים בממשק המשתמש עם סנטימנט אינפורמטיבי. משמש לסמל של כניסה נגישה.
--gmp-mat-color-negative
הצבע של רכיבים בממשק המשתמש עם סנטימנט שלילי. התווית "סגור" בשעות הפתיחה של מקום.
--gmp-mat-color-neutral-container
צבע הקונטיינר של רכיבים ניטרליים בממשק המשתמש. משמש לתגי תאריך של ביקורות ולצורות של פלייסהולדרים לטעינה.
--gmp-mat-color-on-neutral-container
צבע הטקסט והסמלים במאגר ניטרלי. משמש לטקסט של תאריך הביקורת ולטקסט של שגיאת טעינה.
--gmp-mat-color-on-secondary-container
צבע הטקסט והסמלים על רקע צבע משני של מאגר. משמש לטקסט ולסמלים של כפתורים.
--gmp-mat-color-on-surface
צבע לטקסט ולסמלים על גבי צבע משטח. משמש לכותרות ולתוכן של תיבות דו-שיח.
--gmp-mat-color-on-surface-variant
צבע פחות מודגש לטקסט ולסמלים על צבע משטח. משמש למידע על המקום.
--gmp-mat-color-outline-decorative
צבע קו המתאר של רכיבים לא אינטראקטיביים. משמש לגבול של מאגר התגים.
--gmp-mat-color-positive
הצבע של רכיבים בממשק המשתמש עם סנטימנט חיובי. משמש לתווית "פתוח" בשעות הפתיחה של מקום.
--gmp-mat-color-primary
הצבע של הטקסט והסמלים האינטראקטיביים לעומת צבע המשטח. משמש לקישורים, לאינדיקטור הטעינה ולסמלי הסקירה הכללית.
--gmp-mat-color-secondary-container
צבע מילוי פחות בולט על פני השטח. משמש לרקעים של כפתורים.
--gmp-mat-color-surface
צבע לרקעים. משמש לרקעים של קונטיינרים ותיבות דו-שיח.
--gmp-mat-font-body-small
משמש למידע על המקום.
--gmp-mat-font-family
משפחת הגופנים הבסיסית לכל הטקסט.
--gmp-mat-font-headline-medium
משמש לכותרות של תיבות דו-שיח.
--gmp-mat-font-label-large
משמש לתוכן של לחצנים.
--gmp-mat-font-title-medium
משמש לשם המקום.
--gmp-mat-spacing-extra-small
משמש לריווח בתוך הרכיב, כמו השוליים והריפוד מסביב לטקסט.
--gmp-mat-spacing-large
משמש לריווח בתוך הרכיב, כמו השוליים והריפוד מסביב לטקסט.
--gmp-mat-spacing-medium
משמש לריווח בתוך הרכיב, כמו השוליים והריפוד מסביב לטקסט.
--gmp-mat-spacing-small
משמש לריווח בתוך הרכיב, כמו השוליים והריפוד מסביב לטקסט.
--gmp-star-rating-color
צבע הכוכבים המלאים בדירוג כוכבים.
--gmp-thumbnail-border-radius
רדיוס הגבול של התמונה הממוזערת של המקום.
background-color
מבטל את צבע הרקע של הרכיב.
border
מבטל את הגבול של הרכיב.
border-radius
מבטל את רדיוס הגבולות של הרכיב.
color-scheme
מציין באיזו ערכת צבעים אפשר להציג את הרכיב הזה. פרטים נוספים זמינים במסמכי התיעוד של color-scheme. ברירת המחדל היא color-scheme: light dark.
font-size
משנה את הגודל של כל הטקסט והסמלים ברכיב. ברירת המחדל היא 16px.
בירושה: addEventListener, removeEventListener
gmp-error
function(event)
ארגומנטים:
האירוע הזה מופעל כשבקשה לקצה העורפי נדחתה (למשל, מפתח API שגוי). האירוע הזה לא מבעבע.
gmp-load
function(event)
ארגומנטים:
האירוע הזה מופעל כשהרכיב נטען ומציג את התוכן שלו. האירוע הזה לא מבעבע.
gmp-select
function(event)
ארגומנטים:
האירוע הזה מופעל כשבוחרים מקום מהרשימה. מכיל אובייקט Place שכולל את המזהה, המיקום וחלון התצוגה של המקום שנבחר.

ממשק PlaceSearchElementOptions

ממשק google.maps.places.PlaceSearchElementOptions
מורחב על ידי AdvancedPlaceSearchElementOptions
מיושם על ידי AdvancedPlaceSearchElement, PlaceSearchElement

אפשרויות לגבי PlaceSearchElement.

attributionPosition
אופציונלי
internalUsageAttributionIds
אופציונלי
סוג: Iterable<string> optional
מזהים שמשמשים לשיוך קריאות לחבילות ספציפיות או לספריות OSS.
orientation
אופציונלי
סוג: PlaceSearchOrientation optional
selectable
אופציונלי
סוג: boolean optional
truncationPreferred
אופציונלי
סוג: boolean optional

המחלקה PlaceItemElement

class google.maps.places.PlaceItemElement extends HTMLElement implements PlaceItemElementOptions
extended by AdvancedPlaceItemElement
library "places"

רכיב wrapper ציבורי של רכיב אינטרנט (<gmp-place-item>) לפריטים ברשימת המקומות. הרכיב המותאם אישית <gmp-place-item> מציג כרטיס תוצאה של מקום ספציפי בתוך <gmp-place-search>. כל <gmp-place-item> מציג מידע על מקום שמורכב מרכיבים חזותיים צאצאים מ-Places UI Kit.

<gmp-place-item></gmp-place-item>
const {PlaceItemElement} = await google.maps.importLibrary("places");
בירושה: addEventListener, removeEventListener

ממשק PlaceItemElementOptions

ממשק google.maps.places.PlaceItemElementOptions
מורחב על ידי AdvancedPlaceItemElementOptions
מיושם על ידי AdvancedPlaceItemElement, PlaceItemElement

אפשרויות לגבי PlaceItemElement.

המחלקה AdvancedPlaceSearchElement

class google.maps.places.AdvancedPlaceSearchElement extends PlaceSearchElement, HTMLElement implements AdvancedPlaceSearchElementOptions, PlaceSearchElementOptions
library "places"

הצגת התוצאות של חיפוש מקומות מתקדם ברשימה. מוסיפים PlaceTextSearchRequestElement או PlaceNearbySearchRequestElement כדי לציין את הבקשה שרוצים להציג את התוצאות שלה. מוסיפים PlaceStandardContentElement,‏ PlaceAllContentElement או <template slot="details-item"> כדי לציין איזה תוכן לעבד.

דוגמה:

 <gmp-advanced-place-search>
  <gmp-place-text-search-request
    text-query="QUERY"
  ></gmp-place-text-search-request>
  <template slot="details-item">
    <gmp-place-media lightbox-preferred></gmp-place-media>
  </template>
</gmp-advanced-place-search>

כדי להשתמש ברכיב המתקדם של חיפוש מקומות, צריך להפעיל את Places UI Kit API בפרויקט במסוף Google Cloud.

<gmp-advanced-place-search
  attribution-position="value-name"
  internal-usage-attribution-ids="space separated strings"
  orientation="value-name"
  selectable
  truncation-preferred>
</gmp-advanced-place-search>
const {AdvancedPlaceSearchElement} = await google.maps.importLibrary("places");
AdvancedPlaceSearchElement
AdvancedPlaceSearchElement([options])
פרמטרים:
attributionPosition
attr: attribution-position
סוג הקלט: PlaceSearchAttributionPosition optional
סוג הפלט: PlaceSearchAttributionPosition
ברירת המחדל: PlaceSearchAttributionPosition.TOP
המיקום של לוגו השיוך (Attribution) וכפתור הגילוי הנאות כנדרש בחוק.
מאפיין HTML: attribution-position="value-name"
internalUsageAttributionIds
attr: internal-usage-attribution-ids
סוג הקלט: Iterable<string> optional
סוג הפלט: Array<string> optional
מזהים שמשמשים לשיוך קריאות לחבילות ספציפיות או לספריות OSS.
מאפיין HTML: internal-usage-attribution-ids="space separated strings"
orientation
attr: orientation
סוג הקלט: PlaceSearchOrientation optional
סוג הפלט: PlaceSearchOrientation
ברירת המחדל: PlaceSearchOrientation.VERTICAL
הכיוון (אנכי או אופקי) של הרכיב.
מאפיין HTML: orientation="value-name"
selectable
attr: selectable
סוג הקלט: boolean optional
סוג הפלט: boolean
ברירת המחדל: false
אם אפשר לבחור את הפריטים ברשימה או לא. אם הערך הוא true, הפריטים ברשימה יהיו כפתורים ששולחים את האירוע gmp-select כשלוחצים עליהם. יש גם תמיכה בניווט ובבחירה באמצעות מקלדת נגישה.
מאפיין HTML: selectable
truncationPreferred
attr: truncation-preferred
סוג הקלט: boolean optional
סוג הפלט: boolean
ברירת המחדל: false
אם הערך הוא true, שורות תוכן מסוימות נחתכות כדי להתאים לשורה אחת במקום לעבור לשורה הבאה.
מאפיין HTML: truncation-preferred
בירושה: places
details-item
תבנית ה-HTML שמכילה ווידג'טים של gmp-place לעיבוד של כל מקום בתוצאות החיפוש.
--gmp-button-border-color
צבע הגבול של הכפתור "פתיחה במפות Google".
--gmp-button-border-radius
רדיוס הגבולות של הכפתור "פתיחה במפות Google".
--gmp-button-border-width
רוחב הגבול של הכפתור "פתיחה במפות Google".
--gmp-card-border-radius
רדיוס הגבולות של כרטיסי המקומות.
--gmp-dialog-border-radius
רדיוס הגבולות של תיבת הדו-שיח של הגילוי הנאות במפות Google.
--gmp-mat-color-info
צבע של רכיבים בממשק המשתמש עם סנטימנט אינפורמטיבי. משמש לסמל של כניסה נגישה.
--gmp-mat-color-negative
הצבע של רכיבים בממשק המשתמש עם סנטימנט שלילי. התווית "סגור" בשעות הפתיחה של מקום.
--gmp-mat-color-neutral-container
צבע הקונטיינר של רכיבים ניטרליים בממשק המשתמש. משמש לתגי תאריך של ביקורות ולצורות של פלייסהולדרים לטעינה.
--gmp-mat-color-on-neutral-container
צבע הטקסט והסמלים במאגר ניטרלי. משמש לטקסט של תאריך הביקורת ולטקסט של שגיאת טעינה.
--gmp-mat-color-on-secondary-container
צבע הטקסט והסמלים על רקע צבע משני של מאגר. משמש לטקסט ולסמלים של כפתורים.
--gmp-mat-color-on-surface
צבע לטקסט ולסמלים על גבי צבע משטח. משמש לכותרות ולתוכן של תיבות דו-שיח.
--gmp-mat-color-on-surface-variant
צבע פחות מודגש לטקסט ולסמלים על צבע משטח. משמש למידע על המקום.
--gmp-mat-color-outline-decorative
צבע קו המתאר של רכיבים לא אינטראקטיביים. משמש לגבול של מאגר התגים.
--gmp-mat-color-positive
הצבע של רכיבים בממשק המשתמש עם סנטימנט חיובי. משמש לתווית "פתוח" בשעות הפתיחה של מקום.
--gmp-mat-color-primary
הצבע של הטקסט והסמלים האינטראקטיביים לעומת צבע המשטח. משמש לקישורים, לאינדיקטור הטעינה ולסמלי הסקירה הכללית.
--gmp-mat-color-secondary-container
צבע מילוי פחות בולט על פני השטח. משמש לרקעים של כפתורים.
--gmp-mat-color-surface
צבע לרקעים. משמש לרקעים של קונטיינרים ותיבות דו-שיח.
--gmp-mat-font-body-small
משמש למידע על המקום.
--gmp-mat-font-family
משפחת הגופנים הבסיסית לכל הטקסט.
--gmp-mat-font-headline-medium
משמש לכותרות של תיבות דו-שיח.
--gmp-mat-font-label-large
משמש לתוכן של לחצנים.
--gmp-mat-font-title-medium
משמש לשם המקום.
--gmp-mat-spacing-extra-small
משמש לריווח בתוך הרכיב, כמו השוליים והריפוד מסביב לטקסט.
--gmp-mat-spacing-large
משמש לריווח בתוך הרכיב, כמו השוליים והריפוד מסביב לטקסט.
--gmp-mat-spacing-medium
משמש לריווח בתוך הרכיב, כמו השוליים והריפוד מסביב לטקסט.
--gmp-mat-spacing-small
משמש לריווח בתוך הרכיב, כמו השוליים והריפוד מסביב לטקסט.
--gmp-star-rating-color
צבע הכוכבים המלאים בדירוג כוכבים.
--gmp-thumbnail-border-radius
רדיוס הגבול של התמונה הממוזערת של המקום.
background-color
מבטל את צבע הרקע של הרכיב.
border
מבטל את הגבול של הרכיב.
border-radius
מבטל את רדיוס הגבולות של הרכיב.
color-scheme
מציין באיזו ערכת צבעים אפשר להציג את הרכיב הזה. פרטים נוספים זמינים במסמכי התיעוד של color-scheme. ברירת המחדל היא color-scheme: light dark.
font-size
משנה את הגודל של כל הטקסט והסמלים ברכיב. ברירת המחדל היא 16px.
בירושה: addEventListener, removeEventListener
gmp-error
function(event)
ארגומנטים:
האירוע הזה מופעל כשבקשה לקצה העורפי נדחתה (למשל, מפתח API שגוי). האירוע הזה לא מבעבע.
gmp-load
function(event)
ארגומנטים:
האירוע הזה מופעל כשהרכיב נטען ומציג את התוכן שלו. האירוע הזה לא מבעבע.
gmp-select
function(event)
ארגומנטים:
האירוע הזה מופעל כשבוחרים מקום מהרשימה. מכיל אובייקט Place שכולל את המזהה, המיקום וחלון התצוגה של המקום שנבחר.

ממשק AdvancedPlaceSearchElementOptions

ממשק google.maps.places.AdvancedPlaceSearchElementOptions מרחיב את PlaceSearchElementOptions
מוטמע על ידי AdvancedPlaceSearchElement

אפשרויות לגבי AdvancedPlaceSearchElement.

attributionPosition
אופציונלי
internalUsageAttributionIds
אופציונלי
סוג: Iterable<string> optional
מזהים שמשמשים לשיוך קריאות לחבילות ספציפיות או לספריות OSS.
orientation
אופציונלי
סוג: PlaceSearchOrientation optional
selectable
אופציונלי
סוג: boolean optional
truncationPreferred
אופציונלי
סוג: boolean optional

המחלקה AdvancedPlaceListElement

class google.maps.places.AdvancedPlaceListElement extends HTMLElement implements AdvancedPlaceListElementOptions
library "places"

הצגת התוצאות של חיפוש מקומות ברשימה. כדי לציין את המקומות שיוצגו, צריך להוסיף PlaceDetailsPlaceRequestElement אחד או יותר או להגדיר את המאפיין places. מוסיפים PlaceStandardContentElement או PlaceAllContentElement כדי לציין איזה תוכן לעבד.

דוגמה:

 <gmp-advanced-place-list>
  <gmp-place-details-place-request
    place="PLACE_ID"
  </gmp-place-details-place-request>
  <template slot="details-item">
    <gmp-place-media lightbox-preferred></gmp-place-media>
  </template>
</gmp-advanced-place-list>

כדי להשתמש ברכיב המתקדם של רשימת המקומות, צריך להפעיל את Places UI Kit API בפרויקט במסוף Google Cloud.

<gmp-advanced-place-list
  attribution-position="value-name"
  internal-usage-attribution-ids="space separated strings"
  orientation="value-name"
  places="space separated strings"
  selectable
  truncation-preferred>
</gmp-advanced-place-list>
const {AdvancedPlaceListElement} = await google.maps.importLibrary("places");
AdvancedPlaceListElement
AdvancedPlaceListElement([options])
פרמטרים:
attributionPosition
attr: attribution-position
סוג הקלט: PlaceSearchAttributionPosition optional
סוג הפלט: PlaceSearchAttributionPosition
ברירת המחדל: PlaceSearchAttributionPosition.TOP
המיקום של לוגו השיוך (Attribution) וכפתור הגילוי הנאות כנדרש בחוק.
מאפיין HTML: attribution-position="value-name"
internalUsageAttributionIds
attr: internal-usage-attribution-ids
סוג הקלט: Iterable<string> optional
סוג הפלט: Array<string> optional
מזהים שמשמשים לשיוך קריאות לחבילות ספציפיות או לספריות OSS.
מאפיין HTML: internal-usage-attribution-ids="space separated strings"
orientation
attr: orientation
סוג הקלט: PlaceSearchOrientation optional
סוג הפלט: PlaceSearchOrientation
ברירת המחדל: PlaceSearchOrientation.VERTICAL
הכיוון (אנכי או אופקי) של הרכיב.
מאפיין HTML: orientation="value-name"
places
attr: places
סוג הקלט: Iterable<Place|string> optional
סוג הפלט: Array<Place>
רשימה של אובייקטים מסוג Place שמכילים את המזהים שצריך להציג ברכיב הזה. חשוב לדעת: יכול להיות שלא כל המקומות שמוגדרים במאפיין המקומות יוצגו אם לא ניתן לעבד אותם(למשל, מזהה לא חוקי, שגיאה בבקשה לאחזור מהרשת וכו'). אפשר לקרוא את המאפיין places כדי לאחזר את המקומות שמוצגים כרגע.
מאפיין HTML: places="space separated strings"
selectable
attr: selectable
סוג הקלט: boolean optional
סוג הפלט: boolean
ברירת המחדל: false
אם אפשר לבחור את הפריטים ברשימה או לא. אם הערך הוא true, הפריטים ברשימה יהיו כפתורים ששולחים את האירוע gmp-select כשלוחצים עליהם. יש גם תמיכה בניווט ובבחירה באמצעות מקלדת נגישה.
מאפיין HTML: selectable
truncationPreferred
attr: truncation-preferred
סוג הקלט: boolean optional
סוג הפלט: boolean
ברירת המחדל: false
אם הערך הוא true, שורות תוכן מסוימות נחתכות כדי להתאים לשורה אחת במקום לעבור לשורה הבאה.
מאפיין HTML: truncation-preferred
details-item
תבנית ה-HTML שמכילה ווידג'טים של gmp-place לעיבוד של כל מקום ברשימה.
--gmp-button-border-color
צבע הגבול של הכפתור "פתיחה במפות Google".
--gmp-button-border-radius
רדיוס הגבולות של הכפתור "פתיחה במפות Google".
--gmp-button-border-width
רוחב הגבול של הכפתור "פתיחה במפות Google".
--gmp-card-border-radius
רדיוס הגבולות של כרטיסי המקומות.
--gmp-dialog-border-radius
רדיוס הגבולות של תיבת הדו-שיח של הגילוי הנאות במפות Google.
--gmp-mat-color-info
צבע של רכיבים בממשק המשתמש עם סנטימנט אינפורמטיבי. משמש לסמל של כניסה נגישה.
--gmp-mat-color-negative
הצבע של רכיבים בממשק המשתמש עם סנטימנט שלילי. התווית "סגור" בשעות הפתיחה של מקום.
--gmp-mat-color-neutral-container
צבע הקונטיינר של רכיבים ניטרליים בממשק המשתמש. משמש לתגי תאריך של ביקורות ולצורות של פלייסהולדרים לטעינה.
--gmp-mat-color-on-neutral-container
צבע הטקסט והסמלים במאגר ניטרלי. משמש לטקסט של תאריך הביקורת ולטקסט של שגיאת טעינה.
--gmp-mat-color-on-secondary-container
צבע הטקסט והסמלים על רקע צבע משני של מאגר. משמש לטקסט ולסמלים של כפתורים.
--gmp-mat-color-on-surface
צבע לטקסט ולסמלים על גבי צבע משטח. משמש לכותרות ולתוכן של תיבות דו-שיח.
--gmp-mat-color-on-surface-variant
צבע פחות מודגש לטקסט ולסמלים על צבע משטח. משמש למידע על המקום.
--gmp-mat-color-outline-decorative
צבע קו המתאר של רכיבים לא אינטראקטיביים. משמש לגבול של מאגר התגים.
--gmp-mat-color-positive
הצבע של רכיבים בממשק המשתמש עם סנטימנט חיובי. משמש לתווית "פתוח" בשעות הפתיחה של מקום.
--gmp-mat-color-primary
הצבע של הטקסט והסמלים האינטראקטיביים לעומת צבע המשטח. משמש לקישורים, לאינדיקטור הטעינה ולסמלי הסקירה הכללית.
--gmp-mat-color-secondary-container
צבע מילוי פחות בולט על פני השטח. משמש לרקעים של כפתורים.
--gmp-mat-color-surface
צבע לרקעים. משמש לרקעים של קונטיינרים ותיבות דו-שיח.
--gmp-mat-font-body-small
משמש למידע על המקום.
--gmp-mat-font-family
משפחת הגופנים הבסיסית לכל הטקסט.
--gmp-mat-font-headline-medium
משמש לכותרות של תיבות דו-שיח.
--gmp-mat-font-label-large
משמש לתוכן של לחצנים.
--gmp-mat-font-title-medium
משמש לשם המקום.
--gmp-mat-spacing-extra-small
משמש לריווח בתוך הרכיב, כמו השוליים והריפוד מסביב לטקסט.
--gmp-mat-spacing-large
משמש לריווח בתוך הרכיב, כמו השוליים והריפוד מסביב לטקסט.
--gmp-mat-spacing-medium
משמש לריווח בתוך הרכיב, כמו השוליים והריפוד מסביב לטקסט.
--gmp-mat-spacing-small
משמש לריווח בתוך הרכיב, כמו השוליים והריפוד מסביב לטקסט.
--gmp-star-rating-color
צבע הכוכבים המלאים בדירוג כוכבים.
--gmp-thumbnail-border-radius
רדיוס הגבול של התמונה הממוזערת של המקום.
background-color
מבטל את צבע הרקע של הרכיב.
border
מבטל את הגבול של הרכיב.
border-radius
מבטל את רדיוס הגבולות של הרכיב.
color-scheme
מציין באיזו ערכת צבעים אפשר להציג את הרכיב הזה. פרטים נוספים זמינים במסמכי התיעוד של color-scheme. ברירת המחדל היא color-scheme: light dark.
font-size
משנה את הגודל של כל הטקסט והסמלים ברכיב. ברירת המחדל היא 16px.
בירושה: addEventListener, removeEventListener
gmp-error
function(event)
ארגומנטים:
האירוע הזה מופעל כשבקשה לקצה העורפי נדחתה (למשל, מפתח API שגוי). האירוע הזה לא מבעבע.
gmp-load
function(event)
ארגומנטים:
האירוע הזה מופעל כשהרכיב נטען ומציג את התוכן שלו. האירוע הזה לא מבעבע.
gmp-select
function(event)
ארגומנטים:
האירוע הזה מופעל כשבוחרים מקום מהרשימה. מכיל אובייקט Place שכולל את המזהה, המיקום וחלון התצוגה של המקום שנבחר.

ממשק AdvancedPlaceListElementOptions

ממשק google.maps.places.AdvancedPlaceListElementOptions
מיושם על ידי AdvancedPlaceListElement

אפשרויות לגבי AdvancedPlaceListElement.

attributionPosition
אופציונלי
internalUsageAttributionIds
אופציונלי
סוג: Iterable<string> optional
מזהים שמשמשים לשיוך קריאות לחבילות ספציפיות או לספריות OSS.
orientation
אופציונלי
סוג: PlaceSearchOrientation optional
places
אופציונלי
סוג: Iterable<Place|string> optional
selectable
אופציונלי
סוג: boolean optional
truncationPreferred
אופציונלי
סוג: boolean optional

המחלקה AdvancedPlaceItemElement

class google.maps.places.AdvancedPlaceItemElement extends PlaceItemElement, HTMLElement implements AdvancedPlaceItemElementOptions, PlaceItemElementOptions
library "places"

רכיב wrapper ציבורי של רכיב אינטרנט (<gmp-advanced-place-item>) לפריטים מתקדמים ברשימת המקומות. הרכיב המותאם אישית <gmp-advanced-place-item> מציג כרטיס תוצאה עשירה של מקום בודד בתוך קונטיינר של חיפוש מתקדם או של אוסף, כמו <gmp-advanced-place-search> או <gmp-advanced-place-list>. כל <gmp-advanced-place-item> מציג פרטי מקום עשירים, קולאז'ים של מדיה, סיכומי עריכה וכפתורי פעולה אינטראקטיביים שמורכבים מרכיבים חזותיים משניים מ-Places UI Kit.

<gmp-advanced-place-item></gmp-advanced-place-item>
const {AdvancedPlaceItemElement} = await google.maps.importLibrary("places");
Alphabasic-section-bottom
משבצת לתוכן HTML מותאם אישית שמוצג בתחתית הקטע של המידע הבסיסי, ישירות מתחת לכפתורי הפעולה הראשיים.
Alphabasic-section-top
משבצת לתוכן HTML בהתאמה אישית שמוצג בקטע המידע הבסיסי, ישירות מעל שם המקום.
בירושה: addEventListener, removeEventListener

ממשק AdvancedPlaceItemElementOptions

ממשק google.maps.places.AdvancedPlaceItemElementOptions מרחיב את PlaceItemElementOptions
מוטמע על ידי AdvancedPlaceItemElement

אפשרויות לגבי AdvancedPlaceItemElement.

קבועים של PlaceSearchAttributionPosition

constants google.maps.places.PlaceSearchAttributionPosition
ספרייה "places"

מיקומי השיוך (Attribution) של PlaceSearchElement.

אפשר להשתמש בקבועים האלה גם כמחרוזות. ב-TypeScript, המחרוזות המילוליות מוגדרות לפי הסוג PlaceSearchAttributionPositionString.

const {PlaceSearchAttributionPosition} = await google.maps.importLibrary("places");
BOTTOM שיוך בתחתית של PlaceSearchElement
TOP שיוך בחלק העליון של PlaceSearchElement

קבועים של PlaceSearchOrientation

constants google.maps.places.PlaceSearchOrientation
ספרייה "places"

וריאציות של כיוון המסך ב-PlaceSearchElement.

אפשר להשתמש בקבועים האלה גם כמחרוזות. ב-TypeScript, המחרוזות המילוליות מוגדרות לפי הסוג PlaceSearchOrientationString.

const {PlaceSearchOrientation} = await google.maps.importLibrary("places");
HORIZONTAL כיוון אופקי.
VERTICAL כיוון אנכי.

המחלקה PlaceSelectEvent

class google.maps.places.PlaceSelectEvent extends Event
library "places"

האירוע הזה מופעל כשנבחר מקום מרשימת מקומות. כדי לגשת לבחירה, לוחצים על event.place.

const {PlaceSelectEvent} = await google.maps.importLibrary("places");
place
readonly
סוג: Place
המקום שנבחר.

המחלקה PlaceNearbySearchRequestElement

class google.maps.places.PlaceNearbySearchRequestElement extends HTMLElement implements PlaceNearbySearchRequestElementOptions
library "places"

מגדירה PlaceSearchElement לטעינת תוצאות על סמך בקשת חיפוש בסביבה. המאפיין locationRestriction נדרש כדי לטעון את רכיב החיפוש. אם המדיניות locationRestriction לא מוגדרת, המערכת תתעלם מכל המאפיינים האחרים שהוגדרו. כדי לטעון תוצאות, צריך להוסיף את הרכיב הזה כצאצא של PlaceSearchElement. לדוגמה:

 <gmp-place-search>
  <gmp-place-nearby-search-request
    location-restriction="RADIUS@LAT,LNG"
  ></gmp-place-nearby-search-request>
  <gmp-place-content-config>
    <gmp-place-media lightbox-preferred></gmp-place-media>
  </gmp-place-content-config>
</gmp-place-search>

<gmp-place-nearby-search-request
  excluded-primary-types="excluded-primary-type1 excluded-primary-type2..."
  excluded-types="excluded-type1 excluded-type2..."
  included-primary-types="included-primary-type1 included-primary-type2..."
  included-types="included-type1 included-type2..."
  location-restriction="radius@lat,lng"
  max-result-count="number"
  rank-preference="value-name">
</gmp-place-nearby-search-request>
const {PlaceNearbySearchRequestElement} = await google.maps.importLibrary("places");
PlaceNearbySearchRequestElement
PlaceNearbySearchRequestElement([options])
פרמטרים:
excludedPrimaryTypes
attr: excluded-primary-types
סוג הקלט: Array<string> optional
סוג הפלט: Array<string> optional
ברירת המחדל: null
סוגי מקומות ראשיים שהוחרגו.
מאפיין HTML: excluded-primary-types="excluded-primary-type1 excluded-primary-type2..."
excludedTypes
attr: excluded-types
סוג הקלט: Array<string> optional
סוג הפלט: Array<string> optional
ברירת המחדל: null
סוגי מקומות מוחרגים.
מאפיין HTML: excluded-types="excluded-type1 excluded-type2..."
futureOpeningBusinessesIncluded
סוג הקלט: boolean optional
סוג הפלט: boolean optional
לכלול חיזויים של מקומות לעסקים שעדיין לא נפתחו אבל צפויים להיפתח בעתיד.
includedPrimaryTypes
attr: included-primary-types
סוג הקלט: Array<string> optional
סוג הפלט: Array<string> optional
ברירת המחדל: null
סוג המקום הראשי שנכלל.
מאפיין HTML: included-primary-types="included-primary-type1 included-primary-type2..."
includedTypes
attr: included-types
סוג הקלט: Array<string> optional
סוג הפלט: Array<string> optional
ברירת המחדל: null
סוג המקום שנכלל.
מאפיין HTML: included-types="included-type1 included-type2..."
locationRestriction
attr: location-restriction
סוג הקלט: Circle|CircleLiteral optional
סוג הפלט: Circle optional
ברירת המחדל: null
האזור לחיפוש. הפונקציה מנרמלת ל-Circle.
מאפיין HTML: location-restriction="radius@lat,lng"
maxResultCount
attr: max-result-count
סוג הקלט: number optional
סוג הפלט: number optional
ברירת המחדל: null
המספר המקסימלי של תוצאות שיוחזרו.
מאפיין HTML: max-result-count="number"
rankPreference
attr: rank-preference
סוג הקלט: SearchNearbyRankPreference optional
סוג הפלט: SearchNearbyRankPreference optional
ברירת המחדל: null
איך התוצאות ידורגו בתשובה.
מאפיין HTML: rank-preference="value-name"
בירושה: addEventListener, removeEventListener

ממשק PlaceNearbySearchRequestElementOptions

ממשק google.maps.places.PlaceNearbySearchRequestElementOptions
מיושם על ידי PlaceNearbySearchRequestElement

אפשרויות לגבי PlaceNearbySearchRequestElement.

excludedPrimaryTypes
אופציונלי
סוג: Array<string> optional
סוגי מקומות ראשיים שהוחרגו. פרטים נוספים מופיעים ב-PlaceNearbySearchRequestElement.excludedPrimaryTypes וב-SearchNearbyRequest.excludedPrimaryTypes.
excludedTypes
אופציונלי
סוג: Array<string> optional
סוגי מקומות מוחרגים. פרטים נוספים מופיעים ב-PlaceNearbySearchRequestElement.excludedTypes וב-SearchNearbyRequest.excludedTypes.
futureOpeningBusinessesIncluded
אופציונלי
סוג: boolean optional
לכלול חיזויים של מקומות לעסקים שעדיין לא נפתחו אבל צפויים להיפתח בעתיד.
includedPrimaryTypes
אופציונלי
סוג: Array<string> optional
סוגי המקומות הראשיים שנכללים. פרטים נוספים מופיעים ב-PlaceNearbySearchRequestElement.includedPrimaryTypes וב-SearchNearbyRequest.includedPrimaryTypes.
includedTypes
אופציונלי
סוג: Array<string> optional
סוגי המקומות שנכללים. פרטים נוספים מופיעים ב-PlaceNearbySearchRequestElement.includedTypes וב-SearchNearbyRequest.includedTypes.
locationRestriction
אופציונלי
סוג: Circle|CircleLiteral optional
האזור לחיפוש. פרטים נוספים מופיעים ב-PlaceNearbySearchRequestElement.locationRestriction וב-SearchNearbyRequest.locationRestriction.
maxResultCount
אופציונלי
סוג: number optional
המספר המקסימלי של תוצאות שיוחזרו. פרטים נוספים מופיעים ב-PlaceNearbySearchRequestElement.maxResultCount וב-SearchNearbyRequest.maxResultCount.
rankPreference
אופציונלי
איך התוצאות ידורגו בתשובה. פרטים נוספים מופיעים ב-PlaceNearbySearchRequestElement.rankPreference וב-SearchNearbyRankPreference.

המחלקה PlaceTextSearchRequestElement

class google.maps.places.PlaceTextSearchRequestElement extends HTMLElement implements PlaceTextSearchRequestElementOptions
library "places"

מגדיר PlaceSearchElement לטעינת תוצאות על סמך בקשה לחיפוש טקסט. המאפיין textQuery נדרש כדי לטעון את רכיב החיפוש. אם המדיניות textQuery לא מוגדרת, המערכת תתעלם מכל המאפיינים האחרים שהוגדרו. כדי לטעון תוצאות, צריך להוסיף את הרכיב הזה כצאצא של PlaceSearchElement. לדוגמה:

 <gmp-place-search>
  <gmp-place-text-search-request
    text-query="QUERY"
  ></gmp-place-text-search-request>
  <gmp-place-content-config>
    <gmp-place-media lightbox-preferred></gmp-place-media>
  </gmp-place-content-config>
</gmp-place-search>

<gmp-place-text-search-request
  ev-connector-types="ev-connector-type1 ev-connector-type2..."
  ev-minimum-charging-rate-kw="number"
  included-type="type"
  is-open-now
  location-bias="lat,lng"
  location-restriction="southwest-lat,southwest-lng|northeast-lat,northeast-lng"
  max-result-count="number"
  min-rating="number"
  price-levels="price-level1 price-level2..."
  rank-preference="value-name"
  text-query="string"
  use-strict-type-filtering>
</gmp-place-text-search-request>
const {PlaceTextSearchRequestElement} = await google.maps.importLibrary("places");
PlaceTextSearchRequestElement
PlaceTextSearchRequestElement([options])
פרמטרים:
evConnectorTypes
attr: ev-connector-types
סוג הקלט: Array<EVConnectorType> optional
סוג הפלט: Array<EVConnectorType> optional
ברירת המחדל: null
רשימת סוגי המחברים המועדפים לרכב חשמלי.
מאפיין HTML: ev-connector-types="ev-connector-type1 ev-connector-type2..."
evMinimumChargingRateKw
attr: ev-minimum-charging-rate-kw
סוג הקלט: number optional
סוג הפלט: number optional
ברירת המחדל: null
קצב הטעינה המינימלי הנדרש בקילוואט.
מאפיין HTML: ev-minimum-charging-rate-kw="number"
futureOpeningBusinessesIncluded
סוג הקלט: boolean optional
סוג הפלט: boolean optional
לכלול חיזויים של מקומות לעסקים שעדיין לא נפתחו אבל צפויים להיפתח בעתיד.
includedType
attr: included-type
סוג הקלט: string optional
סוג הפלט: string optional
ברירת המחדל: null
סוג המקום המבוקש.
מאפיין HTML: included-type="type"
isOpenNow
attr: is-open-now
סוג הקלט: boolean optional
סוג הפלט: boolean optional
ברירת המחדל: null
משמש להגבלת החיפוש למקומות שפתוחים כרגע.
מאפיין HTML: is-open-now
locationBias
attr: location-bias
סוג הקלט: LocationBias optional
סוג הפלט: LatLngAltitude|LatLngBounds|Circle|string optional
ברירת המחדל: null
הטיית מיקום לחיפוש.
מאפיין HTML:
  • location-bias="lat,lng"
  • location-bias="lat,lng[,altitude]"
  • location-bias="swlat,swlng|nelat,nelng"
  • location-bias="radius@lat,lng"
  • location-bias="IP_BIAS"
locationRestriction
attr: location-restriction
סוג הקלט: LatLngBounds|LatLngBoundsLiteral optional
סוג הפלט: LatLngBounds optional
ברירת המחדל: null
הגבלת מיקום לחיפוש. הפונקציה מנרמלת ל-LatLngBounds.
מאפיין HTML: location-restriction="southwest-lat,southwest-lng|northeast-lat,northeast-lng"
maxResultCount
attr: max-result-count
סוג הקלט: number optional
סוג הפלט: number optional
ברירת המחדל: null
המספר המקסימלי של תוצאות שיוחזרו.
מאפיין HTML: max-result-count="number"
minRating
attr: min-rating
סוג הקלט: number optional
סוג הפלט: number optional
ברירת המחדל: null
סינון תוצאות שדירוג המשתמשים הממוצע שלהן נמוך מהמגבלה הזו.
מאפיין HTML: min-rating="number"
priceLevels
attr: price-levels
סוג הקלט: Array<PriceLevel> optional
סוג הפלט: Array<PriceLevel> optional
ברירת המחדל: null
משמש להגבלת החיפוש למקומות שמסומנים ברמות מחיר מסוימות.
מאפיין HTML: price-levels="price-level1 price-level2..."
rankPreference
attr: rank-preference
סוג הקלט: SearchByTextRankPreference optional
סוג הפלט: SearchByTextRankPreference optional
ברירת המחדל: null
איך התוצאות ידורגו בתשובה.
מאפיין HTML: rank-preference="value-name"
textQuery
attr: text-query
סוג הקלט: string optional
סוג הפלט: string optional
ברירת המחדל: null
שאילתת הטקסט לחיפוש טקסטואלי.
מאפיין HTML: text-query="string"
useStrictTypeFiltering
attr: use-strict-type-filtering
סוג הקלט: boolean optional
סוג הפלט: boolean optional
ברירת המחדל: null
משמש להגדרת סינון סוגים קפדני עבור includedType.
מאפיין HTML: use-strict-type-filtering
בירושה: addEventListener, removeEventListener

ממשק PlaceTextSearchRequestElementOptions

ממשק google.maps.places.PlaceTextSearchRequestElementOptions
מיושם על ידי PlaceTextSearchRequestElement

אפשרויות לגבי PlaceTextSearchRequestElement.

evConnectorTypes
אופציונלי
סוג: Array<EVConnectorType> optional
רשימת סוגי המחברים המועדפים לרכב חשמלי. פרטים נוספים מופיעים ב-SearchByTextRequest.evSearchOptions וב-PlaceTextSearchRequestElement.evConnectorTypes.
evMinimumChargingRateKw
אופציונלי
סוג: number optional
קצב הטעינה המינימלי הנדרש בקילוואט. פרטים נוספים מופיעים ב-SearchByTextRequest.evSearchOptions וב-PlaceTextSearchRequestElement.evMinimumChargingRateKw.
futureOpeningBusinessesIncluded
אופציונלי
סוג: boolean optional
לכלול חיזויים של מקומות לעסקים שעדיין לא נפתחו אבל צפויים להיפתח בעתיד.
includedType
אופציונלי
סוג: string optional
סוג המקום המבוקש. פרטים נוספים מופיעים ב-SearchByTextRequest.includedType וב-PlaceTextSearchRequestElement.includedType.
isOpenNow
אופציונלי
סוג: boolean optional
משמש להגבלת החיפוש למקומות שפתוחים כרגע. פרטים נוספים מופיעים ב-SearchByTextRequest.isOpenNow וב-PlaceTextSearchRequestElement.isOpenNow.
locationBias
אופציונלי
סוג: LocationBias optional
הטיית מיקום לחיפוש. פרטים נוספים מופיעים ב-SearchByTextRequest.locationBias וב-PlaceTextSearchRequestElement.locationBias.
locationRestriction
אופציונלי
הגבלת מיקום לחיפוש. פרטים נוספים מופיעים ב-SearchByTextRequest.locationRestriction וב-PlaceTextSearchRequestElement.locationRestriction.
maxResultCount
אופציונלי
סוג: number optional
המספר המקסימלי של תוצאות שיוחזרו. פרטים נוספים מופיעים ב-SearchByTextRequest.maxResultCount וב-PlaceTextSearchRequestElement.maxResultCount.
minRating
אופציונלי
סוג: number optional
סינון תוצאות שדירוג המשתמשים הממוצע שלהן נמוך מהמגבלה הזו. פרטים נוספים מופיעים ב-SearchByTextRequest.minRating וב-PlaceTextSearchRequestElement.minRating.
priceLevels
אופציונלי
סוג: Array<PriceLevel> optional
משמש להגבלת החיפוש למקומות שמסומנים ברמות מחיר מסוימות. פרטים נוספים מופיעים ב-SearchByTextRequest.priceLevels וב-PlaceTextSearchRequestElement.priceLevels.
rankPreference
אופציונלי
איך התוצאות ידורגו בתשובה. פרטים נוספים מופיעים ב-SearchByTextRequest.rankPreference וב-PlaceTextSearchRequestElement.rankPreference.
textQuery
אופציונלי
סוג: string optional
שאילתת הטקסט לחיפוש טקסטואלי. פרטים נוספים מופיעים ב-SearchByTextRequest.textQuery וב-PlaceTextSearchRequestElement.textQuery.
useStrictTypeFiltering
אופציונלי
סוג: boolean optional
משמש להגדרת סינון קפדני לפי סוג עבור SearchByTextRequest.includedType. פרטים נוספים מופיעים ב-SearchByTextRequest.useStrictTypeFiltering וב-PlaceTextSearchRequestElement.useStrictTypeFiltering.

השלמה אוטומטית class

class google.maps.places.Autocomplete extends MVCObject
library "places"

ווידג'ט שמספק חיזויים של מקומות על סמך קלט הטקסט של המשתמש. הוא מחובר לרכיב קלט מסוג text, ומאזין להזנת טקסט בשדה הזה. רשימת החיזויים מוצגת כתפריט נפתח, והיא מתעדכנת תוך כדי הזנת הטקסט.

const {Autocomplete} = await google.maps.importLibrary("places");
Autocomplete
Autocomplete(inputField[, opts])
פרמטרים:
יצירת מופע חדש של Autocomplete שמצורף לשדה קלט הטקסט שצוין עם האפשרויות שניתנו.
getBounds
getBounds()
פרמטרים: אין
ערך מוחזר: LatLngBounds|undefined גבולות ההטיה.
מחזירה את הגבולות שאליהם מוטות התחזיות.
getFields
getFields()
פרמטרים: אין
ערך מוחזר: Array<string>|undefined
מחזירה את השדות שצריך לכלול בתגובה עם פרטי המקום, כשהפרטים מאוחזרים בהצלחה. רשימת השדות מופיעה במאמר PlaceResult.
getPlace
getPlace()
פרמטרים: אין
ערך מוחזר: PlaceResult המקום שהמשתמש בחר.
הפונקציה מחזירה את פרטי המקום שהמשתמש בחר, אם הפרטים אוחזרו בהצלחה. אחרת, הפונקציה מחזירה אובייקט Place עם מאפיין name שמוגדר לערך הנוכחי של השדה להזנת קלט.
setBounds
setBounds(bounds)
פרמטרים:
הערך המוחזר: אין
מגדירה את האזור המועדף שבו יוחזרו תוצאות של מקומות. התוצאות מוטות לאזור הזה, אבל לא מוגבלות אליו.
setComponentRestrictions
setComponentRestrictions(restrictions)
פרמטרים:
הערך המוחזר: אין
מגדיר את ההגבלות על הרכיבים. הגבלות על רכיבים משמשות להגבלת החיזויים רק לאלה שנמצאים בתוך רכיב ההורה. לדוגמה, המדינה.
setFields
setFields(fields)
פרמטרים:
  • fields: Array<string> optional
הערך המוחזר: אין
מגדירה את השדות שייכללו בתגובה עם פרטי המקום, כשהפרטים מאוחזרים בהצלחה. רשימת השדות מופיעה במאמר PlaceResult.
setOptions
setOptions(options)
פרמטרים:
הערך המוחזר: אין
setTypes
setTypes(types)
פרמטרים:
  • ‫types: Array<string> optional סוגי החיזויים שייכללו.
הערך המוחזר: אין
מגדירה את סוגי החיזויים שיוחזרו. כדי לראות את הסוגים הנתמכים, אפשר לעיין במדריך למפתחים. אם לא מציינים סוגים, כל הסוגים יוחזרו.
‫עברו בירושה: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
place_changed
function()
ארגומנטים: אין
האירוע הזה מופעל כשPlaceResult זמין למקום שהמשתמש בחר.
אם המשתמש מזין שם של מקום שלא הוצע על ידי הפקד ולוחץ על Enter, או אם בקשת פרטי המקום נכשלת, PlaceResult מכיל את הקלט של המשתמש במאפיין name, בלי מאפיינים אחרים שמוגדרים.

ממשק AutocompleteOptions

ממשק google.maps.places.AutocompleteOptions

האפשרויות שאפשר להגדיר באובייקט Autocomplete.

bounds
אופציונלי
האזור שבו רוצים לחפש מקומות.
componentRestrictions
אופציונלי
סוג: ComponentRestrictions optional
הגבלות הרכיבים. הגבלות על רכיבים משמשות להגבלת החיזויים רק לאלה שנמצאים בתוך רכיב ההורה. לדוגמה, המדינה.
fields
אופציונלי
סוג: Array<string> optional
השדות שייכללו בתגובה של פרטי המקום כשהפרטים יאוחזרו בהצלחה, שעליהם תחויבו. אם מעבירים את הערך ['ALL'], כל השדות הזמינים יוחזרו ויחויבו (לא מומלץ לפריסות בסביבת ייצור). רשימת השדות מופיעה במאמר PlaceResult. אפשר לציין שדות בתצוגת עץ באמצעות נתיבי נקודות (לדוגמה, "geometry.location"). ברירת המחדל היא ['ALL'].
placeIdOnly
אופציונלי
סוג: boolean optional
האם לאחזר רק מזהי מקומות. ה-PlaceResult שיהיה זמין כשהאירוע place_changed יופעל יכלול רק את השדות place_id, ‏ types ו-name, עם הערכים של מזהה מקום, ‏ types ו-description שיוחזרו על ידי שירות ההשלמה האוטומטית. מושבתת כברירת מחדל.
strictBounds
אופציונלי
סוג: boolean optional
ערך בוליאני שמציין שהווידג'ט של ההשלמה האוטומטית צריך להחזיר רק את המקומות שנמצאים בתוך הגבולות של הווידג'ט של ההשלמה האוטומטית בזמן שליחת השאילתה. אם מגדירים את strictBounds לערך false (ערך ברירת המחדל), התוצאות יוטו לכיוון מקומות שנמצאים בתוך הגבולות, אבל לא יוגבלו רק אליהם.
types
אופציונלי
סוג: Array<string> optional
סוגי התחזיות שיוחזרו. כדי לראות את הסוגים הנתמכים, אפשר לעיין במדריך למפתחים. אם לא מציינים סוגים, כל הסוגים יוחזרו.

class google.maps.places.SearchBox extends MVCObject
library "places"

ווידג'ט שמספק חיזויים של שאילתות על סמך קלט הטקסט של המשתמש. הוא מחובר לרכיב קלט מסוג text, ומאזין להזנת טקסט בשדה הזה. רשימת החיזויים מוצגת כתפריט נפתח, והיא מתעדכנת תוך כדי הזנת הטקסט.

const {SearchBox} = await google.maps.importLibrary("places");
SearchBox
SearchBox(inputField[, opts])
פרמטרים:
יצירת מופע חדש של SearchBox שמצורף לשדה קלט הטקסט שצוין עם האפשרויות שניתנו.
getBounds
getBounds()
פרמטרים: אין
ערך מוחזר: LatLngBounds|undefined
הפונקציה מחזירה את הגבולות שאליהם מוטים החיזויים של השאילתה.
getPlaces
getPlaces()
פרמטרים: אין
ערך מוחזר: Array<PlaceResult>|undefined
הפונקציה מחזירה את השאילתה שהמשתמש בחר כדי להשתמש בה עם האירוע places_changed.
setBounds
setBounds(bounds)
פרמטרים:
הערך המוחזר: אין
ההגדרה הזו קובעת את האזור שבו המערכת תשתמש כדי להטות את החיזויים של השאילתות. התוצאות יתמקדו באזור הזה, אבל לא יוגבלו אליו באופן מלא.
‫עברו בירושה: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
places_changed
function()
ארגומנטים: אין
האירוע הזה מופעל כשהמשתמש בוחר שאילתה, וצריך להשתמש ב-getPlaces כדי לקבל מקומות חדשים.

ממשק SearchBoxOptions

ממשק google.maps.places.SearchBoxOptions

האפשרויות שאפשר להגדיר באובייקט SearchBox.

bounds
אופציונלי
האזור שאליו רוצים להטות את החיזויים של השאילתות. התחזיות נוטות לשאילתות שמטרגטות את הגבולות האלה, אבל לא מוגבלות אליהן.

המחלקה PlaceContextualElement

class google.maps.places.PlaceContextualElement extends HTMLElement implements PlaceContextualElementOptions
library "places"

ווידג'ט שמשתמש בטוקן של הקשר כדי להציג תצוגה מותאמת מיקום של התשובה מ"עיגון בעזרת מפות Google".

<gmp-place-contextual
  context-token="string">
</gmp-place-contextual>
const {PlaceContextualElement} = await google.maps.importLibrary("places");
PlaceContextualElement
PlaceContextualElement([options])
פרמטרים:
contextToken
attr: context-token
סוג הקלט: string optional
סוג הפלט: string optional
הטוקן של ההקשר.
מאפיין HTML: context-token="string"
בירושה: addEventListener, removeEventListener

ממשק PlaceContextualElementOptions

ממשק google.maps.places.PlaceContextualElementOptions
מיושם על ידי PlaceContextualElement

אפשרויות לגבי PlaceContextualElement.

contextToken
אופציונלי
סוג: string optional
טוקן של הקשר שסופק על ידי התגובה של "עיגון בעזרת מפות Google".

המחלקה PlaceContextualListConfigElement

class google.maps.places.PlaceContextualListConfigElement extends HTMLElement implements PlaceContextualListConfigElementOptions
library "places"

רכיב HTML שמגדיר אפשרויות לתצוגת הרשימה של רכיב ההקשר של המקום.

<gmp-place-contextual-list-config
  layout="value-name"
  map-hidden>
</gmp-place-contextual-list-config>
const {PlaceContextualListConfigElement} = await google.maps.importLibrary("places");
PlaceContextualListConfigElement
PlaceContextualListConfigElement([options])
פרמטרים:
layout
attr: layout
סוג הקלט: PlaceContextualListLayout optional
סוג הפלט: PlaceContextualListLayout
הפריסה.
מאפיין HTML: layout="value-name"
mapHidden
attr: map-hidden
סוג הקלט: boolean optional
סוג הפלט: boolean
אם המפה מוסתרת.
מאפיין HTML: map-hidden
בירושה: addEventListener, removeEventListener

ממשק PlaceContextualListConfigElementOptions

ממשק google.maps.places.PlaceContextualListConfigElementOptions
מיושם על ידי PlaceContextualListConfigElement

אפשרויות ל-PlaceContextualListConfigElement.

layout
אופציונלי
סוג: PlaceContextualListLayout optional
ברירת המחדל: PlaceContextualListLayout.VERTICAL
הפריסה.
mapHidden
אופציונלי
סוג: boolean optional
ברירת המחדל: false
אם המפה צריכה להיות מוסתרת, הערך הוא True.

ערכים קבועים של PlaceContextualListLayout

constants google.maps.places.PlaceContextualListLayout
ספרייה "places"

רשימת הפריסות שבהן הרכיב ההקשרי של המקום תומך בתצוגת הרשימה.

אפשר להשתמש בקבועים האלה גם כמחרוזות. ב-TypeScript, המחרוזות המילוליות מוגדרות לפי הסוג PlaceContextualListLayoutString.

const {PlaceContextualListLayout} = await google.maps.importLibrary("places");
COMPACT פריסת רשימה קומפקטית: פריטי הרשימה מוצגים כקישורים בשורה אחת, עם גלישה לרשימה נפתחת.
VERTICAL פריסת רשימה אנכית: הפריטים ברשימה מוצגים ככרטיסים ברשימה אנכית.

המחלקה PlacePinElement

class google.maps.places.PlacePinElement extends HTMLElement implements PlacePinElementOptions
library "places"

הצגת סיכה במפה של מקום, באמצעות סמל הקטגוריה או התמונה של המקום. כדי לציין את המקום, מוסיפים PlaceDetailsPlaceRequestElement או PlaceDetailsLocationRequestElement. משתמשים בסיכה כתוכן של AdvancedMarkerElement. אין תמיכה במפות תלת-ממדיות.

דוגמה:

 <gmp-advanced-marker>
  <gmp-place-pin>
    <gmp-place-details-place-request
      place="PLACE_ID"
    ></gmp-place-details-place-request>
    <gmp-place-rating></gmp-place-rating>
  </gmp-place-pin>
</gmp-advanced-marker>

כדי להשתמש ברכיב הזה, צריך להפעיל את Places UI Kit API בפרויקט במסוף Google Cloud.

<gmp-place-pin
  icon="value-name"
  scale="number">
</gmp-place-pin>
const {PlacePinElement} = await google.maps.importLibrary("places");
PlacePinElement
PlacePinElement([options])
פרמטרים:
icon
attr: icon
סוג הקלט: PlacePinIcon optional
סוג הפלט: PlacePinIcon
ברירת המחדל: PlacePinIcon.TYPE
הסמל שמוצג בתוך הסיכה. PlacePinIcon.
מאפיין HTML: icon="value-name"
photoRendered
readonly
סוג: boolean
לקריאה בלבד. אם הסיכה מציגה את התמונה של המקום, התנאי מתקיים. תמיד False אם icon הוא לא PHOTO. אם הערך של icon הוא PHOTO אבל למקום אין תמונה, או שהתמונה לא נטענה, הערך הזה הוא False והסיכה מציגה את סמל סוג המקום במקום זאת. צריך להגדיר לפני ש-gmp-load מופעל.
place
readonly
סוג: Place optional
לקריאה בלבד. אובייקט של מקום שמכיל את המזהה, המיקום וחלון התצוגה של המקום שמוצג כרגע. undefined אם המקום עדיין לא נטען או שהטעינה נכשלה.
scale
attr: scale
סוג הקלט: number optional
סוג הפלט: number
ברירת המחדל: 1
מכפיל הגודל של הסיכה.
מאפיין HTML: scale="number"
default
תוכן אופציונלי שמוצג בסיכה, כמו PlaceRatingElement, <span> בהתאמה אישית או טקסט. צאצאים של Light DOM ממוקמים ישירות בסיכה. המיקום שבו התוכן מוצג תלוי בicon: לצד הסמל של סוג המקום בTYPE, כתג על התמונה בPHOTO, וכתוכן הראשי של הסיכה בNONE.
--gmp-background
צבע הרקע של הסיכה: הגלולה, מסגרת התמונה, תג התמונה, המקור והגבול של סיכת סוג המקום.
--gmp-border-radius
רדיוס הגבול של הבועה (סמל של סוג המקום עם תוכן משבצת, או תוכן משבצת בלבד) ושל מסגרת התמונה בסיכות של PHOTO. ברירת המחדל היא 30px לסמל של סוג מקום עם תוכן מותאם אישית, 12px לתוכן מותאם אישית בלבד, ומסגרת תמונה בגודל 12px. לא חל על סיכת סוג המקום ללא תוכן משבצת.
--gmp-glyph-background
צבע הרקע שמאחורי הסמל של סוג המקום. ברירת המחדל היא iconBackgroundColor של המקום.
--gmp-glyph-color
צבע הגליף של סוג המקום. ההגדרה חלה בכל פעם שהסמל מוצג, כולל כשסיכה של PHOTO חוזרת לסמל של סוג המקום.
בירושה: addEventListener, removeEventListener
gmp-error
function(event)
ארגומנטים:
האירוע הזה מופעל כשאי אפשר לעבד את הסיכה בכלל, למשל בגלל כשל ברשת, כשל באישורים (כמו מפתח API שגוי), מזהה מקום שלא ניתן לפתור או מקום ללא מיקום. הסיכה מוסתרת. האירוע הזה לא מבעבע.
gmp-load
function(event)
ארגומנטים:
האירוע הזה מופעל אחרי שפרטי המקום נטענים והסיכה מוצגת. כאשר icon הוא PHOTO, הוא מופעל רק אחרי שהתמונה נטענה או נכשלה; כשל בתמונה בלבד לא מפעיל את gmp-error. קוראים את המקום שנטען מ-PlacePinElement.place ואם התמונה מוצגת מ-PlacePinElement.photoRendered. האירוע הזה לא מבעבע.

ממשק PlacePinElementOptions

ממשק google.maps.places.PlacePinElementOptions
מיושם על ידי PlacePinElement

אפשרויות ליצירת PlacePinElement.

icon
אופציונלי
סוג: PlacePinIcon optional
scale
אופציונלי
סוג: number optional

קבועים של PlacePinIcon

constants google.maps.places.PlacePinIcon
ספרייה "places"

אפשרויות הסמל של PlacePinElement. ‫TYPE היא ברירת המחדל. אם חסרים הנתונים שנדרשים לסמל שנבחר, הסיכה חוזרת ל-TYPE. אם הנתונים שנדרשים ל-TYPE חסרים, יוצג במקום זאת סמל גנרי.

אפשר להשתמש בקבועים האלה גם כמחרוזות. ב-TypeScript, המחרוזות המילוליות מוגדרות לפי הסוג PlacePinIconString.

const {PlacePinIcon} = await google.maps.importLibrary("places");
NONE לא מוצג סמל, רק התוכן של המשבצת.
PHOTO הצגת תמונה של המקום בעיגול. אם למקום אין תמונה, המערכת תשתמש ב-TYPE.
TYPE מציג את סמל הקטגוריה של המקום.