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

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

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

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

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

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

שימוש ב-Places API

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

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

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

    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