במסמך הזה נסביר איך להשתמש ב-Nearby Search (New) API כדי ליצור ממשק פשוט וחסכוני
חוויית הגילוי המקומית.
חוויית גילוי מקומית מציגה למשתמשים מוקדי עניין מרכזיים ליד מיקום שציינתם כשהם מחפשים מלון או נדל"ן. בדרך כלל היא מורכבת ממפה אינטראקטיבית, עם חלונית נוספת שמכילה את בוחר המקומות וגלריית תמונות. יוצגו לכם מוצרים ויכולות שונים של הפלטפורמה של מפות Google כדי לשפר את החוויה בעזרת האינטראקטיביות.
תרחישים לדוגמה
עכשיו נסביר אילו רכיבים בשילוב של הגילוי הנאות המקומי מניבים ערך למשתמשים:
Discovery – מעניקים למשתמשים סקירה כללית של מה שנמצא סביב מיקום יחיד על ידי הצגת מקומות רלוונטיים מסוגים שונים.
אינטראקטיביות – נותנים למשתמשים אפשרות לבחור מקום ולרענן את הנתונים באופן דינמי
יחסית למקום הזה.
הצגה חזותית – הוספת ביקורות ותמונות על מקומות
ואת זמן ההליכה והמרחק, כדי שהמשתמשים יוכלו להבין במהירות אם זה מתאים לצרכים שלהם.
ארכיטקטורת עזר
גילוי מקומי
יש הרבה דרכים ליצור חוויית גילוי מקומית. השילוב הבא הוא דוגמה מותאמת אישית לחוויית משתמש שבה נעשה שימוש בממשקי API ידועים של הפלטפורמה של מפות Google וגם בכמה תכונות חדשות ומעניינות. אם אתם רוצים להשתמש בתבנית לזיהוי מקומי באמצעות תבנית, תוכלו להשתמש ברכיבי אינטרנט.
אפליקציה לדוגמה
הדרכה מפורטת לדוגמה
בטבלה שבהמשך מופיעה האפליקציה לדוגמה, בחלוקה לשלבים יחד עם תיאור של ההטמעה הטכנית באמצעות ממשקי ה-API של הפלטפורמה של מפות Google.
1. חיפוש מיקום עם השלמה אוטומטית של חיפוש המיקום
- טוענים את API JavaScript של מפות Google.
- שאילתה של השלמה אוטומטית של מקומות או לבחור מיקום במפה.
2. הצגה של נקודות עניין מקומיות באמצעות API של חיפוש בקרבת מקום (חדש)
- דירוג פופולריות (תוצאות רלוונטיות יותר) או דירוג מרחק.
includedTypes
,excludedTypes
; אם יש מלון, אפשר להחריג את סוג המקום 'לינה' ולכלול רק סוגים מתאימים, כלומר 'מסעדה, בית קפה, פארק', 'סיורit_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, ואז לשלוח שאילתה אחת בכל פעם בחוויה
מספר השאילתות והעלות המשויכות
- API JavaScript של מפות Google: מפה אחת בטעינה של החוויה.
- Places השלמה אוטומטית API: שאילתה אחת לכל תו שמוקלד (אם משתמשים בווידג'ט ההשלמה האוטומטית). אפשר להתאים אותו אישית.
- Nearby Search (New) API: שאילתה אחת לכל 20 מקומות שמוצגים. החיוב שונה בהתאם לנתוני המקום, שהם חלק מתגובת השאילתה.
- Directions API: שאילתה אחת לגבי כל מקום שהמשתמש בחר.
- Place Photo API: שאילתה אחת לכל תמונה שמוצגת.
סיכום
חוויית גילוי מקומי היא דרך יעילה לספק ערך למשתמש. הטמעת ההדגמה הזו כוללת הרבה תכונות שסביר להניח שתכללו כשתיצרו חוויה כזו בפלטפורמה של מפות Google עם יכולות מיוחדות מ-Nearby Search API (New) API .
השלבים הבאים
הצעות לקריאה נוספת:
- רכיבי אינטרנט ב-Maps JavaScript API
- אופטימיזציה להשלמה אוטומטית של מקומות
- שירותי מקומות אחרים
- נשמח לקבל ממך משוב למטה.
תורמים
מחברים ראשיים:
תומס אנגלר | מהנדס פתרונות פלטפורמה של מפות Google