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

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

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

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

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

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

שימוש ב-Places API

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

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

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

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

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

שימוש ב-Geocoding API

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

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

    בדוגמה הבאה נעשה שימוש בכתובת (עם תווים מיוחדים שמוחלפים בתווים אחרים שמתאימים לכתובות URL) כדי לשלוח בקשה אל Geocoding API:

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

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

    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