סקירה
הפלטפורמה של מפות Google זמינה לאינטרנט (JS, TS), ל-Android ול-iOS, וכוללת גם ממשקי API של שירותי אינטרנט לקבלת מידע על מקומות, מסלולים ומרחקים. הדוגמאות במדריך הזה נכתבו לפלטפורמה אחת, אבל קישורים למסמכי תיעוד סופקו להטמעה בפלטפורמות אחרות.
משתמשים בדרך כלל קשה להבין את הצהרות העסקאות. הם משתמשים בקיצורים כמו ACMEHCORP במקום בשמות מוֹכרים כמו "Acme Houseware", דבר שיכול להוביל לעלייה במספר הקריאות לתמיכת לקוחות ובמחלוקות יקרות. התכונה 'טרנזקציות עשירות' מפשטת את העסקאות האלה והופכת אותן לאינטואיטיביות על ידי ציון השם המלא והקטגוריה של העסק של המוכר, תמונה של חזית החנות, הכתובת והמיקום שלה במפה, פרטים מלאים ליצירת קשר ועוד. כך ניתן להגביר את שביעות הרצון והשקיפות של המשתמשים, וגם להפחית את מספר השיחות לתמיכת לקוחות, להגדיל את ערך ה-NPS ולהאריך את זמן השימוש באפליקציה.
הקטע 'עסקאות עשירות' – מדריך ההטמעה והטיפים להתאמה אישית שאנחנו מספקים בנושא הזה – הוא השילוב האופטימלי של ממשקי ה-API של הפלטפורמה של מפות Google, כדי ליצור חוויית משתמש מעולה בהיסטוריית הטרנזקציות. במדריך ההטמעה הזה מוסבר איך להתאים מיקום למוכר ספציפי ולהציג את המידע המפורט שלו.
![מסכים לדוגמה של טרנזקציות](https://google-developers.gonglchuangl.net/static/maps/solutions/enriched-transactions/images/diagram.png?authuser=0&hl=he)
הפעלת ממשקי API
כדי להטמיע טרנזקציות מועשרות, צריך להפעיל את ממשקי ה-API הבאים במסוף Google Cloud. ההיפר-קישורים הבאים שולחים אתכם למסוף Google Cloud כדי להפעיל כל API בפרויקט שבחרתם:
מידע נוסף על ההגדרה זמין במאמר תחילת העבודה עם הפלטפורמה של מפות Google.הקטעים של מדריך ההטמעה
בהמשך מפורטים היישומים וההתאמות האישיות שנעסוק בהם בנושא זה.
- סמל סימן הווי הוא שלב מרכזי בהטמעה.
- סמל הכוכב הוא התאמה אישית אופציונלית אבל מומלצת כדי לשפר את הפתרון.
התאמה של מוכרים לפלטפורמה של מפות Google | שיוך של מוכר בהיסטוריית העסקאות למקום כלשהו בפלטפורמה של מפות Google. | |
הצגה של פרטי מוֹכר | הצגת טרנזקציות עשירות בנתונים שמציגות מידע מועיל על המוֹכר כדי שהמשתמשים יוכלו לזהות את העסקה במהירות. | |
הוספת מפה של מיקום המוכר | מוסיפים מפה של מיקום המוכר. |
התאמה בין מוכרים לפלטפורמה של מפות Google
בדוגמה הזו: Place API |
בתרשים הבא אפשר לראות איך האפליקציה תואמת לעסקאות של מוכרים כדי להחזיר תוצאה באמצעות פרטי מקום ממסד נתונים קיים של מוֹכרים או דרך בקשת חיפוש מקום:
![מטריצת זרימה למוכר](https://google-developers.gonglchuangl.net/static/maps/solutions/enriched-transactions/images/decision-matrix-diagram.png?authuser=0&hl=he)
קבלת מזהי מקומות בפלטפורמה של מפות 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_id
.
אם פרטי המקום שמציגים לא תואמים למוכר שבו הוא ביצע את העסקה, מומלץ לאפשר למשתמשים לשלוח משוב על איכות ההתאמה למוכר.
מוצגים פרטי המוכר
בדוגמה הזו: Place API | זמין גם: Places SDK ל-Android | Places SDK ל-iOS | ספריית מקומות, Maps JavaScript API |
אפשר לשתף את פרטי המקום שהמשתמשים צריכים לדעת אחרי שהם מבקרים באחד מהמיקומים שלכם. האפליקציה יכולה להציג למשתמשים פרטי מקום עשירים, כמו פרטים ליצירת קשר, שעות פעילות, דירוגי משתמשים ותמונות של משתמשים, כדי להזכיר למשתמשים שהם השלימו את העסקה. אחרי ששולחים קריאה ל-Places API כדי לקבל פרטי מקום, אפשר לסנן ולעבד את התשובה בחלון מידע, בסרגל צד באינטרנט או בכל דרך אחרת.
![מסך של פרטי מוכר לדוגמה](https://google-developers.gonglchuangl.net/static/maps/solutions/enriched-transactions/images/enriched-transactions.png?authuser=0&hl=he)
כדי לבקש פרטי מקום, צריך את מזהה המקום של כל אחד מהמיקומים. ראו קבלת מזהי מקומות כדי לאחזר את מזהה המקום של המיקום.
הבקשה הבאה של Place Details מחזירה את הכתובת, הקואורדינטות, האתר, מספר הטלפון, הדירוג ושעות הפעילות בפלט 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 | Maps Static API | זמין גם: 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 של Maps Static API עם סמן יחיד בקו הרוחב, בקו האורך או בכתובת של המוכר. תוכלו להשתמש ב-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) | סמנים=color:red%7C25.033976%2C121.5645389 |
סגנון מפה מבוסס-ענן | map_id=b224095f76859890 |
מפתח API | key=YOUR_API_KEY |
חתימה דיגיטלית (כך חותמים על בקשה דיגיטלית) | חתימה=BASE64_SIGNATURE |
פרמטר של ערוץ פתרונות (מידע נוסף זמין במסמכי התיעוד בנושא פרמטרים) | solution_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 של מפות ל-Android או ב-SDK של מפות Google ל-iOS, תוכלו להציב סמן באמצעות קואורדינטות מהמידע בפרטי המקום.
מכיוון שהמשתמשים יראו את המפה כדי לאשר עסקאות במקום לעיין או לנווט, בחרו מפה עם אינטראקטיביות מוגבלת:
- לאפליקציות ל-Android, ראו מדריך להוספת מפה באמצעות סמנים והפעילו את מצב Lite כדי להגביל את האינטראקטיביות.
- לאפליקציות iOS, ראו מדריך להוספת מפה באמצעות סמנים והשבתת הפקדים והתנועות עם הדגל
GMSUiSettings
.