המחלקה 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 |
מזהים שמשמשים לשיוך קריאות לחבילות ספציפיות או לספריות 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:
|
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 |
מערכת היחידות שמשמשת להצגת מרחקים. אם לא מציינים מערכת יחידות, היא נקבעת לפי 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. |
מאפייני CSS | |
|---|---|
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 |
משנה את הגופן של הרכיב. |
Methods | |
|---|---|
בירושה:
addEventListener,
removeEventListener
|
אירועים | |
|---|---|
gmp-error |
function(errorEvent)ארגומנטים:
האירוע הזה מופעל כשבקשה לקצה העורפי נדחתה (למשל, מפתח 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
אופציונלי |
סוג:
LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional |
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 |
סוג:
PlacePredictionכדי להמיר את זה ל- 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 |
מזהים שמשמשים לשיוך קריאות לחבילות ספציפיות או לספריות 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:
|
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 |
מערכת היחידות שמשמשת להצגת מרחקים. אם לא מציינים מערכת יחידות, היא נקבעת לפי 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. |
מאפייני CSS | |
|---|---|
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 |
משנה את הגופן של הרכיב. |
Methods | |
|---|---|
בירושה:
addEventListener,
removeEventListener
|
אירועים | |
|---|---|
gmp-error |
function(errorEvent)ארגומנטים:
האירוע הזה מופעל כשבקשה לקצה העורפי נדחתה (למשל, מפתח 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
אופציונלי |
סוג:
LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional |
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 כדי לציין את המקום שרוצים לעבד. כדי לציין איזה תוכן לעבד, מוסיפים , PlaceContentConfigElementPlaceStandardContentElement או 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 |
מזהים שמשמשים לשיוך קריאות לחבילות ספציפיות או לספריות OSS.
מאפיין HTML: internal-usage-attribution-ids="space separated strings" |
place
readonly |
סוג:
Place optionalלקריאה בלבד. אובייקט של מקום שמכיל את המזהה, המיקום וחלון התצוגה של המקום שמוצג כרגע. |
מאפייני CSS | |
|---|---|
--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. |
Methods | |
|---|---|
בירושה:
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 כדי לציין את המקום שרוצים לעבד. כדי לציין איזה תוכן לעבד, מוסיפים , PlaceContentConfigElementPlaceStandardContentElement או 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 |
מזהים שמשמשים לשיוך קריאות לחבילות ספציפיות או לספריות 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 |
מאפייני CSS | |
|---|---|
--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. |
Methods | |
|---|---|
בירושה:
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 |
מזהים שמשמשים לשיוך קריאות לחבילות ספציפיות או לספריות OSS.
מאפיין HTML: internal-usage-attribution-ids="space separated strings" |
place
readonly |
סוג:
Place optionalלקריאה בלבד. אובייקט של מקום שמכיל את המזהה, המיקום וחלון התצוגה של המקום שמוצג כרגע. |
מכונות מזל | |
|---|---|
action-corner |
משבצת זמן ל- PlaceLinkElement ול-PlaceButtonElement. |
action-main |
משבצת זמן ל- PlaceLinkElement ול-PlaceButtonElement. |
|
משבצת לתוכן HTML מותאם אישית שמוצג בתחתית הקטע של המידע הבסיסי, ישירות מתחת לכפתורי הפעולה הראשיים. |
|
משבצת לתוכן HTML בהתאמה אישית שמוצג בקטע המידע הבסיסי, ישירות מעל שם המקום. |
Methods | |
|---|---|
בירושה:
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 |
מזהים שמשמשים לשיוך קריאות לחבילות ספציפיות או לספריות 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. |
|
משבצת לתוכן HTML מותאם אישית שמוצג בתחתית הקטע של המידע הבסיסי, ישירות מתחת לכפתורי הפעולה הראשיים. |
|
משבצת לתוכן HTML בהתאמה אישית שמוצג בקטע המידע הבסיסי, ישירות מעל שם המקום. |
Methods | |
|---|---|
בירושה:
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 |
ברירת המחדל:
nullאובייקט המקום, המזהה או שם המשאב שרוצים להציג את הפרטים שלו ברכיב Place Details Compact. המאפיין הזה משקף את המאפיין כשם משאב.
מאפיין HTML: place="places/###" |
Methods | |
|---|---|
בירושה:
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" |
Methods | |
|---|---|
בירושה:
addEventListener,
removeEventListener
|
ממשק PlaceDetailsLocationRequestElementOptions
ממשק
google.maps.places.PlaceDetailsLocationRequestElementOptions
מיושם על ידי PlaceDetailsLocationRequestElement
אפשרויות לגבי PlaceDetailsLocationRequestElement.
מאפיינים | |
|---|---|
location
אופציונלי |
סוג:
LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optionalהמיקום שבו רוצים להציג את המקום. |
המחלקה PlaceSearchElement
class
google.maps.places.PlaceSearchElement
extends HTMLElement
implements PlaceSearchElementOptions
extended by AdvancedPlaceSearchElement
library "places"
הצגת התוצאות של חיפוש מקומות ברשימה. מוסיפים PlaceTextSearchRequestElement או PlaceNearbySearchRequestElement כדי לציין את הבקשה שרוצים להציג את התוצאות שלה. כדי לציין איזה תוכן לעבד, מוסיפים , PlaceContentConfigElementPlaceStandardContentElement או 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.TOPהמיקום של לוגו השיוך (Attribution) וכפתור הגילוי הנאות כנדרש בחוק.
מאפיין HTML: attribution-position="value-name" |
internalUsageAttributionIds
attr: internal-usage-attribution-ids |
מזהים שמשמשים לשיוך קריאות לחבילות ספציפיות או לספריות OSS.
מאפיין HTML: internal-usage-attribution-ids="space separated strings" |
orientation
attr: orientation |
ברירת המחדל:
PlaceSearchOrientation.VERTICALהכיוון (אנכי או אופקי) של הרכיב.
מאפיין HTML: orientation="value-name" |
places
readonly |
לקריאה בלבד. מערך של אובייקטים מסוג 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 |
מאפייני CSS | |
|---|---|
--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. |
Methods | |
|---|---|
בירושה:
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
אופציונלי |
סוג:
PlaceSearchAttributionPosition optional |
internalUsageAttributionIds
אופציונלי |
סוג:
Iterable<string> optionalמזהים שמשמשים לשיוך קריאות לחבילות ספציפיות או לספריות OSS. |
orientation
אופציונלי |
סוג:
PlaceSearchOrientation optional |
selectable
אופציונלי |
סוג:
boolean optionalהצגה של PlaceSearchElement.selectable |
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");
Methods | |
|---|---|
בירושה:
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.TOPהמיקום של לוגו השיוך (Attribution) וכפתור הגילוי הנאות כנדרש בחוק.
מאפיין HTML: attribution-position="value-name" |
internalUsageAttributionIds
attr: internal-usage-attribution-ids |
מזהים שמשמשים לשיוך קריאות לחבילות ספציפיות או לספריות OSS.
מאפיין HTML: internal-usage-attribution-ids="space separated strings" |
orientation
attr: orientation |
ברירת המחדל:
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 לעיבוד של כל מקום בתוצאות החיפוש. |
מאפייני CSS | |
|---|---|
--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. |
Methods | |
|---|---|
בירושה:
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
אופציונלי |
סוג:
PlaceSearchAttributionPosition optional |
internalUsageAttributionIds
אופציונלי |
סוג:
Iterable<string> optionalמזהים שמשמשים לשיוך קריאות לחבילות ספציפיות או לספריות OSS. |
orientation
אופציונלי |
סוג:
PlaceSearchOrientation optional |
selectable
אופציונלי |
סוג:
boolean optionalהצגה של PlaceSearchElement.selectable |
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.TOPהמיקום של לוגו השיוך (Attribution) וכפתור הגילוי הנאות כנדרש בחוק.
מאפיין HTML: attribution-position="value-name" |
internalUsageAttributionIds
attr: internal-usage-attribution-ids |
מזהים שמשמשים לשיוך קריאות לחבילות ספציפיות או לספריות OSS.
מאפיין HTML: internal-usage-attribution-ids="space separated strings" |
orientation
attr: orientation |
ברירת המחדל:
PlaceSearchOrientation.VERTICALהכיוון (אנכי או אופקי) של הרכיב.
מאפיין HTML: orientation="value-name" |
places
attr: places |
רשימה של אובייקטים מסוג 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 לעיבוד של כל מקום ברשימה. |
מאפייני CSS | |
|---|---|
--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. |
Methods | |
|---|---|
בירושה:
addEventListener,
removeEventListener
|
אירועים | |
|---|---|
gmp-error |
function(event)ארגומנטים:
האירוע הזה מופעל כשבקשה לקצה העורפי נדחתה (למשל, מפתח API שגוי). האירוע הזה לא מבעבע. |
gmp-load |
function(event)ארגומנטים:
האירוע הזה מופעל כשהרכיב נטען ומציג את התוכן שלו. האירוע הזה לא מבעבע. |
gmp-select |
function(event)ארגומנטים:
האירוע הזה מופעל כשבוחרים מקום מהרשימה. מכיל אובייקט Place שכולל את המזהה, המיקום וחלון התצוגה של המקום שנבחר. |
ממשק AdvancedPlaceListElementOptions
ממשק
google.maps.places.AdvancedPlaceListElementOptions
מיושם על ידי AdvancedPlaceListElement
אפשרויות לגבי AdvancedPlaceListElement.
מאפיינים | |
|---|---|
attributionPosition
אופציונלי |
סוג:
PlaceSearchAttributionPosition optional |
internalUsageAttributionIds
אופציונלי |
סוג:
Iterable<string> optionalמזהים שמשמשים לשיוך קריאות לחבילות ספציפיות או לספריות OSS. |
orientation
אופציונלי |
סוג:
PlaceSearchOrientation optional |
places
אופציונלי |
|
selectable
אופציונלי |
סוג:
boolean optionalהצגה של PlaceSearchElement.selectable |
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");
מכונות מזל | |
|---|---|
|
משבצת לתוכן HTML מותאם אישית שמוצג בתחתית הקטע של המידע הבסיסי, ישירות מתחת לכפתורי הפעולה הראשיים. |
|
משבצת לתוכן HTML בהתאמה אישית שמוצג בקטע המידע הבסיסי, ישירות מעל שם המקום. |
Methods | |
|---|---|
בירושה:
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 |
ברירת המחדל:
nullסוגי מקומות ראשיים שהוחרגו.
מאפיין HTML: excluded-primary-types="excluded-primary-type1 excluded-primary-type2..." |
excludedTypes
attr: excluded-types |
ברירת המחדל:
nullסוגי מקומות מוחרגים.
מאפיין HTML: excluded-types="excluded-type1 excluded-type2..." |
futureOpeningBusinessesIncluded |
סוג הקלט:
boolean optionalסוג הפלט: boolean optionalלכלול חיזויים של מקומות לעסקים שעדיין לא נפתחו אבל צפויים להיפתח בעתיד. |
includedPrimaryTypes
attr: included-primary-types |
ברירת המחדל:
nullסוג המקום הראשי שנכלל.
מאפיין HTML: included-primary-types="included-primary-type1 included-primary-type2..." |
includedTypes
attr: included-types |
ברירת המחדל:
nullסוג המקום שנכלל.
מאפיין HTML: included-types="included-type1 included-type2..." |
locationRestriction
attr: location-restriction |
ברירת המחדל:
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 |
ברירת המחדל:
nullאיך התוצאות ידורגו בתשובה.
מאפיין HTML: rank-preference="value-name" |
Methods | |
|---|---|
בירושה:
addEventListener,
removeEventListener
|
ממשק PlaceNearbySearchRequestElementOptions
ממשק
google.maps.places.PlaceNearbySearchRequestElementOptions
מיושם על ידי PlaceNearbySearchRequestElement
אפשרויות לגבי PlaceNearbySearchRequestElement.
המחלקה 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 |
ברירת המחדל:
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 |
ברירת המחדל:
nullהטיית מיקום לחיפוש.
מאפיין HTML:
|
locationRestriction
attr: location-restriction |
ברירת המחדל:
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 |
ברירת המחדל:
nullמשמש להגבלת החיפוש למקומות שמסומנים ברמות מחיר מסוימות.
מאפיין HTML: price-levels="price-level1 price-level2..." |
rankPreference
attr: rank-preference |
ברירת המחדל:
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 |
Methods | |
|---|---|
בירושה:
addEventListener,
removeEventListener
|
ממשק PlaceTextSearchRequestElementOptions
ממשק
google.maps.places.PlaceTextSearchRequestElementOptions
מיושם על ידי PlaceTextSearchRequestElement
אפשרויות לגבי PlaceTextSearchRequestElement.
השלמה אוטומטית class
class
google.maps.places.Autocomplete
extends MVCObject
library "places"
ווידג'ט שמספק חיזויים של מקומות על סמך קלט הטקסט של המשתמש. הוא מחובר לרכיב קלט מסוג text, ומאזין להזנת טקסט בשדה הזה. רשימת החיזויים מוצגת כתפריט נפתח, והיא מתעדכנת תוך כדי הזנת הטקסט.
const {Autocomplete} = await google.maps.importLibrary("places");
יצרן | |
|---|---|
Autocomplete |
Autocomplete(inputField[, opts])פרמטרים:
יצירת מופע חדש של Autocomplete שמצורף לשדה קלט הטקסט שצוין עם האפשרויות שניתנו. |
Methods | |
|---|---|
getBounds |
getBounds()פרמטרים: אין
ערך מוחזר:
LatLngBounds|undefined גבולות ההטיה.מחזירה את הגבולות שאליהם מוטות התחזיות. |
getFields |
getFields()פרמטרים: אין
ערך מוחזר:
Array<string>|undefinedמחזירה את השדות שצריך לכלול בתגובה עם פרטי המקום, כשהפרטים מאוחזרים בהצלחה. רשימת השדות מופיעה במאמר PlaceResult. |
getPlace |
getPlace()פרמטרים: אין
ערך מוחזר:
PlaceResult המקום שהמשתמש בחר.הפונקציה מחזירה את פרטי המקום שהמשתמש בחר, אם הפרטים אוחזרו בהצלחה. אחרת, הפונקציה מחזירה אובייקט Place עם מאפיין name שמוגדר לערך הנוכחי של השדה להזנת קלט. |
setBounds |
setBounds(bounds)פרמטרים:
הערך המוחזר: אין
מגדירה את האזור המועדף שבו יוחזרו תוצאות של מקומות. התוצאות מוטות לאזור הזה, אבל לא מוגבלות אליו. |
setComponentRestrictions |
setComponentRestrictions(restrictions)פרמטרים:
הערך המוחזר: אין
מגדיר את ההגבלות על הרכיבים. הגבלות על רכיבים משמשות להגבלת החיזויים רק לאלה שנמצאים בתוך רכיב ההורה. לדוגמה, המדינה. |
setFields |
setFields(fields)פרמטרים:
הערך המוחזר: אין
מגדירה את השדות שייכללו בתגובה עם פרטי המקום, כשהפרטים מאוחזרים בהצלחה. רשימת השדות מופיעה במאמר PlaceResult. |
setOptions |
setOptions(options)פרמטרים:
הערך המוחזר: אין
|
setTypes |
setTypes(types)פרמטרים:
הערך המוחזר: אין
מגדירה את סוגי החיזויים שיוחזרו. כדי לראות את הסוגים הנתמכים, אפשר לעיין במדריך למפתחים. אם לא מציינים סוגים, כל הסוגים יוחזרו. |
עברו בירושה:
addListener,
bindTo,
get,
notify,
set,
setValues,
unbind,
unbindAll
| |
אירועים | |
|---|---|
place_changed |
function()ארגומנטים: אין
האירוע הזה מופעל כש PlaceResult זמין למקום שהמשתמש בחר. אם המשתמש מזין שם של מקום שלא הוצע על ידי הפקד ולוחץ על Enter, או אם בקשת פרטי המקום נכשלת, PlaceResult מכיל את הקלט של המשתמש במאפיין name, בלי מאפיינים אחרים שמוגדרים. |
ממשק AutocompleteOptions
ממשק
google.maps.places.AutocompleteOptions
האפשרויות שאפשר להגדיר באובייקט Autocomplete.
מאפיינים | |
|---|---|
bounds
אופציונלי |
סוג:
LatLngBounds|LatLngBoundsLiteral optionalהאזור שבו רוצים לחפש מקומות. |
componentRestrictions
אופציונלי |
סוג:
ComponentRestrictions optionalהגבלות הרכיבים. הגבלות על רכיבים משמשות להגבלת החיזויים רק לאלה שנמצאים בתוך רכיב ההורה. לדוגמה, המדינה. |
fields
אופציונלי |
סוג:
Array<string> optionalהשדות שייכללו בתגובה של פרטי המקום כשהפרטים יאוחזרו בהצלחה, שעליהם תחויבו. אם מעבירים את הערך ['ALL'], כל השדות הזמינים יוחזרו ויחויבו (לא מומלץ לפריסות בסביבת ייצור). רשימת השדות מופיעה במאמר PlaceResult. אפשר לציין שדות בתצוגת עץ באמצעות נתיבי נקודות (לדוגמה, "geometry.location"). ברירת המחדל היא ['ALL']. |
אופציונלי |
סוג:
boolean optionalהאם לאחזר רק מזהי מקומות. ה-PlaceResult שיהיה זמין כשהאירוע place_changed יופעל יכלול רק את השדות place_id, types ו-name, עם הערכים של מזהה מקום, types ו-description שיוחזרו על ידי שירות ההשלמה האוטומטית. מושבתת כברירת מחדל. |
strictBounds
אופציונלי |
סוג:
boolean optionalערך בוליאני שמציין שהווידג'ט של ההשלמה האוטומטית צריך להחזיר רק את המקומות שנמצאים בתוך הגבולות של הווידג'ט של ההשלמה האוטומטית בזמן שליחת השאילתה. אם מגדירים את strictBounds לערך false (ערך ברירת המחדל), התוצאות יוטו לכיוון מקומות שנמצאים בתוך הגבולות, אבל לא יוגבלו רק אליהם. |
types
אופציונלי |
סוג:
Array<string> optionalסוגי התחזיות שיוחזרו. כדי לראות את הסוגים הנתמכים, אפשר לעיין במדריך למפתחים. אם לא מציינים סוגים, כל הסוגים יוחזרו. |
המחלקה SearchBox
class
google.maps.places.SearchBox
extends MVCObject
library "places"
ווידג'ט שמספק חיזויים של שאילתות על סמך קלט הטקסט של המשתמש. הוא מחובר לרכיב קלט מסוג text, ומאזין להזנת טקסט בשדה הזה. רשימת החיזויים מוצגת כתפריט נפתח, והיא מתעדכנת תוך כדי הזנת הטקסט.
const {SearchBox} = await google.maps.importLibrary("places");
יצרן | |
|---|---|
SearchBox |
SearchBox(inputField[, opts])פרמטרים:
יצירת מופע חדש של SearchBox שמצורף לשדה קלט הטקסט שצוין עם האפשרויות שניתנו. |
Methods | |
|---|---|
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
אופציונלי |
סוג:
LatLngBounds|LatLngBoundsLiteral optionalהאזור שאליו רוצים להטות את החיזויים של השאילתות. התחזיות נוטות לשאילתות שמטרגטות את הגבולות האלה, אבל לא מוגבלות אליהן. |
המחלקה 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" |
Methods | |
|---|---|
בירושה:
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 |
הפריסה.
מאפיין HTML: layout="value-name" |
mapHidden
attr: map-hidden |
סוג הקלט:
boolean optionalסוג הפלט: booleanאם המפה מוסתרת.
מאפיין HTML: map-hidden |
Methods | |
|---|---|
בירושה:
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.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. |
מאפייני CSS | |
|---|---|
--gmp-background |
צבע הרקע של הסיכה: הגלולה, מסגרת התמונה, תג התמונה, המקור והגבול של סיכת סוג המקום. |
--gmp-border-radius |
רדיוס הגבול של הבועה (סמל של סוג המקום עם תוכן משבצת, או תוכן משבצת בלבד) ושל מסגרת התמונה בסיכות של PHOTO. ברירת המחדל היא 30px לסמל של סוג מקום עם תוכן מותאם אישית, 12px לתוכן מותאם אישית בלבד, ומסגרת תמונה בגודל 12px. לא חל על סיכת סוג המקום ללא תוכן משבצת. |
--gmp-glyph-background |
צבע הרקע שמאחורי הסמל של סוג המקום. ברירת המחדל היא iconBackgroundColor של המקום. |
--gmp-glyph-color |
צבע הגליף של סוג המקום. ההגדרה חלה בכל פעם שהסמל מוצג, כולל כשסיכה של PHOTO חוזרת לסמל של סוג המקום. |
Methods | |
|---|---|
בירושה:
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 |
מציג את סמל הקטגוריה של המקום. |