למה כדאי להשתמש ב-Places API
יצירת תכונות מבוססות-מיקום כדי שלמשתמשים תהיה גישה קלה לנתוני מיקום מפורטים. הנתונים הזמינים דרך Places API מבוססים על אחד מהמודלים המדויקים, המעודכנים והמקיפים ביותר של מקומות בעולם האמיתי. תרחישים לדוגמה של אפליקציות:
- הצגת דירות להשכרה בערים גדולות עם תוצאות שמיועדות ספציפית לערים.
- יש לכלול את פרטי המקום בעדכוני הסטטוס של האיסוף או המסירה.
- הצגה של רשימת פארקים באזור יחד עם תמונות וביקורות שנשלחו על ידי משתמשים.
- ניתן לספק לאנשים שמתכננים נסיעות עם פרטים ליצירת קשר, ביקורות ורמות מחיר עבור ארגונים לאורך הדרך.
מה אפשר לעשות עם ה-API של 'מקומות'
תוכלו להשתמש ב-API של 'מקומות' כדי לכלול את התכונות הבאות באפליקציות שלכם:
- הצגת תוצאות חיפוש של מקומות מסוגים שונים של שאילתות משתמשים, כמו קלט טקסט, מיקומים בקרבת מקום ושאילתות מעורפלות או לגבי קטגוריות מסוימות.
- הפעלת תכונות של השלמה אוטומטית לסוגי חיפוש שונים, עבור שאילתות טקסט ספציפיות או שאילתות קטגוריות.
- ניתן לצמצם את סוג הפרטים שמוחזרים לגבי מקום, כמו שעות פעילות, סיכום, ביקורות של משתמשים ותמונה.
- הוספת תמונות באיכות גבוהה למיקומים שמוצגים על ידי האפליקציה שלך.
איך פועל ה-API של מקומות Google
ה-API של מקומות Google מקבל בקשות ככתובת URL רגילה עם נקודת קצה ספציפית של שירות, כמו /place
או /photo
. נקודות הקצה (endpoints) גם
מקבלות את סוג הפורמט המצוין בבקשה, JSON או XML. לבסוף, בבקשת השירות נעשה שימוש בפרמטרים הרלוונטיים לנקודת הקצה הספציפית הזו כדי לשפר את הנתונים שמוצגים.
לדוגמה, הבקשה הבאה לפרטי מקום עבור רכיבי כתובת פועלת באופן הבא, בהנחה שהחזרה בפורמט JSON:
https://maps.googleapis.com/maps/api/place/details/json ?place_id=ChIJrTLr-GyuEmsRBfy61i59si0 &fields=address_components &key=YOUR_API_KEY
במקרה כזה, השירות משתמש במזהה המקום שסופק כדי למצוא את המקום המבוקש, ולהחזיר את רכיבי הכתובת בפורמט JSON.
משאבים
בטבלה הבאה מופיע סיכום של המשאבים שזמינים דרך Places API יחד עם הנתונים שהוא מחזיר.
מקורות מידע | הנתונים שהוחזרו | פורמט החזרה |
---|---|---|
חיפוש מקום | מחזירה רשימת מקומות על סמך מיקום המכשיר או מחרוזת חיפוש.
פרטים נוספים זמינים במאמרים הוספת תשובות לחיפוש, תגובות לחיפוש בקרבת מקום ותגובות לחיפוש בטקסט. |
|
פרטי המקום | מחזירה מידע מפורט יותר לגבי מקום ספציפי, כולל ביקורות משתמשים.
לפרטים נוספים, אפשר לעיין בקטע תשובות לפרטי המקום. |
|
תמונות של מקומות | מספק גישה למיליוני תמונות הקשורות למקום המאוחסנים במסד הנתונים של Google Place.
לפרטים נוספים על התגובה לתמונות של המקום. |
|
הוספת השלמה אוטומטית | ממלא באופן אוטומטי את השם ו/או הכתובת של המקום בזמן שהמשתמשים מקלידים.
כאן תוכלו לקרוא פרטים נוספים על השלמה אוטומטית של תשובות. |
|
השלמה אוטומטית של שאילתות | מספקת שירות לחיזוי שאילתות בחיפושים גיאוגרפיים מבוססי-טקסט, ומחזירה שאילתות מוצעות תוך כדי הקלדה.
לפרטים נוספים, תוכלו לקרוא את המאמר תשובות להשלמה אוטומטית של שאילתות. |
|
כיצד להשתמש ב-API של 'מקומות'
השלבים הבאים מתארים תרחיש אופייני לשימוש בתרחיש של שימוש בשלוש נקודות קצה (endpoint) בשירות API של מקומות Google. כשאתם יוצרים את הפתרון, אתם יכולים להשתמש בנקודות קצה נוספות, כמו 'חיפוש בקרבת מקום', 'תמונות של מקום' ו'השלמה אוטומטית של שאילתות'.1 | להגדרת האפליקציה | בשלב הראשון, מגדירים את הפרויקט ב-Google Cloud ומשלימים את ההוראות שבהמשך. איך משתמשים במפתח ה-API? |
2 | חיפוש בסיסי של טקסט | אחרי שמקבלים מפתח API, מבצעים חיפוש טקסט פשוט כפי שמצוין בדוגמאות לחיפוש טקסט בסיסי במדריך חיפוש טקסט. |
3 | שימוש בבקשה לחיפוש מקום | בקשות לחיפוש מקום יחזירו מזהה מקום, וגם שדות נתונים שביקשת, כמו שעות פתיחה, כתובת ותמונות. מומלץ לעיין בחיפוש דוגמאות של מקומות ולנסות דוגמה רלוונטית יותר לתרחיש לדוגמה שלך. |
4 | העקרונות הבסיסיים לשימוש בתגובות למקומות | מעיינים בנתונים שמוחזרים מתגובת 'חיפוש מקום'. לפרטים נוספים, אפשר לקרוא את המאמר חיפוש תשובות למקומות. |
5 | אפשר להשתמש במזהה המקום כדי לקבל פרטים נוספים | התשובות על המקום לא מספקות את כל הנתונים הזמינים לגבי מקום מסוים. כדי לקבל פרטים נוספים על מקום מסוים, אפשר להשתמש במזהה המקום שמוחזר מתגובה לחיפוש מקום. פרטים נוספים על המקום. |
ספריות לקוח זמינות
קראו ל-API בשפה הרצויה דרך אחת מספריות הלקוח:
- לקוח Java עבור שירותי מפות Google
- הלקוח של Python לשירותי מפות Google
- מעבר לשירות הלקוח של מפות Google
- לקוח Node.js עבור שירותי מפות Google
לקוחות Java, Python Client, Go Client ו-Node.js עבור שירותי מפות Google הם ספריות לקוח שנתמכות על ידי הקהילה, בקוד פתוח בהתאם לרישיון Apache 2.0. מורידים אותם מ-GitHub. שם אפשר גם למצוא הוראות התקנה וקוד לדוגמה.
המאמרים הבאים
- התחלת השימוש בחיפוש API של מקומות: עוברים אל חיפוש מקומות.
- קבלת מפתח API: עוברים אל שימוש במפתחות API