במסמך הזה נסביר איך להשתמש ב-Nearby Search (New) API כדי ליצור ממשק פשוט וחסכוני
חוויית הגילוי המקומי.
בממשק 'גילוי מקומי' מוצגים למשתמשים מקומות מרכזיים ליד מיקום מסוים, כשהם מחפשים מלון או נכס נדל"ן. לרוב הוא מורכב ממפה אינטראקטיבית, עם חלונית נוספת שמכילה בורר מקומות וגלריה של תמונות. תוצג לכם רשימה של מוצרים ויכולות שונים של פלטפורמת מפות Google, שיעזרו לכם לשפר את חוויית השימוש באמצעות אינטראקטיביות.
תרחישים לדוגמה
עכשיו נסביר אילו רכיבים בשילוב של הגילוי הנאות המקומי מניעים את הערך של המשתמשים:
Discovery – מעניקים למשתמשים סקירה כללית של מה שנמצא סביב מיקום יחיד על ידי הצגת מקומות רלוונטיים מסוגים שונים.
אינטראקטיביות – מאפשרת למשתמשים לבחור מקום ולרענן את הנתונים באופן דינמי
ביחס למקום הזה.
תצוגה חזותית – פרסום ביקורות על מקומות ותמונות שלהם
וגם את משך ההליכה והמרחק, כדי שהמשתמשים יוכלו להבין במהירות אם המסלול מתאים לצרכים שלהם.
ארכיטקטורה לדוגמה
חיפוש מקומי
יש דרכים רבות ליצור חוויית גילוי מקומי. השילוב הבא הוא דוגמה מותאמת אישית לחוויית משתמש שבה נעשה שימוש בממשקי API ידועים של הפלטפורמה של מפות Google וגם בכמה תכונות חדשות ומעניינות. אם אתם רוצים להשתמש בתבניות לאיתור מקומי, תוכלו להשתמש ברכיבי אינטרנט.
אפליקציה לדוגמה
הדרכה מפורטת לדוגמה
בטבלה הבאה מפורטת אפליקציית לדוגמה שמחולקת לשלבים, יחד עם תיאור ההטמעה הטכנית באמצעות ממשקי ה-API של פלטפורמת מפות Google.
1. חיפוש מיקום עם השלמה אוטומטית של חיפוש המיקום
- טוענים את Maps JavaScript API.
- שאילתה של השלמה אוטומטית של מקומות או לבחור מיקום במפה.
2. הצגה של נקודות עניין מקומיות באמצעות 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. הוספת אינטראקטיביות באמצעות Dynamic Maps API ו-Directions API
- שלבים וקטעים עדכניים באמצעות שאילתה ל-Directions API. * משתמשים בזמן בקטע הבא.
4. הצגת מידע מפורט על המקום במהלך האינטראקציה
תיאור:
displayName
,types
,rating
,userRatingCount
,priceLevel
.Time: מגיע משאילתה קודמת של Directions API.
בדיקות:
reviews[i].author
,reviews[i].rating
,reviews[i].text
.תמונות: במהלך התצוגה המקדימה ללא הגבלות של API לחיפוש בקרבת מקום (הגרסה החדשה), תצטרכו לשלוח שאילתה ל-Places Details עם
place.id
כדי לקבל את הערך photo_reference, ולאחר מכן לשלוח שאילתה לכל תמונה בנפרד.
מספר השאילתות והעלות המשויכת
- Maps JavaScript API: מפה אחת בזמן טעינת חוויית השימוש.
- Places Autocomplete API: שאילתה אחת לכל תו שמקלידים (אם משתמשים בווידג'ט של השלמה אוטומטית), אפשר להתאים אישית.
- Nearby Search (New) API: שאילתת חיפוש אחת לכל 20 מקומות שמוצגים. החיוב שונה בהתאם לנתוני המקום, שהם חלק מתגובת השאילתה.
- Directions API: שאילתת API אחת לכל מקום שנבחר על ידי המשתמש.
- Place Photo API: שאילתה אחת לכל תמונה שמוצגת.
סיכום
חוויית חיפוש מקומי היא דרך יעילה לספק ערך למשתמשים. הטמעת ההדגמה הזו כוללת הרבה תכונות שסביר להניח שתכללו כשתיצרו חוויה כזו בפלטפורמה של מפות Google עם יכולות מיוחדות מ-Nearby Search API (New) API .
השלבים הבאים
מקורות מידע נוספים:
- רכיבי אינטרנט ב-Maps JavaScript API
- אופטימיזציה של השלמה אוטומטית של מקומות
- שירותים אחרים של Places
- אפשר להשאיר משוב למטה.
תורמים
מחברים ראשיים:
Thomas Anglaret | מהנדס פתרונות בפלטפורמה של מפות Google