סקירה כללית

בחירת פלטפורמה: Android iOS JavaScript שירות אינטרנט
ממשק API של מקומות הוא שירות שמקבל בקשות HTTP לנתוני מיקום במגוון שיטות. היא מציגה נתוני מיקום מעוצבים ותמונות של מוסדות, מיקומים גיאוגרפיים או נקודות עניין בולטות.

למה כדאי להשתמש ב-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 יחד עם הנתונים שהוא מחזיר.

מקורות מידע הנתונים שהוחזרו פורמט החזרה
חיפוש מקום מחזירה רשימת מקומות על סמך מיקום המכשיר או מחרוזת חיפוש.

פרטים נוספים זמינים במאמרים הוספת תשובות לחיפוש, תגובות לחיפוש בקרבת מקום ותגובות לחיפוש בטקסט.

  • JSON
  • XML
פרטי המקום מחזירה מידע מפורט יותר לגבי מקום ספציפי, כולל ביקורות משתמשים.

לפרטים נוספים, אפשר לעיין בקטע תשובות לפרטי המקום.

  • JSON
  • XML
תמונות של מקומות מספק גישה למיליוני תמונות הקשורות למקום המאוחסנים במסד הנתונים של Google Place.

לפרטים נוספים על התגובה לתמונות של המקום.

  • JSON
  • XML
הוספת השלמה אוטומטית ממלא באופן אוטומטי את השם ו/או הכתובת של המקום בזמן שהמשתמשים מקלידים.

כאן תוכלו לקרוא פרטים נוספים על השלמה אוטומטית של תשובות.

  • JSON
  • XML
השלמה אוטומטית של שאילתות מספקת שירות לחיזוי שאילתות בחיפושים גיאוגרפיים מבוססי-טקסט, ומחזירה שאילתות מוצעות תוך כדי הקלדה.

לפרטים נוספים, תוכלו לקרוא את המאמר תשובות להשלמה אוטומטית של שאילתות.

  • JSON
  • XML

כיצד להשתמש ב-API של 'מקומות'

השלבים הבאים מתארים תרחיש אופייני לשימוש בתרחיש של שימוש בשלוש נקודות קצה (endpoint) בשירות API של מקומות Google. כשאתם יוצרים את הפתרון, אתם יכולים להשתמש בנקודות קצה נוספות, כמו 'חיפוש בקרבת מקום', 'תמונות של מקום' ו'השלמה אוטומטית של שאילתות'.
1 להגדרת האפליקציה בשלב הראשון, מגדירים את הפרויקט ב-Google Cloud ומשלימים את ההוראות שבהמשך. איך משתמשים במפתח ה-API?
2 חיפוש בסיסי של טקסט אחרי שמקבלים מפתח API, מבצעים חיפוש טקסט פשוט כפי שמצוין בדוגמאות לחיפוש טקסט בסיסי במדריך חיפוש טקסט.
3 שימוש בבקשה לחיפוש מקום בקשות לחיפוש מקום יחזירו מזהה מקום, וגם שדות נתונים שביקשת, כמו שעות פתיחה, כתובת ותמונות. מומלץ לעיין בחיפוש דוגמאות של מקומות ולנסות דוגמה רלוונטית יותר לתרחיש לדוגמה שלך.
4 העקרונות הבסיסיים לשימוש בתגובות למקומות מעיינים בנתונים שמוחזרים מתגובת 'חיפוש מקום'. לפרטים נוספים, אפשר לקרוא את המאמר חיפוש תשובות למקומות.
5 אפשר להשתמש במזהה המקום כדי לקבל פרטים נוספים התשובות על המקום לא מספקות את כל הנתונים הזמינים לגבי מקום מסוים. כדי לקבל פרטים נוספים על מקום מסוים, אפשר להשתמש במזהה המקום שמוחזר מתגובה לחיפוש מקום. פרטים נוספים על המקום.

ספריות לקוח זמינות

קראו ל-API בשפה הרצויה דרך אחת מספריות הלקוח:

לקוחות Java, Python Client, Go Client ו-Node.js עבור שירותי מפות Google הם ספריות לקוח שנתמכות על ידי הקהילה, בקוד פתוח בהתאם לרישיון Apache 2.0. מורידים אותם מ-GitHub. שם אפשר גם למצוא הוראות התקנה וקוד לדוגמה.

המאמרים הבאים