סקירה כללית
הפלטפורמה של מפות Google זמינה לאינטרנט (JS, TS), ל-Android ול-iOS, וגם מציעה ממשקי API של שירותי אינטרנט לקבלת מידע על מקומות, מסלולים ומרחקים. הדוגמאות במדריך הזה נכתבו עבור פלטפורמה אחת, אבל יש קישורי תיעוד להטמעה בפלטפורמות אחרות.
למשתמשים קשה יותר להבין את הצהרות העסקאות, כי בעזרת קיצורים כמו ACMEHCORP במקום שמות של מוכרים כמו 'כלי בית של Acme', מספר השיחות לתמיכת לקוחות עשוי לגדול ולערעורים יקרים. עסקאות מוגברות מפשטות את הטרנזקציות והופכות אותן לאינטואיטיביות, באמצעות הצגת השם המלא והקטגוריה של העסק של המוכר, תמונה של חזית החנות, הכתובת והמיקום של החנות במפה, פרטים מלאים ליצירת קשר ועוד. כך אפשר להגביר את שביעות הרצון של המשתמשים ואת השקיפות שלהם, והם יכולים גם לצמצם את מספר השיחות לתמיכת לקוחות, להגדיל את NPS ולהאריך את זמן השימוש באפליקציה.
פיתוח טרנזקציות – מדריך להטמעה וטיפים להתאמה אישית שאנחנו מספקים בנושא הזה – הוא השילוב האופטימלי של ממשקי ה-API של הפלטפורמה של מפות Google ליצירת חוויית משתמש מצוינת בהיסטוריית העסקאות. במדריך ההטמעה הזה מוסבר איך להתאים מיקום למוכר ספציפי ולהציג את המידע המפורט שלו.
הפעלת ממשקי API
כדי להטמיע עסקאות מועשרות, צריך להפעיל את ממשקי ה-API הבאים במסוף Google Cloud. ההיפר-קישורים הבאים מפנים אתכם למסוף Google Cloud כדי להפעיל כל ממשק API בפרויקט שבחרתם:
- Places API.
- ממשק API לקידוד גיאוגרפי.
- מפות סטטיות של מפות Google, SDK של מפות Google ל-Android או SDK של מפות Google ל-iOS.
קטעים של מדריך הטמעה
בהמשך ניתן למצוא את היישומים וההתאמות האישיות שנדון בהם בנושא זה.
- סמל סימן הווי הוא שלב עיקרי בהטמעה.
- סמל הכוכב הוא אופציונלי, אבל מומלץ להתאים אישית כדי לשפר את הפתרון.
| התאמת מוכרים לפלטפורמה של מפות Google | שיוך מוכר בהיסטוריית העסקאות למקום כלשהו בפלטפורמה של מפות Google. | |
| הצגת פרטי המוכר | הצגת טרנזקציות עתירות נתונים שמציגות מידע שימושי לגבי המוכר, כדי שהמשתמשים יוכלו לזהות במהירות את העסקה. | |
| הוספת מפה של מיקום המוכר | יש להוסיף מפה של מיקום המוכר. |
התאמת מוכרים לפלטפורמה של מפות Google
| בדוגמה הזו נעשה שימוש ב: Places API |
התרשים הבא מציג כיצד האפליקציה שלך תואמת לעסקאות של מוכרים, כדי להחזיר תוצאה באמצעות 'פרטי מקום' ממסד נתונים קיים של סוחרים או באמצעות בקשה של 'חיפוש מקום':
מתקבלים מזהי מקומות בפלטפורמה של מפות Google
יכול להיות שיש לכם מסד נתונים של מוכרים עם מידע בסיסי כמו שם העסק והכתובת שלו. כדי לקבל מידע על המקום בפלטפורמה של מפות Google, כולל פרטים ליצירת קשר ופרטים שנוספו על ידי משתמשים, אתם צריכים את מזהה המקום בפלטפורמה של מפות Google שתואם לכל אחד מהמוכרים במסד הנתונים.
כדי למצוא את מזהה המקום של עסק מסוים, צריך לשלוח בקשה לנקודת הקצה /findplacefromtext ב- Places API ולבקש רק את השדה place_id לחיוב הבקשה כקריאה ללא חיוב Find Place - ID only. אם למוכר יש כמה מיקומים, השתמשו בשם המוכר לצד שם העיר או הרחוב. איכות הנתונים שהשיחה מחזירה משתנה, ולכן צריך לבדוק אם התוצאות שהוחזרו אכן תואמות למוכר הרצוי.
לפניכם דוגמה לבקשת מזהה המקום של המשרד של Google בטאיפיי באמצעות שם המוכר והעיר:
https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=google%20taipei&inputtype=textquery&fields=place_id&key=YOUR_API_KEY&solution_channel=GMP_guides_enrichedtransactions_v1_a
הקפידו לקודד את כתובת ה-URL לפרמטר הקלט בבקשת ה-API.
מזהי מקומות אחסון
כדי לאחסן מידע על המוכר מהפלטפורמה של מפות Google לבקשות עתידיות, אתם יכולים לאחסן את מזהה המקום הזה במסד הנתונים שלכם ללא הגבלה, כחלק מרשומת המוכר. עליכם לבצע את הבקשה 'חיפוש מקום' פעם אחת בלבד לכל מוכר. אתם יכולים גם לחפש את מזהה המקום בכל פעם שמשתמש מבקש פרטי עסקה.
כדי להבטיח שתמיד יהיה לכם את המידע המדויק ביותר, צריך לרענן את מזהי המקומות כל 12 חודשים באמצעות בקשת Place Details עם הפרמטר place_id.
אם פרטי המקום שמוצגים אינם תואמים למוכר שבו הוא ביצע את העסקה, מומלץ לאפשר למשתמשים לספק משוב לגבי איכות ההתאמה למוכר.
מוצגים פרטי המוכר
| בדוגמה הזו נעשה שימוש ב: Places API | זמין גם: Places SDK for Android | Places SDK עבור iOS | Places Library, Maps JavaScript API |
ניתן לשתף את פרטי המקום שהמשתמשים צריכים לדעת אחרי שהם מגיעים לאחד מהמיקומים שלך. האפליקציה כוללת 'פרטי מקום' עשירים, כמו פרטים ליצירת קשר, שעות פעילות, דירוגי משתמשים ותמונות של משתמשים. כך האפליקציה יכולה להזכיר למשתמשים לגבי העסקה שהושלמה. אחרי שביצעתם קריאה ל-Places API לקבלת פרטי מקום, תוכלו לסנן ולעבד את התשובה בחלון מידע, בסרגל צד באינטרנט או בכל דרך אחרת שתרצו.
כדי לבקש פרטי מקום, יש צורך במזהה המקום של כל אחד מהמיקומים. כדי לאחזר את מזהה המקום של המיקום שלכם, קראו את המאמר קבלת מזהי מקומות.
הבקשה הבאה של 'פרטי מקום' מחזירה את הכתובת, הקואורדינטות, האתר, מספר הטלפון, הדירוג ושעות הפעילות בפלט json במזהה המקום של Google Taipei 101:
https://maps.googleapis.com/maps/api/place/details/json?placeid=ChIJraeA2rarQjQRyAqIxkx2vN8&fields=name%2Cformatted_address%2Cwebsite%2Cformatted_phone_number%2Cgeometry/location%2Cicon%2Copening_hours%2Crating&key=YOUR_API_KEY&solution_channel=GMP_guides_enrichedtransactions_v1_a
הוספת מפה של מיקום המוכר
| בדוגמה הזו נעשה שימוש ב: Geocoding API | Static API של מפות Google | זמין גם: Android | iOS |
קביעת המיקום של המוכר
ה-API הסטטי של מפות Google מקבל כתובת או קואורדינטות כדי להציב סמן. אם ברשומה של המוכר כבר יש כתובת, תוכלו לדלג לקטע הבא אבל מומלץ להשתמש בקואורדינטות על פני כתובות כדי לשפר את הדיוק של המפה.
אם במסד הנתונים של המוכר יש כתובות של רחובות, אבל לא קואורדינטות גיאוגרפיות ואתם עדיין לא ביקשתם פרטי מקום, תוכלו להשתמש ב-Geocoding API כדי להמיר כתובות רחובות לקואורדינטות של אורך ורוחב בצד השרת, לאחסן קואורדינטות במסד הנתונים ולרענן את הקואורדינטות פעם אחת לפחות בכל 30 ימים.
הנה דוגמה לשימוש ב-Geocoding API כדי לקבל את קווי האורך והרוחב של מזהה מקום המשרדים של Google בטאיפיי:
https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJraeA2rarQjQRyAqIxkx2vN8&key=YOUR_API_KEY&solution_channel=GMP_guides_enrichedtransactions_v1_a
הוספת סמן למיקום של המוכר למפה
מאחר שהמשתמשים שלך יראו את המפה כדי לאשר עסקאות במקום לעיין או לנווט, מומלץ ליצור מפה עם אינטראקטיביות מוגבלת.
באינטרנט לנייד ולמחשב, צריך ליצור כתובת URL של ה-API הסטטי של מפות Google עם סמן יחיד בקו הרוחב/באורך או בכתובת של המוכר. תוכלו להשתמש ב-API הסטטי של מפות Google באמצעות קריאה לשירות אינטרנט, שיוצרת גרסת תמונה של המפה בהתאם לפרמטרים שציינתם. בנייד, מדלגים לפריט הבא הוספת מפה בקטע של אפליקציה לנייד.
הקריאה הבאה מציגה מפת דרכים בגודל של 640x480 פיקסלים, במרכזה של סמן במשרד Google בטאיפיי ברמת ברירת המחדל של מרחק התצוגה. בנוסף, מופיעים סימון אדום של מיקום המסירה וסגנון מפה מבוסס-ענן:
https://maps.googleapis.com/maps/api/staticmap?size=640x480&markers=color:red%7C25.033976%2C121.5645389&map_id=b224095f76859890&key=YOUR_API_KEY&signature=BASE64_SIGNATURE&solution_channel=GMP_guides_enrichedtransactions_v1_a
המעקב מתחלק לקטעים הבאים:
| כתובת URL של ה-API | https://maps.googleapis.com/maps/api/staticmap? |
| גודל התמונה | גודל=640x480 |
| סמני מיקום של מוכרים (באמצעות קידוד כתובות URL) | marks=color:red%7C25.033976%2C121.5645389 |
| סגנון מפה מבוסס-ענן | map_id=b224095f76859890 |
| מפתח API | key=YOUR_API_KEY |
| חתימה דיגיטלית (כך חותמים על בקשה דיגיטלית) | חתימה=BASE64_SIGNATURE |
| פרמטר של ערוץ פתרון (לעיון במסמכי התיעוד בנושא פרמטרים) | result_channel=GMP_guides_enrichedtransactions_v1_a |
זו תהיה התמונה, כפי שמוצג בהמשך:
אפשר גם להשתמש בכתובת כמיקום הסמן:
https://maps.googleapis.com/maps/api/staticmap?size=640x480&markers=color:green%7CTaipei%20101%20Tower%2CNo.%207信義路五段信義區台北市%20Taiwan%20110&map_id=b224095f76859890&key=YOUR_API_KEY&signature=BASE64_SIGNATURE&solution_channel=GMP_guides_enrichedtransactions_v1_a
למידע על אפשרויות נוספות של פרמטרים, עיינו במסמכי התיעוד של Maps Static API.
הוספת מפה באפליקציה לנייד
אם אתם משתמשים ב-SDK של מפות Google ל-Android או ב-SDK של מפות Google ל-iOS, תוכלו להציב סמן באמצעות קואורדינטות מהמידע שמופיע בפרטי מקום.
מאחר שהמשתמשים שלך יראו את המפה כדי לאשר עסקאות ולא כדי לעיין או לנווט, מומלץ לבחור מפה עם אינטראקטיביות מוגבלת:
- באפליקציות ל-Android, תוכלו לעיין במאמר הוספת מפה עם מדריך סימון ולהפעיל את מצב הטעינה המהירה כדי לאפשר אינטראקטיביות מוגבלת.
- באפליקציות ל-iOS תוכלו להיעזר בהוספת מפה עם הדרכה לשימוש בסמנים ובהשבתת הפקדים והתנועות באמצעות הדגל
GMSUiSettings.