במסמך הזה נסביר איך להשתמש ב-Nearby Search (חדש) API כדי ליצור ממשק פשוט וחסכוני
בחוויית הגילוי המקומי.
חוויית גילוי מקומי מציגה למשתמשים מוקדי עניין מרכזיים בקרבת מיקום שציינת בעת חיפוש מלון או נדל"ן. לרוב המפה כוללת מפה אינטראקטיבית, עם לוח נוסף שכולל בוחר מקומות וגלריית תמונות. יוצגו לכם יכולות ומוצרים שונים בפלטפורמה של מפות Google, כדי לשפר את חוויית השימוש בעזרת אינטראקטיביות.
תרחישים לדוגמה
עכשיו נסביר אילו אלמנטים של שילוב הגילוי המקומי מניבים ערך למשתמש:
גילוי – הציגו מקומות רלוונטיים מסוגים שונים כדי לתת למשתמשים סקירה כללית על מה שנמצא מסביב למיקום מסוים.
אינטראקטיביות – עידוד משתמשים לבחור מקום ולרענן את הנתונים באופן דינמי
יחסית למקום הזה.
תצוגה חזותית – הוספת ביקורות ותמונות על מקומות
וזמן ההליכה והמרחק כדי שהמשתמשים יוכלו להבין במהירות אם זה מתאים לצרכים שלהם.
ארכיטקטורת עזר
חיפוש מקומי
יש הרבה דרכים ליצור חוויית גילוי מקומי. השילוב הבא הוא דוגמה מותאמת אישית לחוויית משתמש שמשתמשת בממשקי API המוכרים של הפלטפורמה של מפות Google וגם בכמה תכונות חדשות ומעניינות. אם אתם רוצים להשתמש בתבניות לגילוי מקומי, תוכלו להשתמש ברכיבי אינטרנט.
אפליקציה לדוגמה
הדרכה מפורטת לדוגמה
הטבלה שמתחת לאפליקציה לדוגמה מחולקת לשלבים, בצירוף תיאור של ההטמעה הטכנית באמצעות ממשקי ה-API של הפלטפורמה של מפות Google.
1. חיפוש מיקום עם מיקום של השלמה אוטומטית
- טוענים את Maps JavaScript API.
- שאילתה בנושא השלמה אוטומטית של מקומות או בחירת מיקום במפה.
2. הצגת נקודות עניין מקומיות באמצעות Nearby Search (New) API
- דירוג פופולריות (תוצאות רלוונטיות יותר) או דירוג מרחק.
includedTypes
,excludedTypes
; אם מדובר במלון, אפשר להחריג את סוג ה"לינה" ולכלול רק סוגים של חדרים בהתאמה, כמו "מסעדה, בית קפה, פארק, tourit_attraction".- באמצעות
includedPrimaryTypes
,excludedPrimaryTypes
, אפשר אפילו יותר שליטה בתוצאות. - 'הגבלת מיקום כדי למנוע מספר לא מספיק של תוצאות או מקומות רחוקים מדי'; במקרה של אפס תוצאות, יש להרחיב את גודל העיגול / המלבן לפני הצגת התוצאות.
דוגמת שאילתה כאשר מזמינים מלון עם שדות נתונים שהתבקשו:
- בסיסי (
displayName
,types
,openingHours
,formattedAddress
) - איש קשר (
websiteUri
,nationalPhoneNumber
,internationalPhoneNumber
) - מועדף (
reviews
,priceLevel
,userRatingCount
)
{ "includedTypes": ["restaurant","cafe","park"], "excludedTypes": ["lodging","convenience_store"], "includedPrimaryTypes": ["restaurant","tourist_attraction","airport"], "excludedPrimaryTypes": ["lodging"], "maxResultCount": 20, "locationRestriction": { "circle": { "center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } } }
דוגמת שאילתה כאשר מחפשים נכס נדל"ן באמצעות שדות נתונים מבוקשים:
- בסיסי (
displayName
,types
,openingHours
,formattedAddress
)
{ "includedTypes": ["school","transport","bus","convenience_store"], "excludedTypes": ["lodging"], "includedPrimaryTypes": ["restaurant","tourist_attraction","airport"], "excludedPrimaryTypes": ["lodging"], "maxResultCount": 20, "locationRestriction": { "circle": { "center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } } }
3. מוסיפים אינטראקטיביות עם 'מפות דינמיות' ו-'Directions API'
- גרסה עדכנית של הרגליים והשלבים על ידי שליחת שאילתה ל-Directions API. * יש לציין את הזמן בקטע הבא.
4. להציג מידע מפורט על המקום במהלך האינטראקציה
תיאור:
displayName
,types
,rating
,userRatingCount
,priceLevel
.זמן: מגיע מהשאילתה הקודמת של Directions API.
ביקורות:
reviews[i].author
,reviews[i].rating
,reviews[i].text
.תמונות: במהלך תצוגה מקדימה בלתי מוגבלת של ממשק ה-API של חיפוש בקרבת מקום (חדש), תצטרכו להריץ שאילתה על פרטי מקומות עם
place.id
כדי לקבל את photo_reference, ואז להריץ שאילתה אחת בכל פעם בחוויה שלכם
מספר השאילתות והעלות המשויכות להן
- Maps JavaScript API: מפה אחת בטעינת החוויה.
- מציבה את ה-API להשלמה אוטומטית: שאילתה אחת על כל תו שמוקלד (אם משתמשים בווידג'ט של ההשלמה האוטומטית), ניתן להתאים אותה אישית.
- Nearby Search (חדש): שאילתה אחת לכל 20 מקומות מוצגים. חיוב שונה בהתאם לנתוני מקום שהם חלק מתגובת השאילתה.
- API של מסלול: שאילתה אחת לכל מקום שהמשתמש בחר.
- Place Photo API: שאילתה אחת על כל תמונה שמוצגת.
סיכום
חוויית גילוי מקומי היא דרך יעילה מאוד לספק ערך למשתמש. הטמעת ההדגמה הזו כוללת תכונות רבות שסביר להניח שתכללו כשיוצרים חוויה כזו בפלטפורמה של מפות Google עם יכולות מיוחדות מ-Nearby Search (הממשק החדש) .
השלבים הבאים
הצעות נוספות לקריאה:
- רכיבי אינטרנט ב-Maps JavaScript API
- אופטימיזציה של השלמה אוטומטית במקומות
- שירותי מקומות אחרים
- נשמח לקבל ממך משוב בהמשך.
תורמים
מחברים ראשיים:
תומאס אנגלרט | מהנדס פתרונות הפלטפורמה של מפות Google