Places API yanıtını taşıma

Avrupa Ekonomik Alanı (AEA) geliştiricileri

Giriş

Place Details (New), Nearby Search (New) ve Text Search (New) 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üzey alanları da her API için değişti. Şu konulara göz atın:

Yanıt yer nesnesinde yapılan değişiklikler

Bu tabloda, Yer Ayrıntıları (Yeni), Yakınlardaki Arama (Yeni) ve Metin Arama (Yeni) yanıtlarındaki yeni Place nesnesinde yapılan değişiklikler, eski Place nesnesiyle karşılaştırılarak gösterilmektedir.

Yeni yanıt nesnesi, alan adları için camel-casing kullanır, yeni alanlar içerir ve eski alanların bazılarını yeniden adlandırı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
İşletme 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ıtın en ü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ı 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ına geçiş 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 geçerli olmak üzere, istisnalar ve diğer tüm verilerle birlikte gelecek haftanın ikincil çalışma saatleri secondary_opening_hours currentSecondaryOpeningHours
Yer türleri types types
Yerin Google Haritalar URL'si url googleMapsUri
Kullanıcı puanlarının sayısı user_ratings_total userRatingCount
UTC farkı utc_offset utcOffsetMinutes
Sokak adı ve şehir de 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 adresinde
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 içinde yer alır.
Birincil yer 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 son 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, Metin Arama (Eski) için yanıt nesnesinin ve Metin Arama (Yeni) için yanıt nesnesinin üst düzey alanlarındaki değişiklikler gösterilmektedir. Yeni API'de yanıttaki tek üst düzey alan places dizisidir.

Alan Metin Arama (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
İsteğin durumu status Standart HTTP yanıtına (HTTP yanıt kodu ve mesajı) geçildi.
Hata mesajları error_message Standart HTTP yanıtına (HTTP yanıt kodu ve mesajı) geçildi.
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, Yakınlarda Arama (Eski) için response object ve Yakınlarda Arama (Yeni) için response object üst düzey alanlarındaki 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 place.attributions olarak taşındı
Yer dizisi Eski Place nesnesinin results dizisi Yeni Yer nesnesinin places dizisi
İsteğin durumu status Standart HTTP yanıtına (HTTP yanıt kodu ve mesajı) geçildi.
Hata mesajları error_message Standart HTTP yanıtına (HTTP yanıt kodu ve mesajı) geçildi.
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'de yanıttaki tek üst düzey alan places dizisidir.

Alan Yer ayrıntıları (eski) Yer Ayrıntıları (Yeni) Notlar
Yer ilişkilendirmeleri html_attributions Yeni Yer'e taşındı attributions olarak
Yer Ayrıntıları (Yeni) Eski Yer nesnesini içeren result Yeni Yer nesnesi
İsteğin durumu status Standart HTTP yanıtına (HTTP yanıt kodu ve mesajı) geçildi.
Bilgi mesajları info_messages Standart HTTP yanıtına (HTTP yanıt kodu ve mesajı) geçildi.