Giriş
Yer Ayrıntıları (Yeni), Yakında Arama (Yeni) ve Metin Arama (Yeni) API'lerinin yanıt biçimi, eski API'lerin biçiminden farklıdır. Temel fark, Changes to the response Place object (Yanıt Yer nesnesinde yapılan değişiklikler) bölümünde açıklandığı gibi, her yöntem tarafından döndürülen Place nesnesinin biçimindedir.
Ayrıca, yanıt nesnesinin en üst düzeydeki alanları da her API için değişti. Şu konulara göz atın:
- Metin Arama yanıtı değişiklikleri
- Yakındaki Arama yanıtlarındaki değişiklikler
- Yer Ayrıntıları yanıt değişiklikleri
Yanıtın Place nesnesinde yapılan değişiklikler
Bu tabloda, Yer Ayrıntıları (Yeni), Yakında Arama (Yeni) ve Metin Arama (Yeni) yanıtındaki yeni
Place nesnesinde yapılan değişiklikler, eski
Place nesnesiyle karşılaştırılarak gösterilmektedir.
Yeni yanıt nesnesinde alan adları için camel-case kullanılır, yeni alanlar içerir ve eski alanlardan bazıları yeniden adlandırılır.
| Alan | Places API (Eski) nesnesi | Places API (Yeni) nesnesi | Notlar |
|---|---|---|---|
| Adres bileşeni | address_components |
addressComponents |
|
| Yer mikro biçim adresi | adr_address |
adrFormatAddress |
|
| İşletmenin durumu | business_status |
businessStatus |
|
| Önümüzdeki haftanın çalışma saatleri | current_opening_hours |
currentOpeningHours |
|
| İçerik özeti | editorial_summary |
editorialSummary |
|
| Biçimlendirilmiş adres | formatted_address |
formattedAddress |
|
| Ulusal telefon numarası | formatted_phone_number |
nationalPhoneNumber |
|
| Konum | geometry.location |
location |
|
| Görüntü alanı | geometry.viewport |
viewport |
|
| Yer ilişkilendirmeleri | html_attributions |
attributions |
Eski API'lerdeki yanıtta en üst düzey alan |
| Simge URL'si | icon |
Kaldırıldı. iconMaskBaseUri ve iconBackgroundColor kullanın. Daha
fazla bilgi için Yer simgeleri konusuna
bakın. |
|
| Simge arka plan rengi | icon_background_color |
iconBackgroundColor |
|
| Simge maskesi URL'si | icon_mask_base_uri |
iconMaskBaseUri |
|
| Uluslararası telefon numarası | international_phone_number |
internationalPhoneNumber |
|
| Metin yer adı | name |
displayName |
Metin yer adı artık displayName.text olarak, language ise displayName.languageCode olarak erişilebilir. |
| Çalışma saatleri | opening_hours |
regularOpeningHours |
|
| Fotoğraflar | photos |
photos |
photos biçimi yeni Place nesnesinde değişti. Daha fazla bilgi için Fotoğraf referanslarında değişiklik başlıklı makaleyi inceleyin. |
| Yer kimliği | place_id |
id |
|
| Plus code | plus_code |
plusCode |
|
| Fiyat düzeyi | price_level |
priceLevel |
|
| Derecelendirme | rating |
rating |
|
| Yorumlar | reviews |
reviews |
|
| Bugünden itibaren önümüzdeki hafta için ikincil çalışma saatleri (istisnalar ve diğer tüm verilerle birlikte) | secondary_opening_hours |
currentSecondaryOpeningHours |
|
| Yer türleri | types |
types |
|
| Yerin Google Haritalar URL'si | url |
googleMapsUri |
|
| Kullanıcı puanı sayısı | user_ratings_total |
userRatingCount |
|
| UTC farkı | utc_offset |
utcOffsetMinutes |
|
| Sokak adı ve şehir dahil olmak üzere adresin kısa biçimi | vicinity |
shortFormattedAddress |
|
| Yerin web sitesi | website |
websiteUri |
|
| Tekerlekli sandalyeye uygunluk bilgileri | wheelchair_accessible_entrance |
accessibilityOptions |
wheelchair_accessible_entrance artık accessibilityOptions.wheelchairAccessibleEntrance |
| Yer özellikleri | takeout, delivery, dine_in, curbside_pickup, reservable,
serves_breakfast, serves_lunch, serves_dinner, serves_beer, serves_wine,
serves_brunch, serves_vegetarian_food |
takeout, delivery, dineIn, curbsidePickup, reservable,
servesBreakfast, servesLunch, servesDinner, servesBeer, servesWine,
servesBrunch, servesVegetarianFood |
|
| Kaynak adı | places/PLACE_ID formundaki name alanı |
Eski API'de name alanı, yer adını metin dizesi olarak içeriyordu. Yeni API'de bu bilgiler displayName alanında yer alır. |
|
| Yer birincil türü | primaryTypeName |
Yeni | |
| Birincil türü metin dizesi olarak yerleştirin. | primaryTypeDisplayName |
Yeni | |
| İstisnalar ve diğer tüm verilerle birlikte düzenli haftalık ikincil çalışma saatleri | regularSecondaryOpeningHours |
Yeni | |
| Mekanın kabul ettiği ödeme seçenekleri | paymentOptions |
Yeni | |
| Park yeri seçenekleri | parkingOptions |
Yeni | |
| Yerle ilgili alt hedeflerin listesi | subDestinations |
Yeni | |
| Benzin istasyonundaki yakıt seçenekleri hakkında en güncel bilgiler | fuelOptions |
Yeni | |
| Bir yerle ilgili elektrikli araç şarj bilgileri | evChargeOptions |
Yeni | |
| Yer özellikleri | outdoorSeating, liveMusic, menuForChildren, servesCocktails,
servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom,
goodForGroups, goodForWatchingSports |
Yeni |
Metin Arama yanıtı değişiklikleri
Aşağıdaki tabloda, Text Search (Legacy) için yanıt nesnesinin ve Text Search (New) için yanıt nesnesinin üst düzey alanlarındaki değişiklikler gösterilmektedir. Yeni API için yanıttaki tek üst düzey alan places dizisidir.
| Alan | Text Search (Eski) | Metin Arama (Yeni) | Notlar |
|---|---|---|---|
| Yer ilişkilendirmeleri | html_attributions |
Her yer için yeni Yer nesnesine place.attributions olarak taşındı. |
|
| Yer dizisi | Eski Place nesnesinin results dizisi |
Yeni Place nesnesinin places dizisi |
|
| Talebin durumu | status |
Standart HTTP yanıtına (HTTP yanıt kodu ve mesajı) taşındı | |
| Hata mesajları | error_message |
Standart HTTP yanıtına (HTTP yanıt kodu ve mesajı) taşındı | |
| Tüm bilgi mesajları | info_messages |
Kaldırıldı | |
| Sayfa jetonu | next_page_token |
Kaldırıldı |
Yakında Arama yanıtı değişiklikleri
Aşağıdaki tabloda, Nearby Search (Eski) için yanıt nesnesinin ve Nearby Search (Yeni) için yanıt nesnesinin üst düzey alanlarında yapılan değişiklikler gösterilmektedir. Yeni API'de yanıttaki tek üst düzey alan places dizisidir.
| Alan | Yakında Arama (Eski) | Yakında Arama (Yeni) | Notlar |
|---|---|---|---|
| Yer ilişkilendirmeleri | html_attributions |
Her yer için yeni Yer nesnesine taşındı place.attributions |
|
| Yer dizisi | Eski Place nesnesinin results dizisi |
places yeni Place nesnesinin dizisi |
|
| Talebin durumu | status |
Standart HTTP yanıtına (HTTP yanıt kodu ve mesajı) taşındı | |
| Hata mesajları | error_message |
Standart HTTP yanıtına (HTTP yanıt kodu ve mesajı) taşındı | |
| Tüm bilgi mesajları | info_messages |
Kaldırıldı | |
| Sayfa jetonu | next_page_token |
Kaldırıldı |
Yer Ayrıntıları (Yeni) yanıt değişiklikleri
Aşağıdaki tabloda, Yer Ayrıntıları (Eski) için response
object ve Yer Ayrıntıları (Yeni) için response
object üst düzey alanlarındaki değişiklikler gösterilmektedir. Yeni API için yanıttaki tek üst düzey alan places dizisidir.
| Alan | Yer Ayrıntıları (Eski) | Place Details (New) | Notlar |
|---|---|---|---|
| Yer ilişkilendirmeleri | html_attributions |
Yeni Yer'e taşındı
attributions olarak yerleştirildi |
|
| Yer Ayrıntıları (Yeni) | Eski Place nesnesini içeren result |
Yeni Place nesnesi | |
| Talebin durumu | status |
Standart HTTP yanıtına (HTTP yanıt kodu ve mesajı) taşındı | |
| Tüm bilgi mesajları | info_messages |
Standart HTTP yanıtına (HTTP yanıt kodu ve mesajı) taşındı |