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

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

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

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

כדי להוסיף את Places ו-Geocoding לאפליקציות של Maps SDK ל-iOS:

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

שימוש ב-Places API

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

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

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

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

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

שימוש ב-Geocoding API

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

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

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

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

    אתם יכולים להשתמש בהמרת קואורדינטות לכתובות (reverse geocoding) כדי למצוא מזהי מקומות. הפונקציה הבאה של שירות 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, הוספת הגבלות על רכיבים עם המרת קואורדינטות לכתובות כדי לאחזר את כל רכיבי הכתובת במיקום שצוין לסוג locality:

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