Files
firebase-js-sdk/docs-devsite/firestore_lite.geopoint.md
DellaBittaandGitHub ffb88d05b6 Feat(Firestore) JSON serialization of types to improve SSR support. (#8926)
Support the ability to resume `onSnapshot` listeners in the CSR phase based on serialized `DataSnapshot`s and `QuerySnapshot`s built in the SSR phase. Allow Firestore result types to be serialized with `toJSON` and then deserialized with `fromJSON` methods on the objects.

`DocumentSnapshot` and `QuerySnapshot` deserialization methods will be standalone, tree-shakable functions `dataSnapshotFromJSON` and `querySnapshotFromJSON`.
2025-06-23 14:57:19 -04:00

3.9 KiB

Project: /docs/reference/js/_project.yaml Book: /docs/reference/_book.yaml page_type: reference

{% comment %} DO NOT EDIT THIS FILE! This is generated by the JS SDK team, and any local changes will be overwritten. Changes should be made in the source code at https://github.com/firebase/firebase-js-sdk {% endcomment %}

GeoPoint class

An immutable object representing a geographic location in Firestore. The location is represented as latitude/longitude pair.

Latitude values are in the range of [-90, 90]. Longitude values are in the range of [-180, 180].

Signature:

export declare class GeoPoint 

Constructors

Constructor Modifiers Description
(constructor)(latitude, longitude) Creates a new immutable GeoPoint object with the provided latitude and longitude values.

Properties

Property Modifiers Type Description
latitude number The latitude of this GeoPoint instance.
longitude number The longitude of this GeoPoint instance.

Methods

Method Modifiers Description
fromJSON(json) static Builds a GeoPoint instance from a JSON object created by GeoPoint.toJSON().
isEqual(other) Returns true if this GeoPoint is equal to the provided one.
toJSON() Returns a JSON-serializable representation of this GeoPoint instance.

GeoPoint.(constructor)

Creates a new immutable GeoPoint object with the provided latitude and longitude values.

Signature:

constructor(latitude: number, longitude: number);

Parameters

Parameter Type Description
latitude number The latitude as number between -90 and 90.
longitude number The longitude as number between -180 and 180.

GeoPoint.latitude

The latitude of this GeoPoint instance.

Signature:

get latitude(): number;

GeoPoint.longitude

The longitude of this GeoPoint instance.

Signature:

get longitude(): number;

GeoPoint.fromJSON()

Builds a GeoPoint instance from a JSON object created by GeoPoint.toJSON().

Signature:

static fromJSON(json: object): GeoPoint;

Parameters

Parameter Type Description
json object a JSON object represention of a GeoPoint instance

Returns:

GeoPoint

an instance of GeoPoint if the JSON object could be parsed. Throws a FirestoreError if an error occurs.

GeoPoint.isEqual()

Returns true if this GeoPoint is equal to the provided one.

Signature:

isEqual(other: GeoPoint): boolean;

Parameters

Parameter Type Description
other GeoPoint The GeoPoint to compare against.

Returns:

boolean

true if this GeoPoint is equal to the provided one.

GeoPoint.toJSON()

Returns a JSON-serializable representation of this GeoPoint instance.

Signature:

toJSON(): {
        latitude: number;
        longitude: number;
        type: string;
    };

Returns:

{ latitude: number; longitude: number; type: string; }

a JSON representation of this object.