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