שימוש ב-Places APIs וב-Geocoding עם עיצוב מבוסס-נתונים לגבולות

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

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

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

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

שימוש ב-Places API

  • Places API Text Search מחזיר מידע על קבוצת מקומות על סמך מחרוזת – לדוגמה, 'פיצה בניו יורק' או 'חנויות נעליים ליד אוטווה' או 'רחוב ראשי 123'. השירות יחזיר רשימה של מקומות שתואמים למחרוזת הטקסט ולנטיית המיקום שהוגדרה.

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

אחזור פרטי מקום באזור

  • גם הנתונים של פרטי המקום לאזור מסוים יעילים. לדוגמה, אפשר:

    • חיפוש מזהי מקומות של גבולות על סמך שמות של מקומות.
    • אחזור של אזור התצוגה כדי להתקרב לגבול.
    • אחזור של סוג התכונה של הגבול (לדוגמה, יישוב).
    • מקבלים את הכתובת בפורמט 'שם המקום, מדינה, מדינה' באזור ארצות הברית (לדוגמה, 'Kirkland, WA, USA').
    • לקבל נתונים שימושיים אחרים, כמו תמונות.

שימוש ב-Geocoding API

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

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

    בדוגמה הבאה נעשה שימוש בכתובת (שעברה בריחה מ-URL) כדי לשלוח בקשה ל-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