שימוש בממשקי API של מקומות ובקידוד גיאוגרפי עם סגנון מבוסס-נתונים להגדרת גבולות

בחירת פלטפורמה: iOS JavaScript

כדי לחפש אזורים ולקבל מידע נוסף על מקומות, אפשר להשתמש ב-Places SDK ל-iOS וב-Geocoding API יחד עם ה-SDK של מפות Google ל-iOS. ה-Places SDK ל-iOS ו-Geocoding API הם חלופות חזקות ויציבות לקבלת מזהי מקום. אם אתם כבר משתמשים במזהי מקומות, תוכלו לעשות שימוש חוזר במזהים האלה עם עיצוב מבוסס-נתונים לגבולות.

הוספת מקומות וקידוד גיאוגרפי ל-SDK של מפות Google עבור אפליקציות ל-iOS בדרכים הבאות:

  • האפשרות Places SDK ל-iOS מחזירה מידע על מקומות באמצעות בקשות HTTP.
  • המחלקה של CLGeocoder יכולה לבצע קואורדינטות ולהפך באופן דינמי את הקוד הגיאוגרפי מהקלט של המשתמש.
  • Geocoding API מאפשר לבצע קואורדינטות של כתובות מוכרות עם קואורדינטות.

שימוש ב-Places API

  • חיפוש טקסט של Places API מחזיר מידע על קבוצת מקומות לפי מחרוזת - לדוגמה "פיצה בתל אביב", "חנויות נעליים ליד רוטשילד" או "הרצל 12". השירות משיב עם רשימה של מקומות שתואמים למחרוזת הטקסט וכל הטיית מיקום שהוגדרה.

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

קבלת פרטים על אזור מסוים

  • גם נתוני Place Details של אזור יכולים להיות יעילים. לדוגמה, אתם יכולים:

    • חיפוש מזהים של מקומות גבולות לפי שמות של מקומות.
    • קבלת אזור התצוגה לשינוי מרחק התצוגה עד לגבול.
    • אתם יכולים לקבל את סוג התכונה עבור הגבול (לדוגמה, רשות מוניציפאלית).
    • מוצאים את הכתובת בפורמט המתאים, שמתחילה ב-'Place Name, State, Country' באזור של ארצות הברית (לדוגמה 'קירקלנד, וושינגטון, ארה"ב').
    • מקבלים נתונים שימושיים נוספים כמו תמונות.

שימוש ב-Geocoding API

  • Geocoding API מאפשר להמיר כתובת, קואורדינטות של קווי רוחב וקו אורך או מזהה של מקום לקואורדינטות גיאוגרפיות, ולהיפך. הדוגמאות הבאות משתלבות היטב עם סגנון מבוסס-נתונים בגבולות:

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

    הדוגמה הבאה משתמשת בכתובת (עם קוד Escape) כדי לשלוח בקשה ל-Geocoding API:

    https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&key=YOUR_API_KEY

    אפשר להשתמש בקידוד גיאוגרפי הפוך כדי למצוא את מזהי המקומות. הדוגמה הבאה של שירות הקידוד הגיאוגרפי מחזירה את מזהי המקומות של כל רכיבי הכתובות בקואורדינטות של קו הרוחב וקו האורך שצוינו:

    https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&result_type=locality&key=YOUR_API_KEY

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

    • administrativeArea
    • country
    • locality
    • postalCode
    • schoolDistrict

    בדוגמה הבאה תוכלו לראות איך משתמשים בשירות הקידוד הגיאוגרפי, כשמוסיפים הגבלות על רכיבים עם קידוד גיאוגרפי הפוך כדי לאחזר את כל רכיבי הכתובת במיקום שצוין עבור הסוג locality:

    https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&result_type=locality&key=YOUR_API_KEY