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

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

מפתחים באזור הכלכלי האירופי (EEA)

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

כדי להוסיף את Places ו-Geocoding לאפליקציות שלכם ב-SDK של מפות ל-iOS, אפשר להשתמש באחת מהשיטות הבאות:

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

שימוש ב-Places API

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

  • שירות ההשלמה האוטומטית של מקומות מספק למשתמשים דרך נוחה לחפש אזורים. כדי להציג תוצאות באזור המוגדר, צריך להגדיר את locationRestriction כ-on ב-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

    אפשר להשתמש בהמרת קואורדינטות לכתובות (reverse geocoding) עם סינון רכיבים כדי לקבל את רכיב הכתובת של אחד או יותר מהסוגים הבאים במיקום שצוין:

    • administrativeArea
    • country
    • locality
    • postalCode
    • schoolDistrict

    בדוגמה הבאה מוצג שימוש בשירות המרת כתובות לקואורדינטות (geocoding), הוספת הגבלות על רכיבים באמצעות המרת קואורדינטות לכתובות (reverse geocoding) כדי לאחזר את כל רכיבי הכתובת במיקום שצוין עבור הסוג locality:

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