במאמר הזה נסביר איך להשתמש ב-Nearby Search (New) API כדי ליצור ממשק פשוט וחסכוני
חוויית גילוי מקומית.
כשמשתמשים מחפשים מלון או נדל"ן, חוויית הגילוי המקומית מציגה להם מקומות עניין מרכזיים ליד המיקום שציינתם. בדרך כלל הוא כולל מפה אינטראקטיבית, עם חלונית נוספת שמכילה בוחר מקומות וגלריית תמונות. יוצגו לכם מוצרים ויכולות שונים של Google Maps Platform, כדי לשפר את החוויה באמצעות אינטראקטיביות.

תרחישים לדוגמה
עכשיו נבין אילו רכיבים בשילוב של "חיפוש מקומי" מספקים ערך למשתמשים:
גילוי – הצגת סקירה כללית של מה שנמצא סביב מיקום מסוים על ידי הצגת מקומות רלוונטיים מסוגים שונים.
thought אינטראקטיביות – המשתמשים יכולים לבחור מקום ולרענן את הנתונים באופן דינמי
ביחס למקום הזה.
תצוגה חזותית – הוספת ביקורות ותמונות של מקומות
כדי שהמשתמשים יוכלו להבין במהירות אם הוא מתאים לצרכים שלהם.
ארכיטקטורה לדוגמה

גילוי מקומי
יש הרבה דרכים ליצור חוויית גילוי מקומית. השילוב הבא הוא דוגמה בהתאמה אישית לחוויית שימוש שמבוססת על ממשקי API מוכרים של Google Maps Platform, וגם על כמה תכונות חדשות ומעניינות. אם אתם רוצים להשתמש בגישה מבוססת-תבנית לחיפוש מקומי, אתם יכולים להשתמש ברכיבי אינטרנט.
אפליקציה לדוגמה
הדרכה לדוגמה
בטבלה הבאה מפורטים השלבים של האפליקציה לדוגמה, יחד עם תיאור של ההטמעה הטכנית באמצעות ממשקי ה-API של הפלטפורמה של מפות Google.
1. חיפוש מיקום עם השלמה אוטומטית
- טוענים את Maps JavaScript API.
- שאילתה של השלמה אוטומטית למקומות או בחירת מיקום במפה.

2. הצגת נקודות עניין מקומיות באמצעות חיפוש בסביבה (חדש) API
- דירוג לפי פופולריות (תוצאות רלוונטיות יותר) או דירוג לפי מרחק.
-
includedTypes,excludedTypes; אם אתם מלון, אתם יכולים להחריג את הסוג "לינה" ולכלול רק סוגים מתאימים, למשל: "מסעדה, בית קפה, פארק, אטרקציה תיירותית". - כדי לקבל שליטה רבה יותר על התוצאות, כדאי להשתמש ב-
includedPrimaryTypes,excludedPrimaryTypes. - `locationRestriction כדי להימנע ממספר לא מספיק של תוצאות או ממקומות רחוקים מדי. אם אין תוצאות, צריך להרחיב את גודל המעגל או המלבן לפני שמציגים את התוצאות.

שאילתה לדוגמה כשמזמינים מלון עם שדות הנתונים המבוקשים:
- בסיסי (
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.תמונות: במהלך התצוגה המקדימה ללא הגבלה של Nearby Search (New) API, תצטרכו לשלוח שאילתה ל-Places Details עם
place.idכדי לקבל את photo_reference, ואז לשלוח שאילתה אחת בכל פעם בחוויה שלכם.

מספר השאילתות והעלות שמשויכת אליהן
- Maps JavaScript API: מפה אחת בטעינת החוויה.
- Places Autocomplete API: שאילתה אחת לכל תו שמוקלד (אם משתמשים בווידג'ט ההשלמה האוטומטית למקומות), אפשר להתאים אישית את ההגדרה הזו.
- חיפוש בסביבה (חדש) API: שאילתה אחת לכל 20 מקומות שמוצגים. חיוב שונה בהתאם לנתוני המקום שכלולים בתגובה לשאילתה.
- Directions API: שאילתה אחת לכל מקום שהמשתמש בוחר.
- Place Photo API: שאילתה אחת לכל תמונה שמוצגת.
סיכום
חוויית גילוי מקומית היא דרך יעילה לספק ערך למשתמשים. ההטמעה לדוגמה כוללת הרבה תכונות שכדאי לכלול כשיוצרים חוויה כזו בפלטפורמה של מפות Google, עם יכולות מיוחדות מ-Nearby Search (New) API .
השלבים הבאים
הצעות לקריאה נוספת:
- רכיבי אינטרנט ב-Maps JavaScript API
- אופטימיזציה של השלמה אוטומטית למקומות
- שירותים אחרים של Places
- אפשר לשלוח משוב למטה.
תורמים
מחברים ראשיים:
Thomas Anglaret | מהנדס פתרונות בפלטפורמה של מפות Google