אפשר להשתמש בשירות 'מקומות' Geocoding API עם SDK של מפות ל-Android לחיפוש אזורים, וגם לקבל מידע נוסף על מקומות. שירות 'מקומות' ו-Geocoding API הם חלופות חזקות ויציבות לקבלת מזהים של מקומות. אם השתמשת כבר במזהי מקומות, אפשר להשתמש בהם שוב עם סגנון מבוסס-נתונים בגבולות.
הוספת שירות 'מקומות' והקידוד הגיאוגרפי של SDK של מפות לאפליקציות Android בדרכים הבאות:
- Places SDK ל-Android היא ספריית Android שמכילה שיטות להחזרת מידע על במקומות שונים.
- Places API מחזירה מידע על מקומות באמצעות בקשות HTTP.
- סיווג Geocoder יכול לבצע קואורדינטות ולהפוך את הקוד הגאוגרפי באופן דינמי לקלט של משתמש.
- Geocoding API מאפשר לך כתובות סטטיות ומוכרות לקואורדינטות.
שימוש בשירות 'מקומות'
איך משתמשים בחיפוש טקסט (חדש) כדי למצוא מזהה מקום
אפשר להשתמש בחיפוש טקסט (חדש)
API ל-REST ב-Places API כדי לקבל מזהה מקום שכולל אזור
על ידי ציון places.id
במסכת השדות. שימוש ב
חיפוש טקסט (חדש) כדי לבקש מזהי מקומות בלבד
ללא חיוב. מידע נוסף
לדוגמה, כדי לקבל את מזהה המקום של טרינידד וקנדה, אפשר לבצע את הפעולות הבאות קריאה ל-API:
curl -X POST -d '{ "textQuery" : "Trinidad, CA" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: places.id' \ 'https://places.googleapis.com/v1/places:searchText'
איך משתמשים בהשלמה האוטומטית של 'מקומות' כדי למצוא אזורים
השלמה אוטומטית של מקומות
השירות Places SDK ל-Android מספק דרך נוחה לאפשר
שהמשתמשים שלכם מחפשים לפי אזורים. כדי להגדיר את שירות ההשלמה האוטומטית של 'מקומות' ל-
החזרת אזורים בלבד, שימוש
AutocompleteSupportFragment.setTypesFilter(List)
כדי להגדיר את מסנן הסוג לPlaceTypes.REGIONS
.
קבלת פרטים על אזור מסוים
פרטי המקום בשירות Places SDK ל-Android מחזיר נתונים עבור אזור מסוים, שימושי מאוד. לדוגמה, אפשר:
- חיפוש מזהים של מקומות גבולות לפי שמות של מקומות.
- קבלת אזור התצוגה לשינוי מרחק התצוגה עד לגבול.
- מקבלים את סוג התכונה עבור הגבול (לדוגמה
locality
). - מאתרים את הכתובת בפורמט הבא: 'שם מקום, מדינה', 'מדינה'. באזור ארצות הברית (לדוגמה, "Ottumwa, IA, USA").
- מקבלים נתונים שימושיים נוספים כמו תמונות.
שימוש ב-Geocoding API
Geocoding API מאפשר לבצע המרה כתובת לקואורדינטות של קו אורך וקו רוחב ומזהה מקום, או ממירה של קווי אורך ורוחב או מזהה מקום בכתובת. הבאים משתלב היטב עם סגנון מבוסס-נתונים בגבולות:
- אפשר להשתמש בקידוד גיאוגרפי כדי לקבל את אזור התצוגה של אזור מסוים.
- יש להחיל סינון רכיבים בקריאת הקידוד הגיאוגרפי כדי לקבל את מזהי המקומות של אזורים מנהליים 1-4, הרשות המוניציפאלית או מיקוד.
- אפשר להשתמש בקידוד גיאוגרפי הפוך כדי למצוא מזהי מקומות לפי קו רוחב וקו אורך ואפילו להחזיר מזהי מקומות לכל הרכיבים המיקום.
הדוגמה הבאה משתמשת בכתובת (עם קוד Escape) כדי לשלוח בקשה Geocoding API:
https://maps.googleapis.com/maps/api/geocode/json?address=1600%20Amphitheatre%20Pkwy%20Mountain%20View%20CA&key=YOUR_API_KEY
אפשר להשתמש בהמרת קידוד גיאוגרפי. כדי למצוא מזהי מקומות. הדוגמה הבאה לקידוד גיאוגרפי הפונקציה service מחזירה את מזהי המקומות של כל רכיבי הכתובת קואורדינטות של קווי אורך ורוחב שצוינו:
https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&key=YOUR_API_KEY
שימוש בקידוד גיאוגרפי הפוך עם סינון רכיבים כדי לקבל את רכיב הכתובת עבור אחד או יותר מהסוגים הבאים במיקום שצוין:
administrativeArea
country
locality
postalCode
הפונקציה הבאה לדוגמה מציגה שימוש בשירות קידוד גיאוגרפי, ומוסיפים רכיב
עם קידוד גיאוגרפי הפוך כדי לקבל את כל רכיבי הכתובת
המיקום שצוין רק עבור הסוג locality
:
https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&result_type=locality&key=YOUR_API_KEY