Yeni Yer Ayrıntıları, Yakındaki Arama ve Metin Arama API'lerinin yanıt biçimi, mevcut API'lerin biçiminden farklıdır. Temel fark, Yanıt Place nesnesindeki değişiklikler bölümünde açıklandığı gibi her yöntem tarafından döndürülen Place nesnesinin biçimindedir.
Buna ek olarak, her API için yanıt nesnesinin üst düzey alanları da değişti. Şu konulara göz atın:
- Metin Arama yanıtı değişiklikleri
- Yakındaki Arama yanıtı değişiklikleri
- Yer Ayrıntıları yanıt değişiklikleri
Yanıtın Place nesnesindeki değişiklikler
Bu tabloda, mevcut
Place nesnesine kıyasla Yer Ayrıntıları (Yeni), Yakındaki Arama (Yeni) ve Metin Arama (Yeni) yanıtında yeni
Place nesnesinde yapılan değişiklikler gösterilmektedir.
Yeni yanıt nesnesi, alan adları için büyük/küçük harf kullanımını kullanır, yeni alanları içerir ve mevcut alanlardan bazılarını yeniden adlandırır.
| Alan | Mevcut Yer nesnesi | Yeni Yer nesnesi | Notlar |
|---|---|---|---|
| Adres bileşeni | address_components |
addressComponents |
|
| Mikro biçimli adresi yerleştir | adr_address |
adrFormatAddress |
|
| İşletmenin durumu | business_status |
businessStatus |
|
| Gelecek hafta ç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 atıfları | html_attributions |
attributions |
Mevcut API'lerde yanıtın üst düzey alanı |
| Simge URL'si | icon |
Kaldırıldı. iconMaskBaseUri ve iconBackgroundColor özelliğini kullanın. Daha fazla bilgi için Yer simgeleri bölümüne 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ına artık displayName.languageCode olarak displayName.text ve language olarak erişilebilir |
| Çalışma saatleri | opening_hours |
regularOpeningHours |
|
| Fotoğraflar | photos |
photos |
Yeni Place nesnesinde photos biçimi değişti. Daha fazla bilgi için Fotoğraf referanslarında değişiklik yapma başlıklı makaleye göz atın. |
| Yer kimliği | place_id |
id |
|
| Plus code | plus_code |
plusCode |
|
| Fiyat düzeyi | price_level |
priceLevel |
|
| Derecelendirme | rating |
rating |
|
| İnceleme durumu | reviews |
reviews |
|
| İstisnalar ve diğer tüm veriler dahil olmak üzere bugünden itibaren gelecek hafta için ikincil çalışma saatleri | secondary_opening_hours |
currentSecondaryOpeningHours |
|
| Yer türleri | types |
types |
|
| Yerin Google Haritalar URL'si | url |
googleMapsUri |
|
| Kullanıcı oyu sayısı | user_ratings_total |
userRatingCount |
|
| UTC farkı | utc_offset |
utcOffsetMinutes |
|
| Adresin sokak adını ve ilçeyi içeren kısa biçimi | vicinity |
shortFormattedAddress |
|
| Yer web sitesi | website |
websiteUri |
|
| Tekerlekli sandalyeye uygunluk bilgileri | wheelchair_accessible_entrance |
accessibilityOptions |
wheelchair_accessible_entrance şu anda accessibilityOptions.wheelchairAccessibleEntrance konumunda |
| 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 formunda name alanı |
Mevcut API'de name alanı, yer adını metin dizesi olarak içeriyordu. Yeni API'de bu bilgiler displayName dilindedir. |
|
| Birincil konum türü | primaryTypeName |
Yeni | |
| Birincil türü metin dizesi olarak yerleştirme | primaryTypeDisplayName |
Yeni | |
| İstisnalar ve diğer tüm veriler dahil, normal haftalık ikincil çalışma saatleri | regularSecondaryOpeningHours |
Yeni | |
| Yerin kabul ettiği ödeme seçenekleri | paymentOptions |
Yeni | |
| Yer park etme seçenekleri | parkingOptions |
Yeni | |
| Yerle ilgili alt hedeflerin listesi | subDestinations |
Yeni | |
| Bir benzin istasyonundaki yakıt seçenekleri hakkında en güncel bilgiler | fuelOptions |
Yeni | |
| Bir yer için EV ş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, mevcut Metin Arama için yanıt nesnesinin ve Metin Arama (Yeni) için yanıt nesnesinin üst düzey alanlarında yapılan değişiklikler gösterilmektedir. Yeni API için yanıttaki tek üst düzey alan places dizisidir.
| Alan | Metin Arama (Mevcut) | Metin Arama (Yeni) | Notlar |
|---|---|---|---|
| Yer atıfları | html_attributions |
Her yer için yeni Yer nesnesine place.attributions olarak taşındı |
|
| Yerler dizisi | Mevcut Place nesnesinin results dizisi |
Yeni Place nesnesinin places dizisi |
|
| İsteğin durumu | status |
Standart HTTP yanıtına (HTTP yanıt kodu ve mesajı) taşındı | |
| Tüm hata mesajları | error_message |
Standart HTTP yanıtına (HTTP yanıt kodu ve mesajı) taşındı | |
| Bilgi mesajları | info_messages |
Kaldırıldı | |
| Sayfa jetonu | next_page_token |
Kaldırıldı |
Yakındaki Arama yanıtı değişiklikleri
Aşağıdaki tabloda, mevcut Yakındaki Arama için yanıt nesnesinin üst düzey alanlarında ve Yakındaki Arama (Yeni) için yanıt nesnesinde yapılan değişiklikler gösterilmektedir. Yeni API için yanıttaki tek üst düzey alan places dizisidir.
| Alan | Yakında Arama (Mevcut) | Yakında Arama (Yeni) | Notlar |
|---|---|---|---|
| Yer atıfları | html_attributions |
Her yer için yeni Place nesnesine place.attributions olarak taşındı |
|
| Yerler dizisi | Mevcut Place nesnesinin results dizisi |
Yeni Place nesnesinin places dizisi |
|
| İsteğin durumu | status |
Standart HTTP yanıtına (HTTP yanıt kodu ve mesajı) taşındı | |
| Tüm hata mesajları | error_message |
Standart HTTP yanıtına (HTTP yanıt kodu ve mesajı) taşındı | |
| Bilgi mesajları | info_messages |
Kaldırıldı | |
| Sayfa jetonu | next_page_token |
Kaldırıldı |
Yer Ayrıntıları yanıt değişiklikleri
Aşağıdaki tabloda, mevcut Yer Ayrıntıları için yanıt nesnesinin üst düzey alanlarında ve Yer Ayrıntıları (Yeni) için yanıt nesnesinde yapılan değişiklikler gösterilmektedir. Yeni API için yanıttaki tek üst düzey alan places dizisidir.
| Alan | Yer Ayrıntıları (Mevcut) | Yer Ayrıntıları (Yeni) | Notlar |
|---|---|---|---|
| Yer atıfları | html_attributions |
Yeni Place nesnesine attributions olarak taşındı |
|
| Yer ayrıntıları | Mevcut Place nesnesini içeren result |
Yeni Place nesnesi | |
| İsteğin durumu | status |
Standart HTTP yanıtına (HTTP yanıt kodu ve mesajı) taşındı | |
| Bilgi mesajları | info_messages |
Standart HTTP yanıtına (HTTP yanıt kodu ve mesajı) taşındı |